{"record":{"id":"3bb3a7702a9e7b0d","repo":"paperclipai/paperclip","slug":"filesystemextrapaths-index-must-be-an-absolute","errorCode":null,"errorMessage":"filesystemExtraPaths[${index}] must be an absolute path or { path, access } object.","messagePattern":"filesystemExtraPaths\\[(.+?)\\] must be an absolute path or (.+?) object\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/adapter-utils/src/local-process-sandbox.ts","lineNumber":500,"sourceCode":"    const proxyUrl = `http://127.0.0.1:${SANDBOX_PROXY_PORT}`;\n    env.HTTP_PROXY = proxyUrl;\n    env.HTTPS_PROXY = proxyUrl;\n    env.http_proxy = proxyUrl;\n    env.https_proxy = proxyUrl;\n  }\n\n  args.push(\"--chdir\", cwd, \"--\", executable, ...executableArgs);\n  return { command: bwrapCommand, args, cwd: \"/\", env, cleanup };\n}\n\nexport function parseLocalProcessSandboxExtraPaths(value: unknown): LocalProcessSandboxPath[] {\n  if (!Array.isArray(value)) return [];\n  return value.map((entry, index) => {\n    if (typeof entry === \"string\") {\n      return { path: normalizeAbsolutePath(entry, `filesystemExtraPaths[${index}]`), access: \"ro\" };\n    }\n    if (!entry || typeof entry !== \"object\" || Array.isArray(entry)) {\n      throw new Error(`filesystemExtraPaths[${index}] must be an absolute path or { path, access } object.`);\n    }\n    const raw = entry as Record<string, unknown>;\n    const access = raw.access === \"rw\" ? \"rw\" : raw.access === \"ro\" || raw.access == null ? \"ro\" : null;\n    if (!access || typeof raw.path !== \"string\") {\n      throw new Error(`filesystemExtraPaths[${index}] must use access \"ro\" or \"rw\" and an absolute path.`);\n    }\n    return { path: normalizeAbsolutePath(raw.path, `filesystemExtraPaths[${index}].path`), access };\n  });\n}\n","sourceCodeStart":482,"sourceCodeEnd":510,"githubUrl":"https://github.com/paperclipai/paperclip/blob/120ae5428fa29bee300bcf806491cd4d965fbb7c/packages/adapter-utils/src/local-process-sandbox.ts#L482-L510","documentation":"parseLocalProcessSandboxExtraPaths got a filesystemExtraPaths entry that is neither a string nor a {path, access} object; the entry shape is unrecognized.","triggerScenarios":"Thrown at packages/adapter-utils/src/local-process-sandbox.ts:500 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use an absolute path string or a { path, access } object for filesystemExtraPaths[${index}]."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"120ae5428fa29bee300bcf806491cd4d965fbb7c","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}