ruvnet/ruflo · error

A2A agent card server close error: ${err instanceof Error ?

Error message

A2A agent card server close error: ${err instanceof Error ? err.message : err}

What it means

Log warning in shutdown: closing the A2A agent-card server threw; the error is contained so shutdown proceeds to release the coordinator and transport anyway.

Source

Thrown at v3/@claude-flow/plugin-agent-federation/src/plugin.ts:542

        context.logger.info(`A2A agent card served at ${this.agentCardServer.url}`);
      } catch (err) {
        context.logger.warn(
          `A2A agent card endpoint unavailable (${err instanceof Error ? err.message : err}); ` +
            'federation continues without the A2A discovery surface',
        );
        this.agentCardServer = null;
      }
    }

    context.logger.info('Agent Federation plugin initialized');
  }

  async shutdown(): Promise<void> {
    if (this.agentCardServer) {
      try {
        await this.agentCardServer.close();
      } catch (err) {
        this.context?.logger.warn(
          `A2A agent card server close error: ${err instanceof Error ? err.message : err}`,
        );
      }
      this.agentCardServer = null;
    }
    if (this.coordinator) {
      await this.coordinator.shutdown();
      this.coordinator = null;
    }
    if (this.transport) {
      try {
        await this.transport.close?.();
      } catch (err) {
        this.context?.logger.warn(
          `Federation transport close error: ${err instanceof Error ? err.message : err}`,
        );
      }
      this.transport = null;

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Inspect the close error; it is usually benign during shutdown but repeated occurrences indicate a double-close or dangling connection bug to fix.

When it happens

Trigger: Thrown at v3/@claude-flow/plugin-agent-federation/src/plugin.ts:542 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/38f96c86fac95f13. Report an issue: GitHub.