edgegate-mcp 0.1.1

package/dist/tools/create_pipeline.d.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { EdgeGateClient } from "../client.js";
+import type { ToolResult } from "./setup_workspace.js";
+export declare const createPipelineInputSchema: z.ZodObject<{
+    workspace_id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    models: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        artifact_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        artifact_id: string;
+    }, {
+        name: string;
+        artifact_id: string;
+    }>, "many">;
+    devices: z.ZodArray<z.ZodString, "many">;
+    gates: z.ZodArray<z.ZodObject<{
+        metric: z.ZodEnum<["inference_time_ms", "peak_memory_mb", "throughput_tps"]>;
+        operator: z.ZodEnum<["<=", "<", ">=", ">", "=="]>;
+        threshold: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        metric: "inference_time_ms" | "peak_memory_mb" | "throughput_tps";
+        operator: "<=" | "<" | ">=" | ">" | "==";
+        threshold: number;
+    }, {
+        metric: "inference_time_ms" | "peak_memory_mb" | "throughput_tps";
+        operator: "<=" | "<" | ">=" | ">" | "==";
+        threshold: number;
+    }>, "many">;
+    promptpack_id: z.ZodOptional<z.ZodString>;
+    repeats: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    workspace_id: string;
+    name: string;
+    models: {
+        name: string;
+        artifact_id: string;
+    }[];
+    devices: string[];
+    gates: {
+        metric: "inference_time_ms" | "peak_memory_mb" | "throughput_tps";
+        operator: "<=" | "<" | ">=" | ">" | "==";
+        threshold: number;
+    }[];
+    description?: string | undefined;
+    promptpack_id?: string | undefined;
+    repeats?: number | undefined;
+}, {
+    workspace_id: string;
+    name: string;
+    models: {
+        name: string;
+        artifact_id: string;
+    }[];
+    devices: string[];
+    gates: {
+        metric: "inference_time_ms" | "peak_memory_mb" | "throughput_tps";
+        operator: "<=" | "<" | ">=" | ">" | "==";
+        threshold: number;
+    }[];
+    description?: string | undefined;
+    promptpack_id?: string | undefined;
+    repeats?: number | undefined;
+}>;
+export type CreatePipelineInput = z.infer<typeof createPipelineInputSchema>;
+export declare function createPipelineHandler(client: EdgeGateClient, input: CreatePipelineInput): Promise<ToolResult>;

package/dist/tools/create_pipeline.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { EdgeGateError } from "../client.js";
+const MAX_CELLS = 25;
+export const createPipelineInputSchema = z.object({
+    workspace_id: z.string().uuid(),
+    name: z.string().min(1).max(255),
+    description: z.string().optional(),
+    models: z
+        .array(z.object({ name: z.string().min(1), artifact_id: z.string().min(1) }))
+        .min(1)
+        .max(10),
+    devices: z.array(z.string().min(1)).min(1).max(5),
+    gates: z
+        .array(z.object({
+        metric: z.enum(["inference_time_ms", "peak_memory_mb", "throughput_tps"]),
+        operator: z.enum(["<=", "<", ">=", ">", "=="]),
+        threshold: z.number().positive(),
+    }))
+        .min(1),
+    promptpack_id: z.string().uuid().optional(),
+    repeats: z.number().int().min(1).max(5).optional(),
+});
+export async function createPipelineHandler(client, input) {
+    const cellCount = input.models.length * input.devices.length;
+    if (cellCount > MAX_CELLS) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `${input.models.length} models × ${input.devices.length} devices = ${cellCount} cells, ` +
+                        `which exceeds the per-run limit of ${MAX_CELLS}. Reduce the matrix or split ` +
+                        `into multiple pipelines.`,
+                },
+            ],
+        };
+    }
+    try {
+        const pipeline = await client.createPipeline(input.workspace_id, {
+            name: input.name,
+            description: input.description,
+            models: input.models,
+            devices: input.devices,
+            gates: input.gates,
+            promptpack_id: input.promptpack_id,
+            repeats: input.repeats,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Created pipeline **${pipeline.name}** (id=${pipeline.id}).`,
+                        ``,
+                        `- ${input.models.length} model(s) × ${input.devices.length} device(s) = ${cellCount} cell(s) per run`,
+                        `- ${input.gates.length} gate(s)`,
+                        ``,
+                        `Trigger a run with \`edgegate_run_gate\`, or wire CI with \`edgegate_setup_github_action\`.`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof EdgeGateError) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to create pipeline: ${err.detail}` }],
+            };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=create_pipeline.js.map

package/dist/tools/create_pipeline.js.map

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

package/dist/tools/get_audit_report.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { EdgeGateClient } from "../client.js";
+import type { ToolResult } from "./setup_workspace.js";
+export declare const getAuditReportInputSchema: z.ZodObject<{
+    workspace_id: z.ZodString;
+    run_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workspace_id: string;
+    run_id: string;
+}, {
+    workspace_id: string;
+    run_id: string;
+}>;
+export type GetAuditReportInput = z.infer<typeof getAuditReportInputSchema>;
+export declare function getAuditReportHandler(client: EdgeGateClient, input: GetAuditReportInput): Promise<ToolResult>;

package/dist/tools/get_audit_report.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { EdgeGateError } from "../client.js";
+export const getAuditReportInputSchema = z.object({
+    workspace_id: z.string().uuid(),
+    run_id: z.string().uuid(),
+});
+export async function getAuditReportHandler(client, input) {
+    try {
+        const report = await client.getAuditReport(input.workspace_id, input.run_id);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Audit report for run ${input.run_id}:`,
+                        ``,
+                        `Download URL: ${report.url}`,
+                        `Generated: ${report.generated_at}`,
+                        ``,
+                        `The URL is signed and time-limited (typically 1h). The PDF contains ` +
+                            `the signed evidence bundle hash, device fingerprints, and gate decisions — ` +
+                            `keep it with your compliance records.`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof EdgeGateError) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: err.status === 404
+                            ? `No audit report for run ${input.run_id} yet. Reports are generated ` +
+                                `asynchronously after the run completes — try again in 1-2 minutes.`
+                            : `EdgeGate returned ${err.status}: ${err.detail}`,
+                    },
+                ],
+            };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=get_audit_report.js.map

