{"record":{"id":"636246cf7a7d97bb","repo":"diegosouzapw/OmniRoute","slug":"message-buildhint","errorCode":null,"errorMessage":"${message}${buildHint}","messagePattern":"\\$\\{message\\}\\$\\{buildHint\\}","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"src/lib/vncSession/service.ts","lineNumber":232,"sourceCode":"        `127.0.0.1::${VNC_CONFIG.containerVncPort}`,\n        \"-p\",\n        `127.0.0.1::${VNC_CONFIG.containerCdpPort}`,\n        \"-v\",\n        `${profileDir}:${VNC_CONFIG.containerProfileDir}`,\n        \"-e\",\n        `CHROME_CLI=${chromeCli}`,\n        VNC_CONFIG.image,\n      ],\n      { timeoutMs: 120_000 }\n    );\n    if (result.code !== 0) {\n      const message = result.err.trim() || \"docker run failed\";\n      const buildHint =\n        VNC_CONFIG.image === \"omniroute-vnc-chromium:local\" &&\n        /pull access denied|unable to find image|not found/i.test(message)\n          ? \" Build it with: docker build -t omniroute-vnc-chromium:local docker/vnc-browser/chromium\"\n          : \"\";\n      throw new Error(`${message}${buildHint}`);\n    }\n\n    state.vncPort = await publishedPort(containerName, VNC_CONFIG.containerVncPort);\n    state.cdpPort = await publishedPort(containerName, VNC_CONFIG.containerCdpPort);\n    await waitForCdpReady(state.cdpPort, VNC_CONFIG.browserReadyTimeoutMs);\n\n    state.status = \"running\";\n    scheduleIdleSweep();\n    return state;\n  } catch (error) {\n    state.status = \"error\";\n    state.error = error instanceof Error ? error.message : String(error);\n    SESSIONS.delete(sessionId);\n    await docker([\"rm\", \"-f\", containerName], { timeoutMs: 20_000 });\n    cleanupProfile(state);\n    throw new Error(`Failed to start browser login for connection ${connectionId}: ${state.error}`);\n  }\n}","sourceCodeStart":214,"sourceCodeEnd":250,"githubUrl":"https://github.com/diegosouzapw/OmniRoute/blob/a179ffed5bb2e0b883b9ae7214ce8717b2a94c4d/src/lib/vncSession/service.ts#L214-L250","documentation":"Error \"${message}${buildHint}\" thrown in diegosouzapw/OmniRoute.","triggerScenarios":"Thrown at src/lib/vncSession/service.ts:232 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"a179ffed5bb2e0b883b9ae7214ce8717b2a94c4d","analyzedAt":"2026-08-25T18:35:09.898Z","schemaVersion":2},"datasetVersion":"2026-08-25T21:54:21.419Z"}