@checkview/mcp-server 1.1.0

package/dist/tools/run-test.js

@@ -0,0 +1,186 @@
+import { z } from "zod";
+import { ApiError, idempotencyKey } from "../api-client.js";
+import { formatTestRun } from "../format.js";
+import { pollUntil } from "../polling.js";
+const TERMINAL_STATUSES = new Set([
+    "success",
+    "error",
+    "aborted",
+    "awaiting_email",
+]);
+export function registerRunTestTool(server, client) {
+    server.registerTool("checkview_run_test", {
+        description: "Run an existing CheckView test flow and return results. Optionally provide one-time login credentials.",
+        inputSchema: {
+            test_flow_id: z.string().uuid().describe("The test flow ID to execute"),
+            wait_for_result: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Wait for test to complete and return results (default true)"),
+            credentials: z
+                .object({
+                username: z.string(),
+                password: z.string(),
+            })
+                .optional()
+                .describe("One-time login credentials (encrypted, auto-deleted after 5 min)"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async (args, extra) => {
+        try {
+            // Trigger execution
+            const idemKey = idempotencyKey(`${args.test_flow_id}:${Date.now()}`);
+            const body = { trigger: "api" };
+            if (args.credentials) {
+                body.credentials = args.credentials;
+            }
+            let execution;
+            try {
+                const result = await client.post(`/test-flows/${args.test_flow_id}/executions`, body, idemKey, extra.signal);
+                execution = result.body;
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    // Handle idempotency in-progress (retry with backoff)
+                    if (error.status === 409 &&
+                        error.type ===
+                            "https://api.checkview.io/errors/request-in-progress") {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "A request is currently being processed. Please try again in a few seconds.",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    // Handle test already running
+                    if (error.status === 409) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "A test is already running for this test flow. Please wait for it to complete.",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    // Handle monthly limit
+                    if (error.status === 403) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "Monthly test limit reached. Please upgrade your plan or wait until next month.",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    // Handle paused/no steps
+                    if (error.status === 400) {
+                        return {
+                            content: [{ type: "text", text: error.detail }],
+                            isError: true,
+                        };
+                    }
+                    // Cached error replay — retry with fresh key
+                    if (error.isReplay && error.status >= 400) {
+                        const freshKey = idempotencyKey(`${args.test_flow_id}:retry:${Date.now()}`);
+                        const retryResult = await client.post(`/test-flows/${args.test_flow_id}/executions`, body, freshKey, extra.signal);
+                        execution = retryResult.body;
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            const testRunId = execution.id;
+            if (!args.wait_for_result) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Test triggered successfully.\n\nTest run ID: ${testRunId}\n\nUse checkview_get_results("${testRunId}") to check results later.`,
+                        },
+                    ],
+                };
+            }
+            // Poll for completion
+            await server.sendLoggingMessage({
+                level: "info",
+                data: `Test run ${testRunId} started. Polling for completion...`,
+            });
+            let lastResult = { id: testRunId, status: "started" };
+            let finalResult;
+            try {
+                finalResult = await pollUntil(async () => {
+                    try {
+                        const r = await client.get(`/test-runs/${testRunId}`, undefined, extra.signal);
+                        lastResult = r.body;
+                        return r.body;
+                    }
+                    catch (error) {
+                        // Swallow transient server errors
+                        if (error instanceof ApiError && error.status >= 500) {
+                            return lastResult;
+                        }
+                        throw error;
+                    }
+                }, (result) => TERMINAL_STATUSES.has(result.status), {
+                    intervalMs: 10_000,
+                    timeoutMs: 600_000, // 10 min
+                    signal: extra.signal,
+                    onProgress: (result) => {
+                        server
+                            .sendLoggingMessage({
+                            level: "info",
+                            data: `Test run ${testRunId}: status=${result.status}`,
+                        })
+                            .catch(() => { });
+                    },
+                });
+            }
+            catch (error) {
+                const isTimeout = error instanceof Error &&
+                    error.message.startsWith("Operation timed out");
+                if (isTimeout) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Test run ${testRunId} is still ${lastResult.status} after 10 min. Use checkview_get_results("${testRunId}") to check later.`,
+                            },
+                        ],
+                    };
+                }
+                throw error;
+            }
+            return {
+                content: [{ type: "text", text: formatTestRun(finalResult) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to run test: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=run-test.js.map

package/dist/tools/run-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-test.js","sourceRoot":"","sources":["../../src/tools/run-test.ts"],"names":[],"mappings":"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"}

package/dist/tools/run-ux-audit.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ApiClient } from "../api-client.js";
+export declare function registerRunUxAuditTool(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=run-ux-audit.d.ts.map

package/dist/tools/run-ux-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ux-audit.d.ts","sourceRoot":"","sources":["../../src/tools/run-ux-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAiB5E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CAiON"}

package/dist/tools/run-ux-audit.js

@@ -0,0 +1,192 @@
+import { z } from "zod";
+import { ApiError, idempotencyKey } from "../api-client.js";
+import { pollUntil } from "../polling.js";
+export function registerRunUxAuditTool(server, client) {
+    server.registerTool("checkview_run_ux_audit", {
+        description: "Run a UX audit on selected test flows for a website. Generates an AI-powered report analyzing screenshots.",
+        inputSchema: {
+            website_id: z.string().uuid().describe("The website ID"),
+            name: z
+                .string()
+                .min(1)
+                .max(255)
+                .describe("Name for the UX audit report"),
+            test_flow_ids: z
+                .array(z.string().uuid())
+                .min(1)
+                .max(20)
+                .describe("Test flow IDs to include in the audit (1-20)"),
+            wait_for_result: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Wait for audit to complete and return report (default true)"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async (args, extra) => {
+        try {
+            const sortedFlows = [...args.test_flow_ids].sort();
+            const idemKey = idempotencyKey(`${args.website_id}:${args.name}:${sortedFlows.join(",")}`);
+            let audit;
+            try {
+                const result = await client.post(`/websites/${args.website_id}/ux-audits`, { name: args.name, testFlowIds: args.test_flow_ids }, idemKey, extra.signal);
+                audit = result.body;
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    if (error.status === 400) {
+                        return {
+                            content: [{ type: "text", text: error.detail }],
+                            isError: true,
+                        };
+                    }
+                    if (error.status === 403) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "Monthly UX audit limit reached. Please upgrade your plan or wait until next month.",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (error.status === 404) {
+                        return {
+                            content: [
+                                { type: "text", text: "Website or test flows not found." },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (error.isReplay && error.status >= 400) {
+                        const freshKey = idempotencyKey(`${args.website_id}:${args.name}:${sortedFlows.join(",")}:retry:${Date.now()}`);
+                        const retryResult = await client.post(`/websites/${args.website_id}/ux-audits`, { name: args.name, testFlowIds: args.test_flow_ids }, freshKey, extra.signal);
+                        audit = retryResult.body;
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            const auditId = audit.id;
+            if (!args.wait_for_result) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `UX audit "${args.name}" created.\n\nAudit ID: ${auditId}\n\nUse checkview_list_ux_audits to check status.`,
+                        },
+                    ],
+                };
+            }
+            // Poll for completion
+            await server.sendLoggingMessage({
+                level: "info",
+                data: `UX audit ${auditId} started. Polling for completion...`,
+            });
+            let lastStatus = audit;
+            // Outer try-catch to handle poll timeout gracefully
+            let finalAudit;
+            try {
+                finalAudit = await pollUntil(async () => {
+                    try {
+                        const r = await client.get(`/websites/${args.website_id}/ux-audits/${auditId}`, undefined, extra.signal);
+                        lastStatus = r.body;
+                        return r.body;
+                    }
+                    catch (error) {
+                        // Swallow transient server errors
+                        if (error instanceof ApiError && error.status >= 500) {
+                            return lastStatus;
+                        }
+                        throw error;
+                    }
+                }, (result) => result.status === "ready" || result.status === "error", {
+                    intervalMs: 15_000,
+                    timeoutMs: 600_000, // 10 min
+                    signal: extra.signal,
+                    onProgress: (result) => {
+                        server
+                            .sendLoggingMessage({
+                            level: "info",
+                            data: `UX audit ${auditId}: status=${result.status}`,
+                        })
+                            .catch(() => { });
+                    },
+                });
+            }
+            catch (error) {
+                const isTimeout = error instanceof Error &&
+                    error.message.startsWith("Operation timed out");
+                if (isTimeout) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Audit ${auditId} is still ${lastStatus.status} after 10 min. Check back with checkview_list_ux_audits.`,
+                            },
+                        ],
+                    };
+                }
+                throw error;
+            }
+            if (finalAudit.status === "error") {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `UX audit "${args.name}" failed.\n\nAudit ID: ${auditId}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Fetch report
+            try {
+                const { body: report } = await client.get(`/websites/${args.website_id}/ux-audits/${auditId}/report`, undefined, extra.signal);
+                const reportText = typeof report.report_data === "string"
+                    ? report.report_data
+                    : JSON.stringify(report.report_data, null, 2);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `## UX Audit: ${args.name}\n\nAudit ID: ${auditId}\n\n${reportText}`,
+                        },
+                    ],
+                };
+            }
+            catch {
+                // Report fetch failed (may have been deleted)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `UX audit "${args.name}" completed but report could not be fetched.\n\nAudit ID: ${auditId}`,
+                        },
+                    ],
+                };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to run UX audit: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=run-ux-audit.js.map

package/dist/tools/run-ux-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ux-audit.js","sourceRoot":"","sources":["../../src/tools/run-ux-audit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAkB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAgB1C,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAiB;IAEjB,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,4GAA4G;QAC9G,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACxD,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,8BAA8B,CAAC;YAC3C,aAAa,EAAE,CAAC;iBACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;iBACxB,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,CAAC,8CAA8C,CAAC;YAC3D,eAAe,EAAE,CAAC;iBACf,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CACP,6DAA6D,CAC9D;SACJ;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;SACrB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,OAAO,GAAG,cAAc,CAC5B,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC3D,CAAC;YAEF,IAAI,KAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,aAAa,IAAI,CAAC,UAAU,YAAY,EACxC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,EACpD,OAAO,EACP,KAAK,CAAC,MAAM,CACb,CAAC;gBACF,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;oBAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACzB,OAAO;4BACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;4BAC/C,OAAO,EAAE,IAAI;yBACd,CAAC;oBACJ,CAAC;oBACD,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACzB,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,oFAAoF;iCAC3F;6BACF;4BACD,OAAO,EAAE,IAAI;yBACd,CAAC;oBACJ,CAAC;oBACD,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACzB,OAAO;4BACL,OAAO,EAAE;gCACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kCAAkC,EAAE;6BAC3D;4BACD,OAAO,EAAE,IAAI;yBACd,CAAC;oBACJ,CAAC;oBACD,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;wBAC1C,MAAM,QAAQ,GAAG,cAAc,CAC7B,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE,CAC/E,CAAC;wBACF,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CACnC,aAAa,IAAI,CAAC,UAAU,YAAY,EACxC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,EACpD,QAAQ,EACR,KAAK,CAAC,MAAM,CACb,CAAC;wBACF,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;oBAC3B,CAAC;yBAAM,CAAC;wBACN,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;YAEzB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,2BAA2B,OAAO,mDAAmD;yBAClH;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,sBAAsB;YACtB,MAAM,MAAM,CAAC,kBAAkB,CAAC;gBAC9B,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,YAAY,OAAO,qCAAqC;aAC/D,CAAC,CAAC;YAEH,IAAI,UAAU,GAAoB,KAAK,CAAC;YAExC,oDAAoD;YACpD,IAAI,UAA2B,CAAC;YAChC,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,SAAS,CAC1B,KAAK,IAAI,EAAE;oBACT,IAAI,CAAC;wBACH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,GAAG,CACxB,aAAa,IAAI,CAAC,UAAU,cAAc,OAAO,EAAE,EACnD,SAAS,EACT,KAAK,CAAC,MAAM,CACb,CAAC;wBACF,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;wBACpB,OAAO,CAAC,CAAC,IAAI,CAAC;oBAChB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,kCAAkC;wBAClC,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;4BACrD,OAAO,UAAU,CAAC;wBACpB,CAAC;wBACD,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAClE;oBACE,UAAU,EAAE,MAAM;oBAClB,SAAS,EAAE,OAAO,EAAE,SAAS;oBAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;wBACrB,MAAM;6BACH,kBAAkB,CAAC;4BAClB,KAAK,EAAE,MAAM;4BACb,IAAI,EAAE,YAAY,OAAO,YAAY,MAAM,CAAC,MAAM,EAAE;yBACrD,CAAC;6BACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACrB,CAAC;iBACF,CACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,SAAS,GACb,KAAK,YAAY,KAAK;oBACtB,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;gBAClD,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,SAAS,OAAO,aAAa,UAAU,CAAC,MAAM,0DAA0D;6BAC/G;yBACF;qBACF,CAAC;gBACJ,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,0BAA0B,OAAO,EAAE;yBAChE;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,eAAe;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACvC,aAAa,IAAI,CAAC,UAAU,cAAc,OAAO,SAAS,EAC1D,SAAS,EACT,KAAK,CAAC,MAAM,CACb,CAAC;gBAEF,MAAM,UAAU,GACd,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;oBACpC,CAAC,CAAC,MAAM,CAAC,WAAW;oBACpB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBAElD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,gBAAgB,IAAI,CAAC,IAAI,iBAAiB,OAAO,OAAO,UAAU,EAAE;yBAC3E;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;gBAC9C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,6DAA6D,OAAO,EAAE;yBACnG;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC1F;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/set-organization.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerSetOrganizationTool(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=set-organization.d.ts.map

package/dist/tools/set-organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-organization.d.ts","sourceRoot":"","sources":["../../src/tools/set-organization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQlD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CA8IN"}

package/dist/tools/set-organization.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import { ApiError } from "../api-client.js";
+export function registerSetOrganizationTool(server, client) {
+    server.registerTool("checkview_set_organization", {
+        description: "Switch to a different organization for all subsequent operations. " +
+            "Only super admins can switch to organizations other than their default. " +
+            "Use checkview_list_organizations to find organization IDs. " +
+            'Pass "reset" as organization_id to return to your default organization.',
+        inputSchema: {
+            organization_id: z
+                .string()
+                .describe('The organization UUID to switch to, or "reset" to return to the default organization from your PAT'),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+        },
+    }, async (args, extra) => {
+        try {
+            if (args.organization_id === "reset") {
+                client.clearOrganizationOverride();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Organization override cleared. Now using default organization from your access token.",
+                        },
+                    ],
+                };
+            }
+            // Validate UUID format
+            const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+            if (!uuidRegex.test(args.organization_id)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Invalid organization ID format. Must be a UUID.",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Set the override and verify it works
+            client.setOrganizationOverride(args.organization_id);
+            try {
+                const { body: org } = await client.get("/organizations/me", undefined, extra.signal);
+                // Detect silent guard rejection: if the API returned a different org,
+                // the guard reset the tenant (user is not a super admin).
+                // Compare case-insensitively since UUIDs may differ in case.
+                if (org.id.toLowerCase() !== args.organization_id.toLowerCase()) {
+                    client.clearOrganizationOverride();
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "Failed to switch organization. You may not have admin access to other organizations.",
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Switched to organization: **${org.name}** (${org.id})\n` +
+                                "All subsequent commands will operate in this organization's context.\n" +
+                                'Use checkview_set_organization with "reset" to return to your default organization.',
+                        },
+                    ],
+                };
+            }
+            catch (verifyError) {
+                // Revert the override on any verification failure
+                client.clearOrganizationOverride();
+                if (verifyError instanceof ApiError) {
+                    if (verifyError.status === 401) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "Authentication failed. Your API key may be expired or revoked.",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (verifyError.status === 403) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "Access denied. Only CheckView super admins can switch organizations.",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (verifyError.status === 404) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Organization not found: ${args.organization_id}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                }
+                throw verifyError;
+            }
+        }
+        catch (error) {
+            client.clearOrganizationOverride();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to switch organization: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=set-organization.js.map

package/dist/tools/set-organization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-organization.js","sourceRoot":"","sources":["../../src/tools/set-organization.ts"],"names":[],"mappings":"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"}

package/dist/tools/test-url.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ApiClient } from "../api-client.js";
+export declare function registerTestUrlTool(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=test-url.d.ts.map

package/dist/tools/test-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-url.d.ts","sourceRoot":"","sources":["../../src/tools/test-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA8B5E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CAoYN"}