package/dist/tools/get_audit_report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_audit_report.js","sourceRoot":"","sources":["../../src/tools/get_audit_report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC1B,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAsB,EACtB,KAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,wBAAwB,KAAK,CAAC,MAAM,GAAG;wBACvC,EAAE;wBACF,iBAAiB,MAAM,CAAC,GAAG,EAAE;wBAC7B,cAAc,MAAM,CAAC,YAAY,EAAE;wBACnC,EAAE;wBACF,sEAAsE;4BACpE,6EAA6E;4BAC7E,uCAAuC;qBAC1C,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,GAAG,CAAC,MAAM,KAAK,GAAG;4BAChB,CAAC,CAAC,2BAA2B,KAAK,CAAC,MAAM,8BAA8B;gCACrE,oEAAoE;4BACtE,CAAC,CAAC,qBAAqB,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE;qBACvD;iBACF;aACF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/get_report.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { EdgeGateClient } from "../client.js";
+import type { ToolResult } from "./setup_workspace.js";
+export declare const getReportInputSchema: z.ZodObject<{
+    workspace_id: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    workspace_id: string;
+    limit: number;
+}, {
+    workspace_id: string;
+    limit?: number | undefined;
+}>;
+export type GetReportInput = z.infer<typeof getReportInputSchema>;
+export declare function getReportHandler(client: EdgeGateClient, input: GetReportInput): Promise<ToolResult>;

package/dist/tools/get_report.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { EdgeGateError } from "../client.js";
+export const getReportInputSchema = z.object({
+    workspace_id: z.string().uuid(),
+    limit: z.number().int().min(1).max(50).default(10),
+});
+export async function getReportHandler(client, input) {
+    try {
+        const runs = await client.listRuns(input.workspace_id, input.limit);
+        if (runs.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No runs in this workspace yet. Trigger one with `edgegate_run_gate`.",
+                    },
+                ],
+            };
+        }
+        const rows = runs
+            .map((r) => {
+            const dur = r.started_at && r.completed_at
+                ? `${Math.round((new Date(r.completed_at).getTime() - new Date(r.started_at).getTime()) / 1000)}s`
+                : "-";
+            return `| ${r.id} | ${r.status} | ${r.trigger} | ${dur} | ${r.started_at ?? "-"} |`;
+        })
+            .join("\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Last ${runs.length} run(s):`,
+                        ``,
+                        `| run_id | status | trigger | duration | started_at |`,
+                        `|---|---|---|---|---|`,
+                        rows,
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof EdgeGateError) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `EdgeGate returned ${err.status}: ${err.detail}` }],
+            };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=get_report.js.map

