{"record":{"id":"9c050b2ad4d339fc","repo":"paperclipai/paperclip","slug":"local-process-confinement-requires-bubblewrap-but","errorCode":null,"errorMessage":"Local process confinement requires Bubblewrap, but \"${requestedSandboxCommand}\" was not found in PATH. Install bwrap or configure filesystemSandboxCommand.","messagePattern":"Local process confinement requires Bubblewrap, but \"(.+?)\" was not found in PATH\\. Install bwrap or configure filesystemSandboxCommand\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/adapter-utils/src/server-utils.ts","lineNumber":3465,"sourceCode":"    process.platform === \"win32\" && path.extname(command).length > 0;\n\n  for (const dir of dirs) {\n    const candidates =\n      process.platform === \"win32\"\n        ? hasExtension\n          ? [path.join(dir, command)]\n          : exts.map((ext) => path.join(dir, `${command}${ext}`))\n        : [path.join(dir, command)];\n    for (const candidate of candidates) {\n      if (await pathExists(candidate)) return candidate;\n    }\n  }\n\n  return null;\n}\n\nexport async function resolveCommandForLogs(\n  command: string,\n  cwd: string,\n  env: NodeJS.ProcessEnv,\n  options: {\n    remoteExecution?: RemoteExecutionSpec | null;\n  } = {},\n): Promise<string> {\n  const remote = options.remoteExecution ?? null;\n  if (remote) {\n    return `ssh://${remote.username}@${remote.host}:${remote.port}/${remote.remoteCwd} :: ${command}`;\n  }\n  return (await resolveCommandPath(command, cwd, env)) ?? command;\n}\n\nfunction quoteForCmd(arg: string) {\n  if (!arg.length) return '\"\"';\n  const escaped = arg.replace(/\"/g, '\"\"');\n  return /[\\s\"&<>|^()]/.test(escaped) ? `\"${escaped}\"` : escaped;\n}","sourceCodeStart":3447,"sourceCodeEnd":3483,"githubUrl":"https://github.com/paperclipai/paperclip/blob/3f1d897a7c018d76563a21c6e39c3c9b03933622/packages/adapter-utils/src/server-utils.ts#L3447-L3483","documentation":"Error \"Local process confinement requires Bubblewrap, but \"${requestedSandboxCommand}\" was not found in PATH. Install bwrap or configure filesystemSandboxCommand.\" thrown in paperclipai/paperclip.","triggerScenarios":"Thrown at packages/adapter-utils/src/server-utils.ts:2475 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Install bubblewrap (bwrap) so local confinement works.","Configure filesystemSandboxCommand to point at a bwrap binary."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"3f1d897a7c018d76563a21c6e39c3c9b03933622","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}