Skip to content

OpenAI's Codex Security CLI and TypeScript SDK for finding, validating, and fixing security vulnerabilities. npm: https://www.npmjs.com/package/@openai/codex-security

docs: clarify Deep Scan preflight sandbox limits (#2611)

Wu Shuwenf26b669b56a4
diff --git a/docs/project-configuration.md b/docs/project-configuration.md
index 7db58f06c..d614334f5 100644
--- a/docs/project-configuration.md
+++ b/docs/project-configuration.md
@@ -419,6 +419,17 @@ values, insert defaults, or discard unknown wrapper keys. Completion inside
existing checks. CLI `scan --schema --json` and result artifact schemas remain
separate contracts.
+### Deep Scan sandbox qualification
+
+The CLI dry run and SDK `preflight()` are configuration checks, not sandbox
+qualification. They do not start a Deep Scan worker or execute a command under
+its generated permissions, so they cannot establish that the worker enforces
+filesystem, credential-store, or network restrictions. The documented CLI and
+SDK preflight surfaces do not export that generated policy or run a synthetic
+command under it. Do not use either preflight result as evidence of worker
+isolation. See the [security policy](../SECURITY.md) for the limits of read-only
+worker execution and inherited tools.
+
## Saved reruns
New recipes retain resolved native configuration, scope, auth choice, finding
diff --git a/sdk/typescript/docs/sdk.md b/sdk/typescript/docs/sdk.md
index f41aec97e..43e8fe790 100644
--- a/sdk/typescript/docs/sdk.md
+++ b/sdk/typescript/docs/sdk.md
@@ -308,6 +308,10 @@ console.log(plan);
`preflight()` checks local inputs without starting Codex or using the network. The returned `stateDirectory` identifies the checked storage root, including when the final scan directory will be allocated automatically.
It does not verify credentials, model access, Python, or the plugin. The CLI
equivalent is `scan --dry-run`.
+Neither preflight starts a Deep Scan worker or executes a command under its
+generated permissions, so neither qualifies the worker sandbox. See [Deep Scan
+sandbox qualification](../../../docs/project-configuration.md#deep-scan-sandbox-qualification)
+for the boundary and the limits of what these checks establish.
### Set investigation time