Method findPort

src/index.ts:60–82

* Scans for an existing DocsAgent service or an available port.

()

   * Scans for an existing DocsAgent service or an available port.
   */
  private async findPort(): Promise<number> {
    const START_PORT = 18688;
    // We scan a reasonable range first for an existing service
    for (let p = START_PORT; p < START_PORT + 20; p++) {
      try {
        const controller = new AbortController();
        const timeoutId = setTimeout(() => controller.abort(), 100);
        const res = await fetch(`http://localhost:${p}/status`, { signal: controller.signal });
        clearTimeout(timeoutId);
        if (res.ok) return p;
      } catch {
        // Not responding or not DocsAgent
      }
    }

    // If no existing service, find the first available port
    let p = START_PORT;
    while (p < 65535) {
      if (await this.isPortAvailable(p)) return p;
      p++;
    }
    throw new Error("No available ports found");
  }

  /**
   * Starts the C++ background process and waits for the HTTP interface to be ready.