ruvnet/ruflo · error · Error

Convoy not found: ${validated.convoy_id}

Error message

Convoy not found: ${validated.convoy_id}

What it means

The wasm_optimize_convoy tool queried the convoy status for the validated convoy_id and got an empty list, meaning no convoy exists under that id. The tool refuses to run WASM optimization against a nonexistent convoy rather than fabricating a result.

Source

Thrown at v3/plugins/gastown-bridge/src/mcp-tools.ts:1736

  version: '0.1.0',
  layer: 'wasm',
  inputSchema: WasmOptimizeConvoyInputSchema,
  handler: async (input, context): Promise<MCPToolResult<WasmOptimizeConvoyResult>> => {
    const startTime = Date.now();

    try {
      const validated = WasmOptimizeConvoyInputSchema.parse(input);
      const depWasm = context.bridges.dependencyWasm;
      const bridge = context.bridges.gastown;

      if (!depWasm.isInitialized()) {
        await depWasm.initialize();
      }

      // Get convoy details
      const convoys = await bridge.getConvoyStatus(validated.convoy_id, true);
      if (convoys.length === 0) {
        throw new Error(`Convoy not found: ${validated.convoy_id}`);
      }

      const convoy = convoys[0];

      const wasmStart = Date.now();
      const optimization = await depWasm.optimizeConvoy(
        convoy,
        validated.strategy,
        validated.resource_constraints
      );
      const wasmDuration = Date.now() - wasmStart;

      const result: WasmOptimizeConvoyResult = {
        success: true,
        optimization,
        wasmPerformanceMs: wasmDuration,
        durationMs: Date.now() - startTime,
      };

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Verify the referenced identifier exists before use (list available items and match against user input).
2. Return a clear 404-style error listing valid identifiers, and have the caller retry with an existing id.

When it happens

Trigger: Thrown at v3/plugins/gastown-bridge/src/mcp-tools.ts:1736 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/12c0ec8eb55cec68. Report an issue: GitHub.