diegosouzapw/OmniRoute · error · Error

ChatGPT Web (Codex) tools require a ready tunnel and Custom

Error message

ChatGPT Web (Codex) tools require a ready tunnel and Custom Connector

What it means

Error "ChatGPT Web (Codex) tools require a ready tunnel and Custom Connector" thrown in diegosouzapw/OmniRoute.

Source

Thrown at open-sse/executors/chatgpt-web-codex.ts:175

  }

  const proAvailable = data.proAvailable === true;
  if (route.pro && !proAvailable) {
    throw new Error("ChatGPT Pro is not available for this connection");
  }

  const hasTools = toolModeRequired(parsed);
  const requiredChoice =
    parsed.options.toolChoice === "required" || typeof parsed.options.toolChoice === "object";
  if (route.pro && requiredChoice) {
    throw new Error("ChatGPT Web Pro is read-only and cannot satisfy a required tool choice");
  }

  const connector =
    configuredString(data, "connectorName", "appName") ??
    process.env.CHATGPT_WEB_CODEX_CONNECTOR_NAME?.trim();
  if (!route.pro && hasTools && !connector) {
    throw new Error("ChatGPT Web (Codex) tools require a ready tunnel and Custom Connector");
  }

  parsed.modelId = "gpt-5.6-sol";
  parsed.options.reasoning = route.effort;

  return {
    adapter: "chatgpt-web",
    baseUrl: "https://chatgpt.com",
    defaultModel: "gpt-5.6-sol",
    models: ["gpt-5.6-sol"],
    chatgptWeb: {
      ...(connector ? { appName: connector } : {}),
      storageStatePath,
      ...(chromeExecutablePath ? { chromeExecutablePath } : {}),
      ...(cdpEndpoint ? { cdpEndpoint } : {}),
      brokerSocketPath: paths.brokerSocketPath,
      threadEnvironmentStatePath: paths.threadEnvironmentStatePath,
      headed: false,

View on GitHub (pinned to a179ffed5b)

When it happens

Trigger: Thrown at open-sse/executors/chatgpt-web-codex.ts:175 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of diegosouzapw/OmniRoute@a179ffed5b (2026-08-25). Data as JSON: /api/errors/b7fa7682faad65f3. Report an issue: GitHub.