get_suite_run_status
Check the current execution status of a BugBug test suite run using its unique identifier to monitor test progress and completion.
Instructions
Get current status of a BugBug suite run
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | Yes | Suite run UUID |
Implementation Reference
- src/tools/suiteRuns.ts:65-109 (handler)The complete tool object definition for 'get_suite_run_status', including the handler function that executes the tool logic by calling the bugbugClient API and formatting the response.
export const getSuiteRunStatusTool: Tool = { name: 'get_suite_run_status', title: 'Get current status of a BugBug suite run', description: 'Get current status of a BugBug suite run', inputSchema: z.object({ runId: z.string().describe('Suite run UUID'), }).shape, handler: async ({ runId }) => { try { const statusResponse = await bugbugClient.getSuiteRunStatus(runId); if (statusResponse.status !== 200) { return { content: [ { type: 'text', text: `Error: ${statusResponse.status} ${statusResponse.statusText}`, }, ], }; } const status = statusResponse.data; return { content: [ { type: 'text', text: `**Suite Run Status:**\n\n- **ID:** ${status.id}\n- **Status:** ${status.status}\n- **Last Modified:** ${status.modified}\n- **Web App URL:** ${status.webappUrl}`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error fetching suite run status: ${error instanceof Error ? error.message : 'Unknown error'}`, }, ], }; } } }; - src/tools/suiteRuns.ts:69-71 (schema)Zod input schema for the tool, validating the runId parameter.
inputSchema: z.object({ runId: z.string().describe('Suite run UUID'), }).shape, - src/tools/index.ts:11-33 (registration)Registration function that registers all tools, including get_suite_run_status from suiteRunsTools, using MCP server.registerTool.
export function registerAllTools(server: McpServer): void { const tools: Record<string, Tool> = { ...configTools, ...testsTools, ...testRunsTools, ...suitesTools, ...suiteRunsTools, ...profilesTools, ...advancedTools, }; for (const t in tools) { server.registerTool( tools[t].name, { description: tools[t].description, inputSchema: tools[t].inputSchema, annotations: { title: tools[t].title }, }, (args: unknown) => tools[t].handler(args as unknown) ); } } - src/services/bugbugClient.ts:179-181 (helper)Helper method in BugBugApiClient that makes the API request to retrieve suite run status.
async getSuiteRunStatus(id: string): Promise<ApiResponse<BugBugRunStatusResponse>> { return this.makeRequest(`/suiteruns/${id}/status/`); } - src/tools/index.ts:7-7 (registration)Import of suiteRuns tools module containing the getSuiteRunStatusTool.
import * as suiteRunsTools from './suiteRuns.js';