{"record":{"id":"efca982f104e4b85","repo":"stablyai/orca","slug":"accessibility-error-efca98","errorCode":"accessibility_error","errorMessage":"Orca Computer Use.app was not found","messagePattern":"Orca Computer Use\\.app was not found","errorType":"error_code","errorClass":"RuntimeClientError","httpStatus":null,"severity":"error","filePath":"src/main/computer/macos-computer-use-permissions.ts","lineNumber":43,"sourceCode":"): Promise<ComputerUsePermissionSetupResult> {\n  if (process.platform !== 'darwin') {\n    return {\n      platform: process.platform,\n      helperAppPath: null,\n      permissionId,\n      openedSettings: false,\n      launchedHelper: false,\n      permissions: [\n        { id: 'accessibility', status: 'unsupported' },\n        { id: 'screenshots', status: 'unsupported' }\n      ],\n      nextStep: null\n    }\n  }\n\n  const helperAppPath = resolveMacOSComputerUseAppPath()\n  if (!helperAppPath) {\n    throw new RuntimeClientError('accessibility_error', 'Orca Computer Use.app was not found')\n  }\n  const status = await getComputerUsePermissionStatus()\n  if (status.helperUnavailableReason) {\n    throw new RuntimeClientError('accessibility_error', status.helperUnavailableReason)\n  }\n  const nextStep = nextPermissionStep(status.permissions)\n\n  if (!permissionId && !nextStep) {\n    return {\n      platform: process.platform,\n      helperAppPath,\n      permissionId,\n      openedSettings: false,\n      launchedHelper: false,\n      permissions: status.permissions,\n      nextStep\n    }\n  }","sourceCodeStart":25,"sourceCodeEnd":61,"githubUrl":"https://github.com/stablyai/orca/blob/1136503c6a231a16dce8f921f6fadb63d181e8db/src/main/computer/macos-computer-use-permissions.ts#L25-L61","documentation":"openComputerUsePermissionsAsync resolves the helper app path via resolveMacOSComputerUseAppPath() and throws accessibility_error if it returns null. The helper app brokers macOS TCC permission prompts and status checks, so computer-use permissions cannot be managed without it. macOS-only.","triggerScenarios":"macOS; the helper app bundle was not shipped or installed; the bundle was moved or deleted; resolveMacOSComputerUseAppPath returns null.","commonSituations":"Incomplete install; a dev build without the bundled helper; a custom install location the resolver cannot find.","solutions":["Reinstall the app to restore Orca Computer Use.app.","Verify the bundle exists at the expected resources path.","Rebuild the app packaging to include the helper bundle."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"import { resolveMacOSComputerUseAppPath } from './macos-native-provider-paths'\nif (process.platform === 'darwin' && !resolveMacOSComputerUseAppPath()) {\n  // surface 'helper app missing, reinstall' to the user\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Ship the helper bundle in packaging.","Validate the helper path on startup on macOS."],"tags":["accessibility-error","macos","helper-app","installation"],"backgroundTag":null,"analyzedSha":"1136503c6a231a16dce8f921f6fadb63d181e8db","analyzedAt":"2026-08-12T23:15:58.167Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}