@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
@@ -1,8 +1,15 @@
1
1
  import { constants } from "node:fs";
2
2
  import { access, realpath, stat } from "node:fs/promises";
3
- import { delimiter, extname, isAbsolute, join, relative, resolve, sep, } from "node:path";
3
+ import { basename, delimiter, dirname, extname, isAbsolute, join, relative, resolve, sep, } from "node:path";
4
4
  export async function resolveTrustedExecutable(candidate, environment, protectedRoot) {
5
- const root = await realpath(protectedRoot).catch(() => resolve(protectedRoot));
5
+ const inspected = await inspectTrustedExecutable(candidate, environment, protectedRoot);
6
+ return inspected.executable === null
7
+ ? null
8
+ : { executable: inspected.executable, environment: inspected.environment };
9
+ }
10
+ export async function inspectTrustedExecutable(candidate, environment, protectedRoot) {
11
+ const roots = await Promise.all((typeof protectedRoot === "string" ? [protectedRoot] : protectedRoot).map((root) => realpath(root).catch(() => resolve(root))));
12
+ const isProtected = (path) => roots.some((root) => isWithin(root, path));
6
13
  const path = environment["PATH"] ??
7
14
  Object.entries(environment).find(([name]) => name.toUpperCase() === "PATH")?.[1];
8
15
  const entries = [];
@@ -15,7 +22,7 @@ export async function resolveTrustedExecutable(candidate, environment, protected
15
22
  if (entry.length === 0)
16
23
  continue;
17
24
  const canonical = await realpath(entry).catch(() => null);
18
- if (canonical === null || isWithin(root, canonical))
25
+ if (canonical === null || isProtected(canonical))
19
26
  continue;
20
27
  if (!entries.includes(canonical))
21
28
  entries.push(canonical);
@@ -42,7 +49,9 @@ export async function resolveTrustedExecutable(candidate, environment, protected
42
49
  const candidates = pathLike
43
50
  ? extensions.map((extension) => ({
44
51
  entry: null,
45
- path: resolve(`${candidate}${extension.suffix}`),
52
+ path: process.platform === "win32"
53
+ ? resolve(`${candidate}${extension.suffix}`)
54
+ : candidate,
46
55
  runnable: extension.runnable,
47
56
  }))
48
57
  : entries.flatMap((entry) => extensions.map((extension) => ({
@@ -56,25 +65,34 @@ export async function resolveTrustedExecutable(candidate, environment, protected
56
65
  const canonical = await realpath(current.path).catch(() => null);
57
66
  if (canonical === null)
58
67
  continue;
59
- if (isWithin(root, canonical)) {
68
+ if (isProtected(canonical)) {
60
69
  if (current.entry !== null)
61
70
  unsafeEntries.add(current.entry);
62
71
  continue;
63
72
  }
73
+ if (process.platform === "win32" && /\.(?:bat|cmd)$/iu.test(canonical)) {
74
+ continue;
75
+ }
64
76
  if (!current.runnable)
65
77
  continue;
66
78
  try {
67
79
  await access(canonical, process.platform === "win32" ? constants.F_OK : constants.X_OK);
68
80
  if (!(await stat(canonical)).isFile())
69
81
  continue;
70
- executable ??= pathLike ? canonical : current.path;
82
+ // Keep explicit virtualenv launchers, but resolve repository-local aliases
83
+ // to the trusted target instead of invoking them from the repository.
84
+ const invocationPath = pathLike
85
+ ? join(await realpath(dirname(current.path)), basename(current.path))
86
+ : current.path;
87
+ executable ??=
88
+ pathLike && (isProtected(current.path) || isProtected(invocationPath))
89
+ ? canonical
90
+ : invocationPath;
71
91
  }
72
92
  catch {
73
93
  continue;
74
94
  }
75
95
  }
76
- if (executable === null)
77
- return null;
78
96
  const sanitizedEnvironment = { ...environment };
79
97
  for (const name of Object.keys(sanitizedEnvironment)) {
80
98
  if (name.toUpperCase() === "PATH")
@@ -85,7 +103,8 @@ export async function resolveTrustedExecutable(candidate, environment, protected
85
103
  .join(delimiter);
86
104
  return { executable, environment: sanitizedEnvironment };
87
105
  }
88
- function isWithin(root, candidate) {
106
+ /** @internal */
107
+ export function isWithin(root, candidate) {
89
108
  const path = relative(root, candidate);
90
109
  return (path === "" ||
91
110
  (path !== ".." && !path.startsWith(`..${sep}`) && !isAbsolute(path)));
@@ -1 +1 @@
1
- {"version":3,"file":"trusted-executable.js","sourceRoot":"","sources":["../src/trusted-executable.ts"],"names":[],"mappings":"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","sourcesContent":["import { constants } from \"node:fs\";\nimport { access, realpath, stat } from \"node:fs/promises\";\nimport {\n delimiter,\n extname,\n isAbsolute,\n join,\n relative,\n resolve,\n sep,\n} from \"node:path\";\n\nexport interface TrustedExecutable {\n executable: string;\n environment: Record<string, string | undefined>;\n}\n\nexport async function resolveTrustedExecutable(\n candidate: string,\n environment: Readonly<Record<string, string | undefined>>,\n protectedRoot: string,\n): Promise<TrustedExecutable | null> {\n const root = await realpath(protectedRoot).catch(() =>\n resolve(protectedRoot),\n );\n const path =\n environment[\"PATH\"] ??\n Object.entries(environment).find(\n ([name]) => name.toUpperCase() === \"PATH\",\n )?.[1];\n const entries: string[] = [];\n for (let entry of path?.split(delimiter) ?? []) {\n if (\n process.platform === \"win32\" &&\n entry.startsWith('\"') &&\n entry.endsWith('\"')\n ) {\n entry = entry.slice(1, -1);\n }\n if (entry.length === 0) continue;\n const canonical = await realpath(entry).catch(() => null);\n if (canonical === null || isWithin(root, canonical)) continue;\n if (!entries.includes(canonical)) entries.push(canonical);\n }\n\n const pathLike = candidate.includes(\"/\") || candidate.includes(\"\\\\\");\n // execFile cannot launch batch files, but their symlink targets still affect PATH trust.\n // CreateProcess appends .exe to an extensionless explicit path, so inspect the file that\n // will actually run instead of rejecting an otherwise valid Windows configuration.\n const extensions =\n process.platform === \"win32\"\n ? /\\.(?:exe|com)$/iu.test(candidate)\n ? [{ suffix: \"\", runnable: true }]\n : pathLike\n ? extname(candidate) === \"\"\n ? [{ suffix: \".exe\", runnable: true }]\n : [{ suffix: \"\", runnable: false }]\n : [\n { suffix: \".exe\", runnable: true },\n { suffix: \".com\", runnable: true },\n { suffix: \".bat\", runnable: false },\n { suffix: \".cmd\", runnable: false },\n { suffix: \"\", runnable: false },\n ]\n : [{ suffix: \"\", runnable: true }];\n const candidates = pathLike\n ? extensions.map((extension) => ({\n entry: null,\n path: resolve(`${candidate}${extension.suffix}`),\n runnable: extension.runnable,\n }))\n : entries.flatMap((entry) =>\n extensions.map((extension) => ({\n entry,\n path: join(entry, `${candidate}${extension.suffix}`),\n runnable: extension.runnable,\n })),\n );\n const unsafeEntries = new Set<string>();\n let executable: string | null = null;\n for (const current of candidates) {\n const canonical = await realpath(current.path).catch(() => null);\n if (canonical === null) continue;\n if (isWithin(root, canonical)) {\n if (current.entry !== null) unsafeEntries.add(current.entry);\n continue;\n }\n if (!current.runnable) continue;\n try {\n await access(\n canonical,\n process.platform === \"win32\" ? constants.F_OK : constants.X_OK,\n );\n if (!(await stat(canonical)).isFile()) continue;\n executable ??= pathLike ? canonical : current.path;\n } catch {\n continue;\n }\n }\n if (executable === null) return null;\n\n const sanitizedEnvironment = { ...environment };\n for (const name of Object.keys(sanitizedEnvironment)) {\n if (name.toUpperCase() === \"PATH\") delete sanitizedEnvironment[name];\n }\n sanitizedEnvironment[\"PATH\"] = entries\n .filter((entry) => !unsafeEntries.has(entry))\n .join(delimiter);\n return { executable, environment: sanitizedEnvironment };\n}\n\nfunction isWithin(root: string, candidate: string): boolean {\n const path = relative(root, candidate);\n return (\n path === \"\" ||\n (path !== \"..\" && !path.startsWith(`..${sep}`) && !isAbsolute(path))\n );\n}\n"]}
1
+ {"version":3,"file":"trusted-executable.js","sourceRoot":"","sources":["../src/trusted-executable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,SAAS,EACT,OAAO,EACP,OAAO,EACP,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,GAAG,GACJ,MAAM,WAAW,CAAC;AAYnB,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAiB,EACjB,WAAyD,EACzD,aAAyC;IAEzC,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAC9C,SAAS,EACT,WAAW,EACX,aAAa,CACd,CAAC;IACF,OAAO,SAAS,CAAC,UAAU,KAAK,IAAI;QAClC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAiB,EACjB,WAAyD,EACzD,aAAyC;IAEzC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,CAAC,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,CACvE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CACpD,CACF,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CACnC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GACR,WAAW,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAC1C,EAAE,CAAC,CAAC,CAAC,CAAC;IACT,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/C,IACE,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC5B,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YACrB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EACnB,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,SAAS,KAAK,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC;YAAE,SAAS;QAC3D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrE,yFAAyF;IACzF,yFAAyF;IACzF,mFAAmF;IACnF,MAAM,UAAU,GACd,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;YAClC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAClC,CAAC,CAAC,QAAQ;gBACR,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE;oBACzB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;oBACtC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACrC,CAAC,CAAC;oBACE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAClC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAClC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;oBACnC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;oBACnC,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;iBAChC;QACP,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,QAAQ;QACzB,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC7B,KAAK,EAAE,IAAI;YACX,IAAI,EACF,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAC1B,CAAC,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;gBAC5C,CAAC,CAAC,SAAS;YACf,QAAQ,EAAE,SAAS,CAAC,QAAQ;SAC7B,CAAC,CAAC;QACL,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC7B,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;YACpD,QAAQ,EAAE,SAAS,CAAC,QAAQ;SAC7B,CAAC,CAAC,CACJ,CAAC;IACN,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,SAAS,KAAK,IAAI;YAAE,SAAS;QACjC,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI;gBAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACvE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,SAAS;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,CACV,SAAS,EACT,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAC/D,CAAC;YACF,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE;gBAAE,SAAS;YAChD,2EAA2E;YAC3E,sEAAsE;YACtE,MAAM,cAAc,GAAG,QAAQ;gBAC7B,CAAC,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,UAAU;gBACR,QAAQ,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;oBACpE,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,cAAc,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,MAAM,oBAAoB,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACrD,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM;YAAE,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,oBAAoB,CAAC,MAAM,CAAC,GAAG,OAAO;SACnC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SAC5C,IAAI,CAAC,SAAS,CAAC,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;AAC3D,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvC,OAAO,CACL,IAAI,KAAK,EAAE;QACX,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACrE,CAAC;AACJ,CAAC","sourcesContent":["import { constants } from \"node:fs\";\nimport { access, realpath, stat } from \"node:fs/promises\";\nimport {\n basename,\n delimiter,\n dirname,\n extname,\n isAbsolute,\n join,\n relative,\n resolve,\n sep,\n} from \"node:path\";\n\nexport interface TrustedExecutable {\n executable: string;\n environment: Record<string, string | undefined>;\n}\n\nexport interface InspectedExecutable {\n executable: string | null;\n environment: Record<string, string | undefined>;\n}\n\nexport async function resolveTrustedExecutable(\n candidate: string,\n environment: Readonly<Record<string, string | undefined>>,\n protectedRoot: string | readonly string[],\n): Promise<TrustedExecutable | null> {\n const inspected = await inspectTrustedExecutable(\n candidate,\n environment,\n protectedRoot,\n );\n return inspected.executable === null\n ? null\n : { executable: inspected.executable, environment: inspected.environment };\n}\n\nexport async function inspectTrustedExecutable(\n candidate: string,\n environment: Readonly<Record<string, string | undefined>>,\n protectedRoot: string | readonly string[],\n): Promise<InspectedExecutable> {\n const roots = await Promise.all(\n (typeof protectedRoot === \"string\" ? [protectedRoot] : protectedRoot).map(\n (root) => realpath(root).catch(() => resolve(root)),\n ),\n );\n const isProtected = (path: string) =>\n roots.some((root) => isWithin(root, path));\n const path =\n environment[\"PATH\"] ??\n Object.entries(environment).find(\n ([name]) => name.toUpperCase() === \"PATH\",\n )?.[1];\n const entries: string[] = [];\n for (let entry of path?.split(delimiter) ?? []) {\n if (\n process.platform === \"win32\" &&\n entry.startsWith('\"') &&\n entry.endsWith('\"')\n ) {\n entry = entry.slice(1, -1);\n }\n if (entry.length === 0) continue;\n const canonical = await realpath(entry).catch(() => null);\n if (canonical === null || isProtected(canonical)) continue;\n if (!entries.includes(canonical)) entries.push(canonical);\n }\n\n const pathLike = candidate.includes(\"/\") || candidate.includes(\"\\\\\");\n // execFile cannot launch batch files, but their symlink targets still affect PATH trust.\n // CreateProcess appends .exe to an extensionless explicit path, so inspect the file that\n // will actually run instead of rejecting an otherwise valid Windows configuration.\n const extensions =\n process.platform === \"win32\"\n ? /\\.(?:exe|com)$/iu.test(candidate)\n ? [{ suffix: \"\", runnable: true }]\n : pathLike\n ? extname(candidate) === \"\"\n ? [{ suffix: \".exe\", runnable: true }]\n : [{ suffix: \"\", runnable: false }]\n : [\n { suffix: \".exe\", runnable: true },\n { suffix: \".com\", runnable: true },\n { suffix: \".bat\", runnable: false },\n { suffix: \".cmd\", runnable: false },\n { suffix: \"\", runnable: false },\n ]\n : [{ suffix: \"\", runnable: true }];\n const candidates = pathLike\n ? extensions.map((extension) => ({\n entry: null,\n path:\n process.platform === \"win32\"\n ? resolve(`${candidate}${extension.suffix}`)\n : candidate,\n runnable: extension.runnable,\n }))\n : entries.flatMap((entry) =>\n extensions.map((extension) => ({\n entry,\n path: join(entry, `${candidate}${extension.suffix}`),\n runnable: extension.runnable,\n })),\n );\n const unsafeEntries = new Set<string>();\n let executable: string | null = null;\n for (const current of candidates) {\n const canonical = await realpath(current.path).catch(() => null);\n if (canonical === null) continue;\n if (isProtected(canonical)) {\n if (current.entry !== null) unsafeEntries.add(current.entry);\n continue;\n }\n if (process.platform === \"win32\" && /\\.(?:bat|cmd)$/iu.test(canonical)) {\n continue;\n }\n if (!current.runnable) continue;\n try {\n await access(\n canonical,\n process.platform === \"win32\" ? constants.F_OK : constants.X_OK,\n );\n if (!(await stat(canonical)).isFile()) continue;\n // Keep explicit virtualenv launchers, but resolve repository-local aliases\n // to the trusted target instead of invoking them from the repository.\n const invocationPath = pathLike\n ? join(await realpath(dirname(current.path)), basename(current.path))\n : current.path;\n executable ??=\n pathLike && (isProtected(current.path) || isProtected(invocationPath))\n ? canonical\n : invocationPath;\n } catch {\n continue;\n }\n }\n\n const sanitizedEnvironment = { ...environment };\n for (const name of Object.keys(sanitizedEnvironment)) {\n if (name.toUpperCase() === \"PATH\") delete sanitizedEnvironment[name];\n }\n sanitizedEnvironment[\"PATH\"] = entries\n .filter((entry) => !unsafeEntries.has(entry))\n .join(delimiter);\n return { executable, environment: sanitizedEnvironment };\n}\n\n/** @internal */\nexport function isWithin(root: string, candidate: string): boolean {\n const path = relative(root, candidate);\n return (\n path === \"\" ||\n (path !== \"..\" && !path.startsWith(`..${sep}`) && !isAbsolute(path))\n );\n}\n"]}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=value.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../src/value.ts"],"names":[],"mappings":""}
package/dist/value.js ADDED
@@ -0,0 +1,27 @@
1
+ /** @internal */
2
+ export function isSafeNonNegativeInteger(value) {
3
+ return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
4
+ }
5
+ /** @internal */
6
+ export function isNonEmptyString(value) {
7
+ return typeof value === "string" && value.length > 0;
8
+ }
9
+ /** @internal */
10
+ export function parseJson(read) {
11
+ try {
12
+ return JSON.parse(read());
13
+ }
14
+ catch {
15
+ return null;
16
+ }
17
+ }
18
+ /** @internal */
19
+ export const findingEntry = (finding) => [finding.findingId, finding];
20
+ /** @internal Optional observers must not block or interrupt their operation. */
21
+ export function notify(callback) {
22
+ try {
23
+ void Promise.resolve(callback()).catch(() => { });
24
+ }
25
+ catch { }
26
+ }
27
+ //# sourceMappingURL=value.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"value.js","sourceRoot":"","sources":["../src/value.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,SAAS,CAAC,IAAkB;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAAU,EACG,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAE/C,gFAAgF;AAChF,MAAM,UAAU,MAAM,CAAC,QAAuB;IAC5C,IAAI,CAAC;QACH,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC","sourcesContent":["/** @internal */\nexport function isSafeNonNegativeInteger(value: unknown): value is number {\n return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\n/** @internal */\nexport function isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n}\n\n/** @internal */\nexport function parseJson(read: () => string): unknown {\n try {\n return JSON.parse(read());\n } catch {\n return null;\n }\n}\n\n/** @internal */\nexport const findingEntry = <T extends { findingId: string }>(\n finding: T,\n): [string, T] => [finding.findingId, finding];\n\n/** @internal Optional observers must not block or interrupt their operation. */\nexport function notify(callback: () => unknown): void {\n try {\n void Promise.resolve(callback()).catch(() => {});\n } catch {}\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,OAAO,QAA2B,CAAC;AAChD,eAAO,MAAM,iBAAiB,QAAuB,CAAC;AACtD,eAAO,MAAM,wBAAwB,QAA8B,CAAC;AACpE,eAAO,MAAM,sBAAsB,EAAG,QAAiB,CAAC;AAIxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAM3E;AAED,wBAAgB,aAAa,CAC3B,WAAW,GAAE,MAAM,CAAC,UAAwB,EAC5C,UAAU,GAAE,MAAuC,GAClD,MAAM,CAwCR;AAED,wBAAsB,cAAc,CAAC,EACnC,WAAyB,EACzB,UAAU,EACV,cAAwB,EACxB,KAAK,EAAE,WAAmB,EAC1B,MAAM,GACP,GAAE;IACD,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,CACN,KAAK,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAClC,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAC/B,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAyCzC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAa/D"}
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO,QAA2B,CAAC;AAChD,eAAO,MAAM,iBAAiB,QAAuB,CAAC;AACtD,eAAO,MAAM,wBAAwB,QAA8B,CAAC;AACpE,eAAO,MAAM,sBAAsB,EAAG,QAAiB,CAAC;AAIxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAM3E;AAED,wBAAgB,aAAa,CAC3B,WAAW,GAAE,MAAM,CAAC,UAAwB,EAC5C,UAAU,GAAE,MAAuC,GAClD,MAAM,CAwCR;AAED,wBAAsB,cAAc,CAAC,EACnC,WAAyB,EACzB,UAAU,EACV,cAAwB,EACxB,KAAK,EAAE,WAAmB,EAC1B,MAAM,GACP,GAAE;IACD,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,CACN,KAAK,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAClC,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAC/B,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAyCzC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAa/D"}
package/dist/version.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { isNonEmptyString } from "./value.js";
1
2
  import { readFileSync } from "node:fs";
2
3
  import { fileURLToPath } from "node:url";
3
4
  import semverGt from "semver/functions/gt.js";
@@ -97,8 +98,7 @@ function packageVersions(url) {
97
98
  if (typeof manifest !== "object" ||
98
99
  manifest === null ||
99
100
  !("version" in manifest) ||
100
- typeof manifest.version !== "string" ||
101
- manifest.version.length === 0) {
101
+ !isNonEmptyString(manifest.version)) {
102
102
  throw new Error("version must be a non-empty string");
103
103
  }
104
104
  const dependencies = "dependencies" in manifest ? manifest.dependencies : undefined;
@@ -111,10 +111,7 @@ function packageVersions(url) {
111
111
  const executable = "@openai/codex" in dependencies
112
112
  ? dependencies["@openai/codex"]
113
113
  : undefined;
114
- if (typeof sdk !== "string" ||
115
- sdk.length === 0 ||
116
- typeof executable !== "string" ||
117
- executable.length === 0) {
114
+ if (!isNonEmptyString(sdk) || !isNonEmptyString(executable)) {
118
115
  throw new Error("Codex dependencies must have non-empty versions");
119
116
  }
120
117
  return { package: manifest.version, sdk, executable };
@@ -1 +1 @@
1
- {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport semverGt from \"semver/functions/gt.js\";\n\nconst PACKAGE_VERSIONS = packageVersions(\n new URL(\"../package.json\", import.meta.url),\n);\n\nexport const VERSION = PACKAGE_VERSIONS.package;\nexport const CODEX_SDK_VERSION = PACKAGE_VERSIONS.sdk;\nexport const CODEX_EXECUTABLE_VERSION = PACKAGE_VERSIONS.executable;\nexport const BUNDLED_PLUGIN_VERSION = \"0.1.95\" as const;\n\nconst PACKAGE_NAME = \"@openai/codex-security\";\n\nexport interface UpdateNotice {\n readonly currentVersion: string;\n readonly latestVersion: string;\n readonly command: string;\n}\n\nexport function updateNoticeEnabled(environment: NodeJS.ProcessEnv): boolean {\n return (\n environment[\"CODEX_SECURITY_NO_UPDATE_NOTICE\"] === undefined &&\n environment[\"NO_UPDATE_NOTIFIER\"] === undefined &&\n environment[\"CI\"] === undefined\n );\n}\n\nexport function updateCommand(\n environment: NodeJS.ProcessEnv = process.env,\n entrypoint: string = fileURLToPath(import.meta.url),\n): string {\n const path = entrypoint.replaceAll(\"\\\\\", \"/\").toLowerCase();\n const agent = (environment[\"npm_config_user_agent\"] ?? \"\").toLowerCase();\n\n if (\n environment[\"npm_command\"] === \"exec\" ||\n environment[\"npm_lifecycle_event\"] === \"npx\" ||\n path.includes(\"/_npx/\")\n ) {\n return `npx ${PACKAGE_NAME}@latest`;\n }\n if (path.includes(\"/.install/node_modules/\")) {\n return \"download and extract the latest Codex Security release\";\n }\n\n const global =\n environment[\"npm_config_global\"] === \"true\" ||\n path.includes(\"/lib/node_modules/\") ||\n path.includes(\"/appdata/roaming/npm/node_modules/\") ||\n path.includes(\"/pnpm/global/\") ||\n path.includes(\"/.bun/install/global/\") ||\n path.includes(\"/.yarn/global/\") ||\n path.includes(\"/yarn/global/\");\n\n if (agent.startsWith(\"pnpm/\") || path.includes(\"/.pnpm/\")) {\n return `pnpm add${global ? \" -g\" : \"\"} ${PACKAGE_NAME}@latest`;\n }\n if (\n agent.startsWith(\"yarn/\") ||\n path.includes(\"/.yarn/\") ||\n path.includes(\"/yarn/global/\")\n ) {\n return `yarn${global ? \" global\" : \"\"} add ${PACKAGE_NAME}@latest`;\n }\n if (agent.startsWith(\"bun/\") || path.includes(\"/.bun/\")) {\n return `bun add${global ? \" -g\" : \"\"} ${PACKAGE_NAME}@latest`;\n }\n return agent.startsWith(\"npm/\") || path.includes(\"/node_modules/\")\n ? `npm install${global ? \" -g\" : \"\"} ${PACKAGE_NAME}@latest`\n : `npx ${PACKAGE_NAME}@latest`;\n}\n\nexport async function checkForUpdate({\n environment = process.env,\n entrypoint,\n currentVersion = VERSION,\n fetch: fetchLatest = fetch,\n signal,\n}: {\n environment?: NodeJS.ProcessEnv;\n entrypoint?: string;\n currentVersion?: string;\n fetch?: (\n input: Parameters<typeof fetch>[0],\n init?: Parameters<typeof fetch>[1],\n ) => ReturnType<typeof fetch>;\n signal?: AbortSignal;\n} = {}): Promise<UpdateNotice | undefined> {\n if (!updateNoticeEnabled(environment)) return undefined;\n\n try {\n const registry =\n environment[\"CODEX_SECURITY_NPM_REGISTRY\"] ??\n environment[\"npm_config_registry\"] ??\n environment[\"NPM_CONFIG_REGISTRY\"] ??\n \"https://registry.npmjs.org/\";\n const timeout = AbortSignal.timeout(3_000);\n const response = await fetchLatest(\n new URL(\n `${encodeURIComponent(PACKAGE_NAME)}/latest`,\n registry.endsWith(\"/\") ? registry : `${registry}/`,\n ),\n {\n signal:\n signal === undefined ? timeout : AbortSignal.any([signal, timeout]),\n },\n );\n if (!response.ok) return undefined;\n\n const manifest: unknown = await response.json();\n if (\n typeof manifest !== \"object\" ||\n manifest === null ||\n !(\"version\" in manifest) ||\n typeof manifest.version !== \"string\" ||\n !semverGt(manifest.version, currentVersion)\n ) {\n return undefined;\n }\n\n return {\n currentVersion,\n latestVersion: manifest.version,\n command: updateCommand(environment, entrypoint),\n };\n } catch {\n return undefined;\n }\n}\n\nexport function formatUpdateNotice(notice: UpdateNotice): string {\n const lines = [\n `Codex Security update available: ${notice.currentVersion} → ${notice.latestVersion}`,\n `Run: ${notice.command}`,\n ];\n const width = Math.max(...lines.map((line) => line.length));\n return [\n \"\",\n `╭${\"─\".repeat(width + 2)}╮`,\n ...lines.map((line) => `│ ${line.padEnd(width)} │`),\n `╰${\"─\".repeat(width + 2)}╯`,\n \"\",\n ].join(\"\\n\");\n}\n\nfunction packageVersions(url: URL): {\n package: string;\n sdk: string;\n executable: string;\n} {\n try {\n const manifest: unknown = JSON.parse(readFileSync(url, \"utf8\"));\n if (\n typeof manifest !== \"object\" ||\n manifest === null ||\n !(\"version\" in manifest) ||\n typeof manifest.version !== \"string\" ||\n manifest.version.length === 0\n ) {\n throw new Error(\"version must be a non-empty string\");\n }\n const dependencies =\n \"dependencies\" in manifest ? manifest.dependencies : undefined;\n if (typeof dependencies !== \"object\" || dependencies === null) {\n throw new Error(\"dependencies must be an object\");\n }\n const sdk =\n \"@openai/codex-sdk\" in dependencies\n ? dependencies[\"@openai/codex-sdk\"]\n : undefined;\n const executable =\n \"@openai/codex\" in dependencies\n ? dependencies[\"@openai/codex\"]\n : undefined;\n if (\n typeof sdk !== \"string\" ||\n sdk.length === 0 ||\n typeof executable !== \"string\" ||\n executable.length === 0\n ) {\n throw new Error(\"Codex dependencies must have non-empty versions\");\n }\n return { package: manifest.version, sdk, executable };\n } catch (error) {\n throw new Error(\"Unable to read Codex Security package versions.\", {\n cause: error,\n });\n }\n}\n"]}
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"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","sourcesContent":["import { isNonEmptyString } from \"./value.js\";\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport semverGt from \"semver/functions/gt.js\";\n\nconst PACKAGE_VERSIONS = packageVersions(\n new URL(\"../package.json\", import.meta.url),\n);\n\nexport const VERSION = PACKAGE_VERSIONS.package;\nexport const CODEX_SDK_VERSION = PACKAGE_VERSIONS.sdk;\nexport const CODEX_EXECUTABLE_VERSION = PACKAGE_VERSIONS.executable;\nexport const BUNDLED_PLUGIN_VERSION = \"0.1.95\" as const;\n\nconst PACKAGE_NAME = \"@openai/codex-security\";\n\nexport interface UpdateNotice {\n readonly currentVersion: string;\n readonly latestVersion: string;\n readonly command: string;\n}\n\nexport function updateNoticeEnabled(environment: NodeJS.ProcessEnv): boolean {\n return (\n environment[\"CODEX_SECURITY_NO_UPDATE_NOTICE\"] === undefined &&\n environment[\"NO_UPDATE_NOTIFIER\"] === undefined &&\n environment[\"CI\"] === undefined\n );\n}\n\nexport function updateCommand(\n environment: NodeJS.ProcessEnv = process.env,\n entrypoint: string = fileURLToPath(import.meta.url),\n): string {\n const path = entrypoint.replaceAll(\"\\\\\", \"/\").toLowerCase();\n const agent = (environment[\"npm_config_user_agent\"] ?? \"\").toLowerCase();\n\n if (\n environment[\"npm_command\"] === \"exec\" ||\n environment[\"npm_lifecycle_event\"] === \"npx\" ||\n path.includes(\"/_npx/\")\n ) {\n return `npx ${PACKAGE_NAME}@latest`;\n }\n if (path.includes(\"/.install/node_modules/\")) {\n return \"download and extract the latest Codex Security release\";\n }\n\n const global =\n environment[\"npm_config_global\"] === \"true\" ||\n path.includes(\"/lib/node_modules/\") ||\n path.includes(\"/appdata/roaming/npm/node_modules/\") ||\n path.includes(\"/pnpm/global/\") ||\n path.includes(\"/.bun/install/global/\") ||\n path.includes(\"/.yarn/global/\") ||\n path.includes(\"/yarn/global/\");\n\n if (agent.startsWith(\"pnpm/\") || path.includes(\"/.pnpm/\")) {\n return `pnpm add${global ? \" -g\" : \"\"} ${PACKAGE_NAME}@latest`;\n }\n if (\n agent.startsWith(\"yarn/\") ||\n path.includes(\"/.yarn/\") ||\n path.includes(\"/yarn/global/\")\n ) {\n return `yarn${global ? \" global\" : \"\"} add ${PACKAGE_NAME}@latest`;\n }\n if (agent.startsWith(\"bun/\") || path.includes(\"/.bun/\")) {\n return `bun add${global ? \" -g\" : \"\"} ${PACKAGE_NAME}@latest`;\n }\n return agent.startsWith(\"npm/\") || path.includes(\"/node_modules/\")\n ? `npm install${global ? \" -g\" : \"\"} ${PACKAGE_NAME}@latest`\n : `npx ${PACKAGE_NAME}@latest`;\n}\n\nexport async function checkForUpdate({\n environment = process.env,\n entrypoint,\n currentVersion = VERSION,\n fetch: fetchLatest = fetch,\n signal,\n}: {\n environment?: NodeJS.ProcessEnv;\n entrypoint?: string;\n currentVersion?: string;\n fetch?: (\n input: Parameters<typeof fetch>[0],\n init?: Parameters<typeof fetch>[1],\n ) => ReturnType<typeof fetch>;\n signal?: AbortSignal;\n} = {}): Promise<UpdateNotice | undefined> {\n if (!updateNoticeEnabled(environment)) return undefined;\n\n try {\n const registry =\n environment[\"CODEX_SECURITY_NPM_REGISTRY\"] ??\n environment[\"npm_config_registry\"] ??\n environment[\"NPM_CONFIG_REGISTRY\"] ??\n \"https://registry.npmjs.org/\";\n const timeout = AbortSignal.timeout(3_000);\n const response = await fetchLatest(\n new URL(\n `${encodeURIComponent(PACKAGE_NAME)}/latest`,\n registry.endsWith(\"/\") ? registry : `${registry}/`,\n ),\n {\n signal:\n signal === undefined ? timeout : AbortSignal.any([signal, timeout]),\n },\n );\n if (!response.ok) return undefined;\n\n const manifest: unknown = await response.json();\n if (\n typeof manifest !== \"object\" ||\n manifest === null ||\n !(\"version\" in manifest) ||\n typeof manifest.version !== \"string\" ||\n !semverGt(manifest.version, currentVersion)\n ) {\n return undefined;\n }\n\n return {\n currentVersion,\n latestVersion: manifest.version,\n command: updateCommand(environment, entrypoint),\n };\n } catch {\n return undefined;\n }\n}\n\nexport function formatUpdateNotice(notice: UpdateNotice): string {\n const lines = [\n `Codex Security update available: ${notice.currentVersion} → ${notice.latestVersion}`,\n `Run: ${notice.command}`,\n ];\n const width = Math.max(...lines.map((line) => line.length));\n return [\n \"\",\n `╭${\"─\".repeat(width + 2)}╮`,\n ...lines.map((line) => `│ ${line.padEnd(width)} │`),\n `╰${\"─\".repeat(width + 2)}╯`,\n \"\",\n ].join(\"\\n\");\n}\n\nfunction packageVersions(url: URL) {\n try {\n const manifest: unknown = JSON.parse(readFileSync(url, \"utf8\"));\n if (\n typeof manifest !== \"object\" ||\n manifest === null ||\n !(\"version\" in manifest) ||\n !isNonEmptyString(manifest.version)\n ) {\n throw new Error(\"version must be a non-empty string\");\n }\n const dependencies =\n \"dependencies\" in manifest ? manifest.dependencies : undefined;\n if (typeof dependencies !== \"object\" || dependencies === null) {\n throw new Error(\"dependencies must be an object\");\n }\n const sdk =\n \"@openai/codex-sdk\" in dependencies\n ? dependencies[\"@openai/codex-sdk\"]\n : undefined;\n const executable =\n \"@openai/codex\" in dependencies\n ? dependencies[\"@openai/codex\"]\n : undefined;\n if (!isNonEmptyString(sdk) || !isNonEmptyString(executable)) {\n throw new Error(\"Codex dependencies must have non-empty versions\");\n }\n return { package: manifest.version, sdk, executable };\n } catch (error) {\n throw new Error(\"Unable to read Codex Security package versions.\", {\n cause: error,\n });\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"windows-path.d.ts","sourceRoot":"","sources":["../src/windows-path.ts"],"names":[],"mappings":"AAMA,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMnE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM3E"}
1
+ {"version":3,"file":"windows-path.d.ts","sourceRoot":"","sources":["../src/windows-path.ts"],"names":[],"mappings":"AAMA,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMnE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3E"}
@@ -7,9 +7,8 @@ export function isWindowsUnsafePathComponent(value) {
7
7
  (UNSAFE_COMPONENT.test(value) || RESERVED_COMPONENT.test(value)));
8
8
  }
9
9
  export function windowsUnsafePathComponent(path) {
10
- const root = parse(path).root;
11
10
  return path
12
- .slice(root.length)
11
+ .slice(parse(path).root.length)
13
12
  .split(/[\\/]/u)
14
13
  .find(isWindowsUnsafePathComponent);
15
14
  }
@@ -1 +1 @@
1
- {"version":3,"file":"windows-path.js","sourceRoot":"","sources":["../src/windows-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AACzD,MAAM,kBAAkB,GACtB,2EAA2E,CAAC;AAE9E,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,CACL,KAAK,KAAK,EAAE;QACZ,KAAK,KAAK,GAAG;QACb,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IAC9B,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;SAClB,KAAK,CAAC,QAAQ,CAAC;SACf,IAAI,CAAC,4BAA4B,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import { parse } from \"node:path\";\n\nconst UNSAFE_COMPONENT = /[<>:\"|?*\\u0000-\\u001f]|[ .]$/u;\nconst RESERVED_COMPONENT =\n /^(?:con|prn|aux|nul|conin\\$|conout\\$|com[1-9¹²³]|lpt[1-9¹²³])(?:\\..*)?$/iu;\n\nexport function isWindowsUnsafePathComponent(value: string): boolean {\n return (\n value !== \"\" &&\n value !== \".\" &&\n (UNSAFE_COMPONENT.test(value) || RESERVED_COMPONENT.test(value))\n );\n}\n\nexport function windowsUnsafePathComponent(path: string): string | undefined {\n const root = parse(path).root;\n return path\n .slice(root.length)\n .split(/[\\\\/]/u)\n .find(isWindowsUnsafePathComponent);\n}\n"]}
1
+ {"version":3,"file":"windows-path.js","sourceRoot":"","sources":["../src/windows-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AACzD,MAAM,kBAAkB,GACtB,2EAA2E,CAAC;AAE9E,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,CACL,KAAK,KAAK,EAAE;QACZ,KAAK,KAAK,GAAG;QACb,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,IAAI;SACR,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;SAC9B,KAAK,CAAC,QAAQ,CAAC;SACf,IAAI,CAAC,4BAA4B,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import { parse } from \"node:path\";\n\nconst UNSAFE_COMPONENT = /[<>:\"|?*\\u0000-\\u001f]|[ .]$/u;\nconst RESERVED_COMPONENT =\n /^(?:con|prn|aux|nul|conin\\$|conout\\$|com[1-9¹²³]|lpt[1-9¹²³])(?:\\..*)?$/iu;\n\nexport function isWindowsUnsafePathComponent(value: string): boolean {\n return (\n value !== \"\" &&\n value !== \".\" &&\n (UNSAFE_COMPONENT.test(value) || RESERVED_COMPONENT.test(value))\n );\n}\n\nexport function windowsUnsafePathComponent(path: string): string | undefined {\n return path\n .slice(parse(path).root.length)\n .split(/[\\\\/]/u)\n .find(isWindowsUnsafePathComponent);\n}\n"]}
@@ -0,0 +1,3 @@
1
+ export type WorkbenchFields = Record<string, string | number | boolean | readonly string[] | undefined>;
2
+ export declare function workbenchArgs(command: string, fields: WorkbenchFields): string[];
3
+ //# sourceMappingURL=workbench-arguments.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workbench-arguments.d.ts","sourceRoot":"","sources":["../src/workbench-arguments.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,eAAe,GAAG,MAAM,CAClC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAC1D,CAAC;AAEF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,GACtB,MAAM,EAAE,CAWV"}
@@ -0,0 +1,15 @@
1
+ export function workbenchArgs(command, fields) {
2
+ const args = [command];
3
+ for (const [name, value] of Object.entries(fields)) {
4
+ if (value === undefined || value === false)
5
+ continue;
6
+ const flag = `--${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
7
+ (Array.isArray(value) ? value : [value]).forEach((item) => {
8
+ args.push(flag);
9
+ if (item !== true)
10
+ args.push(String(item));
11
+ });
12
+ }
13
+ return args;
14
+ }
15
+ //# sourceMappingURL=workbench-arguments.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workbench-arguments.js","sourceRoot":"","sources":["../src/workbench-arguments.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,MAAuB;IAEvB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;YAAE,SAAS;QACrD,MAAM,IAAI,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;QACnF,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACxD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,IAAI,KAAK,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/* Generated from plugin workbench-arguments.ts. Run `pnpm generate:models`. */\nexport type WorkbenchFields = Record<\n string,\n string | number | boolean | readonly string[] | undefined\n>;\n\nexport function workbenchArgs(\n command: string,\n fields: WorkbenchFields,\n): string[] {\n const args = [command];\n for (const [name, value] of Object.entries(fields)) {\n if (value === undefined || value === false) continue;\n const flag = `--${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;\n (Array.isArray(value) ? value : [value]).forEach((item) => {\n args.push(flag);\n if (item !== true) args.push(String(item));\n });\n }\n return args;\n}\n"]}
@@ -6,6 +6,7 @@ export interface ScanProgress {
6
6
  filesTotal: number;
7
7
  }
8
8
  export declare function scanPhaseLabel(value: ScanWorkerPhase | ScanPhase): string;
9
+ /** Preflight is tool-derived; dispatch counts depend on model-emitted markers. */
9
10
  export type ScanWorkerStatus = {
10
11
  kind: "preflight";
11
12
  delegation: "available" | "unavailable" | "unknown";
@@ -18,4 +19,5 @@ export type ScanWorkerStatus = {
18
19
  };
19
20
  export declare function workerStatusFromEvent(event: Readonly<Record<string, unknown>>): ScanWorkerStatus | null;
20
21
  export declare function scanProgressUpdatesFromEvent(event: Readonly<Record<string, unknown>>): ScanProgress[];
22
+ export declare function scanProgressUpdatesFromText(output: string): ScanProgress[];
21
23
  //# sourceMappingURL=worker-progress.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"worker-progress.d.ts","sourceRoot":"","sources":["../src/worker-progress.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,eAAe,GACzB,SAAS,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAE3D,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,cAAc,GACd,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAWzE;AAED,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;IACpD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,gBAAgB,GAAG,IAAI,CAQzB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,YAAY,EAAE,CAwBhB"}
1
+ {"version":3,"file":"worker-progress.d.ts","sourceRoot":"","sources":["../src/worker-progress.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,eAAe,GACzB,SAAS,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAE3D,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,cAAc,GACd,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAWzE;AAED,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;IACpD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,gBAAgB,GAAG,IAAI,CAQzB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,YAAY,EAAE,CAYhB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAQ1E"}
@@ -1,3 +1,5 @@
1
+ import { isRecord } from "./record.js";
2
+ import { isSafeNonNegativeInteger, parseJson } from "./value.js";
1
3
  const WORKER_STATUS_PREFIX = "CODEX_SECURITY_WORKER_STATUS ";
2
4
  const SCAN_PROGRESS_PREFIX = "CODEX_SECURITY_SCAN_PROGRESS ";
3
5
  const PREFLIGHT_COMMAND = /(?:^|[\\/])config_preflight\.py(?=$|["'\s])/u;
@@ -40,16 +42,12 @@ export function scanProgressUpdatesFromEvent(event) {
40
42
  : item["type"] === "command_execution"
41
43
  ? item["aggregated_output"]
42
44
  : null;
43
- if (typeof output !== "string")
44
- return [];
45
+ return typeof output === "string" ? scanProgressUpdatesFromText(output) : [];
46
+ }
47
+ export function scanProgressUpdatesFromText(output) {
45
48
  const updates = [];
46
- let codeFence = false;
47
- for (const line of output.split(/\r?\n/u)) {
48
- if (/^\s*```/u.test(line)) {
49
- codeFence = !codeFence;
50
- continue;
51
- }
52
- if (codeFence || !line.startsWith(SCAN_PROGRESS_PREFIX))
49
+ for (const line of linesOutsideFences(output)) {
50
+ if (!line.startsWith(SCAN_PROGRESS_PREFIX))
53
51
  continue;
54
52
  const progress = scanProgressFromMarker(line);
55
53
  if (progress !== null)
@@ -57,18 +55,35 @@ export function scanProgressUpdatesFromEvent(event) {
57
55
  }
58
56
  return updates;
59
57
  }
60
- function scanProgressFromMarker(marker) {
61
- let payload;
62
- try {
63
- payload = JSON.parse(marker.slice(SCAN_PROGRESS_PREFIX.length));
64
- }
65
- catch {
66
- return null;
58
+ /** Return lines outside Markdown fences so quoted markers are not read as live. */
59
+ function linesOutsideFences(text) {
60
+ const lines = [];
61
+ let fence = null;
62
+ for (const line of text.split(/\r?\n/u)) {
63
+ const delimiter = /^\s*(`{3,}|~{3,})(.*)$/u.exec(line);
64
+ if (delimiter !== null) {
65
+ const run = delimiter[1];
66
+ if (fence === null) {
67
+ fence = { marker: run[0], length: run.length };
68
+ }
69
+ else if (run[0] === fence.marker &&
70
+ run.length >= fence.length &&
71
+ delimiter[2].trim() === "") {
72
+ fence = null;
73
+ }
74
+ continue;
75
+ }
76
+ if (fence === null)
77
+ lines.push(line);
67
78
  }
79
+ return lines;
80
+ }
81
+ function scanProgressFromMarker(marker) {
82
+ const payload = parseJson(() => marker.slice(SCAN_PROGRESS_PREFIX.length));
68
83
  if (!isRecord(payload) ||
69
84
  !isScanPhase(payload["phase"]) ||
70
- !isProgressCount(payload["filesCompleted"]) ||
71
- !isProgressCount(payload["filesTotal"]) ||
85
+ !isSafeNonNegativeInteger(payload["filesCompleted"]) ||
86
+ !isSafeNonNegativeInteger(payload["filesTotal"]) ||
72
87
  payload["filesCompleted"] > payload["filesTotal"]) {
73
88
  return null;
74
89
  }
@@ -84,13 +99,7 @@ function preflightStatus(item) {
84
99
  typeof item["aggregated_output"] !== "string") {
85
100
  return null;
86
101
  }
87
- let payload;
88
- try {
89
- payload = JSON.parse(item["aggregated_output"]);
90
- }
91
- catch {
92
- return null;
93
- }
102
+ const payload = parseJson(() => item["aggregated_output"]);
94
103
  if (!isRecord(payload) ||
95
104
  (payload["profile"] !== "security_scan" &&
96
105
  payload["profile"] !== "security_diff_scan") ||
@@ -117,9 +126,8 @@ function preflightStatus(item) {
117
126
  if (capacity.length > 1)
118
127
  return null;
119
128
  const capacityResult = capacity[0];
120
- const configuredSlots = capacity.length === 1 &&
121
- capacityResult !== undefined &&
122
- isProgressCount(capacityResult["actual"])
129
+ const configuredSlots = capacityResult !== undefined &&
130
+ isSafeNonNegativeInteger(capacityResult["actual"])
123
131
  ? capacityResult["actual"]
124
132
  : null;
125
133
  return { kind: "preflight", delegation, configuredSlots };
@@ -127,24 +135,16 @@ function preflightStatus(item) {
127
135
  function dispatchStatus(item) {
128
136
  if (typeof item["text"] !== "string")
129
137
  return null;
130
- const markers = item["text"]
131
- .split(/\r?\n/u)
132
- .filter((line) => line.startsWith(WORKER_STATUS_PREFIX));
138
+ const markers = linesOutsideFences(item["text"]).filter((line) => line.startsWith(WORKER_STATUS_PREFIX));
133
139
  const marker = markers[0];
134
140
  if (markers.length !== 1 || marker === undefined)
135
141
  return null;
136
- let payload;
137
- try {
138
- payload = JSON.parse(marker.slice(WORKER_STATUS_PREFIX.length));
139
- }
140
- catch {
141
- return null;
142
- }
142
+ const payload = parseJson(() => marker.slice(WORKER_STATUS_PREFIX.length));
143
143
  if (!isRecord(payload) ||
144
144
  typeof payload["phase"] !== "string" ||
145
145
  !WORKER_PHASES.has(payload["phase"]) ||
146
- !isProgressCount(payload["planned"]) ||
147
- !isProgressCount(payload["started"]) ||
146
+ !isSafeNonNegativeInteger(payload["planned"]) ||
147
+ !isSafeNonNegativeInteger(payload["started"]) ||
148
148
  payload["started"] > payload["planned"]) {
149
149
  return null;
150
150
  }
@@ -155,9 +155,6 @@ function dispatchStatus(item) {
155
155
  started: payload["started"],
156
156
  };
157
157
  }
158
- function isProgressCount(value) {
159
- return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
160
- }
161
158
  function isScanPhase(value) {
162
159
  return (value === "preflight" ||
163
160
  value === "threat_model" ||
@@ -166,7 +163,4 @@ function isScanPhase(value) {
166
163
  value === "attack_path" ||
167
164
  value === "reporting");
168
165
  }
169
- function isRecord(value) {
170
- return value !== null && typeof value === "object" && !Array.isArray(value);
171
- }
172
166
  //# sourceMappingURL=worker-progress.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"worker-progress.js","sourceRoot":"","sources":["../src/worker-progress.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAC7D,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAC7D,MAAM,iBAAiB,GAAG,8CAA8C,CAAC;AACzE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;CACd,CAAC,CAAC;AAmBH,MAAM,UAAU,cAAc,CAAC,KAAkC;IAC/D,OAAO;QACL,SAAS,EAAE,WAAW;QACtB,YAAY,EAAE,uBAAuB;QACrC,SAAS,EAAE,iBAAiB;QAC5B,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EAAE,iBAAiB;QAC9B,UAAU,EAAE,qBAAqB;QACjC,WAAW,EAAE,wBAAwB;QACrC,SAAS,EAAE,gBAAgB;KAC5B,CAAC,KAAK,CAAC,CAAC;AACX,CAAC;AAeD,MAAM,UAAU,qBAAqB,CACnC,KAAwC;IAExC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,gBAAgB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,mBAAmB;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,eAAe;QAAE,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAwC;IAExC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,gBAAgB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,CAAC,KAAK,eAAe;QAC9B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACd,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,mBAAmB;YACpC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;YAC3B,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,SAAS,GAAG,CAAC,SAAS,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAAE,SAAS;QAClE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC5C,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClB,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC,eAAe,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,EACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC,gBAAgB,CAAC;QACzC,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,IAAuC;IAEvC,IACE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ;QACnC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,QAAQ,EAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClB,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,eAAe;YACrC,OAAO,CAAC,SAAS,CAAC,KAAK,oBAAoB,CAAC;QAC9C,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAC9B,CAAC,MAAM,EAAqC,EAAE,CAC5C,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,mBAAmB,CACnE,CAAC;IACF,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,UAAU,GACd,eAAe,CAAC,QAAQ,CAAC,KAAK,MAAM;QAClC,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,MAAM;YACpC,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,SAAS;gBACvC,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC;IACf,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAC7B,CAAC,MAAM,EAAqC,EAAE,CAC5C,QAAQ,CAAC,MAAM,CAAC;QAChB,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ;QACxC,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAC1D,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,eAAe,GACnB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACrB,cAAc,KAAK,SAAS;QAC5B,eAAe,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC1B,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CACrB,IAAuC;IAEvC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;SACzB,KAAK,CAAC,QAAQ,CAAC;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ;QACpC,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,EACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,OAAO,CAAC,OAAO,CAAoB;QAC1C,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,KAAK,KAAK,WAAW;QACrB,KAAK,KAAK,cAAc;QACxB,KAAK,KAAK,WAAW;QACrB,KAAK,KAAK,YAAY;QACtB,KAAK,KAAK,aAAa;QACvB,KAAK,KAAK,WAAW,CACtB,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["const WORKER_STATUS_PREFIX = \"CODEX_SECURITY_WORKER_STATUS \";\nconst SCAN_PROGRESS_PREFIX = \"CODEX_SECURITY_SCAN_PROGRESS \";\nconst PREFLIGHT_COMMAND = /(?:^|[\\\\/])config_preflight\\.py(?=$|[\"'\\s])/u;\nconst WORKER_PHASES = new Set([\n \"ranking\",\n \"file_review\",\n \"validation\",\n \"attack_path\",\n]);\n\nexport type ScanWorkerPhase =\n \"ranking\" | \"file_review\" | \"validation\" | \"attack_path\";\n\nexport type ScanPhase =\n | \"preflight\"\n | \"threat_model\"\n | \"discovery\"\n | \"validation\"\n | \"attack_path\"\n | \"reporting\";\n\nexport interface ScanProgress {\n phase: ScanPhase;\n filesCompleted: number;\n filesTotal: number;\n}\n\nexport function scanPhaseLabel(value: ScanWorkerPhase | ScanPhase): string {\n return {\n preflight: \"preflight\",\n threat_model: \"building threat model\",\n discovery: \"reviewing files\",\n ranking: \"ranking scan targets\",\n file_review: \"reviewing files\",\n validation: \"validating findings\",\n attack_path: \"analyzing attack paths\",\n reporting: \"writing report\",\n }[value];\n}\n\nexport type ScanWorkerStatus =\n | {\n kind: \"preflight\";\n delegation: \"available\" | \"unavailable\" | \"unknown\";\n configuredSlots: number | null;\n }\n | {\n kind: \"dispatch\";\n phase: ScanWorkerPhase;\n planned: number;\n started: number;\n };\n\nexport function workerStatusFromEvent(\n event: Readonly<Record<string, unknown>>,\n): ScanWorkerStatus | null {\n if (event[\"type\"] !== \"item.completed\" || !isRecord(event[\"item\"])) {\n return null;\n }\n const item = event[\"item\"];\n if (item[\"type\"] === \"command_execution\") return preflightStatus(item);\n if (item[\"type\"] === \"agent_message\") return dispatchStatus(item);\n return null;\n}\n\nexport function scanProgressUpdatesFromEvent(\n event: Readonly<Record<string, unknown>>,\n): ScanProgress[] {\n if (event[\"type\"] !== \"item.completed\" || !isRecord(event[\"item\"])) {\n return [];\n }\n const item = event[\"item\"];\n const output =\n item[\"type\"] === \"agent_message\"\n ? item[\"text\"]\n : item[\"type\"] === \"command_execution\"\n ? item[\"aggregated_output\"]\n : null;\n if (typeof output !== \"string\") return [];\n const updates: ScanProgress[] = [];\n let codeFence = false;\n for (const line of output.split(/\\r?\\n/u)) {\n if (/^\\s*```/u.test(line)) {\n codeFence = !codeFence;\n continue;\n }\n if (codeFence || !line.startsWith(SCAN_PROGRESS_PREFIX)) continue;\n const progress = scanProgressFromMarker(line);\n if (progress !== null) updates.push(progress);\n }\n return updates;\n}\n\nfunction scanProgressFromMarker(marker: string): ScanProgress | null {\n let payload: unknown;\n try {\n payload = JSON.parse(marker.slice(SCAN_PROGRESS_PREFIX.length));\n } catch {\n return null;\n }\n if (\n !isRecord(payload) ||\n !isScanPhase(payload[\"phase\"]) ||\n !isProgressCount(payload[\"filesCompleted\"]) ||\n !isProgressCount(payload[\"filesTotal\"]) ||\n payload[\"filesCompleted\"] > payload[\"filesTotal\"]\n ) {\n return null;\n }\n return {\n phase: payload[\"phase\"],\n filesCompleted: payload[\"filesCompleted\"],\n filesTotal: payload[\"filesTotal\"],\n };\n}\n\nfunction preflightStatus(\n item: Readonly<Record<string, unknown>>,\n): ScanWorkerStatus | null {\n if (\n typeof item[\"command\"] !== \"string\" ||\n !PREFLIGHT_COMMAND.test(item[\"command\"]) ||\n typeof item[\"aggregated_output\"] !== \"string\"\n ) {\n return null;\n }\n let payload: unknown;\n try {\n payload = JSON.parse(item[\"aggregated_output\"]);\n } catch {\n return null;\n }\n if (\n !isRecord(payload) ||\n (payload[\"profile\"] !== \"security_scan\" &&\n payload[\"profile\"] !== \"security_diff_scan\") ||\n !Array.isArray(payload[\"results\"])\n ) {\n return null;\n }\n const results = payload[\"results\"];\n const delegated = results.filter(\n (result): result is Record<string, unknown> =>\n isRecord(result) && result[\"capability\"] === \"delegated_workers\",\n );\n const delegatedResult = delegated[0];\n if (delegated.length !== 1 || delegatedResult === undefined) return null;\n const delegation =\n delegatedResult[\"status\"] === \"pass\"\n ? \"available\"\n : delegatedResult[\"status\"] === \"fail\"\n ? \"unavailable\"\n : delegatedResult[\"status\"] === \"unknown\"\n ? \"unknown\"\n : null;\n if (delegation === null) return null;\n const capacity = results.filter(\n (result): result is Record<string, unknown> =>\n isRecord(result) &&\n typeof result[\"capability\"] === \"string\" &&\n result[\"capability\"].startsWith(\"usable_worker_slots_\"),\n );\n if (capacity.length > 1) return null;\n const capacityResult = capacity[0];\n const configuredSlots =\n capacity.length === 1 &&\n capacityResult !== undefined &&\n isProgressCount(capacityResult[\"actual\"])\n ? capacityResult[\"actual\"]\n : null;\n return { kind: \"preflight\", delegation, configuredSlots };\n}\n\nfunction dispatchStatus(\n item: Readonly<Record<string, unknown>>,\n): ScanWorkerStatus | null {\n if (typeof item[\"text\"] !== \"string\") return null;\n const markers = item[\"text\"]\n .split(/\\r?\\n/u)\n .filter((line) => line.startsWith(WORKER_STATUS_PREFIX));\n const marker = markers[0];\n if (markers.length !== 1 || marker === undefined) return null;\n let payload: unknown;\n try {\n payload = JSON.parse(marker.slice(WORKER_STATUS_PREFIX.length));\n } catch {\n return null;\n }\n if (\n !isRecord(payload) ||\n typeof payload[\"phase\"] !== \"string\" ||\n !WORKER_PHASES.has(payload[\"phase\"]) ||\n !isProgressCount(payload[\"planned\"]) ||\n !isProgressCount(payload[\"started\"]) ||\n payload[\"started\"] > payload[\"planned\"]\n ) {\n return null;\n }\n return {\n kind: \"dispatch\",\n phase: payload[\"phase\"] as ScanWorkerPhase,\n planned: payload[\"planned\"],\n started: payload[\"started\"],\n };\n}\n\nfunction isProgressCount(value: unknown): value is number {\n return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction isScanPhase(value: unknown): value is ScanPhase {\n return (\n value === \"preflight\" ||\n value === \"threat_model\" ||\n value === \"discovery\" ||\n value === \"validation\" ||\n value === \"attack_path\" ||\n value === \"reporting\"\n );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n"]}
1
+ {"version":3,"file":"worker-progress.js","sourceRoot":"","sources":["../src/worker-progress.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRecord } from \"./record.js\";\nimport { isSafeNonNegativeInteger, parseJson } from \"./value.js\";\n\nconst WORKER_STATUS_PREFIX = \"CODEX_SECURITY_WORKER_STATUS \";\nconst SCAN_PROGRESS_PREFIX = \"CODEX_SECURITY_SCAN_PROGRESS \";\nconst PREFLIGHT_COMMAND = /(?:^|[\\\\/])config_preflight\\.py(?=$|[\"'\\s])/u;\nconst WORKER_PHASES = new Set([\n \"ranking\",\n \"file_review\",\n \"validation\",\n \"attack_path\",\n]);\n\nexport type ScanWorkerPhase =\n \"ranking\" | \"file_review\" | \"validation\" | \"attack_path\";\n\nexport type ScanPhase =\n | \"preflight\"\n | \"threat_model\"\n | \"discovery\"\n | \"validation\"\n | \"attack_path\"\n | \"reporting\";\n\nexport interface ScanProgress {\n phase: ScanPhase;\n filesCompleted: number;\n filesTotal: number;\n}\n\nexport function scanPhaseLabel(value: ScanWorkerPhase | ScanPhase): string {\n return {\n preflight: \"preflight\",\n threat_model: \"building threat model\",\n discovery: \"reviewing files\",\n ranking: \"ranking scan targets\",\n file_review: \"reviewing files\",\n validation: \"validating findings\",\n attack_path: \"analyzing attack paths\",\n reporting: \"writing report\",\n }[value];\n}\n\n/** Preflight is tool-derived; dispatch counts depend on model-emitted markers. */\nexport type ScanWorkerStatus =\n | {\n kind: \"preflight\";\n delegation: \"available\" | \"unavailable\" | \"unknown\";\n configuredSlots: number | null;\n }\n | {\n kind: \"dispatch\";\n phase: ScanWorkerPhase;\n planned: number;\n started: number;\n };\n\nexport function workerStatusFromEvent(\n event: Readonly<Record<string, unknown>>,\n): ScanWorkerStatus | null {\n if (event[\"type\"] !== \"item.completed\" || !isRecord(event[\"item\"])) {\n return null;\n }\n const item = event[\"item\"];\n if (item[\"type\"] === \"command_execution\") return preflightStatus(item);\n if (item[\"type\"] === \"agent_message\") return dispatchStatus(item);\n return null;\n}\n\nexport function scanProgressUpdatesFromEvent(\n event: Readonly<Record<string, unknown>>,\n): ScanProgress[] {\n if (event[\"type\"] !== \"item.completed\" || !isRecord(event[\"item\"])) {\n return [];\n }\n const item = event[\"item\"];\n const output =\n item[\"type\"] === \"agent_message\"\n ? item[\"text\"]\n : item[\"type\"] === \"command_execution\"\n ? item[\"aggregated_output\"]\n : null;\n return typeof output === \"string\" ? scanProgressUpdatesFromText(output) : [];\n}\n\nexport function scanProgressUpdatesFromText(output: string): ScanProgress[] {\n const updates: ScanProgress[] = [];\n for (const line of linesOutsideFences(output)) {\n if (!line.startsWith(SCAN_PROGRESS_PREFIX)) continue;\n const progress = scanProgressFromMarker(line);\n if (progress !== null) updates.push(progress);\n }\n return updates;\n}\n\n/** Return lines outside Markdown fences so quoted markers are not read as live. */\nfunction linesOutsideFences(text: string): string[] {\n const lines: string[] = [];\n let fence: { marker: string; length: number } | null = null;\n for (const line of text.split(/\\r?\\n/u)) {\n const delimiter = /^\\s*(`{3,}|~{3,})(.*)$/u.exec(line);\n if (delimiter !== null) {\n const run = delimiter[1]!;\n if (fence === null) {\n fence = { marker: run[0]!, length: run.length };\n } else if (\n run[0] === fence.marker &&\n run.length >= fence.length &&\n delimiter[2]!.trim() === \"\"\n ) {\n fence = null;\n }\n continue;\n }\n if (fence === null) lines.push(line);\n }\n return lines;\n}\n\nfunction scanProgressFromMarker(marker: string): ScanProgress | null {\n const payload = parseJson(() => marker.slice(SCAN_PROGRESS_PREFIX.length));\n if (\n !isRecord(payload) ||\n !isScanPhase(payload[\"phase\"]) ||\n !isSafeNonNegativeInteger(payload[\"filesCompleted\"]) ||\n !isSafeNonNegativeInteger(payload[\"filesTotal\"]) ||\n payload[\"filesCompleted\"] > payload[\"filesTotal\"]\n ) {\n return null;\n }\n return {\n phase: payload[\"phase\"],\n filesCompleted: payload[\"filesCompleted\"],\n filesTotal: payload[\"filesTotal\"],\n };\n}\n\nfunction preflightStatus(\n item: Readonly<Record<string, unknown>>,\n): ScanWorkerStatus | null {\n if (\n typeof item[\"command\"] !== \"string\" ||\n !PREFLIGHT_COMMAND.test(item[\"command\"]) ||\n typeof item[\"aggregated_output\"] !== \"string\"\n ) {\n return null;\n }\n const payload = parseJson(() => item[\"aggregated_output\"] as string);\n if (\n !isRecord(payload) ||\n (payload[\"profile\"] !== \"security_scan\" &&\n payload[\"profile\"] !== \"security_diff_scan\") ||\n !Array.isArray(payload[\"results\"])\n ) {\n return null;\n }\n const results = payload[\"results\"];\n const delegated = results.filter(\n (result): result is Record<string, unknown> =>\n isRecord(result) && result[\"capability\"] === \"delegated_workers\",\n );\n const delegatedResult = delegated[0];\n if (delegated.length !== 1 || delegatedResult === undefined) return null;\n const delegation =\n delegatedResult[\"status\"] === \"pass\"\n ? \"available\"\n : delegatedResult[\"status\"] === \"fail\"\n ? \"unavailable\"\n : delegatedResult[\"status\"] === \"unknown\"\n ? \"unknown\"\n : null;\n if (delegation === null) return null;\n const capacity = results.filter(\n (result): result is Record<string, unknown> =>\n isRecord(result) &&\n typeof result[\"capability\"] === \"string\" &&\n result[\"capability\"].startsWith(\"usable_worker_slots_\"),\n );\n if (capacity.length > 1) return null;\n const capacityResult = capacity[0];\n const configuredSlots =\n capacityResult !== undefined &&\n isSafeNonNegativeInteger(capacityResult[\"actual\"])\n ? capacityResult[\"actual\"]\n : null;\n return { kind: \"preflight\", delegation, configuredSlots };\n}\n\nfunction dispatchStatus(\n item: Readonly<Record<string, unknown>>,\n): ScanWorkerStatus | null {\n if (typeof item[\"text\"] !== \"string\") return null;\n const markers = linesOutsideFences(item[\"text\"]).filter((line) =>\n line.startsWith(WORKER_STATUS_PREFIX),\n );\n const marker = markers[0];\n if (markers.length !== 1 || marker === undefined) return null;\n const payload = parseJson(() => marker.slice(WORKER_STATUS_PREFIX.length));\n if (\n !isRecord(payload) ||\n typeof payload[\"phase\"] !== \"string\" ||\n !WORKER_PHASES.has(payload[\"phase\"]) ||\n !isSafeNonNegativeInteger(payload[\"planned\"]) ||\n !isSafeNonNegativeInteger(payload[\"started\"]) ||\n payload[\"started\"] > payload[\"planned\"]\n ) {\n return null;\n }\n return {\n kind: \"dispatch\",\n phase: payload[\"phase\"] as ScanWorkerPhase,\n planned: payload[\"planned\"],\n started: payload[\"started\"],\n };\n}\n\nfunction isScanPhase(value: unknown): value is ScanPhase {\n return (\n value === \"preflight\" ||\n value === \"threat_model\" ||\n value === \"discovery\" ||\n value === \"validation\" ||\n value === \"attack_path\" ||\n value === \"reporting\"\n );\n}\n"]}