@openai/codex-security 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/README.md +45 -9
  2. package/_bundled_plugin/.codex-plugin/plugin.json +5 -5
  3. package/_bundled_plugin/.mcp.json +1 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  5. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  6. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  7. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +13 -20
  8. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  9. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  10. package/_bundled_plugin/references/core-scan.md +2 -0
  11. package/_bundled_plugin/references/final-report.md +5 -1
  12. package/_bundled_plugin/references/investigation-time-budget.md +11 -0
  13. package/_bundled_plugin/references/sarif-adapter.md +1 -0
  14. package/_bundled_plugin/references/scan-prologue.md +2 -6
  15. package/_bundled_plugin/references/scan-runtime.md +15 -0
  16. package/_bundled_plugin/references/threat-model.md +2 -0
  17. package/_bundled_plugin/schemas/coverage.schema.json +45 -126
  18. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +5 -1
  19. package/_bundled_plugin/schemas/findings.schema.json +140 -427
  20. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  21. package/_bundled_plugin/schemas/scan-manifest.schema.json +73 -188
  22. package/_bundled_plugin/scripts/deep_scan_workbench.py +7 -0
  23. package/_bundled_plugin/scripts/finalize_scan_contract.py +87 -49
  24. package/_bundled_plugin/scripts/finding_preview.py +5 -3
  25. package/_bundled_plugin/scripts/generate_rank_input.py +26 -106
  26. package/_bundled_plugin/scripts/launch_codex_security_mcp +39 -4
  27. package/_bundled_plugin/scripts/report_projection.py +35 -13
  28. package/_bundled_plugin/scripts/snapshot_sqlite.py +7 -0
  29. package/_bundled_plugin/scripts/windows_scan_local_files.py +43 -1
  30. package/_bundled_plugin/scripts/workbench_cli.py +9 -9
  31. package/_bundled_plugin/scripts/workbench_constants.py +4 -0
  32. package/_bundled_plugin/scripts/workbench_db.py +103 -45
  33. package/_bundled_plugin/scripts/workbench_progress.py +0 -50
  34. package/_bundled_plugin/scripts/workbench_publication.py +216 -247
  35. package/_bundled_plugin/scripts/workbench_scan_history.py +3 -2
  36. package/_bundled_plugin/scripts/workbench_scan_start.py +12 -4
  37. package/_bundled_plugin/scripts/workbench_scan_usage.py +360 -37
  38. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  39. package/_bundled_plugin/scripts/workbench_source_excerpt.py +74 -51
  40. package/_bundled_plugin/scripts/workbench_source_scopes.py +388 -0
  41. package/_bundled_plugin/scripts/workbench_target.py +7 -5
  42. package/_bundled_plugin/scripts/workbench_validation.py +52 -2
  43. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -0
  44. package/_bundled_plugin/shared/workbench-migrations.json +22 -0
  45. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +1 -1
  46. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  47. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +4 -2
  48. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  49. package/_bundled_plugin/skills/security-scan/SKILL.md +4 -2
  50. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  51. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -3
  52. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +2 -0
  53. package/_bundled_plugin/skills/track-findings/SKILL.md +8 -4
  54. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  55. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +1 -1
  56. package/dist/api.d.ts +6 -2
  57. package/dist/api.d.ts.map +1 -1
  58. package/dist/api.js +266 -39
  59. package/dist/api.js.map +1 -1
  60. package/dist/artifact-export.d.ts +2 -1
  61. package/dist/artifact-export.d.ts.map +1 -1
  62. package/dist/artifact-export.js +38 -23
  63. package/dist/artifact-export.js.map +1 -1
  64. package/dist/classify-severity-records.d.ts +76 -0
  65. package/dist/classify-severity-records.d.ts.map +1 -0
  66. package/dist/classify-severity-records.js +141 -0
  67. package/dist/classify-severity-records.js.map +1 -0
  68. package/dist/classify-severity.d.ts +1 -23
  69. package/dist/classify-severity.d.ts.map +1 -1
  70. package/dist/classify-severity.js +3 -24
  71. package/dist/classify-severity.js.map +1 -1
  72. package/dist/cli-help.d.ts.map +1 -1
  73. package/dist/cli-help.js +2 -0
  74. package/dist/cli-help.js.map +1 -1
  75. package/dist/cli.d.ts +4 -2
  76. package/dist/cli.d.ts.map +1 -1
  77. package/dist/cli.js +148 -149
  78. package/dist/cli.js.map +1 -1
  79. package/dist/cloud-publish.js +1 -1
  80. package/dist/cloud-publish.js.map +1 -1
  81. package/dist/codex-sdk-environment.js +1 -1
  82. package/dist/codex-sdk-environment.js.map +1 -1
  83. package/dist/component-plan.js +1 -1
  84. package/dist/component-plan.js.map +1 -1
  85. package/dist/component-scan.d.ts.map +1 -1
  86. package/dist/component-scan.js +5 -4
  87. package/dist/component-scan.js.map +1 -1
  88. package/dist/config.d.ts +12 -0
  89. package/dist/config.d.ts.map +1 -1
  90. package/dist/config.js +10 -4
  91. package/dist/config.js.map +1 -1
  92. package/dist/contract.d.ts +6 -0
  93. package/dist/contract.d.ts.map +1 -1
  94. package/dist/contract.js +69 -20
  95. package/dist/contract.js.map +1 -1
  96. package/dist/cost-model.d.ts.map +1 -1
  97. package/dist/cost-model.js +7 -2
  98. package/dist/cost-model.js.map +1 -1
  99. package/dist/custom-validation-prompt.js +3 -3
  100. package/dist/custom-validation-prompt.js.map +1 -1
  101. package/dist/deduplication/codex-review.d.ts +1 -5
  102. package/dist/deduplication/codex-review.d.ts.map +1 -1
  103. package/dist/deduplication/codex-review.js +2 -2
  104. package/dist/deduplication/codex-review.js.map +1 -1
  105. package/dist/deduplication/deduplication-prompts.d.ts +1 -1
  106. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  107. package/dist/deduplication/deduplication-prompts.js +2 -2
  108. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  109. package/dist/deduplication/deduplication-reviewer.d.ts +1 -1
  110. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  111. package/dist/deduplication/deduplication-reviewer.js +1 -1
  112. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  113. package/dist/deduplication/records-protocol.d.ts +3 -8
  114. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  115. package/dist/deduplication/records-protocol.js +11 -171
  116. package/dist/deduplication/records-protocol.js.map +1 -1
  117. package/dist/deduplication/records.js +1 -1
  118. package/dist/deduplication/records.js.map +1 -1
  119. package/dist/deduplication/scan.d.ts.map +1 -1
  120. package/dist/deduplication/scan.js +10 -9
  121. package/dist/deduplication/scan.js.map +1 -1
  122. package/dist/deep-config.d.ts +4 -1
  123. package/dist/deep-config.d.ts.map +1 -1
  124. package/dist/deep-config.js +21 -1
  125. package/dist/deep-config.js.map +1 -1
  126. package/dist/deep-progress.d.ts +15 -1
  127. package/dist/deep-progress.d.ts.map +1 -1
  128. package/dist/deep-progress.js +15 -16
  129. package/dist/deep-progress.js.map +1 -1
  130. package/dist/executable-path.d.ts +2 -0
  131. package/dist/executable-path.d.ts.map +1 -0
  132. package/dist/executable-path.js +12 -0
  133. package/dist/executable-path.js.map +1 -0
  134. package/dist/feedback.d.ts +1 -4
  135. package/dist/feedback.d.ts.map +1 -1
  136. package/dist/feedback.js +1 -1
  137. package/dist/feedback.js.map +1 -1
  138. package/dist/findings-import.d.ts +1 -1
  139. package/dist/findings-import.d.ts.map +1 -1
  140. package/dist/findings-import.js +3 -3
  141. package/dist/findings-import.js.map +1 -1
  142. package/dist/git-remote.d.ts +10 -0
  143. package/dist/git-remote.d.ts.map +1 -0
  144. package/dist/git-remote.js +24 -0
  145. package/dist/git-remote.js.map +1 -0
  146. package/dist/github.d.ts.map +1 -1
  147. package/dist/github.js +5 -7
  148. package/dist/github.js.map +1 -1
  149. package/dist/host-protocol.d.ts +19 -0
  150. package/dist/host-protocol.d.ts.map +1 -0
  151. package/dist/host-protocol.js +270 -0
  152. package/dist/host-protocol.js.map +1 -0
  153. package/dist/host-records-protocol.d.ts +15 -0
  154. package/dist/host-records-protocol.d.ts.map +1 -0
  155. package/dist/host-records-protocol.js +15 -0
  156. package/dist/host-records-protocol.js.map +1 -0
  157. package/dist/hosted-scan-protocol.d.ts +4 -0
  158. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  159. package/dist/hosted-scan-protocol.js +25 -0
  160. package/dist/hosted-scan-protocol.js.map +1 -0
  161. package/dist/hosted-scan.d.ts +112 -0
  162. package/dist/hosted-scan.d.ts.map +1 -0
  163. package/dist/hosted-scan.js +260 -0
  164. package/dist/hosted-scan.js.map +1 -0
  165. package/dist/index.d.ts +7 -0
  166. package/dist/index.d.ts.map +1 -1
  167. package/dist/index.js +3 -0
  168. package/dist/index.js.map +1 -1
  169. package/dist/knowledge-base.d.ts.map +1 -1
  170. package/dist/knowledge-base.js +87 -7
  171. package/dist/knowledge-base.js.map +1 -1
  172. package/dist/multiscan.d.ts.map +1 -1
  173. package/dist/multiscan.js +108 -36
  174. package/dist/multiscan.js.map +1 -1
  175. package/dist/patch-publication.d.ts +26 -0
  176. package/dist/patch-publication.d.ts.map +1 -0
  177. package/dist/patch-publication.js +105 -0
  178. package/dist/patch-publication.js.map +1 -0
  179. package/dist/patch-tui.d.ts.map +1 -1
  180. package/dist/patch-tui.js +4 -1
  181. package/dist/patch-tui.js.map +1 -1
  182. package/dist/project-config-schema.d.ts +2 -0
  183. package/dist/project-config-schema.d.ts.map +1 -1
  184. package/dist/project-config-schema.js +1 -0
  185. package/dist/project-config-schema.js.map +1 -1
  186. package/dist/project-config.d.ts +1 -0
  187. package/dist/project-config.d.ts.map +1 -1
  188. package/dist/project-config.js +16 -6
  189. package/dist/project-config.js.map +1 -1
  190. package/dist/publication-store.d.ts.map +1 -1
  191. package/dist/publication-store.js +73 -63
  192. package/dist/publication-store.js.map +1 -1
  193. package/dist/publication.d.ts +0 -2
  194. package/dist/publication.d.ts.map +1 -1
  195. package/dist/publication.js +135 -24
  196. package/dist/publication.js.map +1 -1
  197. package/dist/publish.d.ts.map +1 -1
  198. package/dist/publish.js +39 -25
  199. package/dist/publish.js.map +1 -1
  200. package/dist/runtime.d.ts +5 -2
  201. package/dist/runtime.d.ts.map +1 -1
  202. package/dist/runtime.js +86 -58
  203. package/dist/runtime.js.map +1 -1
  204. package/dist/scan-executor.d.ts +104 -0
  205. package/dist/scan-executor.d.ts.map +1 -0
  206. package/dist/scan-executor.js +62 -0
  207. package/dist/scan-executor.js.map +1 -0
  208. package/dist/scan-settings.d.ts +1 -0
  209. package/dist/scan-settings.d.ts.map +1 -1
  210. package/dist/scan-settings.js +7 -1
  211. package/dist/scan-settings.js.map +1 -1
  212. package/dist/scan-time-budget.d.ts +9 -0
  213. package/dist/scan-time-budget.d.ts.map +1 -0
  214. package/dist/scan-time-budget.js +16 -0
  215. package/dist/scan-time-budget.js.map +1 -0
  216. package/dist/severity-review.d.ts +29 -0
  217. package/dist/severity-review.d.ts.map +1 -0
  218. package/dist/severity-review.js +47 -0
  219. package/dist/severity-review.js.map +1 -0
  220. package/dist/targets.d.ts.map +1 -1
  221. package/dist/targets.js +17 -25
  222. package/dist/targets.js.map +1 -1
  223. package/dist/validation-records.d.ts +38 -0
  224. package/dist/validation-records.d.ts.map +1 -0
  225. package/dist/validation-records.js +76 -0
  226. package/dist/validation-records.js.map +1 -0
  227. package/dist/version.d.ts.map +1 -1
  228. package/dist/version.js +4 -2
  229. package/dist/version.js.map +1 -1
  230. package/dist/worker-progress.d.ts +43 -15
  231. package/dist/worker-progress.d.ts.map +1 -1
  232. package/dist/worker-progress.js +22 -80
  233. package/dist/worker-progress.js.map +1 -1
  234. package/docs/classify-severity-records.md +89 -0
  235. package/docs/cli.md +281 -35
  236. package/docs/hosted-scans.md +242 -0
  237. package/docs/validate-records.md +69 -0
  238. package/package.json +18 -14
  239. package/schemas/hosted-scan-v2.fixture.json +145 -0
  240. package/schemas/project-config.schema.json +7 -1
  241. package/_bundled_plugin/preflight/capability-profiles.toml +0 -76
  242. package/_bundled_plugin/references/config-preflight.md +0 -93
  243. package/_bundled_plugin/references/desktop-config-preflight.md +0 -11
  244. package/_bundled_plugin/scripts/config_preflight.py +0 -911
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, open, rename, unlink } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { CyberAccessProgram } from \"@openai/codex-sdk\";\nimport { parse, stringify } from \"smol-toml\";\nimport { ConfigurationError } from \"./errors.js\";\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonValue[] | JsonObject;\nexport interface JsonObject {\n [key: string]: JsonValue;\n}\n\nexport interface CodexSecurityConfig {\n pluginPath?: string;\n codexOverrides?: JsonObject;\n pythonPath?: string;\n}\n\nexport interface ScanModelConfiguration {\n model: string;\n reasoningEffort: string;\n}\n\nexport const OPENROUTER_CODEX_PROVIDER = {\n name: \"OpenRouter\",\n base_url: \"https://openrouter.ai/api/v1\",\n env_key: \"OPENROUTER_API_KEY\",\n wire_api: \"responses\",\n} as const satisfies JsonObject;\n\nexport const FIREWORKS_CODEX_PROVIDER = {\n name: \"Fireworks AI\",\n base_url: \"https://api.fireworks.ai/inference/v1\",\n env_key: \"FIREWORKS_API_KEY\",\n wire_api: \"responses\",\n} as const satisfies JsonObject;\n\nexport const EXTERNAL_CODEX_PROVIDERS = {\n openrouter: OPENROUTER_CODEX_PROVIDER,\n fireworks: FIREWORKS_CODEX_PROVIDER,\n} as const;\n\nexport type ExternalModelProvider = keyof typeof EXTERNAL_CODEX_PROVIDERS;\n\nexport function isExternalModelProvider(\n provider: unknown,\n): provider is ExternalModelProvider {\n return (\n typeof provider === \"string\" &&\n Object.hasOwn(EXTERNAL_CODEX_PROVIDERS, provider)\n );\n}\n\nexport const DEFAULT_CODEX_CONFIG: Readonly<JsonObject> = Object.freeze({\n approval_policy: \"on-request\",\n approvals_reviewer: \"auto_review\",\n cli_auth_credentials_store: \"auto\",\n model: \"gpt-5.6-sol\",\n model_reasoning_effort: \"xhigh\",\n model_reasoning_summary: \"detailed\",\n show_raw_agent_reasoning: true,\n features: Object.freeze({\n plugins: true,\n goals: true,\n multi_agent_v2: Object.freeze({\n enabled: true,\n max_concurrent_threads_per_session: 9,\n }),\n }),\n // Credential read denials require the elevated Windows sandbox backend.\n windows: Object.freeze({\n sandbox: \"elevated\",\n }),\n});\n\nexport function scanModelConfiguration(\n config: Readonly<JsonObject>,\n): ScanModelConfiguration {\n const selectedProfile = selectedScanProfile(config);\n const model = scanModel(config);\n if (typeof model !== \"string\" || model.trim().length === 0) {\n throw new ConfigurationError(\n \"The configured Codex model must be a nonempty string.\",\n );\n }\n const reasoningEffort =\n selectedProfile?.[\"model_reasoning_effort\"] ??\n config[\"model_reasoning_effort\"];\n if (\n typeof reasoningEffort !== \"string\" ||\n reasoningEffort.trim().length === 0\n ) {\n throw new ConfigurationError(\n \"The configured Codex reasoning effort must be a nonempty string.\",\n );\n }\n return { model, reasoningEffort };\n}\n\nexport function scanModel(config: Readonly<JsonObject>): unknown {\n const selectedProfile = selectedScanProfile(config);\n return selectedProfile?.[\"model\"] ?? config[\"model\"];\n}\n\nexport function scanModelProvider(config: Readonly<JsonObject>): unknown {\n const selectedProfile = selectedScanProfile(config);\n return selectedProfile?.[\"model_provider\"] ?? config[\"model_provider\"];\n}\n\n/** @internal Native Codex validates the auth table, including invalid selections. */\nexport function hasCommandAuth(config: Readonly<JsonObject>): boolean {\n const selected = scanModelProvider(config);\n const providers = resolveCodexProfile(config)[\"model_providers\"];\n const provider =\n typeof selected === \"string\" && isObject(providers)\n ? providers[selected]\n : undefined;\n return isObject(provider) && provider[\"auth\"] != null;\n}\n\n/** @internal Keep host-side helpers independent of the source checkout. */\nexport function resolveCommandAuthConfig(\n config: JsonObject,\n home: string,\n): JsonObject {\n const resolved = structuredClone(config);\n const providers = resolveCodexProfile(resolved)[\"model_providers\"];\n if (isObject(providers)) {\n (selectedScanProfile(resolved) ?? resolved)[\"model_providers\"] = providers;\n for (const provider of Object.values(providers)) {\n if (!isObject(provider) || !isObject(provider[\"auth\"])) continue;\n const auth = provider[\"auth\"];\n const cwd = auth[\"cwd\"];\n if (\n cwd == null ||\n (typeof cwd === \"string\" && !/^~(?:[/\\\\]|$)/u.test(cwd))\n ) {\n auth[\"cwd\"] = resolve(home, cwd ?? \".\");\n }\n }\n }\n return resolved;\n}\n\n/** @internal CLI dotted keys cannot represent provider IDs containing dots. */\nexport function modelProviderConfigOverride(config: JsonObject): string[] {\n return config[\"model_providers\"] == null\n ? []\n : [`model_providers=${inlineToml(config[\"model_providers\"])}`];\n}\n\n/** @internal Resolve settings; literal-key tables use native file layers. */\nexport function structuredCodexConfig(config: JsonObject = {}): JsonObject {\n const structured = resolveCodexProfile(config);\n delete structured[\"projects\"];\n delete structured[\"permissions\"];\n delete structured[\"model_providers\"];\n return structured;\n}\n\n/** @internal Serialize one Codex CLI override value without flattening its keys. */\nexport function inlineToml(value: JsonValue): string {\n if (value === null)\n throw new ConfigurationError(\n \"Codex TOML overrides cannot contain null values.\",\n );\n if (Array.isArray(value)) return `[${value.map(inlineToml).join(\",\")}]`;\n if (isObject(value)) {\n return `{${Object.entries(value)\n .filter(([, item]) => item !== null)\n .map(([key, item]) => `${JSON.stringify(key)}=${inlineToml(item)}`)\n .join(\",\")}}`;\n }\n return stringify({ value }).slice(\"value = \".length).trim();\n}\n\nexport function scanApprovalPolicy(\n config: Readonly<JsonObject>,\n): \"never\" | \"on-request\" {\n return config[\"approval_policy\"] === \"never\" ||\n selectedScanProfile(config)?.[\"approval_policy\"] === \"never\"\n ? \"never\"\n : \"on-request\";\n}\n\nfunction selectedScanProfile(\n config: Readonly<JsonObject>,\n): Record<string, JsonValue> | undefined {\n const profileName = config[\"profile\"];\n const profiles = config[\"profiles\"];\n const configuredProfile =\n typeof profileName === \"string\" &&\n isObject(profiles) &&\n Object.hasOwn(profiles, profileName)\n ? profiles[profileName]\n : undefined;\n return isObject(configuredProfile) ? configuredProfile : undefined;\n}\n\nexport function resolveCodexProfile(config: JsonObject): JsonObject {\n const normalized = parse(stringify(config)) as JsonObject;\n const resolved = deepMerge(normalized, selectedScanProfile(normalized) ?? {});\n delete resolved[\"profile\"];\n delete resolved[\"profiles\"];\n return resolved;\n}\n\n/** @internal */\nexport function scanCyberAccessConfig(\n config: JsonObject,\n program: CyberAccessProgram | undefined,\n): JsonObject {\n if (program === undefined) return config;\n const resolved = resolveCodexProfile(config);\n const features = isObject(resolved[\"features\"]) ? resolved[\"features\"] : {};\n return {\n ...config,\n features: {\n ...(isObject(config[\"features\"]) ? config[\"features\"] : {}),\n // Explicit selections opt in to upstream API-key support. Keep a user's\n // explicit disable so Codex can report it instead of silently dropping it.\n api_key_cyber_access_programs:\n features[\"api_key_cyber_access_programs\"] ?? true,\n },\n };\n}\n\nexport async function mergedCodexConfig(\n config: CodexSecurityConfig,\n): Promise<JsonObject> {\n if (config.codexOverrides !== undefined && !isObject(config.codexOverrides)) {\n throw new ConfigurationError(\"codexOverrides must be an object.\");\n }\n validateOverrideKeys(config.codexOverrides ?? {});\n const overrides = structuredClone(config.codexOverrides ?? {});\n validateOverrides(overrides);\n const agents = overrides[\"agents\"];\n if (isObject(agents) && \"max_threads\" in agents) {\n throw new ConfigurationError(\n \"The selected Codex Security plugin requires native multi-agent v2; \" +\n \"agents.max_threads is a legacy v1 setting. Use \" +\n \"features.multi_agent_v2.max_concurrent_threads_per_session instead.\",\n );\n }\n const features = overrides[\"features\"];\n if (isObject(features) && \"multi_agent_v2\" in features) {\n const multiAgentV2 = features[\"multi_agent_v2\"];\n if (!isObject(multiAgentV2)) {\n throw new ConfigurationError(\n \"The selected Codex Security plugin requires native multi-agent v2; \" +\n \"features.multi_agent_v2 must remain a table with enabled = true.\",\n );\n }\n if (\"enabled\" in multiAgentV2 && multiAgentV2[\"enabled\"] !== true) {\n throw new ConfigurationError(\n \"The selected Codex Security plugin requires native multi-agent v2; \" +\n \"features.multi_agent_v2.enabled cannot be disabled.\",\n );\n }\n }\n\n const profiles = Object.entries(\n (overrides[\"profiles\"] ?? {}) as Record<string, JsonObject>,\n );\n for (const [name, profile] of profiles) {\n const profileAgents = profile[\"agents\"];\n if (isObject(profileAgents) && \"max_threads\" in profileAgents) {\n throw new ConfigurationError(\n `The selected Codex Security plugin requires native multi-agent v2; profile ${name} agents.max_threads is a legacy v1 setting.`,\n );\n }\n const profileFeatures = profile[\"features\"];\n if (!isObject(profileFeatures) || !(\"multi_agent_v2\" in profileFeatures)) {\n continue;\n }\n const profileV2 = profileFeatures[\"multi_agent_v2\"];\n if (\n !isObject(profileV2) ||\n (\"enabled\" in profileV2 && profileV2[\"enabled\"] !== true)\n ) {\n throw new ConfigurationError(\n `The selected Codex Security plugin requires native multi-agent v2; profile ${name} features.multi_agent_v2 cannot be disabled.`,\n );\n }\n }\n normalizeLegacyWindowsSandboxOverride(overrides);\n for (const [, profile] of profiles) {\n normalizeLegacyWindowsSandboxOverride(profile);\n }\n const defaults: JsonObject = structuredClone(DEFAULT_CODEX_CONFIG);\n if (scanModelProvider(overrides) === \"amazon-bedrock\") {\n // Bedrock models can reject reasoning.summary before the scan starts.\n defaults[\"model_reasoning_summary\"] = \"none\";\n }\n return deepMerge(defaults, overrides);\n}\n\n/** @internal Preserve existing native Windows backend selections. */\nexport function normalizeLegacyWindowsSandboxOverride(\n overrides: JsonObject,\n): void {\n const features = overrides[\"features\"];\n if (!isObject(features)) {\n return;\n }\n const elevated = features[\"elevated_windows_sandbox\"];\n if (typeof elevated !== \"boolean\") {\n return;\n }\n const windows = overrides[\"windows\"];\n if (\n windows !== undefined &&\n (!isObject(windows) || Object.hasOwn(windows, \"sandbox\"))\n ) {\n return;\n }\n overrides[\"windows\"] = {\n ...(isObject(windows) ? windows : {}),\n sandbox: elevated ? \"elevated\" : \"unelevated\",\n };\n}\n\nexport async function writeCodexConfig(\n path: string,\n config: JsonObject,\n): Promise<void> {\n const parent = dirname(path);\n await mkdir(parent, { recursive: true, mode: 0o700 });\n let contents: string;\n try {\n contents = stringify(config);\n } catch (error) {\n throw new ConfigurationError(\"Invalid Codex configuration.\", {\n cause: error,\n });\n }\n const temporary = join(parent, `.${randomUUID()}.config.toml.tmp`);\n let created = false;\n try {\n const handle = await open(temporary, \"wx\", 0o600);\n created = true;\n try {\n await handle.chmod(0o600);\n await handle.writeFile(contents, \"utf8\");\n await handle.sync();\n } finally {\n await handle.close();\n }\n await rename(temporary, path);\n created = false;\n } finally {\n if (created) {\n await unlink(temporary).catch(() => undefined);\n }\n }\n}\n\nfunction validateOverrideKeys(value: JsonValue): void {\n if (Array.isArray(value)) {\n for (const item of value) validateOverrideKeys(item);\n return;\n }\n if (!isObject(value)) return;\n for (const [key, item] of Object.entries(value)) {\n if ([\"__proto__\", \"constructor\", \"prototype\"].includes(key)) {\n throw new ConfigurationError(`Invalid Codex override key: ${key}.`);\n }\n validateOverrideKeys(item);\n }\n}\n\nfunction validateOverrides(overrides: JsonObject): void {\n if (\"plugins\" in overrides || \"marketplaces\" in overrides) {\n throw new ConfigurationError(\n \"Codex Security owns plugin loading configuration.\",\n );\n }\n const features = overrides[\"features\"];\n if (\"features\" in overrides && !isObject(features)) {\n throw new ConfigurationError(\n \"Codex override features must be a TOML table.\",\n );\n }\n if (isObject(features) && \"plugins\" in features) {\n throw new ConfigurationError(\n \"Codex Security owns plugin loading configuration.\",\n );\n }\n const profiles = overrides[\"profiles\"];\n if (profiles === undefined) {\n return;\n }\n if (!isObject(profiles)) {\n throw new ConfigurationError(\n \"Codex override profiles must be TOML tables.\",\n );\n }\n for (const [name, profile] of Object.entries(profiles)) {\n if (!isObject(profile)) {\n throw new ConfigurationError(\n `Codex override profile ${name} must be a TOML table.`,\n );\n }\n if (\"plugins\" in profile || \"marketplaces\" in profile) {\n throw new ConfigurationError(\n `Codex Security owns plugin loading configuration in profile ${name}.`,\n );\n }\n const profileFeatures = profile[\"features\"];\n if (profileFeatures !== undefined && !isObject(profileFeatures)) {\n throw new ConfigurationError(\n `Codex override profile ${name} features must be a TOML table.`,\n );\n }\n if (isObject(profileFeatures) && \"plugins\" in profileFeatures) {\n throw new ConfigurationError(\n `Codex Security owns plugin loading configuration in profile ${name}.`,\n );\n }\n }\n}\n\nexport function mergeCodexOverrides(\n base: JsonObject,\n overrides: JsonObject,\n): JsonObject {\n validateOverrideKeys(base);\n validateOverrideKeys(overrides);\n return deepMerge(structuredClone(base), overrides);\n}\n\n/** @internal */\nexport function deepMerge(base: JsonObject, overrides: JsonObject): JsonObject {\n for (const [key, value] of Object.entries(overrides)) {\n const existing = Object.hasOwn(base, key) ? base[key] : undefined;\n base[key] =\n isObject(value) && isObject(existing)\n ? deepMerge({ ...existing }, value)\n : structuredClone(value);\n }\n return base;\n}\n\nfunction isObject(value: unknown): value is Record<string, JsonValue> {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n return false;\n }\n const prototype = Object.getPrototypeOf(value);\n return prototype === Object.prototype || prototype === null;\n}\n"]}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, open, rename, unlink } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { CyberAccessProgram } from \"@openai/codex-sdk\";\nimport { parse, stringify } from \"smol-toml\";\nimport { ConfigurationError } from \"./errors.js\";\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonValue[] | JsonObject;\nexport interface JsonObject {\n [key: string]: JsonValue;\n}\n\nexport interface CodexSecurityConfig {\n pluginPath?: string;\n codexOverrides?: JsonObject;\n pythonPath?: string;\n}\n\nexport interface ScanModelConfiguration {\n model: string;\n reasoningEffort: string;\n}\n\nexport const OPENROUTER_CODEX_PROVIDER = {\n name: \"OpenRouter\",\n base_url: \"https://openrouter.ai/api/v1\",\n env_key: \"OPENROUTER_API_KEY\",\n wire_api: \"responses\",\n} as const satisfies JsonObject;\n\nexport const FIREWORKS_CODEX_PROVIDER = {\n name: \"Fireworks AI\",\n base_url: \"https://api.fireworks.ai/inference/v1\",\n env_key: \"FIREWORKS_API_KEY\",\n wire_api: \"responses\",\n} as const satisfies JsonObject;\n\nexport const CHEAPERINFERENCE_CODEX_PROVIDER = {\n name: \"Cheaper Inference\",\n base_url: \"https://api.cheaperinference.com/v1\",\n env_key: \"CHEAPER_INFERENCE_API_KEY\",\n wire_api: \"responses\",\n} as const satisfies JsonObject;\n\nexport const EXTERNAL_CODEX_PROVIDERS = {\n openrouter: OPENROUTER_CODEX_PROVIDER,\n fireworks: FIREWORKS_CODEX_PROVIDER,\n cheaperinference: CHEAPERINFERENCE_CODEX_PROVIDER,\n} as const;\n\nexport type ExternalModelProvider = keyof typeof EXTERNAL_CODEX_PROVIDERS;\n\nexport function isExternalModelProvider(\n provider: unknown,\n): provider is ExternalModelProvider {\n return (\n typeof provider === \"string\" &&\n Object.hasOwn(EXTERNAL_CODEX_PROVIDERS, provider)\n );\n}\n\nexport const DEFAULT_CODEX_CONFIG: Readonly<JsonObject> = Object.freeze({\n approval_policy: \"on-request\",\n approvals_reviewer: \"auto_review\",\n cli_auth_credentials_store: \"auto\",\n model: \"gpt-5.6-sol\",\n model_reasoning_effort: \"xhigh\",\n model_reasoning_summary: \"detailed\",\n show_raw_agent_reasoning: true,\n features: Object.freeze({\n plugins: true,\n goals: true,\n multi_agent_v2: Object.freeze({\n enabled: true,\n max_concurrent_threads_per_session: 9,\n }),\n }),\n // Credential read denials require the elevated Windows sandbox backend.\n windows: Object.freeze({\n sandbox: \"elevated\",\n }),\n});\n\nexport function scanModelConfiguration(\n config: Readonly<JsonObject>,\n): ScanModelConfiguration {\n const selectedProfile = selectedScanProfile(config);\n const model = scanModel(config);\n if (typeof model !== \"string\" || model.trim().length === 0) {\n throw new ConfigurationError(\n \"The configured Codex model must be a nonempty string.\",\n );\n }\n const reasoningEffort =\n selectedProfile?.[\"model_reasoning_effort\"] ??\n config[\"model_reasoning_effort\"];\n if (\n typeof reasoningEffort !== \"string\" ||\n reasoningEffort.trim().length === 0\n ) {\n throw new ConfigurationError(\n \"The configured Codex reasoning effort must be a nonempty string.\",\n );\n }\n return { model, reasoningEffort };\n}\n\nexport function scanModel(config: Readonly<JsonObject>): unknown {\n const selectedProfile = selectedScanProfile(config);\n return selectedProfile?.[\"model\"] ?? config[\"model\"];\n}\n\nexport function scanModelProvider(config: Readonly<JsonObject>): unknown {\n const selectedProfile = selectedScanProfile(config);\n return selectedProfile?.[\"model_provider\"] ?? config[\"model_provider\"];\n}\n\n/** @internal Native Codex validates the auth table, including invalid selections. */\nexport function hasCommandAuth(config: Readonly<JsonObject>): boolean {\n const selected = scanModelProvider(config);\n const providers = resolveCodexProfile(config)[\"model_providers\"];\n const provider =\n typeof selected === \"string\" && isObject(providers)\n ? providers[selected]\n : undefined;\n return isObject(provider) && provider[\"auth\"] != null;\n}\n\n/** @internal Keep host-side helpers independent of the source checkout. */\nexport function resolveCommandAuthConfig(\n config: JsonObject,\n home: string,\n): JsonObject {\n const resolved = structuredClone(config);\n const providers = resolveCodexProfile(resolved)[\"model_providers\"];\n if (isObject(providers)) {\n (selectedScanProfile(resolved) ?? resolved)[\"model_providers\"] = providers;\n for (const provider of Object.values(providers)) {\n if (!isObject(provider) || !isObject(provider[\"auth\"])) continue;\n const auth = provider[\"auth\"];\n const cwd = auth[\"cwd\"];\n if (\n cwd == null ||\n (typeof cwd === \"string\" && !/^~(?:[/\\\\]|$)/u.test(cwd))\n ) {\n auth[\"cwd\"] = resolve(home, cwd ?? \".\");\n }\n }\n }\n return resolved;\n}\n\n/** @internal CLI dotted keys cannot represent provider IDs containing dots. */\nexport function modelProviderConfigOverride(config: JsonObject): string[] {\n return config[\"model_providers\"] == null\n ? []\n : [`model_providers=${inlineToml(config[\"model_providers\"])}`];\n}\n\n/** @internal Resolve settings; literal-key tables use native file layers. */\nexport function structuredCodexConfig(config: JsonObject = {}): JsonObject {\n const structured = resolveCodexProfile(config);\n delete structured[\"projects\"];\n delete structured[\"permissions\"];\n delete structured[\"model_providers\"];\n return structured;\n}\n\n/** @internal Serialize one Codex CLI override value without flattening its keys. */\nexport function inlineToml(value: JsonValue): string {\n if (value === null)\n throw new ConfigurationError(\n \"Codex TOML overrides cannot contain null values.\",\n );\n if (Array.isArray(value)) return `[${value.map(inlineToml).join(\",\")}]`;\n if (isObject(value)) {\n return `{${Object.entries(value)\n .filter(([, item]) => item !== null)\n .map(([key, item]) => `${JSON.stringify(key)}=${inlineToml(item)}`)\n .join(\",\")}}`;\n }\n return stringify({ value }).slice(\"value = \".length).trim();\n}\n\nexport function scanApprovalPolicy(\n config: Readonly<JsonObject>,\n): \"never\" | \"on-request\" {\n const configured =\n selectedScanProfile(config)?.[\"approval_policy\"] ??\n config[\"approval_policy\"];\n return configured === \"never\" ? \"never\" : \"on-request\";\n}\n\nfunction selectedScanProfile(\n config: Readonly<JsonObject>,\n): Record<string, JsonValue> | undefined {\n const profileName = config[\"profile\"];\n const profiles = config[\"profiles\"];\n const configuredProfile =\n typeof profileName === \"string\" &&\n isObject(profiles) &&\n Object.hasOwn(profiles, profileName)\n ? profiles[profileName]\n : undefined;\n return isObject(configuredProfile) ? configuredProfile : undefined;\n}\n\nexport function resolveCodexProfile(config: JsonObject): JsonObject {\n const normalized = parse(stringify(config)) as JsonObject;\n const resolved = deepMerge(normalized, selectedScanProfile(normalized) ?? {});\n delete resolved[\"profile\"];\n delete resolved[\"profiles\"];\n return resolved;\n}\n\n/** @internal */\nexport function scanCyberAccessConfig(\n config: JsonObject,\n program: CyberAccessProgram | undefined,\n): JsonObject {\n if (program === undefined) return config;\n const resolved = resolveCodexProfile(config);\n const features = isObject(resolved[\"features\"]) ? resolved[\"features\"] : {};\n return {\n ...config,\n features: {\n ...(isObject(config[\"features\"]) ? config[\"features\"] : {}),\n // Explicit selections opt in to upstream API-key support. Keep a user's\n // explicit disable so Codex can report it instead of silently dropping it.\n api_key_cyber_access_programs:\n features[\"api_key_cyber_access_programs\"] ?? true,\n },\n };\n}\n\nexport async function mergedCodexConfig(\n config: CodexSecurityConfig,\n): Promise<JsonObject> {\n if (config.codexOverrides !== undefined && !isObject(config.codexOverrides)) {\n throw new ConfigurationError(\"codexOverrides must be an object.\");\n }\n validateOverrideKeys(config.codexOverrides ?? {});\n const overrides = structuredClone(config.codexOverrides ?? {});\n validateOverrides(overrides);\n const agents = overrides[\"agents\"];\n if (isObject(agents) && \"max_threads\" in agents) {\n throw new ConfigurationError(\n \"The selected Codex Security plugin requires native multi-agent v2; \" +\n \"agents.max_threads is a legacy v1 setting. Use \" +\n \"features.multi_agent_v2.max_concurrent_threads_per_session instead.\",\n );\n }\n const features = overrides[\"features\"];\n if (isObject(features) && \"multi_agent_v2\" in features) {\n const multiAgentV2 = features[\"multi_agent_v2\"];\n if (!isObject(multiAgentV2)) {\n throw new ConfigurationError(\n \"The selected Codex Security plugin requires native multi-agent v2; \" +\n \"features.multi_agent_v2 must remain a table with enabled = true.\",\n );\n }\n if (\"enabled\" in multiAgentV2 && multiAgentV2[\"enabled\"] !== true) {\n throw new ConfigurationError(\n \"The selected Codex Security plugin requires native multi-agent v2; \" +\n \"features.multi_agent_v2.enabled cannot be disabled.\",\n );\n }\n }\n\n const profiles = Object.entries(\n (overrides[\"profiles\"] ?? {}) as Record<string, JsonObject>,\n );\n for (const [name, profile] of profiles) {\n const profileAgents = profile[\"agents\"];\n if (isObject(profileAgents) && \"max_threads\" in profileAgents) {\n throw new ConfigurationError(\n `The selected Codex Security plugin requires native multi-agent v2; profile ${name} agents.max_threads is a legacy v1 setting.`,\n );\n }\n const profileFeatures = profile[\"features\"];\n if (!isObject(profileFeatures) || !(\"multi_agent_v2\" in profileFeatures)) {\n continue;\n }\n const profileV2 = profileFeatures[\"multi_agent_v2\"];\n if (\n !isObject(profileV2) ||\n (\"enabled\" in profileV2 && profileV2[\"enabled\"] !== true)\n ) {\n throw new ConfigurationError(\n `The selected Codex Security plugin requires native multi-agent v2; profile ${name} features.multi_agent_v2 cannot be disabled.`,\n );\n }\n }\n normalizeLegacyWindowsSandboxOverride(overrides);\n for (const [, profile] of profiles) {\n normalizeLegacyWindowsSandboxOverride(profile);\n }\n const defaults: JsonObject = structuredClone(DEFAULT_CODEX_CONFIG);\n if (scanModelProvider(overrides) === \"amazon-bedrock\") {\n // Bedrock models can reject reasoning.summary before the scan starts.\n defaults[\"model_reasoning_summary\"] = \"none\";\n }\n return deepMerge(defaults, overrides);\n}\n\n/** @internal Preserve existing native Windows backend selections. */\nexport function normalizeLegacyWindowsSandboxOverride(\n overrides: JsonObject,\n): void {\n const features = overrides[\"features\"];\n if (!isObject(features)) {\n return;\n }\n const elevated = features[\"elevated_windows_sandbox\"];\n if (typeof elevated !== \"boolean\") {\n return;\n }\n const windows = overrides[\"windows\"];\n if (\n windows !== undefined &&\n (!isObject(windows) || Object.hasOwn(windows, \"sandbox\"))\n ) {\n return;\n }\n overrides[\"windows\"] = {\n ...(isObject(windows) ? windows : {}),\n sandbox: elevated ? \"elevated\" : \"unelevated\",\n };\n}\n\nexport async function writeCodexConfig(\n path: string,\n config: JsonObject,\n): Promise<void> {\n const parent = dirname(path);\n await mkdir(parent, { recursive: true, mode: 0o700 });\n let contents: string;\n try {\n contents = stringify(config);\n } catch (error) {\n throw new ConfigurationError(\"Invalid Codex configuration.\", {\n cause: error,\n });\n }\n const temporary = join(parent, `.${randomUUID()}.config.toml.tmp`);\n let created = false;\n try {\n const handle = await open(temporary, \"wx\", 0o600);\n created = true;\n try {\n await handle.chmod(0o600);\n await handle.writeFile(contents, \"utf8\");\n await handle.sync();\n } finally {\n await handle.close();\n }\n await rename(temporary, path);\n created = false;\n } finally {\n if (created) {\n await unlink(temporary).catch(() => undefined);\n }\n }\n}\n\nfunction validateOverrideKeys(value: JsonValue): void {\n if (Array.isArray(value)) {\n for (const item of value) validateOverrideKeys(item);\n return;\n }\n if (!isObject(value)) return;\n for (const [key, item] of Object.entries(value)) {\n if ([\"__proto__\", \"constructor\", \"prototype\"].includes(key)) {\n throw new ConfigurationError(`Invalid Codex override key: ${key}.`);\n }\n validateOverrideKeys(item);\n }\n}\n\nfunction validateOverrides(overrides: JsonObject): void {\n if (\"plugins\" in overrides || \"marketplaces\" in overrides) {\n throw new ConfigurationError(\n \"Codex Security owns plugin loading configuration.\",\n );\n }\n const features = overrides[\"features\"];\n if (\"features\" in overrides && !isObject(features)) {\n throw new ConfigurationError(\n \"Codex override features must be a TOML table.\",\n );\n }\n if (isObject(features) && \"plugins\" in features) {\n throw new ConfigurationError(\n \"Codex Security owns plugin loading configuration.\",\n );\n }\n const profiles = overrides[\"profiles\"];\n if (profiles === undefined) {\n return;\n }\n if (!isObject(profiles)) {\n throw new ConfigurationError(\n \"Codex override profiles must be TOML tables.\",\n );\n }\n for (const [name, profile] of Object.entries(profiles)) {\n if (!isObject(profile)) {\n throw new ConfigurationError(\n `Codex override profile ${name} must be a TOML table.`,\n );\n }\n if (\"plugins\" in profile || \"marketplaces\" in profile) {\n throw new ConfigurationError(\n `Codex Security owns plugin loading configuration in profile ${name}.`,\n );\n }\n const profileFeatures = profile[\"features\"];\n if (profileFeatures !== undefined && !isObject(profileFeatures)) {\n throw new ConfigurationError(\n `Codex override profile ${name} features must be a TOML table.`,\n );\n }\n if (isObject(profileFeatures) && \"plugins\" in profileFeatures) {\n throw new ConfigurationError(\n `Codex Security owns plugin loading configuration in profile ${name}.`,\n );\n }\n }\n}\n\nexport function mergeCodexOverrides(\n base: JsonObject,\n overrides: JsonObject,\n): JsonObject {\n validateOverrideKeys(base);\n validateOverrideKeys(overrides);\n return deepMerge(structuredClone(base), overrides);\n}\n\n/** @internal */\nexport function deepMerge(base: JsonObject, overrides: JsonObject): JsonObject {\n for (const [key, value] of Object.entries(overrides)) {\n const existing = Object.hasOwn(base, key) ? base[key] : undefined;\n base[key] =\n isObject(value) && isObject(existing)\n ? deepMerge({ ...existing }, value)\n : structuredClone(value);\n }\n return base;\n}\n\nfunction isObject(value: unknown): value is Record<string, JsonValue> {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n return false;\n }\n const prototype = Object.getPrototypeOf(value);\n return prototype === Object.prototype || prototype === null;\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { type BigIntStats, type Stats } from "node:fs";
2
2
  import { type FileHandle } from "node:fs/promises";
