ruvnet/ruflo · error · QECoreError

Failed to send message

Error message

Failed to send message

What it means

AgentHandleImpl.send caught an error from agentService.sendMessage for this agent id and rethrew as QECoreError. The message could not be delivered (agent terminated, mailbox closed, or service failure); the payload itself is only the vehicle, not the cause.

Source

Thrown at v3/plugins/agentic-qe/src/bridges/QECoreBridge.ts:500

  async terminate(): Promise<void> {
    try {
      this.logger.debug(`Terminating agent: ${this.id}`);
      await this.agentService.terminate(this.id);
      this._status = 'terminated';
    } catch (error) {
      this.logger.error(`Failed to terminate agent: ${this.id}`, error);
      throw new QECoreError('Failed to terminate agent', error as Error);
    }
  }

  async send(message: Record<string, unknown>): Promise<void> {
    try {
      this.logger.debug(`Sending message to agent: ${this.id}`);
      await this.agentService.sendMessage(this.id, message);
    } catch (error) {
      this.logger.error(`Failed to send message to agent: ${this.id}`, error);
      throw new QECoreError('Failed to send message', error as Error);
    }
  }
}

/**
 * Task Handle Implementation
 */
class TaskHandleImpl implements TaskHandle {
  readonly id: string;
  readonly type: string;
  private _status: TaskHandle['status'];
  private taskService: ITaskService;
  private logger: QELogger;

  constructor(
    task: CreatedTask,
    taskService: ITaskService,
    logger: QELogger

View on GitHub (pinned to fa13ee4ad6)

Solutions

  1. Verify the message target exists and the transport is connected.
  2. Inspect the underlying send error.
Defensive patterns

Strategy: try-catch

When it happens

Trigger: Thrown at v3/plugins/agentic-qe/src/bridges/QECoreBridge.ts:500 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/cabc8fe816b26e67. Report an issue: GitHub.