package/dist/tools/get_report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_report.js","sourceRoot":"","sources":["../../src/tools/get_report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACnD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAsB,EACtB,KAAqB;IAErB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sEAAsE;qBAC7E;iBACF;aACF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,IAAI;aACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,GAAG,GACP,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,YAAY;gBAC5B,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CACX,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAC/E,GAAG;gBACN,CAAC,CAAC,GAAG,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,OAAO,MAAM,GAAG,MAAM,CAAC,CAAC,UAAU,IAAI,GAAG,IAAI,CAAC;QACtF,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,QAAQ,IAAI,CAAC,MAAM,UAAU;wBAC7B,EAAE;wBACF,uDAAuD;wBACvD,uBAAuB;wBACvB,IAAI;qBACL,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;aACpF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/run_gate.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { EdgeGateClient } from "../client.js";
+import type { ToolResult } from "./setup_workspace.js";
+export declare const runGateInputSchema: z.ZodObject<{
+    workspace_id: z.ZodString;
+    pipeline_id: z.ZodString;
+    model_artifact_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workspace_id: string;
+    pipeline_id: string;
+    model_artifact_id?: string | undefined;
+}, {
+    workspace_id: string;
+    pipeline_id: string;
+    model_artifact_id?: string | undefined;
+}>;
+export type RunGateInput = z.infer<typeof runGateInputSchema>;
+export declare function runGateHandler(client: EdgeGateClient, input: RunGateInput): Promise<ToolResult>;

package/dist/tools/run_gate.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { EdgeGateError } from "../client.js";
+export const runGateInputSchema = z.object({
+    workspace_id: z.string().uuid(),
+    pipeline_id: z.string().uuid(),
+    model_artifact_id: z.string().uuid().optional(),
+});
+export async function runGateHandler(client, input) {
+    try {
+        const run = await client.triggerRun(input.workspace_id, input.pipeline_id, {
+            trigger: "mcp",
+            model_artifact_id: input.model_artifact_id,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Triggered run **${run.id}** on pipeline ${input.pipeline_id}.`,
+                        ``,
+                        `Poll status with:`,
+                        `  \`edgegate_check_status({ workspace_id: "${input.workspace_id}", run_id: "${run.id}" })\``,
+                        ``,
+                        `Typical end-to-end time: 3-5 minutes per device.`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof EdgeGateError) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: err.status === 409
+                            ? `Another run is in flight in this workspace. EdgeGate enforces ` +
+                                `workspace_concurrency=1. Wait for it to finish, then retry.`
+                            : `Failed to trigger run: ${err.detail}`,
+                    },
+                ],
+            };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=run_gate.js.map

package/dist/tools/run_gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_gate.js","sourceRoot":"","sources":["../../src/tools/run_gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC9B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB,EACtB,KAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;YACzE,OAAO,EAAE,KAAK;YACd,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;SAC3C,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,mBAAmB,GAAG,CAAC,EAAE,kBAAkB,KAAK,CAAC,WAAW,GAAG;wBAC/D,EAAE;wBACF,mBAAmB;wBACnB,8CAA8C,KAAK,CAAC,YAAY,eAAe,GAAG,CAAC,EAAE,QAAQ;wBAC7F,EAAE;wBACF,kDAAkD;qBACnD,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,GAAG,CAAC,MAAM,KAAK,GAAG;4BAChB,CAAC,CAAC,gEAAgE;gCAChE,6DAA6D;4BAC/D,CAAC,CAAC,0BAA0B,GAAG,CAAC,MAAM,EAAE;qBAC7C;iBACF;aACF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/setup_github_action.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { EdgeGateClient } from "../client.js";
+import type { ToolResult } from "./setup_workspace.js";
+export declare const setupGithubActionInputSchema: z.ZodObject<{
+    workspace_id: z.ZodString;
+    pipeline_id: z.ZodOptional<z.ZodString>;
+    model_artifact_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workspace_id: string;
+    pipeline_id?: string | undefined;
+    model_artifact_id?: string | undefined;
+}, {
+    workspace_id: string;
+    pipeline_id?: string | undefined;
+    model_artifact_id?: string | undefined;
+}>;
+export type SetupGithubActionInput = z.infer<typeof setupGithubActionInputSchema>;
+export declare function setupGithubActionHandler(client: EdgeGateClient, input: SetupGithubActionInput): Promise<ToolResult>;