3
+ import { ContractValidationError } from "./errors.js";
3
4
  import type { CoverageDocument, Finding, FindingsDocument, ScanManifest } from "./models.js";
4
5
  import type { NormalizedTarget, ScanMode } from "./targets.js";
5
6
  export interface ScanExpectation {
@@ -14,6 +15,8 @@ export interface LoadedContract {
14
15
  findings: FindingsDocument;
15
16
  coverage: CoverageDocument;
16
17
  }
18
+ export declare class ContractSchemaError extends ContractValidationError {
19
+ }
17
20
  type LoadContractOptions = {
18
21
  pluginRoot: string;
19
22
  expectedScanId?: string;
@@ -26,8 +29,11 @@ export declare function loadContractWithScanDirectory(scanDirectory: string, opt
26
29
  contract: LoadedContract;
27
30
  scanDirectory: string;
28
31
  }>;
32
+ /** Match the producer's Python str.strip without changing saved text. */
33
+ export declare function hasRequiredFindingText(value: string): boolean;
29
34
  export declare function requireScanFile(scanDirectory: string, relativePath: string, context: string, signal?: AbortSignal): Promise<string>;
30
35
  export declare function readScanFile(scanDirectory: string, relativePath: string, context: string, signal?: AbortSignal): Promise<Buffer>;
36
+ export declare function safeScopePath(value: string): string;
31
37
  export declare function sameCheckedFileDevice(file: FileHandle, checked: {
32
38
  path: string;
33
39
  metadata: Pick<Stats | BigIntStats, "dev" | "ino">;
@@ -1 +1 @@
1
- {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,YAAY,EACb,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAqB/D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CA6G9D;AA2ID,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAmkBD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;CAAE,EAC7E,MAAM,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,EAChD,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,aAAa,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAQ,GACzE,OAAO,CAAC,OAAO,CAAC,CA+BlB;AA0CD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;QAiBzB,SAAS,EAAE,mBAAmB;QAC9B,OAAO;;EAGZ"}
1
+ {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,uBAAuB,EAGxB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,YAAY,EACb,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAqB/D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,qBAAa,mBAAoB,SAAQ,uBAAuB;CAAG;AAEnE,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAoG9D;AAeD,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAyJD,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;AA+WD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AA0PD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;CAAE,EAC7E,MAAM,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,EAChD,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,aAAa,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAQ,GACzE,OAAO,CAAC,OAAO,CAAC,CA+BlB;AA0CD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;QAiBzB,SAAS,EAAE,mBAAmB;QAC9B,OAAO;;EAGZ"}
package/dist/contract.js CHANGED
@@ -6,7 +6,7 @@ import { lstat, open, readFile, realpath, } from "node:fs/promises";
6
6
  import { isAbsolute, join, posix, resolve } from "node:path";
7
7
  import Ajv2020 from "ajv/dist/2020.js";
8
8
  import { regexes } from "zod";
9
- import { ContractValidationError, abortReason } from "./errors.js";
9
+ import { ContractValidationError, abortReason, errorMessage, } from "./errors.js";
10
10
  import { isRecord } from "./record.js";
11
11
  import { requirePrivateOutputDirectory, requireSecureOutputAncestry, } from "./runtime.js";
12
12
  import { isWithin as isContained } from "./trusted-executable.js";
@@ -17,10 +17,13 @@ const DOCUMENTS = {
17
17
  "coverage.json": "coverage.schema.json",
18
18
  };
19
19
  const PRODUCER_NAME = "codex-security-plugin";
20
+ export class ContractSchemaError extends ContractValidationError {
21
+ }
20
22
  export async function loadContract(scanDirectory, options) {
21
23
  return (await loadContractWithScanDirectory(scanDirectory, options)).contract;
22
24
  }
23
25
  export async function loadContractWithScanDirectory(scanDirectory, options) {
26
+ const validators = await loadContractValidators(options.pluginRoot, options.signal);
24
27
  const scanRoot = await requireScanRoot(scanDirectory, options.signal);
25
28
  const scanDir = scanRoot.path;
26
29
  const documentDigests = new Map();
@@ -29,17 +32,10 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
29
32
  payloads[filename] = await readScanJson(scanDir, filename, documentDigests, options.signal, scanRoot);
30
33
  }
31
34
  throwIfAborted(options.signal);
32
- // The plugin schemas are the immutable v0 contract. They are valid Draft
33
- // 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
34
- // optional strict-schema linter requires.
35
- const ajv = new Ajv2020({ allErrors: false, strict: false }).addFormat("date-time", { type: "string", validate: validRfc3339DateTime });
36
- for (const [filename, schemaName] of Object.entries(DOCUMENTS)) {
37
- const schema = await readJson(join(options.pluginRoot, "schemas", schemaName), options.signal);
38
- let validate;
35
+ for (const { filename, schemaName, validate } of validators) {
39
36
  let payload;
40
37
  let valid;
41
38
  try {
42
- validate = ajv.compile(schema);
43
39
  payload = payloads[filename];
44
40
  const validatePayload = (payload) => {
45
41
  const result = validate(payload);
@@ -55,7 +51,7 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
55
51
  }
56
52
  }
57
53
  catch {
58
- throw new ContractValidationError(`${schemaName}: invalid JSON Schema.`);
54
+ throw new ContractSchemaError(`${schemaName}: invalid JSON Schema.`);
59
55
  }
60
56
  if (!valid) {
61
57
  throw schemaError(filename, validate.errors ?? []);
@@ -80,7 +76,7 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
80
76
  if (!sameArray(coverage.excludePaths, manifest.scan.scope.excludePaths)) {
81
77
  throw new ContractValidationError("Coverage exclude paths do not match the manifest scope.");
82
78
  }
83
- validateCanonicalContract(manifest, findings);
79
+ validateCanonicalContract(manifest, findings, coverage);
84
80
  await validateSeal(scanDir, manifest, findings, coverage, documentDigests, options.signal, scanRoot);
85
81
  if (options.expectation !== undefined) {
86
82
  validateExpectation(manifest, coverage, options.expectation, options.workbenchValidated === true);
@@ -104,7 +100,11 @@ function normalizePersistedFindings(payload) {
104
100
  }
105
101
  return compatible;
106
102
  }
107
- function validateCanonicalContract(manifest, findings) {
103
+ /** Match the producer's Python str.strip without changing saved text. */
104
+ export function hasRequiredFindingText(value) {
105
+ return !/^[\p{White_Space}\u001c-\u001f]*$/u.test(value);
106
+ }
107
+ function validateCanonicalContract(manifest, findings, coverage) {
108
108
  const remote = manifest.scan.target.remote;
109
109
  if (remote !== undefined) {
110
110
  const authority = /^[A-Za-z][A-Za-z0-9+.-]*:\/\/([^/?#]+)/.exec(remote)?.[1];
@@ -141,6 +141,17 @@ function validateCanonicalContract(manifest, findings) {
141
141
  }
142
142
  }
143
143
  }
144
+ for (const [index, deferred] of coverage.deferred.entries()) {
145
+ for (const [pathIndex, path] of (deferred.paths ?? []).entries()) {
146
+ const context = `coverage.deferred[${index}].paths[${pathIndex}]`;
147
+ try {
148
+ safeRelativePath(path, context, true);
149
+ }
150
+ catch (error) {
151
+ throw new ContractValidationError(`${context}: expected a safe repository-relative POSIX path.`, { cause: error });
152
+ }
153
+ }
154
+ }
144
155
  const findingIds = new Set();
145
156
  for (const [findingIndex, finding] of findings.findings.entries()) {
146
157
  const context = `findings.findings[${findingIndex}]`;
@@ -159,8 +170,7 @@ function validateCanonicalContract(manifest, findings) {
159
170
  ? []
160
171
  : [["severity.scoringSystem", finding.severity.scoringSystem]]),
161
172
  ]) {
162
- // Match the producer's Python str.strip without changing saved text.
163
- if (/^[\p{White_Space}\u001c-\u001f]*$/u.test(value ?? "")) {
173
+ if (!hasRequiredFindingText(value ?? "")) {
164
174
  throw new ContractValidationError(`${context}.${field}: expected a non-empty string.`);
165
175
  }
166
176
  }
@@ -176,6 +186,15 @@ function validateCanonicalContract(manifest, findings) {
176
186
  throw new ContractValidationError(`${locationContext}.endLine: expected an integer >= startLine.`);
177
187
  }
178
188
  }
189
+ for (const [evidenceIndex, evidence] of (finding.codeEvidence ?? []).entries()) {
190
+ const evidenceContext = `${context}.codeEvidence[${evidenceIndex}].path`;
191
+ try {
192
+ safeRelativePath(evidence.path, evidenceContext);
193
+ }
194
+ catch (error) {
195
+ throw new ContractValidationError(`${evidenceContext}: expected a safe repository-relative POSIX path.`, { cause: error });
196
+ }
197
+ }
179
198
  const { findingId, occurrenceId, fingerprints } = deriveFindingIdentity(manifest.scan.id, manifest.scan.target.targetId, finding.ruleId, finding.identity);
180
199
  if (finding.findingId !== findingId) {
181
200
  throw new ContractValidationError(`${context}.findingId: does not match derived fingerprint identity.`);
@@ -419,11 +438,11 @@ async function verifyScanRoot(root, signal) {
419
438
  throw new ContractValidationError("Scan directory changed while reading the canonical contract.", { cause: error });
420
439
  }
421
440
  }
422
- function safeRelativePath(value, context) {
441
+ function safeRelativePath(value, context, allowDot = false) {
423
442
  const parts = value.split("/");
424
- if (value.trim().length === 0 ||
443
+ if (value.length === 0 ||
425
444
  Buffer.from(value, "utf8").toString("utf8") !== value ||
426
- value === "." ||
445
+ (!allowDot && value === ".") ||
427
446
  value.startsWith("/") ||
428
447
  /^[A-Za-z]:/.test(value) ||
429
448
  parts.includes("..") ||
@@ -432,7 +451,7 @@ function safeRelativePath(value, context) {
432
451
  throw new ContractValidationError(`${context}: expected a safe scan-relative POSIX path.`);
433
452
  }
434
453
  const normalized = posix.normalize(value).replace(/\/+$/, "");
435
- if (normalized === "." ||
454
+ if ((!allowDot && normalized === ".") ||
436
455
  normalized.startsWith("../") ||
437
456
  isAbsolute(normalized)) {
438
457
  throw new ContractValidationError(`${context}: expected a safe scan-relative POSIX path.`);
@@ -441,12 +460,13 @@ function safeRelativePath(value, context) {
441
460
  }
442
461
  function portableRelativePath(value, context) {
443
462
  const normalized = safeRelativePath(value, context);
444
- if (value.split("/").some(isWindowsUnsafePathComponent)) {
463
+ if (value.trim().length === 0 ||
464
+ value.split("/").some(isWindowsUnsafePathComponent)) {
445
465
  throw new ContractValidationError(`${context}: expected a safe scan-relative POSIX path.`);
446
466
  }
447
467
  return normalized;
448
468
  }
449
- function safeScopePath(value) {
469
+ export function safeScopePath(value) {
450
470
  return value === "."
451
471
  ? value
452
472
  : safeRelativePath(value, "manifest scope include path");
@@ -538,6 +558,35 @@ function validateParsedJson(value, context) {
538
558
  }
539
559
  }
540
560
  }
561
+ async function loadContractValidators(pluginRoot, signal) {
562
+ // The plugin schemas are the immutable v0 contract. They are valid Draft
563
+ // 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
564
+ // optional strict-schema linter requires.
565
+ const ajv = new Ajv2020({ allErrors: false, strict: false });
566
+ ajv.addFormat("date-time", {
567
+ type: "string",
568
+ validate: validRfc3339DateTime,
569
+ });
570
+ const validators = [];
571
+ for (const [filename, schemaName] of Object.entries(DOCUMENTS)) {
572
+ const schema = await readJson(join(pluginRoot, "schemas", schemaName), signal).catch((error) => {
573
+ throwIfAborted(signal);
574
+ throw new ContractSchemaError(errorMessage(error), { cause: error });
575
+ });
576
+ try {
577
+ const validate = ajv.compile(schema);
578
+ if ("$async" in validate && validate.$async === true) {
579
+ throw new Error("asynchronous JSON Schema validation is unsupported");
580
+ }
581
+ validators.push({ filename, schemaName, validate });
582
+ }
583
+ catch {
584
+ throw new ContractSchemaError(`${schemaName}: invalid JSON Schema.`);
585
+ }
586
+ throwIfAborted(signal);
587
+ }
588
+ return validators;
589
+ }
541
590
  async function sha256ScanFile(scanDir, relativePath, context, signal, expectedRoot) {
542
591
  const file = await openCheckedScanFile(scanDir, relativePath, context, signal, expectedRoot);
543
592
  try {