@openai/codex-security 0.8.3 → 0.10.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 +36 -746
- package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
- package/_bundled_plugin/.mcp.json +7 -1
- package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
- package/_bundled_plugin/examples/completed-scan/report.md +11 -8
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
- package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
- package/_bundled_plugin/mcp/helpers.mjs +2 -11
- package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
- 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/package.json +1 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
- package/_bundled_plugin/mcp/server.mjs +2 -11
- package/_bundled_plugin/mcp/server.mjs.br +0 -0
- package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
- package/_bundled_plugin/references/artifact-storage.md +1 -1
- package/_bundled_plugin/references/baseline-auditor.md +18 -0
- package/_bundled_plugin/references/core-scan.md +5 -42
- package/_bundled_plugin/references/default-severity-rubric.md +9 -4
- package/_bundled_plugin/references/final-report.md +5 -3
- package/_bundled_plugin/references/finding-detail-fields.md +18 -18
- package/_bundled_plugin/references/focused-investigator.md +13 -0
- package/_bundled_plugin/references/sarif-adapter.md +8 -2
- package/_bundled_plugin/references/scan-artifacts.md +21 -12
- package/_bundled_plugin/references/scan-contract.md +27 -33
- package/_bundled_plugin/references/scan-prologue.md +2 -2
- package/_bundled_plugin/references/scan-runtime.md +4 -2
- package/_bundled_plugin/references/security-guidance.md +14 -1
- package/_bundled_plugin/references/validate-scan-findings.md +3 -0
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
- package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
- package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
- package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
- package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
- package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
- package/_bundled_plugin/scripts/finding_preview.py +20 -0
- package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
- package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
- package/_bundled_plugin/scripts/report_projection.py +81 -43
- package/_bundled_plugin/scripts/review_state.py +8 -2
- package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
- package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
- package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
- package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
- package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
- package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
- package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
- package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
- package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
- package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
- package/_bundled_plugin/scripts/workbench/storage.py +91 -7
- package/_bundled_plugin/scripts/workbench_cli.py +54 -14
- package/_bundled_plugin/scripts/workbench_constants.py +12 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +562 -303
- package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
- package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
- package/_bundled_plugin/scripts/workbench_progress.py +169 -4
- package/_bundled_plugin/scripts/workbench_publication.py +16 -13
- package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
- package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
- package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
- package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
- package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
- package/_bundled_plugin/scripts/workbench_schema.py +258 -63
- package/_bundled_plugin/scripts/workbench_setup.py +14 -2
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
- package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
- package/_bundled_plugin/scripts/workbench_target.py +594 -136
- package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
- package/_bundled_plugin/scripts/workbench_validation.py +43 -3
- package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
- package/_bundled_plugin/shared/workbench-migrations.json +100 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
- package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
- package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
- package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
- package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
- package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
- package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
- package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
- package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
- package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
- package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
- package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
- package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
- package/bin/codex-security.mjs +2 -2
- package/dist/api.d.ts +45 -5
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1192 -427
- package/dist/api.js.map +1 -1
- package/dist/armorcode-findings.d.ts +9 -0
- package/dist/armorcode-findings.d.ts.map +1 -0
- package/dist/armorcode-findings.js +145 -0
- package/dist/armorcode-findings.js.map +1 -0
- package/dist/artifact-export.d.ts +2 -0
- package/dist/artifact-export.d.ts.map +1 -1
- package/dist/artifact-export.js +29 -13
- package/dist/artifact-export.js.map +1 -1
- package/dist/auth.d.ts +6 -2
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +37 -18
- package/dist/auth.js.map +1 -1
- package/dist/batch-cost.d.ts +18 -0
- package/dist/batch-cost.d.ts.map +1 -0
- package/dist/batch-cost.js +41 -0
- package/dist/batch-cost.js.map +1 -0
- package/dist/bedrock-oss-pricing.d.ts +6 -0
- package/dist/bedrock-oss-pricing.d.ts.map +1 -0
- package/dist/bedrock-oss-pricing.js +58 -0
- package/dist/bedrock-oss-pricing.js.map +1 -0
- package/dist/bedrock-pricing.d.ts +15 -0
- package/dist/bedrock-pricing.d.ts.map +1 -0
- package/dist/bedrock-pricing.js +117 -0
- package/dist/bedrock-pricing.js.map +1 -0
- package/dist/blackduck-findings.d.ts +1 -1
- package/dist/blackduck-findings.d.ts.map +1 -1
- package/dist/blackduck-findings.js +24 -22
- package/dist/blackduck-findings.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +4 -4
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/bundled-plugin.d.ts +4 -0
- package/dist/bundled-plugin.d.ts.map +1 -0
- package/dist/bundled-plugin.js +23 -0
- package/dist/bundled-plugin.js.map +1 -0
- package/dist/checkmarx-evidence.d.ts +19 -0
- package/dist/checkmarx-evidence.d.ts.map +1 -0
- package/dist/checkmarx-evidence.js +36 -0
- package/dist/checkmarx-evidence.js.map +1 -0
- package/dist/checkmarx-findings.d.ts +4 -0
- package/dist/checkmarx-findings.d.ts.map +1 -0
- package/dist/checkmarx-findings.js +27 -0
- package/dist/checkmarx-findings.js.map +1 -0
- package/dist/checkmarx-one.d.ts +4 -0
- package/dist/checkmarx-one.d.ts.map +1 -0
- package/dist/checkmarx-one.js +53 -0
- package/dist/checkmarx-one.js.map +1 -0
- package/dist/checkmarx-repository.d.ts +12 -0
- package/dist/checkmarx-repository.d.ts.map +1 -0
- package/dist/checkmarx-repository.js +181 -0
- package/dist/checkmarx-repository.js.map +1 -0
- package/dist/checkmarx-xml.d.ts +12 -0
- package/dist/checkmarx-xml.d.ts.map +1 -0
- package/dist/checkmarx-xml.js +196 -0
- package/dist/checkmarx-xml.js.map +1 -0
- package/dist/classify-scan-severity.d.ts +1 -1
- package/dist/classify-scan-severity.d.ts.map +1 -1
- package/dist/classify-scan-severity.js +11 -3
- package/dist/classify-scan-severity.js.map +1 -1
- package/dist/classify-severity-records.d.ts +1 -9
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +3 -13
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +11 -10
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-argument.d.ts +4 -0
- package/dist/cli-argument.d.ts.map +1 -0
- package/dist/cli-argument.js +17 -0
- package/dist/cli-argument.js.map +1 -0
- package/dist/cli-help.d.ts +1 -1
- package/dist/cli-help.d.ts.map +1 -1
- package/dist/cli-help.js +71 -29
- package/dist/cli-help.js.map +1 -1
- package/dist/cli-hook.d.ts +3 -0
- package/dist/cli-hook.d.ts.map +1 -0
- package/dist/cli-hook.js +87 -0
- package/dist/cli-hook.js.map +1 -0
- package/dist/cli-integrations.d.ts +13 -0
- package/dist/cli-integrations.d.ts.map +1 -0
- package/dist/cli-integrations.js +333 -0
- package/dist/cli-integrations.js.map +1 -0
- package/dist/cli-mcp.d.ts +15 -0
- package/dist/cli-mcp.d.ts.map +1 -0
- package/dist/cli-mcp.js +178 -0
- package/dist/cli-mcp.js.map +1 -0
- package/dist/cli-token-view.d.ts +10 -0
- package/dist/cli-token-view.d.ts.map +1 -0
- package/dist/cli-token-view.js +41 -0
- package/dist/cli-token-view.js.map +1 -0
- package/dist/cli.d.ts +16 -8
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +3382 -2017
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +35 -33
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codex-sdk-environment.d.ts +6 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -1
- package/dist/codex-sdk-environment.js +19 -0
- package/dist/codex-sdk-environment.js.map +1 -1
- package/dist/command-words.d.ts +3 -0
- package/dist/command-words.d.ts.map +1 -0
- package/dist/command-words.js +46 -0
- package/dist/command-words.js.map +1 -0
- package/dist/component-scan.d.ts +19 -4
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +67 -9
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +130 -67
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts +1 -1
- package/dist/continuum-findings.d.ts.map +1 -1
- package/dist/continuum-findings.js +149 -19
- package/dist/continuum-findings.js.map +1 -1
- package/dist/contract-values.d.ts +2 -0
- package/dist/contract-values.d.ts.map +1 -1
- package/dist/contract-values.js +12 -9
- package/dist/contract-values.js.map +1 -1
- package/dist/cost-model.d.ts +13 -1
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +66 -112
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +42 -3
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +484 -149
- package/dist/cost.js.map +1 -1
- package/dist/custom-publish.d.ts +4 -0
- package/dist/custom-publish.d.ts.map +1 -1
- package/dist/custom-publish.js +40 -3
- package/dist/custom-publish.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +29 -19
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/deduplication/local.d.ts +4 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +9 -2
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +26 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +5 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +24 -7
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +0 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +22 -33
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-scan-defaults.d.ts +2 -0
- package/dist/deep-scan-defaults.d.ts.map +1 -1
- package/dist/deep-scan-defaults.js +28 -1
- package/dist/deep-scan-defaults.js.map +1 -1
- package/dist/deep-scan.d.ts +2 -0
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +44 -19
- package/dist/deep-scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +1 -1
- package/dist/default-severity-rubric.d.ts.map +1 -1
- package/dist/default-severity-rubric.js +1 -1
- package/dist/default-severity-rubric.js.map +1 -1
- package/dist/endor-findings.d.ts +3 -1
- package/dist/endor-findings.d.ts.map +1 -1
- package/dist/endor-findings.js +86 -45
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +4 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +15 -4
- package/dist/errors.js.map +1 -1
- package/dist/executable-path.d.ts +3 -0
- package/dist/executable-path.d.ts.map +1 -1
- package/dist/executable-path.js +26 -0
- package/dist/executable-path.js.map +1 -1
- package/dist/external-findings-import.d.ts +5 -3
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +19 -7
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +69 -5
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +537 -108
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +13 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +895 -1142
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +21 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +130 -68
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +15 -3
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +54 -2
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +8 -12
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +51 -184
- package/dist/external-import-contract.js.map +1 -1
- package/dist/external-import-models.d.ts +1 -1
- package/dist/external-import-models.d.ts.map +1 -1
- package/dist/external-import-models.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +5 -4
- package/dist/feedback.js.map +1 -1
- package/dist/finding-prompt.d.ts +5 -0
- package/dist/finding-prompt.d.ts.map +1 -0
- package/dist/finding-prompt.js +32 -0
- package/dist/finding-prompt.js.map +1 -0
- package/dist/findings-client.d.ts +1 -0
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +27 -3
- package/dist/findings-client.js.map +1 -1
- package/dist/github-advisories.d.ts.map +1 -1
- package/dist/github-advisories.js +0 -2
- package/dist/github-advisories.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +18 -8
- package/dist/github-dependabot-findings.js.map +1 -1
- package/dist/github-findings.d.ts +4 -1
- package/dist/github-findings.d.ts.map +1 -1
- package/dist/github-findings.js +73 -316
- package/dist/github-findings.js.map +1 -1
- package/dist/hosted-git-remotes.d.ts +5 -0
- package/dist/hosted-git-remotes.d.ts.map +1 -0
- package/dist/hosted-git-remotes.js +285 -0
- package/dist/hosted-git-remotes.js.map +1 -0
- package/dist/hosted-git-repository.d.ts +28 -0
- package/dist/hosted-git-repository.d.ts.map +1 -0
- package/dist/hosted-git-repository.js +222 -0
- package/dist/hosted-git-repository.js.map +1 -0
- package/dist/hosted-remediation.d.ts +1 -0
- package/dist/hosted-remediation.d.ts.map +1 -1
- package/dist/hosted-remediation.js +23 -3
- package/dist/hosted-remediation.js.map +1 -1
- package/dist/hosted-scan-protocol.js +2 -2
- package/dist/hosted-scan-protocol.js.map +1 -1
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +16 -11
- package/dist/hosted-scan.js.map +1 -1
- package/dist/hosted-scanner-http.d.ts +21 -0
- package/dist/hosted-scanner-http.d.ts.map +1 -0
- package/dist/hosted-scanner-http.js +204 -0
- package/dist/hosted-scanner-http.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +3 -0
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +21 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +12 -3
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +52 -86
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +102 -32
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts +11 -0
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js.map +1 -1
- package/dist/local-git-metadata.d.ts +5 -2
- package/dist/local-git-metadata.d.ts.map +1 -1
- package/dist/local-git-metadata.js +8 -5
- package/dist/local-git-metadata.js.map +1 -1
- package/dist/multiscan.d.ts +10 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +217 -102
- package/dist/multiscan.js.map +1 -1
- package/dist/native-json-findings.d.ts +2 -1
- package/dist/native-json-findings.d.ts.map +1 -1
- package/dist/native-json-findings.js +12 -2
- package/dist/native-json-findings.js.map +1 -1
- package/dist/opengrep-findings.d.ts +5 -2
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +54 -33
- package/dist/opengrep-findings.js.map +1 -1
- package/dist/operation-telemetry.d.ts +104 -0
- package/dist/operation-telemetry.d.ts.map +1 -0
- package/dist/operation-telemetry.js +293 -0
- package/dist/operation-telemetry.js.map +1 -0
- package/dist/plugin-python-probe.d.ts +4 -0
- package/dist/plugin-python-probe.d.ts.map +1 -0
- package/dist/plugin-python-probe.js +10 -0
- package/dist/plugin-python-probe.js.map +1 -0
- package/dist/private-finding-import.d.ts +99 -9
- package/dist/private-finding-import.d.ts.map +1 -1
- package/dist/private-finding-import.js +116 -152
- package/dist/private-finding-import.js.map +1 -1
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +53 -13
- package/dist/project-config.js.map +1 -1
- package/dist/prompt-files.d.ts +7 -2
- package/dist/prompt-files.d.ts.map +1 -1
- package/dist/prompt-files.js +42 -20
- package/dist/prompt-files.js.map +1 -1
- package/dist/provider-profile.d.ts +1 -1
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +12 -10
- package/dist/provider-profile.js.map +1 -1
- package/dist/publication-telemetry.d.ts +45 -0
- package/dist/publication-telemetry.d.ts.map +1 -0
- package/dist/publication-telemetry.js +50 -0
- package/dist/publication-telemetry.js.map +1 -0
- package/dist/publication.d.ts +1 -1
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +4 -0
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +42 -2
- package/dist/publish.js.map +1 -1
- package/dist/record.d.ts +1 -5
- package/dist/record.d.ts.map +1 -1
- package/dist/record.js +3 -51
- package/dist/record.js.map +1 -1
- package/dist/remediation.d.ts +1 -4
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +6 -8
- package/dist/remediation.js.map +1 -1
- package/dist/request-metadata.d.ts +3 -0
- package/dist/request-metadata.d.ts.map +1 -1
- package/dist/request-metadata.js +9 -0
- package/dist/request-metadata.js.map +1 -1
- package/dist/result.d.ts +4 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +1 -1
- package/dist/result.js.map +1 -1
- package/dist/retry-windows-rename.d.ts +8 -0
- package/dist/retry-windows-rename.d.ts.map +1 -0
- package/dist/retry-windows-rename.js +24 -0
- package/dist/retry-windows-rename.js.map +1 -0
- package/dist/runtime.d.ts +54 -6
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +1084 -256
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +7 -1
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +269 -114
- package/dist/saved-scan-bootstrap.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +141 -56
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-archive-path.d.ts +2 -0
- package/dist/scan-archive-path.d.ts.map +1 -0
- package/dist/scan-archive-path.js +5 -0
- package/dist/scan-archive-path.js.map +1 -0
- package/dist/scan-comparison.d.ts +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +66 -17
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +7 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +92 -43
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +10 -1
- package/dist/scan-executor.d.ts.map +1 -1
- package/dist/scan-executor.js +24 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts +1 -0
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +34 -28
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-logs.d.ts +12 -0
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +131 -78
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-measurement.d.ts +26 -0
- package/dist/scan-measurement.d.ts.map +1 -0
- package/dist/scan-measurement.js +77 -0
- package/dist/scan-measurement.js.map +1 -0
- package/dist/scan-progress.d.ts +1 -0
- package/dist/scan-progress.d.ts.map +1 -1
- package/dist/scan-progress.js +3 -0
- package/dist/scan-progress.js.map +1 -1
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +4 -1
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +1 -1
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +1 -24
- package/dist/scan-settings.js.map +1 -1
- package/dist/scanner-import.d.ts +25 -13
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +216 -97
- package/dist/scanner-import.js.map +1 -1
- package/dist/scanner-repository-url.d.ts +4 -1
- package/dist/scanner-repository-url.d.ts.map +1 -1
- package/dist/scanner-repository-url.js +10 -6
- package/dist/scanner-repository-url.js.map +1 -1
- package/dist/security-policy.d.ts +1 -1
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +26 -6
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +6 -3
- package/dist/semgrep-findings.d.ts.map +1 -1
- package/dist/semgrep-findings.js +72 -42
- package/dist/semgrep-findings.js.map +1 -1
- package/dist/semgrep-guardian-findings.d.ts +38 -0
- package/dist/semgrep-guardian-findings.d.ts.map +1 -0
- package/dist/semgrep-guardian-findings.js +165 -0
- package/dist/semgrep-guardian-findings.js.map +1 -0
- package/dist/semgrep-platform-collector.d.ts +26 -0
- package/dist/semgrep-platform-collector.d.ts.map +1 -0
- package/dist/semgrep-platform-collector.js +108 -0
- package/dist/semgrep-platform-collector.js.map +1 -0
- package/dist/semgrep-platform-findings.d.ts +157 -6
- package/dist/semgrep-platform-findings.d.ts.map +1 -1
- package/dist/semgrep-platform-findings.js +766 -103
- package/dist/semgrep-platform-findings.js.map +1 -1
- package/dist/server/api.d.ts +1 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embedding-tokenizer.cdx.json +33 -0
- package/dist/server/embedding-tokenizer.d.ts +2 -0
- package/dist/server/embedding-tokenizer.d.ts.map +1 -0
- package/dist/server/embedding-tokenizer.js +322 -0
- package/dist/server/embedding-tokenizer.js.map +6 -0
- package/dist/server/embeddings.d.ts +16 -2
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +35 -5
- package/dist/server/embeddings.js.map +1 -1
- package/dist/session-lines.d.ts +5 -0
- package/dist/session-lines.d.ts.map +1 -0
- package/dist/session-lines.js +60 -0
- package/dist/session-lines.js.map +1 -0
- package/dist/severity-review.d.ts +3 -1
- package/dist/severity-review.d.ts.map +1 -1
- package/dist/severity-review.js +3 -2
- package/dist/severity-review.js.map +1 -1
- package/dist/skill-authentication.d.ts +1 -0
- package/dist/skill-authentication.d.ts.map +1 -1
- package/dist/skill-authentication.js +1 -0
- package/dist/skill-authentication.js.map +1 -1
- package/dist/snyk-findings.d.ts +9 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +90 -70
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +59 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +879 -0
- package/dist/snyk-rest-findings.js.map +1 -0
- package/dist/snyk-token-origin.d.ts +4 -0
- package/dist/snyk-token-origin.d.ts.map +1 -0
- package/dist/snyk-token-origin.js +82 -0
- package/dist/snyk-token-origin.js.map +1 -0
- package/dist/sonar-collector.d.ts.map +1 -1
- package/dist/sonar-collector.js +0 -3
- package/dist/sonar-collector.js.map +1 -1
- package/dist/sonar-findings.d.ts +1 -1
- package/dist/sonar-findings.d.ts.map +1 -1
- package/dist/sonar-findings.js +2 -4
- package/dist/sonar-findings.js.map +1 -1
- package/dist/sonar-import.d.ts +3 -0
- package/dist/sonar-import.d.ts.map +1 -1
- package/dist/sonar-import.js +30 -34
- package/dist/sonar-import.js.map +1 -1
- package/dist/stored-finding-projection.d.ts +6 -0
- package/dist/stored-finding-projection.d.ts.map +1 -0
- package/dist/stored-finding-projection.js +104 -0
- package/dist/stored-finding-projection.js.map +1 -0
- package/dist/stored-findings-publication.d.ts +23 -0
- package/dist/stored-findings-publication.d.ts.map +1 -0
- package/dist/stored-findings-publication.js +169 -0
- package/dist/stored-findings-publication.js.map +1 -0
- package/dist/target-drift.d.ts +9 -0
- package/dist/target-drift.d.ts.map +1 -0
- package/dist/target-drift.js +27 -0
- package/dist/target-drift.js.map +1 -0
- package/dist/targets.d.ts +8 -1
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +131 -42
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +6 -0
- package/dist/tenable-findings.d.ts.map +1 -0
- package/dist/tenable-findings.js +122 -0
- package/dist/tenable-findings.js.map +1 -0
- package/dist/terminal-stream.d.ts +13 -0
- package/dist/terminal-stream.d.ts.map +1 -0
- package/dist/terminal-stream.js +35 -0
- package/dist/terminal-stream.js.map +1 -0
- package/dist/trivy-findings.d.ts +19 -0
- package/dist/trivy-findings.d.ts.map +1 -0
- package/dist/trivy-findings.js +424 -0
- package/dist/trivy-findings.js.map +1 -0
- package/dist/trivy-import.d.ts +19 -0
- package/dist/trivy-import.d.ts.map +1 -0
- package/dist/trivy-import.js +151 -0
- package/dist/trivy-import.js.map +1 -0
- package/dist/trusted-executable.d.ts +6 -0
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +140 -37
- package/dist/trusted-executable.js.map +1 -1
- package/dist/validation-records.js +1 -1
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +1 -1
- package/dist/veracode-findings.d.ts.map +1 -1
- package/dist/veracode-findings.js +19 -6
- package/dist/veracode-findings.js.map +1 -1
- package/dist/version.d.ts +3 -1
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +184 -32
- package/dist/version.js.map +1 -1
- package/dist/vertex-pricing.d.ts +8 -0
- package/dist/vertex-pricing.d.ts.map +1 -0
- package/dist/vertex-pricing.js +20 -0
- package/dist/vertex-pricing.js.map +1 -0
- package/dist/windows-path.d.ts +1 -0
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +26 -1
- package/dist/windows-path.js.map +1 -1
- package/dist/wiz-findings.d.ts +6 -2
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +65 -89
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +27 -12
- package/docs/cli.md +853 -639
- package/docs/dedupe-records.md +44 -24
- package/docs/findings-service.md +84 -44
- package/docs/hosted-remediation.md +27 -11
- package/docs/hosted-scans.md +50 -42
- package/docs/sdk.md +903 -0
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +23 -16
- package/schemas/external-findings.schema.json +4 -1
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -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/mcp/server.mjs.br.part-002 +0 -0
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
- package/dist/external-imports-feature.d.ts +0 -6
- package/dist/external-imports-feature.d.ts.map +0 -1
- package/dist/external-imports-feature.js +0 -51
- package/dist/external-imports-feature.js.map +0 -1
- package/dist/finding-normalization.d.ts +0 -5
- package/dist/finding-normalization.d.ts.map +0 -1
- package/dist/finding-normalization.js +0 -155
- package/dist/finding-normalization.js.map +0 -1
- package/dist/reader-selection.d.ts +0 -13
- package/dist/reader-selection.d.ts.map +0 -1
- package/dist/reader-selection.js +0 -81
- package/dist/reader-selection.js.map +0 -1
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { ExternalImportTarget } from "./external-import-contract.js";
|
|
2
|
+
import type { ExternalFindings } from "./external-findings.js";
|
|
3
|
+
type ArmorCodeFinding = Record<string, unknown>;
|
|
4
|
+
/** Recover the source repository independently of the finding's scan type. */
|
|
5
|
+
export declare function armorCodeRepositoryUrl(finding: ArmorCodeFinding | null | undefined, target: ExternalImportTarget): string | undefined;
|
|
6
|
+
/** Normalize stable finding records while retaining the original ArmorCode row. */
|
|
7
|
+
export declare function normalizeArmorCodeFindings(input: unknown, target?: ExternalImportTarget, sourceRepositoryUrl?: string): ExternalFindings;
|
|
8
|
+
export {};
|
|
9
|
+
//# sourceMappingURL=armorcode-findings.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"armorcode-findings.d.ts","sourceRoot":"","sources":["../src/armorcode-findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAW/D,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoBhD,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC5C,MAAM,EAAE,oBAAoB,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,oBAA8B,EACtC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,gBAAgB,CA0IlB"}
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
import { validateExternalEvidence } from "./external-import-contract.js";
|
|
2
|
+
import { declaredScannerRepositoryUrl } from "./scanner-repository-url.js";
|
|
3
|
+
import { isRecord } from "./record.js";
|
|
4
|
+
import { normalizeRecords, record, requiredText, text, } from "./scanner-import.js";
|
|
5
|
+
function armorCodeId(value) {
|
|
6
|
+
if (typeof value === "string")
|
|
7
|
+
return requiredText(value, "ArmorCode finding ID");
|
|
8
|
+
if (typeof value === "number" && Number.isSafeInteger(value))
|
|
9
|
+
return String(value);
|
|
10
|
+
throw new Error("ArmorCode finding ID must be text or a safe integer.");
|
|
11
|
+
}
|
|
12
|
+
function stringValues(value) {
|
|
13
|
+
const values = Array.isArray(value) ? value : value == null ? [] : [value];
|
|
14
|
+
return values.flatMap((item) => {
|
|
15
|
+
if (typeof item === "string" && item.trim())
|
|
16
|
+
return [item];
|
|
17
|
+
if (typeof item === "number" && Number.isSafeInteger(item))
|
|
18
|
+
return [String(item)];
|
|
19
|
+
return [];
|
|
20
|
+
});
|
|
21
|
+
}
|
|
22
|
+
/** Recover the source repository independently of the finding's scan type. */
|
|
23
|
+
export function armorCodeRepositoryUrl(finding, target) {
|
|
24
|
+
const repository = finding?.["repository"];
|
|
25
|
+
const url = text(finding?.["sourceRepositoryUrl"]) ??
|
|
26
|
+
text(finding?.["repositoryUrl"]) ??
|
|
27
|
+
text(isRecord(repository) ? repository["url"] : repository);
|
|
28
|
+
return url
|
|
29
|
+
? declaredScannerRepositoryUrl(url, "ArmorCode", target)
|
|
30
|
+
: undefined;
|
|
31
|
+
}
|
|
32
|
+
/** Normalize stable finding records while retaining the original ArmorCode row. */
|
|
33
|
+
export function normalizeArmorCodeFindings(input, target = "cloud", sourceRepositoryUrl) {
|
|
34
|
+
const document = Array.isArray(input)
|
|
35
|
+
? { findings: input }
|
|
36
|
+
: record(input, "ArmorCode report");
|
|
37
|
+
const raw = document["findings"] ??
|
|
38
|
+
document["issues"] ??
|
|
39
|
+
(isRecord(document["data"]) ? document["data"]["findings"] : undefined);
|
|
40
|
+
if (!Array.isArray(raw))
|
|
41
|
+
throw new Error("ArmorCode report must contain a findings array.");
|
|
42
|
+
const report = { ...document };
|
|
43
|
+
delete report["findings"];
|
|
44
|
+
delete report["issues"];
|
|
45
|
+
if (isRecord(report["data"])) {
|
|
46
|
+
const data = { ...report["data"] };
|
|
47
|
+
delete data["findings"];
|
|
48
|
+
if (Object.keys(data).length)
|
|
49
|
+
report["data"] = data;
|
|
50
|
+
else
|
|
51
|
+
delete report["data"];
|
|
52
|
+
}
|
|
53
|
+
const declaredUrl = sourceRepositoryUrl === undefined
|
|
54
|
+
? undefined
|
|
55
|
+
: declaredScannerRepositoryUrl(sourceRepositoryUrl, "ArmorCode", target);
|
|
56
|
+
return normalizeRecords(raw, (finding) => {
|
|
57
|
+
const severity = (text(finding["severity"]) ?? "unknown").toLowerCase();
|
|
58
|
+
const locations = Array.isArray(finding["locations"])
|
|
59
|
+
? finding["locations"]
|
|
60
|
+
: finding["location"]
|
|
61
|
+
? [finding["location"]]
|
|
62
|
+
: text(finding["filePath"])
|
|
63
|
+
? [{ path: finding["filePath"], line: finding["lineNumber"] }]
|
|
64
|
+
: [];
|
|
65
|
+
const description = text(finding["description"] ??
|
|
66
|
+
finding["details"] ??
|
|
67
|
+
finding["toolDescription"]);
|
|
68
|
+
const mitigation = text(finding["mitigation"]);
|
|
69
|
+
const lastUpdated = finding["lastUpdated"];
|
|
70
|
+
const isSast = Array.isArray(finding["scanType"]) &&
|
|
71
|
+
finding["scanType"].some((value) => typeof value === "string" && value.toLowerCase() === "sast");
|
|
72
|
+
const ruleIds = stringValues(finding["ruleId"]);
|
|
73
|
+
const weaknessIds = [
|
|
74
|
+
...stringValues(finding["cwe"]),
|
|
75
|
+
...stringValues(finding["cwesStrings"]),
|
|
76
|
+
];
|
|
77
|
+
const repositoryUrl = armorCodeRepositoryUrl(finding, target) ?? declaredUrl;
|
|
78
|
+
if (isSast && !repositoryUrl)
|
|
79
|
+
throw new Error("ArmorCode SAST evidence requires its source repository. For a single-repository report, supply its verified --source-repository-url.");
|
|
80
|
+
const evidence = {
|
|
81
|
+
title: requiredText(finding["title"] ?? finding["name"] ?? finding["findingName"], "ArmorCode finding title"),
|
|
82
|
+
severity: ([
|
|
83
|
+
"critical",
|
|
84
|
+
"high",
|
|
85
|
+
"medium",
|
|
86
|
+
"low",
|
|
87
|
+
"informational",
|
|
88
|
+
].includes(severity)
|
|
89
|
+
? severity
|
|
90
|
+
: "unknown"),
|
|
91
|
+
description: isSast
|
|
92
|
+
? description
|
|
93
|
+
: description && mitigation
|
|
94
|
+
? `${description}\n\nMitigation: ${mitigation}`
|
|
95
|
+
: (description ?? mitigation),
|
|
96
|
+
// ArmorCode's findingUrl remains available in source_data; url points
|
|
97
|
+
// to the originating scanner when ArmorCode provides both links.
|
|
98
|
+
url: text(finding["url"] ?? finding["findingUrl"]),
|
|
99
|
+
...(Array.isArray(finding["cve"]) && {
|
|
100
|
+
advisory_ids: finding["cve"].filter((value) => typeof value === "string"),
|
|
101
|
+
}),
|
|
102
|
+
locations: locations.flatMap((value) => {
|
|
103
|
+
if (!isRecord(value))
|
|
104
|
+
return [];
|
|
105
|
+
const path = text(value["path"] ?? value["filePath"] ?? value["file"]);
|
|
106
|
+
if (!path)
|
|
107
|
+
return [];
|
|
108
|
+
const line = value["line"] ?? value["startLine"] ?? value["lineNumber"];
|
|
109
|
+
return [
|
|
110
|
+
{
|
|
111
|
+
path,
|
|
112
|
+
line: Number.isSafeInteger(line) && Number(line) > 0
|
|
113
|
+
? Number(line)
|
|
114
|
+
: null,
|
|
115
|
+
},
|
|
116
|
+
];
|
|
117
|
+
}),
|
|
118
|
+
...(typeof lastUpdated === "number" &&
|
|
119
|
+
Number.isSafeInteger(lastUpdated) && {
|
|
120
|
+
source_updated_at: Math.floor(lastUpdated / 1000),
|
|
121
|
+
}),
|
|
122
|
+
...(isSast && {
|
|
123
|
+
details: {
|
|
124
|
+
kind: "sast",
|
|
125
|
+
...(repositoryUrl && { repository: { url: repositoryUrl } }),
|
|
126
|
+
source_status: text(finding["status"] ?? finding["toolFindingStatus"]),
|
|
127
|
+
scanner_origin: text(finding["source"]),
|
|
128
|
+
scanner_verdict: text(finding["toolStatusOriginal"]),
|
|
129
|
+
...(ruleIds.length > 0 && { rule: { id: ruleIds.join(", ") } }),
|
|
130
|
+
...(weaknessIds.length > 0 && {
|
|
131
|
+
weakness_ids: [...new Set(weaknessIds)],
|
|
132
|
+
}),
|
|
133
|
+
...(mitigation && { remediation_instructions: mitigation }),
|
|
134
|
+
},
|
|
135
|
+
}),
|
|
136
|
+
source_data: structuredClone(finding),
|
|
137
|
+
};
|
|
138
|
+
validateExternalEvidence(evidence, target);
|
|
139
|
+
return evidence;
|
|
140
|
+
}, (finding) => armorCodeId(finding["source_finding_id"] ??
|
|
141
|
+
finding["findingId"] ??
|
|
142
|
+
finding["id"] ??
|
|
143
|
+
finding["finding_id"]), target, { report });
|
|
144
|
+
}
|
|
145
|
+
//# sourceMappingURL=armorcode-findings.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"armorcode-findings.js","sourceRoot":"","sources":["../src/armorcode-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalImportTarget } from \"./external-import-contract.js\";\nimport { validateExternalEvidence } from \"./external-import-contract.js\";\nimport type { ExternalFindings } from \"./external-findings.js\";\nimport type { ExternalFindingEvidence } from \"./external-import-models.js\";\nimport { declaredScannerRepositoryUrl } from \"./scanner-repository-url.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n normalizeRecords,\n record,\n requiredText,\n text,\n} from \"./scanner-import.js\";\n\ntype ArmorCodeFinding = Record<string, unknown>;\n\nfunction armorCodeId(value: unknown): string {\n if (typeof value === \"string\")\n return requiredText(value, \"ArmorCode finding ID\");\n if (typeof value === \"number\" && Number.isSafeInteger(value))\n return String(value);\n throw new Error(\"ArmorCode finding ID must be text or a safe integer.\");\n}\n\nfunction stringValues(value: unknown): string[] {\n const values = Array.isArray(value) ? value : value == null ? [] : [value];\n return values.flatMap((item) => {\n if (typeof item === \"string\" && item.trim()) return [item];\n if (typeof item === \"number\" && Number.isSafeInteger(item))\n return [String(item)];\n return [];\n });\n}\n\n/** Recover the source repository independently of the finding's scan type. */\nexport function armorCodeRepositoryUrl(\n finding: ArmorCodeFinding | null | undefined,\n target: ExternalImportTarget,\n): string | undefined {\n const repository = finding?.[\"repository\"];\n const url =\n text(finding?.[\"sourceRepositoryUrl\"]) ??\n text(finding?.[\"repositoryUrl\"]) ??\n text(isRecord(repository) ? repository[\"url\"] : repository);\n return url\n ? declaredScannerRepositoryUrl(url, \"ArmorCode\", target)\n : undefined;\n}\n\n/** Normalize stable finding records while retaining the original ArmorCode row. */\nexport function normalizeArmorCodeFindings(\n input: unknown,\n target: ExternalImportTarget = \"cloud\",\n sourceRepositoryUrl?: string,\n): ExternalFindings {\n const document = Array.isArray(input)\n ? { findings: input }\n : record(input, \"ArmorCode report\");\n const raw =\n document[\"findings\"] ??\n document[\"issues\"] ??\n (isRecord(document[\"data\"]) ? document[\"data\"][\"findings\"] : undefined);\n if (!Array.isArray(raw))\n throw new Error(\"ArmorCode report must contain a findings array.\");\n const report = { ...document };\n delete report[\"findings\"];\n delete report[\"issues\"];\n if (isRecord(report[\"data\"])) {\n const data = { ...report[\"data\"] };\n delete data[\"findings\"];\n if (Object.keys(data).length) report[\"data\"] = data;\n else delete report[\"data\"];\n }\n const declaredUrl =\n sourceRepositoryUrl === undefined\n ? undefined\n : declaredScannerRepositoryUrl(sourceRepositoryUrl, \"ArmorCode\", target);\n return normalizeRecords(\n raw as ArmorCodeFinding[],\n (finding) => {\n const severity = (text(finding[\"severity\"]) ?? \"unknown\").toLowerCase();\n const locations = Array.isArray(finding[\"locations\"])\n ? finding[\"locations\"]\n : finding[\"location\"]\n ? [finding[\"location\"]]\n : text(finding[\"filePath\"])\n ? [{ path: finding[\"filePath\"], line: finding[\"lineNumber\"] }]\n : [];\n const description = text(\n finding[\"description\"] ??\n finding[\"details\"] ??\n finding[\"toolDescription\"],\n );\n const mitigation = text(finding[\"mitigation\"]);\n const lastUpdated = finding[\"lastUpdated\"];\n const isSast =\n Array.isArray(finding[\"scanType\"]) &&\n finding[\"scanType\"].some(\n (value) =>\n typeof value === \"string\" && value.toLowerCase() === \"sast\",\n );\n const ruleIds = stringValues(finding[\"ruleId\"]);\n const weaknessIds = [\n ...stringValues(finding[\"cwe\"]),\n ...stringValues(finding[\"cwesStrings\"]),\n ];\n const repositoryUrl =\n armorCodeRepositoryUrl(finding, target) ?? declaredUrl;\n if (isSast && !repositoryUrl)\n throw new Error(\n \"ArmorCode SAST evidence requires its source repository. For a single-repository report, supply its verified --source-repository-url.\",\n );\n const evidence: ExternalFindingEvidence = {\n title: requiredText(\n finding[\"title\"] ?? finding[\"name\"] ?? finding[\"findingName\"],\n \"ArmorCode finding title\",\n ),\n severity: ([\n \"critical\",\n \"high\",\n \"medium\",\n \"low\",\n \"informational\",\n ].includes(severity)\n ? severity\n : \"unknown\") as ExternalFindingEvidence[\"severity\"],\n description: isSast\n ? description\n : description && mitigation\n ? `${description}\\n\\nMitigation: ${mitigation}`\n : (description ?? mitigation),\n // ArmorCode's findingUrl remains available in source_data; url points\n // to the originating scanner when ArmorCode provides both links.\n url: text(finding[\"url\"] ?? finding[\"findingUrl\"]),\n ...(Array.isArray(finding[\"cve\"]) && {\n advisory_ids: finding[\"cve\"].filter(\n (value): value is string => typeof value === \"string\",\n ),\n }),\n locations: locations.flatMap((value) => {\n if (!isRecord(value)) return [];\n const path = text(\n value[\"path\"] ?? value[\"filePath\"] ?? value[\"file\"],\n );\n if (!path) return [];\n const line =\n value[\"line\"] ?? value[\"startLine\"] ?? value[\"lineNumber\"];\n return [\n {\n path,\n line:\n Number.isSafeInteger(line) && Number(line) > 0\n ? Number(line)\n : null,\n },\n ];\n }),\n ...(typeof lastUpdated === \"number\" &&\n Number.isSafeInteger(lastUpdated) && {\n source_updated_at: Math.floor(lastUpdated / 1000),\n }),\n ...(isSast && {\n details: {\n kind: \"sast\",\n ...(repositoryUrl && { repository: { url: repositoryUrl } }),\n source_status: text(\n finding[\"status\"] ?? finding[\"toolFindingStatus\"],\n ),\n scanner_origin: text(finding[\"source\"]),\n scanner_verdict: text(finding[\"toolStatusOriginal\"]),\n ...(ruleIds.length > 0 && { rule: { id: ruleIds.join(\", \") } }),\n ...(weaknessIds.length > 0 && {\n weakness_ids: [...new Set(weaknessIds)],\n }),\n ...(mitigation && { remediation_instructions: mitigation }),\n },\n }),\n source_data: structuredClone(finding),\n };\n validateExternalEvidence(evidence, target);\n return evidence;\n },\n (finding) =>\n armorCodeId(\n finding[\"source_finding_id\"] ??\n finding[\"findingId\"] ??\n finding[\"id\"] ??\n finding[\"finding_id\"],\n ),\n target,\n { report },\n );\n}\n"]}
|
|
@@ -20,6 +20,7 @@ export interface ArtifactExportArguments {
|
|
|
20
20
|
pythonPath?: string;
|
|
21
21
|
signal?: AbortSignal;
|
|
22
22
|
includeMetadata?: boolean;
|
|
23
|
+
noClobber?: boolean;
|
|
23
24
|
}
|
|
24
25
|
export type ExportArtifactOptions = {
|
|
25
26
|
source: {
|
|
@@ -60,6 +61,7 @@ interface HelperOptions {
|
|
|
60
61
|
output?: ArtifactOutput;
|
|
61
62
|
failureMessage?: string;
|
|
62
63
|
}
|
|
64
|
+
export declare function artifactSourceProtectionRoots(sourceRoot: string | undefined, directory?: string): Promise<string[] | undefined>;
|
|
63
65
|
export declare function resolveArtifactFormat(artifact: ExportArtifactKind, format?: ExportFormat, avitTemplate?: string): ExportFormat;
|
|
64
66
|
export declare function runArtifactHelper(args: readonly string[], options?: HelperOptions): Promise<{
|
|
65
67
|
stdout: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"artifact-export.d.ts","sourceRoot":"","sources":["../src/artifact-export.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"artifact-export.d.ts","sourceRoot":"","sources":["../src/artifact-export.ts"],"names":[],"mappings":"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"}
|
package/dist/artifact-export.js
CHANGED
|
@@ -9,7 +9,8 @@ import { promisify } from "node:util";
|
|
|
9
9
|
import { resolveConfigPath } from "./config-path.js";
|
|
10
10
|
import { CodexSecurityError } from "./errors.js";
|
|
11
11
|
import { relativePathIsOutside as isOutsidePath } from "./targets.js";
|
|
12
|
-
import {
|
|
12
|
+
import { campaignCommandEnvironment } from "./trusted-executable.js";
|
|
13
|
+
import { bundledPluginRoot, codexSecurityStateDirectory, expandHome, resolveInputPath, resolveParentTraversal, pythonUtf8Environment, resolvePluginPython, runWorkbench, } from "./runtime.js";
|
|
13
14
|
// Bun's promise-based realpath can return drive-relative Windows roots.
|
|
14
15
|
const nativeRealpath = promisify(callbackRealpath.native);
|
|
15
16
|
export const ARTIFACT_EXPORT_FILENAMES = {
|
|
@@ -19,6 +20,20 @@ export const ARTIFACT_EXPORT_FILENAMES = {
|
|
|
19
20
|
sarif: "results.sarif",
|
|
20
21
|
md: "threatmodel.md",
|
|
21
22
|
};
|
|
23
|
+
export async function artifactSourceProtectionRoots(sourceRoot, directory = process.cwd()) {
|
|
24
|
+
return (await resolveArtifactSource(sourceRoot, directory))?.protectedRoots;
|
|
25
|
+
}
|
|
26
|
+
async function resolveArtifactSource(sourceRoot, directory = process.cwd()) {
|
|
27
|
+
if (sourceRoot === undefined)
|
|
28
|
+
return;
|
|
29
|
+
const path = await resolveParentTraversal(sourceRoot);
|
|
30
|
+
return {
|
|
31
|
+
path,
|
|
32
|
+
protectedRoots: [
|
|
33
|
+
...new Set([directory, resolve(directory, sourceRoot), path]),
|
|
34
|
+
],
|
|
35
|
+
};
|
|
36
|
+
}
|
|
22
37
|
export function resolveArtifactFormat(artifact, format, avitTemplate) {
|
|
23
38
|
const selected = format ?? (artifact === "threat-model" ? "md" : "sarif");
|
|
24
39
|
if ((artifact === "threat-model") !== (selected === "md")) {
|
|
@@ -51,7 +66,7 @@ export async function runArtifactHelper(args, options = {}) {
|
|
|
51
66
|
join(plugin, "scripts", "finalize_scan_contract.py"),
|
|
52
67
|
...args,
|
|
53
68
|
], {
|
|
54
|
-
env: environment,
|
|
69
|
+
env: (await campaignCommandEnvironment(environment)) ?? environment,
|
|
55
70
|
stdio: ["ignore", "pipe", "pipe"],
|
|
56
71
|
windowsHide: true,
|
|
57
72
|
signal: options.signal,
|
|
@@ -111,6 +126,7 @@ export async function readThreatModelPath(directory, options = {}) {
|
|
|
111
126
|
export async function runArtifactExport(arguments_, output, diagnostics = process.stderr) {
|
|
112
127
|
const artifact = arguments_.artifact ?? "findings";
|
|
113
128
|
resolveArtifactFormat(artifact, arguments_.format, arguments_.avitTemplate);
|
|
129
|
+
const source = await resolveArtifactSource(arguments_.sourceRoot);
|
|
114
130
|
const result = await runArtifactHelper([
|
|
115
131
|
"--scan-dir",
|
|
116
132
|
arguments_.scanDir,
|
|
@@ -123,15 +139,12 @@ export async function runArtifactExport(arguments_, output, diagnostics = proces
|
|
|
123
139
|
...(arguments_.output === "-"
|
|
124
140
|
? []
|
|
125
141
|
: ["--export-output", arguments_.output]),
|
|
126
|
-
...(
|
|
127
|
-
? []
|
|
128
|
-
: ["--source-root", arguments_.sourceRoot]),
|
|
142
|
+
...(source === undefined ? [] : ["--source-root", source.path]),
|
|
129
143
|
...(arguments_.includeMetadata ? ["--export-metadata"] : []),
|
|
144
|
+
...(arguments_.noClobber ? ["--no-clobber"] : []),
|
|
130
145
|
], {
|
|
131
146
|
pythonPath: arguments_.pythonPath,
|
|
132
|
-
protectedRoot:
|
|
133
|
-
? undefined
|
|
134
|
-
: [process.cwd(), arguments_.sourceRoot],
|
|
147
|
+
protectedRoot: source?.protectedRoots,
|
|
135
148
|
signal: arguments_.signal,
|
|
136
149
|
failureMessage: artifact === "findings"
|
|
137
150
|
? `Could not export Codex Security findings as ${arguments_.format.toUpperCase()}.`
|
|
@@ -147,8 +160,11 @@ export async function runArtifactExport(arguments_, output, diagnostics = proces
|
|
|
147
160
|
: undefined;
|
|
148
161
|
}
|
|
149
162
|
export async function resolveArtifactExportOutput(arguments_, currentDirectory) {
|
|
150
|
-
const
|
|
151
|
-
|
|
163
|
+
const scanDir = await resolveParentTraversal(arguments_.scanDir, {
|
|
164
|
+
allowMissing: true,
|
|
165
|
+
});
|
|
166
|
+
const canonicalScan = await realpath(scanDir).catch(() => scanDir);
|
|
167
|
+
const scanRelativeOutput = relative(scanDir, arguments_.output);
|
|
152
168
|
const scanLocalOutput = join("exports", ARTIFACT_EXPORT_FILENAMES[arguments_.format]);
|
|
153
169
|
if (arguments_.output !== "-" &&
|
|
154
170
|
!isOutsidePath(scanRelativeOutput) &&
|
|
@@ -224,20 +240,20 @@ export async function exportArtifact(options) {
|
|
|
224
240
|
const format = resolveArtifactFormat(artifact, options.format, options.avitTemplate);
|
|
225
241
|
const sourceRoot = options.sourceRoot === undefined
|
|
226
242
|
? undefined
|
|
227
|
-
:
|
|
243
|
+
: resolveInputPath(options.sourceRoot);
|
|
228
244
|
const environment = {
|
|
229
245
|
...exportEnvironment(),
|
|
230
246
|
CODEX_SECURITY_STATE_DIR: codexSecurityStateDirectory(),
|
|
231
247
|
};
|
|
232
248
|
let directory;
|
|
233
249
|
if (options.source.directory !== undefined) {
|
|
234
|
-
directory =
|
|
250
|
+
directory = resolveInputPath(options.source.directory);
|
|
235
251
|
}
|
|
236
252
|
else {
|
|
237
253
|
const python = await resolvePluginPython({
|
|
238
254
|
configuredPath: options.pythonPath,
|
|
239
255
|
environment,
|
|
240
|
-
protectedRoot:
|
|
256
|
+
protectedRoot: await artifactSourceProtectionRoots(sourceRoot),
|
|
241
257
|
signal: options.signal,
|
|
242
258
|
});
|
|
243
259
|
const pluginRoot = await bundledPluginRoot();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"artifact-export.js","sourceRoot":"","sources":["../src/artifact-export.ts"],"names":[],"mappings":"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","sourcesContent":["import { workbenchArgs } from \"./workbench-arguments.js\";\nimport { spawn } from \"node:child_process\";\nimport { realpath as callbackRealpath } from \"node:fs\";\nimport { lstat, realpath } from \"node:fs/promises\";\nimport { basename, dirname, join, relative, resolve } from \"node:path\";\nimport { Writable as NodeWritable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport { promisify } from \"node:util\";\nimport type { JsonObject } from \"./config.js\";\nimport { resolveConfigPath } from \"./config-path.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { relativePathIsOutside as isOutsidePath } from \"./targets.js\";\nimport {\n type PluginPythonOptions,\n bundledPluginRoot,\n codexSecurityStateDirectory,\n expandHome,\n pythonUtf8Environment,\n resolvePluginPython,\n runWorkbench,\n} from \"./runtime.js\";\n\n// Bun's promise-based realpath can return drive-relative Windows roots.\nconst nativeRealpath = promisify(callbackRealpath.native);\n\nexport type ArtifactOutput = Pick<NodeJS.WriteStream, \"write\">;\n\nexport const ARTIFACT_EXPORT_FILENAMES = {\n csv: \"findings.csv\",\n \"servicenow-avit\": \"servicenow-avit.csv\",\n json: \"findings.json\",\n sarif: \"results.sarif\",\n md: \"threatmodel.md\",\n} as const;\nexport type ExportFormat = keyof typeof ARTIFACT_EXPORT_FILENAMES;\nexport type ExportArtifactKind = \"findings\" | \"threat-model\";\n\nexport interface ArtifactExportArguments {\n scanDir: string;\n artifact?: ExportArtifactKind;\n format: ExportFormat;\n output: string;\n sourceRoot?: string;\n avitTemplate?: string;\n pythonPath?: string;\n signal?: AbortSignal;\n includeMetadata?: boolean;\n}\n\nexport type ExportArtifactOptions = {\n source:\n | { directory: string; scanId?: never }\n | { scanId: string; directory?: never };\n output: string;\n pythonPath?: string;\n signal?: AbortSignal;\n} & (\n | {\n artifact: \"threat-model\";\n format?: \"md\";\n sourceRoot?: never;\n avitTemplate?: never;\n }\n | {\n artifact?: \"findings\";\n format?: \"csv\" | \"json\" | \"sarif\";\n sourceRoot?: string;\n avitTemplate?: never;\n }\n | {\n artifact?: \"findings\";\n format: \"servicenow-avit\";\n avitTemplate: string;\n sourceRoot?: never;\n }\n);\n\nexport interface ArtifactExportResult {\n path: string | null;\n provenance: JsonObject | null;\n}\n\ninterface HelperOptions {\n pythonPath?: string;\n protectedRoot?: PluginPythonOptions[\"protectedRoot\"];\n pluginRoot?: string;\n signal?: AbortSignal;\n output?: ArtifactOutput;\n failureMessage?: string;\n}\n\nexport function resolveArtifactFormat(\n artifact: ExportArtifactKind,\n format?: ExportFormat,\n avitTemplate?: string,\n): ExportFormat {\n const selected = format ?? (artifact === \"threat-model\" ? \"md\" : \"sarif\");\n if ((artifact === \"threat-model\") !== (selected === \"md\")) {\n throw new CodexSecurityError(\n artifact === \"threat-model\"\n ? \"Threat-model exports only support --export-format md.\"\n : \"Findings exports support --export-format csv, json, sarif, or servicenow-avit.\",\n );\n }\n if (selected === \"servicenow-avit\" && !avitTemplate) {\n throw new CodexSecurityError(\n \"--export-format servicenow-avit requires --avit-template.\",\n );\n }\n if (selected !== \"servicenow-avit\" && avitTemplate !== undefined) {\n throw new CodexSecurityError(\n \"--avit-template is only supported with --export-format servicenow-avit.\",\n );\n }\n return selected;\n}\n\nexport async function runArtifactHelper(\n args: readonly string[],\n options: HelperOptions = {},\n): Promise<{ stdout: string; stderr: string }> {\n const environment = exportEnvironment();\n const python = await resolvePluginPython({\n configuredPath: options.pythonPath,\n environment,\n protectedRoot: options.protectedRoot,\n signal: options.signal,\n });\n const plugin = options.pluginRoot ?? (await bundledPluginRoot());\n const invocation = spawn(\n python,\n [\n \"-I\",\n \"-X\",\n \"utf8\",\n \"-B\",\n join(plugin, \"scripts\", \"finalize_scan_contract.py\"),\n ...args,\n ],\n {\n env: environment,\n stdio: [\"ignore\", \"pipe\", \"pipe\"],\n windowsHide: true,\n signal: options.signal,\n },\n );\n let stderr = \"\";\n let stdout = \"\";\n invocation.stderr.setEncoding(\"utf8\");\n invocation.stderr.on(\"data\", (chunk: string) => {\n stderr = `${stderr}${chunk}`.slice(-64 * 1024);\n });\n const forwarded =\n options.output === undefined\n ? (async () => {\n invocation.stdout.setEncoding(\"utf8\");\n for await (const chunk of invocation.stdout) stdout += chunk;\n })()\n : writeArtifactOutput(options.output, invocation.stdout);\n let status: number;\n try {\n [status] = await Promise.all([\n new Promise<number>((resolve, reject) => {\n invocation.once(\"error\", reject);\n invocation.once(\"close\", (code, signal) =>\n resolve(signal === null ? (code ?? 1) : 1),\n );\n }),\n forwarded,\n ]);\n } catch (error) {\n invocation.stdout.destroy();\n invocation.kill();\n throw error;\n }\n if (status !== 0) {\n const detail = stderr.trim().split(\"\\n\").at(-1);\n throw new CodexSecurityError(\n detail?.replace(/^finalize_scan_contract\\.py: error: /, \"\") ||\n options.failureMessage ||\n \"Could not export Codex Security artifacts.\",\n );\n }\n return { stdout, stderr };\n}\n\nexport async function writeThreatModel(\n directory: string,\n options: HelperOptions = {},\n): Promise<string> {\n const result = await runArtifactHelper(\n [\"--scan-dir\", directory, \"--write-threat-model\"],\n options,\n );\n return result.stderr.trim().replace(/^codex-security: warning: /u, \"\");\n}\n\n/** Read the current document path without making an optional projection required. */\nexport async function readThreatModelPath(\n directory: string,\n options: HelperOptions = {},\n): Promise<string | null> {\n try {\n options.signal?.throwIfAborted();\n const result = await runArtifactHelper(\n [\"--scan-dir\", directory, \"--describe-threat-model\"],\n options,\n );\n return (JSON.parse(result.stdout) as ArtifactExportResult).path;\n } catch {\n options.signal?.throwIfAborted();\n return null;\n }\n}\n\nexport async function runArtifactExport(\n arguments_: ArtifactExportArguments,\n output?: ArtifactOutput,\n diagnostics: ArtifactOutput = process.stderr,\n): Promise<string | undefined> {\n const artifact = arguments_.artifact ?? \"findings\";\n resolveArtifactFormat(artifact, arguments_.format, arguments_.avitTemplate);\n const result = await runArtifactHelper(\n [\n \"--scan-dir\",\n arguments_.scanDir,\n ...(artifact === \"findings\" ? [] : [\"--export-artifact\", artifact]),\n \"--export-format\",\n arguments_.format,\n ...(arguments_.avitTemplate === undefined\n ? []\n : [\"--avit-template\", arguments_.avitTemplate]),\n ...(arguments_.output === \"-\"\n ? []\n : [\"--export-output\", arguments_.output]),\n ...(arguments_.sourceRoot === undefined\n ? []\n : [\"--source-root\", arguments_.sourceRoot]),\n ...(arguments_.includeMetadata ? [\"--export-metadata\"] : []),\n ],\n {\n pythonPath: arguments_.pythonPath,\n protectedRoot:\n arguments_.sourceRoot === undefined\n ? undefined\n : [process.cwd(), arguments_.sourceRoot],\n signal: arguments_.signal,\n failureMessage:\n artifact === \"findings\"\n ? `Could not export Codex Security findings as ${arguments_.format.toUpperCase()}.`\n : \"Could not export the saved threat model as Markdown.\",\n ...(arguments_.output === \"-\" && output !== undefined ? { output } : {}),\n },\n );\n if (arguments_.format === \"servicenow-avit\" && result.stderr) {\n diagnostics.write(result.stderr);\n }\n return (arguments_.output === \"-\" && output === undefined) ||\n arguments_.includeMetadata\n ? result.stdout\n : undefined;\n}\n\nexport async function resolveArtifactExportOutput(\n arguments_: ArtifactExportArguments,\n currentDirectory: string,\n): Promise<ArtifactExportArguments> {\n const canonicalScan = await realpath(arguments_.scanDir).catch(\n () => arguments_.scanDir,\n );\n const scanRelativeOutput = relative(arguments_.scanDir, arguments_.output);\n const scanLocalOutput = join(\n \"exports\",\n ARTIFACT_EXPORT_FILENAMES[arguments_.format],\n );\n if (\n arguments_.output !== \"-\" &&\n !isOutsidePath(scanRelativeOutput) &&\n scanRelativeOutput !== scanLocalOutput\n ) {\n throw new CodexSecurityError(\n \"The export output path cannot overwrite a scan artifact.\",\n );\n }\n const outputPath =\n arguments_.output === \"-\"\n ? \"-\"\n : !isOutsidePath(scanRelativeOutput)\n ? join(canonicalScan, scanRelativeOutput)\n : join(\n await realpath(dirname(arguments_.output)).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\")\n throw new CodexSecurityError(\n `Export output directory does not exist: ${dirname(arguments_.output)}. Create the directory and retry.`,\n );\n throw error;\n },\n ),\n basename(arguments_.output),\n );\n if (arguments_.output !== \"-\") {\n const canonicalCurrent = await realpath(currentDirectory).catch(\n () => currentDirectory,\n );\n let traversedSymlink = false;\n let expectedOutput: string | undefined;\n for (\n let directory = dirname(arguments_.output);\n ;\n directory = dirname(directory)\n ) {\n const metadata = await lstat(directory).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\") return undefined;\n throw error;\n },\n );\n const canonicalDirectory =\n relative(currentDirectory, directory) === \"\"\n ? canonicalCurrent\n : metadata === undefined\n ? undefined\n : await nativeRealpath(directory);\n if (canonicalDirectory !== undefined) {\n expectedOutput ??= resolve(\n canonicalDirectory,\n relative(directory, arguments_.output),\n );\n if (\n !isOutsidePath(relative(canonicalCurrent, canonicalDirectory)) &&\n (traversedSymlink ||\n isOutsidePath(relative(canonicalCurrent, outputPath)) ||\n relative(expectedOutput, outputPath) !== \"\")\n ) {\n throw new CodexSecurityError(\n \"The export output path cannot traverse a repository symlink.\",\n );\n }\n }\n // An external alias may select the repository, but links below it are\n // repository-owned. Check ancestors before counting the current link.\n traversedSymlink ||= metadata?.isSymbolicLink() ?? false;\n if (\n relative(currentDirectory, directory) === \"\" ||\n dirname(directory) === directory\n )\n break;\n }\n }\n return {\n ...arguments_,\n scanDir: canonicalScan,\n output: outputPath,\n avitTemplate:\n arguments_.avitTemplate &&\n resolveConfigPath(currentDirectory, arguments_.avitTemplate),\n };\n}\n\n/** Resolve saved artifacts after the workbench validates their recorded identity. */\nexport async function resolveSavedArtifactDirectory(\n scanId: string,\n artifact: ExportArtifactKind,\n workbench: (args: readonly string[]) => Promise<JsonObject>,\n): Promise<string> {\n // Reuse the workbench's recorded digest and scan binding checks without\n // requiring a writable saved-scan directory for stdout or external exports.\n const context = await workbench(\n workbenchArgs(\"export-findings\", {\n scanId,\n artifact,\n validateOnly: true,\n }),\n );\n const scan = context[\"scan\"] as JsonObject | undefined;\n if (typeof scan?.[\"scanDir\"] !== \"string\")\n throw new CodexSecurityError(\n `Artifacts for scan ${scanId} are unavailable.`,\n );\n return resolve(expandHome(scan[\"scanDir\"]));\n}\n\n/** Export saved artifacts without authenticating or starting Codex. */\nexport async function exportArtifact(\n options: ExportArtifactOptions,\n): Promise<ArtifactExportResult> {\n const artifact = options.artifact ?? \"findings\";\n const format = resolveArtifactFormat(\n artifact,\n options.format,\n options.avitTemplate,\n );\n const sourceRoot =\n options.sourceRoot === undefined\n ? undefined\n : resolve(expandHome(options.sourceRoot));\n const environment = {\n ...exportEnvironment(),\n CODEX_SECURITY_STATE_DIR: codexSecurityStateDirectory(),\n };\n let directory: string;\n if (options.source.directory !== undefined) {\n directory = resolve(expandHome(options.source.directory));\n } else {\n const python = await resolvePluginPython({\n configuredPath: options.pythonPath,\n environment,\n protectedRoot:\n sourceRoot === undefined ? undefined : [process.cwd(), sourceRoot],\n signal: options.signal,\n });\n const pluginRoot = await bundledPluginRoot();\n directory = await resolveSavedArtifactDirectory(\n options.source.scanId,\n artifact,\n (args) =>\n runWorkbench(\n {\n python,\n pluginRoot,\n environment,\n signal: options.signal,\n failureMessage: \"Could not export Codex Security scan artifacts\",\n },\n args,\n ),\n );\n }\n const arguments_ = await resolveArtifactExportOutput(\n {\n scanDir: directory,\n artifact,\n format,\n output:\n options.output === \"-\" ? \"-\" : resolve(expandHome(options.output)),\n pythonPath: options.pythonPath,\n signal: options.signal,\n includeMetadata: artifact === \"threat-model\" && options.output !== \"-\",\n avitTemplate: options.avitTemplate,\n sourceRoot,\n },\n process.cwd(),\n );\n const metadata = await runArtifactExport(\n arguments_,\n options.output === \"-\" ? process.stdout : undefined,\n );\n const description =\n metadata === undefined\n ? null\n : (JSON.parse(metadata) as ArtifactExportResult);\n return {\n path: arguments_.output === \"-\" ? null : arguments_.output,\n provenance: description?.provenance ?? null,\n };\n}\n\nexport async function writeArtifactOutput(\n output: ArtifactOutput,\n value: string | Uint8Array | AsyncIterable<Uint8Array>,\n): Promise<void> {\n const destination = new NodeWritable({\n write(chunk, _encoding, callback) {\n try {\n if (output instanceof NodeWritable) {\n output.write(chunk, callback);\n } else if (output.write(chunk)) {\n callback();\n } else {\n callback(\n new CodexSecurityError(\n \"The export stdout stream cannot report backpressure safely.\",\n ),\n );\n }\n } catch (error) {\n callback(error instanceof Error ? error : new Error(String(error)));\n }\n },\n });\n const forwardError = (error: Error): void => {\n destination.destroy(error);\n };\n if (output instanceof NodeWritable) output.once(\"error\", forwardError);\n try {\n await pipeline(\n typeof value === \"string\" || value instanceof Uint8Array\n ? [value]\n : value,\n destination,\n );\n } finally {\n if (output instanceof NodeWritable) {\n output.removeListener(\"error\", forwardError);\n }\n }\n}\n\nexport function exportEnvironment(\n environment: NodeJS.ProcessEnv = process.env,\n): NodeJS.ProcessEnv {\n return pythonUtf8Environment(\n Object.fromEntries(\n [\n \"PATH\",\n \"Path\",\n \"PATHEXT\",\n \"SystemRoot\",\n \"SYSTEMROOT\",\n \"WINDIR\",\n \"TMP\",\n \"TEMP\",\n \"TMPDIR\",\n \"PYTHON\",\n \"XDG_CACHE_HOME\",\n \"LANG\",\n \"LC_ALL\",\n \"LC_CTYPE\",\n ]\n .filter((key) => environment[key] !== undefined)\n .map((key) => [key, environment[key]]),\n ),\n );\n}\n"]}
|
|
1
|
+
{"version":3,"file":"artifact-export.js","sourceRoot":"","sources":["../src/artifact-export.ts"],"names":[],"mappings":"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","sourcesContent":["import { workbenchArgs } from \"./workbench-arguments.js\";\nimport { spawn } from \"node:child_process\";\nimport { realpath as callbackRealpath } from \"node:fs\";\nimport { lstat, realpath } from \"node:fs/promises\";\nimport { basename, dirname, join, relative, resolve } from \"node:path\";\nimport { Writable as NodeWritable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport { promisify } from \"node:util\";\nimport type { JsonObject } from \"./config.js\";\nimport { resolveConfigPath } from \"./config-path.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { relativePathIsOutside as isOutsidePath } from \"./targets.js\";\nimport { campaignCommandEnvironment } from \"./trusted-executable.js\";\nimport {\n type PluginPythonOptions,\n bundledPluginRoot,\n codexSecurityStateDirectory,\n expandHome,\n resolveInputPath,\n resolveParentTraversal,\n pythonUtf8Environment,\n resolvePluginPython,\n runWorkbench,\n} from \"./runtime.js\";\n\n// Bun's promise-based realpath can return drive-relative Windows roots.\nconst nativeRealpath = promisify(callbackRealpath.native);\n\nexport type ArtifactOutput = Pick<NodeJS.WriteStream, \"write\">;\n\nexport const ARTIFACT_EXPORT_FILENAMES = {\n csv: \"findings.csv\",\n \"servicenow-avit\": \"servicenow-avit.csv\",\n json: \"findings.json\",\n sarif: \"results.sarif\",\n md: \"threatmodel.md\",\n} as const;\nexport type ExportFormat = keyof typeof ARTIFACT_EXPORT_FILENAMES;\nexport type ExportArtifactKind = \"findings\" | \"threat-model\";\n\nexport interface ArtifactExportArguments {\n scanDir: string;\n artifact?: ExportArtifactKind;\n format: ExportFormat;\n output: string;\n sourceRoot?: string;\n avitTemplate?: string;\n pythonPath?: string;\n signal?: AbortSignal;\n includeMetadata?: boolean;\n noClobber?: boolean;\n}\n\nexport type ExportArtifactOptions = {\n source:\n | { directory: string; scanId?: never }\n | { scanId: string; directory?: never };\n output: string;\n pythonPath?: string;\n signal?: AbortSignal;\n} & (\n | {\n artifact: \"threat-model\";\n format?: \"md\";\n sourceRoot?: never;\n avitTemplate?: never;\n }\n | {\n artifact?: \"findings\";\n format?: \"csv\" | \"json\" | \"sarif\";\n sourceRoot?: string;\n avitTemplate?: never;\n }\n | {\n artifact?: \"findings\";\n format: \"servicenow-avit\";\n avitTemplate: string;\n sourceRoot?: never;\n }\n);\n\nexport interface ArtifactExportResult {\n path: string | null;\n provenance: JsonObject | null;\n}\n\ninterface HelperOptions {\n pythonPath?: string;\n protectedRoot?: PluginPythonOptions[\"protectedRoot\"];\n pluginRoot?: string;\n signal?: AbortSignal;\n output?: ArtifactOutput;\n failureMessage?: string;\n}\n\nexport async function artifactSourceProtectionRoots(\n sourceRoot: string | undefined,\n directory = process.cwd(),\n): Promise<string[] | undefined> {\n return (await resolveArtifactSource(sourceRoot, directory))?.protectedRoots;\n}\n\nasync function resolveArtifactSource(\n sourceRoot: string | undefined,\n directory = process.cwd(),\n) {\n if (sourceRoot === undefined) return;\n const path = await resolveParentTraversal(sourceRoot);\n return {\n path,\n protectedRoots: [\n ...new Set([directory, resolve(directory, sourceRoot), path]),\n ],\n };\n}\n\nexport function resolveArtifactFormat(\n artifact: ExportArtifactKind,\n format?: ExportFormat,\n avitTemplate?: string,\n): ExportFormat {\n const selected = format ?? (artifact === \"threat-model\" ? \"md\" : \"sarif\");\n if ((artifact === \"threat-model\") !== (selected === \"md\")) {\n throw new CodexSecurityError(\n artifact === \"threat-model\"\n ? \"Threat-model exports only support --export-format md.\"\n : \"Findings exports support --export-format csv, json, sarif, or servicenow-avit.\",\n );\n }\n if (selected === \"servicenow-avit\" && !avitTemplate) {\n throw new CodexSecurityError(\n \"--export-format servicenow-avit requires --avit-template.\",\n );\n }\n if (selected !== \"servicenow-avit\" && avitTemplate !== undefined) {\n throw new CodexSecurityError(\n \"--avit-template is only supported with --export-format servicenow-avit.\",\n );\n }\n return selected;\n}\n\nexport async function runArtifactHelper(\n args: readonly string[],\n options: HelperOptions = {},\n): Promise<{ stdout: string; stderr: string }> {\n const environment = exportEnvironment();\n const python = await resolvePluginPython({\n configuredPath: options.pythonPath,\n environment,\n protectedRoot: options.protectedRoot,\n signal: options.signal,\n });\n const plugin = options.pluginRoot ?? (await bundledPluginRoot());\n const invocation = spawn(\n python,\n [\n \"-I\",\n \"-X\",\n \"utf8\",\n \"-B\",\n join(plugin, \"scripts\", \"finalize_scan_contract.py\"),\n ...args,\n ],\n {\n env: (await campaignCommandEnvironment(environment)) ?? environment,\n stdio: [\"ignore\", \"pipe\", \"pipe\"],\n windowsHide: true,\n signal: options.signal,\n },\n );\n let stderr = \"\";\n let stdout = \"\";\n invocation.stderr.setEncoding(\"utf8\");\n invocation.stderr.on(\"data\", (chunk: string) => {\n stderr = `${stderr}${chunk}`.slice(-64 * 1024);\n });\n const forwarded =\n options.output === undefined\n ? (async () => {\n invocation.stdout.setEncoding(\"utf8\");\n for await (const chunk of invocation.stdout) stdout += chunk;\n })()\n : writeArtifactOutput(options.output, invocation.stdout);\n let status: number;\n try {\n [status] = await Promise.all([\n new Promise<number>((resolve, reject) => {\n invocation.once(\"error\", reject);\n invocation.once(\"close\", (code, signal) =>\n resolve(signal === null ? (code ?? 1) : 1),\n );\n }),\n forwarded,\n ]);\n } catch (error) {\n invocation.stdout.destroy();\n invocation.kill();\n throw error;\n }\n if (status !== 0) {\n const detail = stderr.trim().split(\"\\n\").at(-1);\n throw new CodexSecurityError(\n detail?.replace(/^finalize_scan_contract\\.py: error: /, \"\") ||\n options.failureMessage ||\n \"Could not export Codex Security artifacts.\",\n );\n }\n return { stdout, stderr };\n}\n\nexport async function writeThreatModel(\n directory: string,\n options: HelperOptions = {},\n): Promise<string> {\n const result = await runArtifactHelper(\n [\"--scan-dir\", directory, \"--write-threat-model\"],\n options,\n );\n return result.stderr.trim().replace(/^codex-security: warning: /u, \"\");\n}\n\n/** Read the current document path without making an optional projection required. */\nexport async function readThreatModelPath(\n directory: string,\n options: HelperOptions = {},\n): Promise<string | null> {\n try {\n options.signal?.throwIfAborted();\n const result = await runArtifactHelper(\n [\"--scan-dir\", directory, \"--describe-threat-model\"],\n options,\n );\n return (JSON.parse(result.stdout) as ArtifactExportResult).path;\n } catch {\n options.signal?.throwIfAborted();\n return null;\n }\n}\n\nexport async function runArtifactExport(\n arguments_: ArtifactExportArguments,\n output?: ArtifactOutput,\n diagnostics: ArtifactOutput = process.stderr,\n): Promise<string | undefined> {\n const artifact = arguments_.artifact ?? \"findings\";\n resolveArtifactFormat(artifact, arguments_.format, arguments_.avitTemplate);\n const source = await resolveArtifactSource(arguments_.sourceRoot);\n const result = await runArtifactHelper(\n [\n \"--scan-dir\",\n arguments_.scanDir,\n ...(artifact === \"findings\" ? [] : [\"--export-artifact\", artifact]),\n \"--export-format\",\n arguments_.format,\n ...(arguments_.avitTemplate === undefined\n ? []\n : [\"--avit-template\", arguments_.avitTemplate]),\n ...(arguments_.output === \"-\"\n ? []\n : [\"--export-output\", arguments_.output]),\n ...(source === undefined ? [] : [\"--source-root\", source.path]),\n ...(arguments_.includeMetadata ? [\"--export-metadata\"] : []),\n ...(arguments_.noClobber ? [\"--no-clobber\"] : []),\n ],\n {\n pythonPath: arguments_.pythonPath,\n protectedRoot: source?.protectedRoots,\n signal: arguments_.signal,\n failureMessage:\n artifact === \"findings\"\n ? `Could not export Codex Security findings as ${arguments_.format.toUpperCase()}.`\n : \"Could not export the saved threat model as Markdown.\",\n ...(arguments_.output === \"-\" && output !== undefined ? { output } : {}),\n },\n );\n if (arguments_.format === \"servicenow-avit\" && result.stderr) {\n diagnostics.write(result.stderr);\n }\n return (arguments_.output === \"-\" && output === undefined) ||\n arguments_.includeMetadata\n ? result.stdout\n : undefined;\n}\n\nexport async function resolveArtifactExportOutput(\n arguments_: ArtifactExportArguments,\n currentDirectory: string,\n): Promise<ArtifactExportArguments> {\n const scanDir = await resolveParentTraversal(arguments_.scanDir, {\n allowMissing: true,\n });\n const canonicalScan = await realpath(scanDir).catch(() => scanDir);\n const scanRelativeOutput = relative(scanDir, arguments_.output);\n const scanLocalOutput = join(\n \"exports\",\n ARTIFACT_EXPORT_FILENAMES[arguments_.format],\n );\n if (\n arguments_.output !== \"-\" &&\n !isOutsidePath(scanRelativeOutput) &&\n scanRelativeOutput !== scanLocalOutput\n ) {\n throw new CodexSecurityError(\n \"The export output path cannot overwrite a scan artifact.\",\n );\n }\n const outputPath =\n arguments_.output === \"-\"\n ? \"-\"\n : !isOutsidePath(scanRelativeOutput)\n ? join(canonicalScan, scanRelativeOutput)\n : join(\n await realpath(dirname(arguments_.output)).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\")\n throw new CodexSecurityError(\n `Export output directory does not exist: ${dirname(arguments_.output)}. Create the directory and retry.`,\n );\n throw error;\n },\n ),\n basename(arguments_.output),\n );\n if (arguments_.output !== \"-\") {\n const canonicalCurrent = await realpath(currentDirectory).catch(\n () => currentDirectory,\n );\n let traversedSymlink = false;\n let expectedOutput: string | undefined;\n for (\n let directory = dirname(arguments_.output);\n ;\n directory = dirname(directory)\n ) {\n const metadata = await lstat(directory).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\") return undefined;\n throw error;\n },\n );\n const canonicalDirectory =\n relative(currentDirectory, directory) === \"\"\n ? canonicalCurrent\n : metadata === undefined\n ? undefined\n : await nativeRealpath(directory);\n if (canonicalDirectory !== undefined) {\n expectedOutput ??= resolve(\n canonicalDirectory,\n relative(directory, arguments_.output),\n );\n if (\n !isOutsidePath(relative(canonicalCurrent, canonicalDirectory)) &&\n (traversedSymlink ||\n isOutsidePath(relative(canonicalCurrent, outputPath)) ||\n relative(expectedOutput, outputPath) !== \"\")\n ) {\n throw new CodexSecurityError(\n \"The export output path cannot traverse a repository symlink.\",\n );\n }\n }\n // An external alias may select the repository, but links below it are\n // repository-owned. Check ancestors before counting the current link.\n traversedSymlink ||= metadata?.isSymbolicLink() ?? false;\n if (\n relative(currentDirectory, directory) === \"\" ||\n dirname(directory) === directory\n )\n break;\n }\n }\n return {\n ...arguments_,\n scanDir: canonicalScan,\n output: outputPath,\n avitTemplate:\n arguments_.avitTemplate &&\n resolveConfigPath(currentDirectory, arguments_.avitTemplate),\n };\n}\n\n/** Resolve saved artifacts after the workbench validates their recorded identity. */\nexport async function resolveSavedArtifactDirectory(\n scanId: string,\n artifact: ExportArtifactKind,\n workbench: (args: readonly string[]) => Promise<JsonObject>,\n): Promise<string> {\n // Reuse the workbench's recorded digest and scan binding checks without\n // requiring a writable saved-scan directory for stdout or external exports.\n const context = await workbench(\n workbenchArgs(\"export-findings\", {\n scanId,\n artifact,\n validateOnly: true,\n }),\n );\n const scan = context[\"scan\"] as JsonObject | undefined;\n if (typeof scan?.[\"scanDir\"] !== \"string\")\n throw new CodexSecurityError(\n `Artifacts for scan ${scanId} are unavailable.`,\n );\n return resolve(expandHome(scan[\"scanDir\"]));\n}\n\n/** Export saved artifacts without authenticating or starting Codex. */\nexport async function exportArtifact(\n options: ExportArtifactOptions,\n): Promise<ArtifactExportResult> {\n const artifact = options.artifact ?? \"findings\";\n const format = resolveArtifactFormat(\n artifact,\n options.format,\n options.avitTemplate,\n );\n const sourceRoot =\n options.sourceRoot === undefined\n ? undefined\n : resolveInputPath(options.sourceRoot);\n const environment = {\n ...exportEnvironment(),\n CODEX_SECURITY_STATE_DIR: codexSecurityStateDirectory(),\n };\n let directory: string;\n if (options.source.directory !== undefined) {\n directory = resolveInputPath(options.source.directory);\n } else {\n const python = await resolvePluginPython({\n configuredPath: options.pythonPath,\n environment,\n protectedRoot: await artifactSourceProtectionRoots(sourceRoot),\n signal: options.signal,\n });\n const pluginRoot = await bundledPluginRoot();\n directory = await resolveSavedArtifactDirectory(\n options.source.scanId,\n artifact,\n (args) =>\n runWorkbench(\n {\n python,\n pluginRoot,\n environment,\n signal: options.signal,\n failureMessage: \"Could not export Codex Security scan artifacts\",\n },\n args,\n ),\n );\n }\n const arguments_ = await resolveArtifactExportOutput(\n {\n scanDir: directory,\n artifact,\n format,\n output:\n options.output === \"-\" ? \"-\" : resolve(expandHome(options.output)),\n pythonPath: options.pythonPath,\n signal: options.signal,\n includeMetadata: artifact === \"threat-model\" && options.output !== \"-\",\n avitTemplate: options.avitTemplate,\n sourceRoot,\n },\n process.cwd(),\n );\n const metadata = await runArtifactExport(\n arguments_,\n options.output === \"-\" ? process.stdout : undefined,\n );\n const description =\n metadata === undefined\n ? null\n : (JSON.parse(metadata) as ArtifactExportResult);\n return {\n path: arguments_.output === \"-\" ? null : arguments_.output,\n provenance: description?.provenance ?? null,\n };\n}\n\nexport async function writeArtifactOutput(\n output: ArtifactOutput,\n value: string | Uint8Array | AsyncIterable<Uint8Array>,\n): Promise<void> {\n const destination = new NodeWritable({\n write(chunk, _encoding, callback) {\n try {\n if (output instanceof NodeWritable) {\n output.write(chunk, callback);\n } else if (output.write(chunk)) {\n callback();\n } else {\n callback(\n new CodexSecurityError(\n \"The export stdout stream cannot report backpressure safely.\",\n ),\n );\n }\n } catch (error) {\n callback(error instanceof Error ? error : new Error(String(error)));\n }\n },\n });\n const forwardError = (error: Error): void => {\n destination.destroy(error);\n };\n if (output instanceof NodeWritable) output.once(\"error\", forwardError);\n try {\n await pipeline(\n typeof value === \"string\" || value instanceof Uint8Array\n ? [value]\n : value,\n destination,\n );\n } finally {\n if (output instanceof NodeWritable) {\n output.removeListener(\"error\", forwardError);\n }\n }\n}\n\nexport function exportEnvironment(\n environment: NodeJS.ProcessEnv = process.env,\n): NodeJS.ProcessEnv {\n return pythonUtf8Environment(\n Object.fromEntries(\n [\n \"PATH\",\n \"Path\",\n \"PATHEXT\",\n \"SystemRoot\",\n \"SYSTEMROOT\",\n \"WINDIR\",\n \"TMP\",\n \"TEMP\",\n \"TMPDIR\",\n \"PYTHON\",\n \"XDG_CACHE_HOME\",\n \"LANG\",\n \"LC_ALL\",\n \"LC_CTYPE\",\n ]\n .filter((key) => environment[key] !== undefined)\n .map((key) => [key, environment[key]]),\n ),\n );\n}\n"]}
|
package/dist/auth.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type JsonObject } from "./config.js";
|
|
1
2
|
import { runCodexCommand, type CodexCommand, type ProcessEnvironment } from "./runtime.js";
|
|
2
3
|
export interface LoginResult extends Awaited<ReturnType<typeof runCodexCommand>> {
|
|
3
4
|
}
|
|
@@ -7,7 +8,7 @@ export interface AccountStatus {
|
|
|
7
8
|
}
|
|
8
9
|
export declare class CodexLoginHandle {
|
|
9
10
|
#private;
|
|
10
|
-
constructor(command: CodexCommand, args: readonly string[], environment: ProcessEnvironment, onSuccess: () => void | Promise<void>);
|
|
11
|
+
constructor(command: CodexCommand, args: readonly string[], environment: ProcessEnvironment, onSuccess: () => void | Promise<void>, onFinish?: () => Promise<void>);
|
|
11
12
|
get loginId(): null;
|
|
12
13
|
get authUrl(): string | null;
|
|
13
14
|
get verificationUrl(): string | null;
|
|
@@ -20,5 +21,8 @@ export declare class CodexLoginHandle {
|
|
|
20
21
|
}
|
|
21
22
|
export declare function loginApiKey(command: CodexCommand, environment: ProcessEnvironment, apiKey: string, signal?: AbortSignal): Promise<LoginResult>;
|
|
22
23
|
export declare function accountStatus(command: CodexCommand, environment: ProcessEnvironment, signal?: AbortSignal): Promise<AccountStatus>;
|
|
23
|
-
export declare function
|
|
24
|
+
export declare function nativeLogoutArgs(store?: string): string[];
|
|
25
|
+
export declare function logout(command: CodexCommand, environment: ProcessEnvironment, signal?: AbortSignal, store?: string): Promise<void>;
|
|
26
|
+
/** Prepare native login under the credential-home lock, preserving unrelated settings. */
|
|
27
|
+
export declare function prepareLoginConfig(credentialHome: string, requested: JsonObject): Promise<void>;
|
|
24
28
|
//# sourceMappingURL=auth.d.ts.map
|
package/dist/auth.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAMA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAMtE,OAAO,EAIL,eAAe,EAEf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAgEtB,MAAM,WAAW,WAAY,SAAQ,OAAO,CAC1C,UAAU,CAAC,OAAO,eAAe,CAAC,CACnC;CAAG;AAEJ,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;;IAkB3B,YACE,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAqD/B;IAED,IAAW,OAAO,IAAI,IAAI,CAEzB;IAED,IAAW,OAAO,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,IAAW,eAAe,IAAI,MAAM,GAAG,IAAI,CAE1C;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAEY,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAExC;IAEY,mBAAmB,CAC9B,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC,CAGf;IAEM,MAAM,IAAI,IAAI,CAoBpB;CA2CF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzD;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,IAAI,CAAC,CAcf"}
|
package/dist/auth.js
CHANGED
|
@@ -4,9 +4,9 @@ import { readFile } from "node:fs/promises";
|
|
|
4
4
|
import { homedir } from "node:os";
|
|
5
5
|
import { join, resolve } from "node:path";
|
|
6
6
|
import { parse } from "smol-toml";
|
|
7
|
-
import {
|
|
7
|
+
import { CODEX_AUTH_CONFIG_KEYS } from "./config.js";
|
|
8
8
|
import { CodexSecurityError, PluginBootstrapError, errorMessage, } from "./errors.js";
|
|
9
|
-
import { executablePathForSpawn, expandHome, runCodexCommand, } from "./runtime.js";
|
|
9
|
+
import { beginCredentialLogin, executablePathForSpawn, expandHome, runCodexCommand, writeCredentialHomeConfig, } from "./runtime.js";
|
|
10
10
|
const LOGIN_CHILD_TERMINATION_GRACE_MS = 1_000;
|
|
11
11
|
/** @internal */
|
|
12
12
|
export function environmentEntry(environment, requested) {
|
|
@@ -18,9 +18,7 @@ export function environmentEntry(environment, requested) {
|
|
|
18
18
|
}
|
|
19
19
|
/** @internal */
|
|
20
20
|
export function withoutOpenAiApiKeys(environment) {
|
|
21
|
-
|
|
22
|
-
forwardExternalImportSetting(environment, child);
|
|
23
|
-
return child;
|
|
21
|
+
return Object.fromEntries(Object.entries(environment).filter(([name]) => !["OPENAI_API_KEY", "CODEX_API_KEY"].includes(name.toUpperCase())));
|
|
24
22
|
}
|
|
25
23
|
/** @internal */
|
|
26
24
|
export function configuredCodexHome(environment) {
|
|
@@ -29,17 +27,18 @@ export function configuredCodexHome(environment) {
|
|
|
29
27
|
}
|
|
30
28
|
/** @internal */
|
|
31
29
|
export async function readCodexHomeConfig(environment, signal) {
|
|
30
|
+
const path = join(configuredCodexHome(environment), "config.toml");
|
|
32
31
|
try {
|
|
33
|
-
return parse(await readFile(
|
|
32
|
+
return parse(await readFile(path, {
|
|
34
33
|
encoding: "utf8",
|
|
35
34
|
signal,
|
|
36
|
-
}));
|
|
35
|
+
}), { integersAsBigInt: "asNeeded" });
|
|
37
36
|
}
|
|
38
37
|
catch (error) {
|
|
39
38
|
signal?.throwIfAborted();
|
|
40
39
|
if (error.code === "ENOENT")
|
|
41
40
|
return {};
|
|
42
|
-
throw new CodexSecurityError(`Could not read the configured Codex provider: ${errorMessage(error)}`, { cause: error });
|
|
41
|
+
throw new CodexSecurityError(`Could not read the configured Codex provider from ${path}: ${errorMessage(error)}`, { cause: error });
|
|
43
42
|
}
|
|
44
43
|
}
|
|
45
44
|
export class CodexLoginHandle {
|
|
@@ -59,7 +58,7 @@ export class CodexLoginHandle {
|
|
|
59
58
|
stdout: null,
|
|
60
59
|
stderr: null,
|
|
61
60
|
};
|
|
62
|
-
constructor(command, args, environment, onSuccess) {
|
|
61
|
+
constructor(command, args, environment, onSuccess, onFinish) {
|
|
63
62
|
void this.#urlReady.promise.catch(() => undefined);
|
|
64
63
|
void this.#deviceReady.promise.catch(() => undefined);
|
|
65
64
|
this.#child = spawn(executablePathForSpawn(command.command), [...(command.args ?? []), ...args], {
|
|
@@ -107,7 +106,7 @@ export class CodexLoginHandle {
|
|
|
107
106
|
});
|
|
108
107
|
reject(error);
|
|
109
108
|
});
|
|
110
|
-
});
|
|
109
|
+
}).finally(onFinish);
|
|
111
110
|
}
|
|
112
111
|
get loginId() {
|
|
113
112
|
return null;
|
|
@@ -203,18 +202,38 @@ export async function accountStatus(command, environment, signal) {
|
|
|
203
202
|
details,
|
|
204
203
|
};
|
|
205
204
|
}
|
|
206
|
-
export
|
|
207
|
-
|
|
205
|
+
export function nativeLogoutArgs(store) {
|
|
206
|
+
return store === undefined
|
|
207
|
+
? ["logout"]
|
|
208
|
+
: ["-c", `cli_auth_credentials_store=${JSON.stringify(store)}`, "logout"];
|
|
209
|
+
}
|
|
210
|
+
export async function logout(command, environment, signal, store) {
|
|
211
|
+
const result = await runCodexCommand(command, nativeLogoutArgs(store), environment, undefined, signal);
|
|
208
212
|
if (!result.success) {
|
|
209
213
|
throw new PluginBootstrapError(`Codex logout failed: ${result.stderr.trim() || result.stdout.trim() || "unknown error"}`);
|
|
210
214
|
}
|
|
211
215
|
}
|
|
212
|
-
/**
|
|
213
|
-
export
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
];
|
|
216
|
+
/** Prepare native login under the credential-home lock, preserving unrelated settings. */
|
|
217
|
+
export async function prepareLoginConfig(credentialHome, requested) {
|
|
218
|
+
const config = await readCodexHomeConfig({ CODEX_HOME: credentialHome });
|
|
219
|
+
let changed = false;
|
|
220
|
+
for (const key of CODEX_AUTH_CONFIG_KEYS) {
|
|
221
|
+
const value = requested[key];
|
|
222
|
+
// Keep existing users in their native store until they select another.
|
|
223
|
+
if (key === "cli_auth_credentials_store" && value === undefined)
|
|
224
|
+
continue;
|
|
225
|
+
if (config[key] === value)
|
|
226
|
+
continue;
|
|
227
|
+
if (value === undefined)
|
|
228
|
+
delete config[key];
|
|
229
|
+
else
|
|
230
|
+
config[key] = value;
|
|
231
|
+
changed = true;
|
|
232
|
+
}
|
|
233
|
+
if (changed)
|
|
234
|
+
await writeCredentialHomeConfig(credentialHome, config);
|
|
235
|
+
await beginCredentialLogin(credentialHome);
|
|
236
|
+
}
|
|
218
237
|
/** @internal Shared login recovery guidance for model commands. */
|
|
219
238
|
export const NO_CREDENTIALS_MESSAGE = "No credentials were found. Run 'codex-security login'. On a remote or headless " +
|
|
220
239
|
"machine, use 'codex-security login --device-auth' if your workspace allows it. " +
|