package/dist/tools/setup_github_action.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { EdgeGateError } from "../client.js";
+export const setupGithubActionInputSchema = z.object({
+    workspace_id: z.string().uuid(),
+    pipeline_id: z.string().uuid().optional(),
+    model_artifact_id: z.string().uuid().optional(),
+});
+export async function setupGithubActionHandler(client, input) {
+    try {
+        const tmpl = await client.getWorkflowTemplate(input.workspace_id);
+        const ghCommands = buildGhCommands({
+            workspace_id: input.workspace_id,
+            pipeline_id: input.pipeline_id,
+            model_artifact_id: input.model_artifact_id,
+        });
+        const text = [
+            `## EdgeGate GitHub Action setup`,
+            ``,
+            `**Step 1.** Write this workflow to your repo:`,
+            ``,
+            "```yaml",
+            `# .github/workflows/edgegate.yml`,
+            tmpl.workflow_yaml.trimEnd(),
+            "```",
+            ``,
+            `**Step 2.** From the repo root, run these \`gh\` CLI commands to set the secrets:`,
+            ``,
+            "```bash",
+            ghCommands,
+            "```",
+            ``,
+            `**Step 3.** Need an API_SECRET? Generate one in the EdgeGate dashboard:`,
+            `https://edgegate.frozo.ai/workspace/${input.workspace_id}/settings#integrations`,
+            ``,
+            `Once committed and pushed, every PR to \`main\` will trigger an EdgeGate run ` +
+                `and post the results back as a PR comment.`,
+        ].join("\n");
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        if (err instanceof EdgeGateError) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to fetch workflow template: ${err.detail}` }],
+            };
+        }
+        throw err;
+    }
+}
+function buildGhCommands(args) {
+    const lines = [
+        `gh secret set EDGEGATE_WORKSPACE_ID --body "${args.workspace_id}"`,
+        `gh secret set EDGEGATE_API_SECRET --body "<paste-secret-from-dashboard>"`,
+    ];
+    if (args.pipeline_id) {
+        lines.push(`gh secret set EDGEGATE_PIPELINE_ID --body "${args.pipeline_id}"`);
+    }
+    else {
+        lines.push(`# Optional: gh secret set EDGEGATE_PIPELINE_ID --body "<pipeline-uuid>"`);
+    }
+    if (args.model_artifact_id) {
+        lines.push(`gh secret set EDGEGATE_MODEL_ARTIFACT_ID --body "${args.model_artifact_id}"`);
+    }
+    else {
+        lines.push(`# Optional: gh secret set EDGEGATE_MODEL_ARTIFACT_ID --body "<artifact-uuid>"`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=setup_github_action.js.map

package/dist/tools/setup_github_action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup_github_action.js","sourceRoot":"","sources":["../../src/tools/setup_github_action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACzC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAsB,EACtB,KAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,eAAe,CAAC;YACjC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;SAC3C,CAAC,CAAC;QACH,MAAM,IAAI,GAAG;YACX,iCAAiC;YACjC,EAAE;YACF,+CAA+C;YAC/C,EAAE;YACF,SAAS;YACT,kCAAkC;YAClC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;YAC5B,KAAK;YACL,EAAE;YACF,mFAAmF;YACnF,EAAE;YACF,SAAS;YACT,UAAU;YACV,KAAK;YACL,EAAE;YACF,yEAAyE;YACzE,uCAAuC,KAAK,CAAC,YAAY,wBAAwB;YACjF,EAAE;YACF,+EAA+E;gBAC7E,4CAA4C;SAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sCAAsC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;aACtF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAIxB;IACC,MAAM,KAAK,GAAG;QACZ,+CAA+C,IAAI,CAAC,YAAY,GAAG;QACnE,0EAA0E;KAC3E,CAAC;IACF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,8CAA8C,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IAChF,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,oDAAoD,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC5F,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/setup_workspace.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { EdgeGateClient } from "../client.js";
+export declare const setupWorkspaceInputSchema: z.ZodObject<{
+    workspace_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workspace_id?: string | undefined;
+}, {
+    workspace_id?: string | undefined;
+}>;
+export type SetupWorkspaceInput = z.infer<typeof setupWorkspaceInputSchema>;
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function setupWorkspaceHandler(client: EdgeGateClient, input: SetupWorkspaceInput): Promise<ToolResult>;

package/dist/tools/setup_workspace.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { EdgeGateError } from "../client.js";
+export const setupWorkspaceInputSchema = z.object({
+    workspace_id: z
+        .string()
+        .uuid()
+        .optional()
+        .describe("Optional UUID. If omitted, lists all visible workspaces."),
+});
+export async function setupWorkspaceHandler(client, input) {
+    try {
+        if (input.workspace_id) {
+            const ws = await client.getWorkspace(input.workspace_id);
+            return { content: [{ type: "text", text: formatSingle(ws) }] };
+        }
+        const list = await client.listWorkspaces();
+        if (list.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No workspaces visible to this API key. The key may have been revoked, " +
+                            "or it was scoped to a deleted workspace. Generate a new one at " +
+                            "https://edgegate.frozo.ai/workspace/<id>/settings#api-keys.",
+                    },
+                ],
+            };
+        }
+        return { content: [{ type: "text", text: formatList(list) }] };
+    }
+    catch (err) {
+        if (err instanceof EdgeGateError) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: err.status === 401
+                            ? "EDGEGATE_API_KEY is missing, expired, or revoked. Generate a fresh key at " +
+                                "https://edgegate.frozo.ai/workspace/<id>/settings#api-keys and retry."
+                            : `EdgeGate returned ${err.status}: ${err.detail}`,
+                    },
+                ],
+            };
+        }
+        throw err;
+    }
+}
+function planLabel(plan) {
+    return plan ? plan : "(unknown)";
+}
+function formatSingle(ws) {
+    return [
+        `Active workspace: **${ws.name}**`,
+        `- ID: ${ws.id}`,
+        `- Plan: ${planLabel(ws.plan)}`,
+        ``,
+        `You can now use this workspace_id in the other EdgeGate MCP tools.`,
+    ].join("\n");
+}
+function formatList(list) {
+    const rows = list
+        .map((w) => `- **${w.name}** (id=${w.id}, plan=${planLabel(w.plan)})`)
+        .join("\n");
+    return [
+        `Found ${list.length} workspace(s):`,
+        ``,
+        rows,
+        ``,
+        `Pick one and pass its id back as \`workspace_id\` to lock it in.`,
+    ].join("\n");
+}
+//# sourceMappingURL=setup_workspace.js.map

