Method startDeviceFlow

src/node/services/codexOauthService.ts:215–265

()

  }

  async startDeviceFlow(): Promise<
    Result<
      {
        flowId: string;
        userCode: string;
        verifyUrl: string;
        intervalSeconds: number;
      },
      string
    >
  > {
    const flowId = randomBase64Url();

    const deviceAuthResult = await this.requestDeviceUserCode();
    if (!deviceAuthResult.success) {
      return Err(deviceAuthResult.error);
    }

    const { deviceAuthId, userCode, intervalSeconds, expiresAtMs } = deviceAuthResult.data;
    const verifyUrl = CODEX_OAUTH_DEVICE_VERIFY_URL;

    const { promise: resultPromise, resolve: resolveResult } =
      createDeferred<Result<void, string>>();

    const abortController = new AbortController();

    const timeoutMs = Math.min(DEFAULT_DEVICE_TIMEOUT_MS, Math.max(0, expiresAtMs - Date.now()));
    const timeout = setTimeout(() => {
      void this.finishDeviceFlow(flowId, Err("Device code expired"));
    }, timeoutMs);

    this.deviceFlows.set(flowId, {
      flowId,
      deviceAuthId,
      userCode,
      verifyUrl,
      intervalSeconds,
      expiresAtMs,
      abortController,
      pollingStarted: false,
      timeout,
      cleanupTimeout: null,
      resultPromise,
      resolveResult,
      settled: false,
    });

    log.debug(`[Codex OAuth] Device flow started (flowId=${flowId})`);

    return Ok({ flowId, userCode, verifyUrl, intervalSeconds });
  }

  async waitForDeviceFlow(
    flowId: string,