ruvnet/ruflo · error

Session not found for initialization

Error message

Session not found for initialization

What it means

Guard in SessionManager.initializeSession(): no session exists under the given sessionId, so initialization (client info, transition to 'ready') cannot proceed and undefined is returned. Typically a stale, expired, or never-created session id.

Source

Thrown at v3/@claude-flow/shared/src/mcp/session-manager.ts:115

    this.sessions.set(id, session);
    this.totalCreated++;

    this.logger.debug('Session created', { id, transport });
    this.emit('session:created', session);

    return session;
  }

  /**
   * Initialize a session with client information
   */
  initializeSession(
    sessionId: string,
    params: MCPInitializeParams
  ): MCPSession | undefined {
    const session = this.sessions.get(sessionId);
    if (!session) {
      this.logger.warn('Session not found for initialization', { sessionId });
      return undefined;
    }

    session.state = 'ready';
    session.isInitialized = true;
    session.clientInfo = params.clientInfo;
    session.protocolVersion = params.protocolVersion;
    session.capabilities = params.capabilities;
    session.lastActivityAt = new Date();

    this.logger.info('Session initialized', {
      sessionId,
      clientInfo: params.clientInfo,
      protocolVersion: params.protocolVersion,
    });

    this.emit('session:initialized', session);
    return session;

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Create/register the session before initialization; ensure the session ID passed exists in the session manager.

When it happens

Trigger: Thrown at v3/@claude-flow/shared/src/mcp/session-manager.ts:115 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/29b488f253e33a20. Report an issue: GitHub.