RelayPlane

Instructions

Implementation Reference

• src/tools/relay-runs-list.ts:41-66 (handler)

  The core handler function for the 'relay_runs_list' tool. Fetches recent runs from the run store, computes summaries with metrics like duration, tokens, cost, and trace URLs, and returns the formatted list.

  export async function relayRunsList(
    input: RelayRunsListInput
  ): Promise<RelayRunsListResponse> {
    const limit = input.limit || 10;
    const runs = getRecentRuns(limit);
    const config = getConfig();
  
    const summaries: RunSummary[] = runs.map((run: RunRecord) => ({
      runId: run.runId,
      type: run.type,
      name: run.type === 'workflow' ? run.workflowName : undefined,
      model: run.type === 'single' ? run.model : undefined,
      success: run.success,
      startTime: run.startTime.toISOString(),
      durationMs: run.durationMs,
      totalTokens: run.usage.totalTokens,
      estimatedCostUsd: run.usage.estimatedProviderCostUsd,
      traceUrl: `${config.traceUrlBase}/${run.runId}`,
      contextReduction: run.contextReduction,
    }));
  
    return {
      runs: summaries,
      total: summaries.length,
    };
  }

• src/tools/relay-runs-list.ts:11-18 (schema)

  Zod schema defining the input parameters for the relay_runs_list tool, including an optional limit for the number of runs.

  export const relayRunsListSchema = z.object({
    limit: z
      .number()
      .min(1)
      .max(50)
      .optional()
      .describe('Number of runs to return (default: 10, max: 50)'),
  });

• src/tools/relay-runs-list.ts:68-80 (registration)

  MCP tool definition object specifying the name, description, and input schema structure for registration.

  export const relayRunsListDefinition = {
    name: 'relay_runs_list',
    description: 'List recent workflow runs for debugging and reference.',
    inputSchema: {
      type: 'object' as const,
      properties: {
        limit: {
          type: 'number',
          description: 'Number of runs to return (default: 10, max: 50)',
        },
      },
    },
  };

• src/server.ts:59-67 (registration)

  Array of all tool definitions, including relayRunsListDefinition, registered with the MCP server's listTools request handler.

  const TOOLS = [
    relayModelsListDefinition,
    relayRunDefinition,
    relayWorkflowRunDefinition,
    relayWorkflowValidateDefinition,
    relaySkillsListDefinition,
    relayRunsListDefinition,
    relayRunGetDefinition,
  ];

• src/server.ts:134-137 (handler)

  Dispatch logic in the MCP callTool request handler: parses arguments with the tool schema and invokes the relayRunsList handler function.

  case 'relay_runs_list': {
    const parsed = relayRunsListSchema.parse(args || {});
    result = await relayRunsList(parsed);
    break;