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