Advisory

GHSA-3pw3-v88x-xj24

Details, part 2 of 2. The advisory

Details

Recommended Fix
Restrict configuration authority
Agents should not be allowed to modify filesystem-sensitive configuration fields.
Example mitigation:

adapterConfig.instructionsFilePath

should only be configurable by board/admin actors.

Path validation
Restrict file access to a safe directory such as:

workspace/
agent-config/

Reject:

absolute paths
system directories
paths containing ".."

Avoid direct filesystem reads from configuration
Instead of:

fs.readFile(user_supplied_path)

use:

readFile(workspaceSafePath)

Example guard

if (
  request.auth?.principal === "agent" &&
  body?.adapterConfig?.instructionsFilePath
) {
  throw new Error(
    "Agents are not permitted to configure instructionsFilePath"
  );
}

Security Impact Statement
An authenticated attacker with an Agent API key can modify their agent configuration to inject an arbitrary filesystem path into adapterConfig.instructionsFilePath.
The Paperclip server reads this path during agent execution via fs.readFile, allowing the attacker to access files on the server host filesystem.

Disclosure
This vulnerability was discovered during security research on the Paperclip orchestration runtime and is reported privately to allow maintainers to patch the issue before public disclosure.

Sources & licences