package/dist/tools/setup_workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup_workspace.js","sourceRoot":"","sources":["../../src/tools/setup_workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC,CAAC;AASH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAsB,EACtB,KAA0B;IAE1B,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACzD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,wEAAwE;4BACxE,iEAAiE;4BACjE,6DAA6D;qBAChE;iBACF;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,GAAG,CAAC,MAAM,KAAK,GAAG;4BAChB,CAAC,CAAC,4EAA4E;gCAC5E,uEAAuE;4BACzE,CAAC,CAAC,qBAAqB,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE;qBACvD;iBACF;aACF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAA+B;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,EAAa;IACjC,OAAO;QACL,uBAAuB,EAAE,CAAC,IAAI,IAAI;QAClC,SAAS,EAAE,CAAC,EAAE,EAAE;QAChB,WAAW,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAC/B,EAAE;QACF,oEAAoE;KACrE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AACD,SAAS,UAAU,CAAC,IAAiB;IACnC,MAAM,IAAI,GAAG,IAAI;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,UAAU,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SACrE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;QACL,SAAS,IAAI,CAAC,MAAM,gBAAgB;QACpC,EAAE;QACF,IAAI;QACJ,EAAE;QACF,kEAAkE;KACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+export type UUID = string;
+export interface Workspace {
+    id: UUID;
+    name: string;
+    /** Owner UUID — may be omitted by the API depending on response shape. */
+    owner_id?: UUID;
+    /** Calling user's plan tier; null/undefined when the API hasn't been
+     *  updated to include it. The MCP tool renders "(unknown)" in that case. */
+    plan?: string | null;
+}
+export interface Pipeline {
+    id: UUID;
+    workspace_id: UUID;
+    name: string;
+    description: string | null;
+    status: "active" | "paused";
+    pipeline_yaml: string;
+    created_at: string;
+}
+export interface Gate {
+    metric: string;
+    operator: "<=" | "<" | ">=" | ">" | "==";
+    threshold: number;
+}
+export interface RunSummary {
+    id: UUID;
+    workspace_id: UUID;
+    pipeline_id: UUID;
+    status: "pending" | "running" | "passed" | "failed" | "error";
+    started_at: string | null;
+    completed_at: string | null;
+    trigger: string;
+}
+export interface RunCell {
+    model_artifact_id: UUID;
+    device_name: string;
+    metrics: Record<string, number>;
+    gate_results: Array<{
+        metric: string;
+        passed: boolean;
+        threshold: number;
+        actual: number;
+    }>;
+}
+export interface RunDetail extends RunSummary {
+    cells: RunCell[];
+    evidence_bundle_url: string | null;
+}
+export interface APIKeyCreateResponse {
+    id: UUID;
+    plaintext: string;
+    name: string;
+    prefix: string;
+    suffix: string;
+}
+export interface WorkflowTemplate {
+    workflow_yaml: string;
+    api_url: string;
+    secret_names: string[];
+}
+export interface AuditReport {
+    url: string;
+    generated_at: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.1";
+export declare const USER_AGENT = "edgegate-mcp/0.1.1";

package/dist/version.js

@@ -0,0 +1,3 @@
+export const VERSION = "0.1.1";
+export const USER_AGENT = `edgegate-mcp/${VERSION}`;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,OAAO,EAAE,CAAC"}