Get Test Suite Results

Instructions

Implementation Reference

• handlers/getTestSuiteResultsHandler.ts:14-44 (handler)

  Main handler for get_test_suite_results tool. Resolves suiteUuid (directly or via suiteName+project), then fetches and returns full test suite detail including per-test outcomes.

  export async function getTestSuiteResultsHandler(
    input: GetTestSuiteResultsInput,
    _context: ToolContext,
  ): Promise<ToolResponse> {
    const start = Date.now();
    logger.toolStart('get_test_suite_results', input);
    try {
      const client = new DebuggAIServerClient(config.api.key);
      await client.init();
  
      let suiteUuid = input.suiteUuid;
      if (!suiteUuid) {
        let projectUuid = input.projectUuid;
        if (!projectUuid) {
          const resolved = await resolveProject(client, input.projectName!);
          if ('error' in resolved) return errorResp(resolved.error, resolved.message, { candidates: (resolved as any).candidates });
          projectUuid = resolved.uuid;
        }
        const resolved = await resolveTestSuite(client, input.suiteName!, projectUuid);
        if ('error' in resolved) return errorResp(resolved.error, resolved.message, { candidates: (resolved as any).candidates });
        suiteUuid = resolved.uuid;
      }
  
      const detail = await client.getTestSuiteDetail(suiteUuid);
      logger.toolComplete('get_test_suite_results', Date.now() - start);
      return { content: [{ type: 'text', text: JSON.stringify(detail, null, 2) }] };
    } catch (error) {
      logger.toolError('get_test_suite_results', error as Error, Date.now() - start);
      throw handleExternalServiceError(error, 'DebuggAI', 'get_test_suite_results');
    }
  }

• types/index.ts:418-423 (schema)

  Zod schema (GetTestSuiteResultsInputSchema) defining input: optional suiteUuid or suiteName + projectUuid/projectName. Type inferred as GetTestSuiteResultsInput.

  export const GetTestSuiteResultsInputSchema = z.object({
    ...suiteIdentifier,
    ...projectIdentifier,
  }).strict();
  
  export type GetTestSuiteResultsInput = z.infer<typeof GetTestSuiteResultsInputSchema>;

• tools/testSuiteTools.ts:202-220 (registration)

  buildGetTestSuiteResultsTool() defines the tool name, title, description, and inputSchema. buildValidatedGetTestSuiteResultsTool() wires schema + handler together.

  export function buildGetTestSuiteResultsTool(): Tool {
    return {
      name: 'get_test_suite_results',
      title: 'Get Test Suite Results',
      description: 'Fetch a test suite with full per-test results. Returns suite-level status (NEVER_RUN, PENDING, RUNNING, COMPLETED, ERROR), pass rate, last run timestamp, and per-test outcomes (PASS, FAIL, ERROR, TIMEOUT, etc.) with execution times. Accepts suiteUuid directly or suiteName + project identifier.',
      inputSchema: {
        type: 'object',
        properties: {
          ...SUITE_PROPS,
          ...PROJECT_PROPS,
        },
        additionalProperties: false,
      },
    };
  }
  
  export function buildValidatedGetTestSuiteResultsTool(): ValidatedTool {
    return { ...buildGetTestSuiteResultsTool(), inputSchema: GetTestSuiteResultsInputSchema, handler: getTestSuiteResultsHandler };
  }

• tools/index.ts:34-85 (registration)

  initTools() registers all tools including buildGetTestSuiteResultsTool() and buildValidatedGetTestSuiteResultsTool() into the tool registry.

  export function initTools(ctx: ProjectContext | null): void {
    const tools: Tool[] = [
      buildTestPageChangesTool(ctx),
      buildTriggerCrawlTool(ctx),
      buildProbePageTool(),
      buildSearchProjectsTool(),
      buildSearchEnvironmentsTool(),
      buildCreateEnvironmentTool(),
      buildUpdateEnvironmentTool(),
      buildDeleteEnvironmentTool(),
      buildUpdateProjectTool(),
      buildDeleteProjectTool(),
      buildSearchExecutionsTool(),
      buildCreateProjectTool(),
      buildCreateTestSuiteTool(),
      buildSearchTestSuitesTool(),
      buildDeleteTestSuiteTool(),
      buildCreateTestCaseTool(),
      buildUpdateTestCaseTool(),
      buildDeleteTestCaseTool(),
      buildRunTestSuiteTool(),
      buildGetTestSuiteResultsTool(),
    ];
    const validated: ValidatedTool[] = [
      buildValidatedTestPageChangesTool(ctx),
      buildValidatedTriggerCrawlTool(ctx),
      buildValidatedProbePageTool(),
      buildValidatedSearchProjectsTool(),
      buildValidatedSearchEnvironmentsTool(),
      buildValidatedCreateEnvironmentTool(),
      buildValidatedUpdateEnvironmentTool(),
      buildValidatedDeleteEnvironmentTool(),
      buildValidatedUpdateProjectTool(),
      buildValidatedDeleteProjectTool(),
      buildValidatedSearchExecutionsTool(),
      buildValidatedCreateProjectTool(),
      buildValidatedCreateTestSuiteTool(),
      buildValidatedSearchTestSuitesTool(),
      buildValidatedDeleteTestSuiteTool(),
      buildValidatedCreateTestCaseTool(),
      buildValidatedUpdateTestCaseTool(),
      buildValidatedDeleteTestCaseTool(),
      buildValidatedRunTestSuiteTool(),
      buildValidatedGetTestSuiteResultsTool(),
    ];
  
    _tools = tools;
    _validatedTools = validated;
  
    toolRegistry.clear();
    for (const v of validated) toolRegistry.set(v.name, v);
  }