Method getSession

src/sessionManager.ts:357–410

(
    sessionId: string,
    config: Config,
    createIfMissing: boolean = true,
  )

  // Get a specific session by ID
  async getSession(
    sessionId: string,
    config: Config,
    createIfMissing: boolean = true,
  ): Promise<BrowserSession | null> {
    if (sessionId === this.defaultSessionId && createIfMissing) {
      try {
        return await this.ensureDefaultSessionInternal(config);
      } catch {
        process.stderr.write(
          `[SessionManager] Failed to get default session due to error in ensureDefaultSessionInternal for ${sessionId}. See previous messages for details.\n`,
        );
        return null;
      }
    }

    // For non-default sessions
    process.stderr.write(`[SessionManager] Getting session: ${sessionId}\n`);
    const sessionObj = this.browsers.get(sessionId);

    if (!sessionObj) {
      process.stderr.write(
        `[SessionManager] WARN - Session not found in map: ${sessionId}\n`,
      );
      return null;
    }

    try {
      const pages = sessionObj.stagehand.context.pages();
      if (!pages || pages.length === 0) {
        throw new Error("No pages available");
      }
    } catch {
      process.stderr.write(
        `[SessionManager] WARN - Found session ${sessionId} is stale, removing.\n`,
      );
      await this.closeBrowserGracefully(sessionObj, sessionId);
      this.browsers.delete(sessionId);
      if (this.activeSessionId === sessionId) {
        process.stderr.write(
          `[SessionManager] WARN - Invalidated active session ${sessionId}, resetting to default.\n`,
        );
        this.setActiveSessionId(this.defaultSessionId);
      }
      return null;
    }

    // Session appears valid, make it active
    this.setActiveSessionId(sessionId);
    process.stderr.write(
      `[SessionManager] Using valid session: ${sessionId}\n`,
    );
    return sessionObj;
  }

  /**
   * Clean up a session by closing the browser and removing it from tracking.