@calltelemetry/ct-lab-mcp 0.1.0

package/dist/src/tools/slot-tools.js

@@ -0,0 +1,296 @@
+/**
+ * MCP Tools: claim_slot, release_slot, and list_slots
+ *
+ * Manages 8GB appliance slot reservations, concurrency limits, lease TTLs,
+ * least-loaded placement, and Linear issue tracking across Proxmox VE and VMware ESXi.
+ */
+import { z } from "zod";
+import { ProxmoxErrorCode, createToolErrorResult } from "../types/mcp.js";
+import { formatClaimResult, formatReleaseResult, formatSlotList } from "../utils/formatters.js";
+import { CapacityExceededError, GlobalCapacityExceededError, InvalidSlotOperationError, SlotNotFoundError, DatastoreCapacityExceededError, } from "../slot/types.js";
+// ============================================================================
+// claim_slot
+// ============================================================================
+export const ClaimSlotInputShape = {
+    tag: z
+        .string()
+        .optional()
+        .describe("Requester tag or Linear issue key (e.g. 'QA-255', 'CTUAT-693', 'LINEAR-UAT-101')."),
+    requester: z
+        .string()
+        .optional()
+        .describe("Requester identifier / agent name (e.g. 'agent-uat', 'dev-jason')."),
+    linearIssue: z
+        .string()
+        .optional()
+        .describe("Linear issue tracking key (e.g. 'CTUAT-693', '[LINEAR-UAT-101]')."),
+    host: z
+        .string()
+        .optional()
+        .default("auto")
+        .describe("Target hypervisor host ('proxmox-lab', 'proxmox-mini', 'esxi-intel-192-168-123-176', or 'auto' for least-loaded placement)."),
+    targetHost: z
+        .string()
+        .optional()
+        .describe("Alias for host."),
+    hypervisorType: z
+        .enum(["proxmox", "esxi", "any"])
+        .optional()
+        .default("any")
+        .describe("Preferred hypervisor platform: 'proxmox', 'esxi', or 'any'."),
+    durationMinutes: z
+        .number()
+        .int()
+        .min(5, "Minimum lease duration is 5 minutes.")
+        .max(1440)
+        .optional()
+        .default(60)
+        .describe("Lease duration in minutes (5 to 1440 minutes / 24 hours, default: 60)."),
+    ttlMinutes: z
+        .number()
+        .int()
+        .min(5, "Minimum lease duration is 5 minutes.")
+        .max(1440)
+        .optional()
+        .describe("Alias for durationMinutes."),
+    ttlSeconds: z
+        .number()
+        .int()
+        .min(60)
+        .max(86400)
+        .optional()
+        .describe("Lease duration in seconds (60 to 86400)."),
+    purpose: z
+        .string()
+        .optional()
+        .describe("Brief description of the test scenario or workload."),
+    sessionId: z
+        .string()
+        .optional()
+        .describe("MCP client session ID / UUID for lease ownership."),
+};
+export const ClaimSlotInputSchema = z
+    .object(ClaimSlotInputShape)
+    .refine((data) => Boolean(data.tag || data.linearIssue || data.requester), {
+    message: "At least one of 'tag', 'linearIssue', or 'requester' must be provided to claim a slot.",
+});
+export async function handleClaimSlot(rawArgs, context) {
+    try {
+        const parseResult = ClaimSlotInputSchema.safeParse(rawArgs);
+        if (!parseResult.success) {
+            const errMsg = parseResult.error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+            return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, errMsg);
+        }
+        const args = parseResult.data;
+        const claim = await context.slotManager.claimSlot({
+            tag: args.tag || args.linearIssue || args.requester,
+            requester: args.requester || args.tag,
+            linearIssue: args.linearIssue || (args.tag && args.tag.startsWith("CTUAT-") ? args.tag : undefined),
+            host: args.host || args.targetHost,
+            targetHost: args.targetHost || args.host,
+            hypervisorType: args.hypervisorType,
+            durationMinutes: args.durationMinutes ?? args.ttlMinutes,
+            ttlMinutes: args.ttlMinutes ?? args.durationMinutes,
+            ttlSeconds: args.ttlSeconds,
+            purpose: args.purpose,
+            sessionId: args.sessionId,
+        });
+        const capacity = (await context.slotManager.listHosts());
+        const formatted = formatClaimResult(claim, capacity);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatted.markdown,
+                },
+            ],
+            structuredContent: formatted.structuredContent,
+        };
+    }
+    catch (error) {
+        if (error instanceof CapacityExceededError) {
+            return createToolErrorResult(ProxmoxErrorCode.CAPACITY_EXCEEDED, error.message, {
+                host: error.hostId,
+                maxSlots: error.maxSlots,
+                allocatedSlots: error.allocatedSlots,
+            });
+        }
+        if (error instanceof GlobalCapacityExceededError) {
+            return createToolErrorResult(ProxmoxErrorCode.CAPACITY_EXCEEDED, error.message, {
+                clusterMaxSlots: error.clusterMaxSlots,
+                clusterAllocatedSlots: error.clusterAllocatedSlots,
+            });
+        }
+        if (error instanceof DatastoreCapacityExceededError) {
+            return createToolErrorResult(ProxmoxErrorCode.CAPACITY_EXCEEDED, error.message, {
+                host: error.hostId,
+                requiredGb: error.requiredGb,
+                availableGb: error.availableGb,
+            });
+        }
+        if (error instanceof InvalidSlotOperationError) {
+            return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, error.message);
+        }
+        if (error instanceof z.ZodError) {
+            return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, `Validation failed: ${error.errors.map((e) => e.message).join(", ")}`);
+        }
+        const msg = error instanceof Error ? error.message : String(error);
+        return createToolErrorResult(ProxmoxErrorCode.UPSTREAM_API_ERROR, msg);
+    }
+}
+// ============================================================================
+// release_slot
+// ============================================================================
+export const ReleaseSlotInputShape = {
+    claimId: z
+        .string()
+        .optional()
+        .describe("Exact claim ID to release (e.g. 'claim-a1b2c3d4')."),
+    tag: z
+        .string()
+        .optional()
+        .describe("Requester tag or Linear issue key to release all matching slots."),
+    requester: z
+        .string()
+        .optional()
+        .describe("Requester identifier to release all matching slots."),
+    linearIssue: z
+        .string()
+        .optional()
+        .describe("Linear issue key to release matching slots."),
+    slotId: z
+        .string()
+        .optional()
+        .describe("Slot identifier (e.g. 'slot-proxmox-lab-1')."),
+    sessionId: z
+        .string()
+        .optional()
+        .describe("MCP client session ID."),
+    destroyVm: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("If true and a disposable VM is attached to the slot, automatically destroys and cleans up the VM."),
+};
+export const ReleaseSlotInputSchema = z
+    .object(ReleaseSlotInputShape)
+    .refine((data) => Boolean(data.claimId || data.tag || data.requester || data.linearIssue || data.slotId), {
+    message: "Must specify claimId, tag, requester, linearIssue, or slotId to release a slot.",
+});
+export async function handleReleaseSlot(rawArgs, context) {
+    try {
+        const parseResult = ReleaseSlotInputSchema.safeParse(rawArgs);
+        if (!parseResult.success) {
+            return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, "Must specify claimId, tag, requester, linearIssue, or slotId to release a slot.");
+        }
+        const args = parseResult.data;
+        const releaseResult = await context.slotManager.releaseSlot({
+            claimId: args.claimId,
+            tag: args.tag,
+            requester: args.requester,
+            linearIssue: args.linearIssue,
+            slotId: args.slotId,
+            sessionId: args.sessionId,
+            destroyVm: args.destroyVm,
+        });
+        // If destroyVm requested and hypervisorManager is available, perform cleanup
+        if (args.destroyVm && releaseResult.destroyedVms && releaseResult.destroyedVms.length > 0 && context.hypervisorManager) {
+            for (const vmId of releaseResult.destroyedVms) {
+                try {
+                    await context.hypervisorManager.vmAction({
+                        vmIdOrName: String(vmId),
+                        action: "destroy",
+                        force: true,
+                    });
+                }
+                catch (destroyErr) {
+                    console.error(`[release_slot] VM cleanup error for VMID ${vmId}:`, destroyErr);
+                }
+            }
+        }
+        const capacity = (await context.slotManager.listHosts());
+        const formatted = formatReleaseResult(releaseResult, capacity);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatted.markdown,
+                },
+            ],
+            structuredContent: formatted.structuredContent,
+        };
+    }
+    catch (error) {
+        if (error instanceof SlotNotFoundError) {
+            return createToolErrorResult(ProxmoxErrorCode.SLOT_NOT_FOUND, error.message);
+        }
+        if (error instanceof InvalidSlotOperationError) {
+            return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, error.message);
+        }
+        const msg = error instanceof Error ? error.message : String(error);
+        return createToolErrorResult(ProxmoxErrorCode.UPSTREAM_API_ERROR, msg);
+    }
+}
+// ============================================================================
+// list_slots
+// ============================================================================
+export const ListSlotsInputShape = {
+    host: z
+        .string()
+        .optional()
+        .default("all")
+        .describe("Filter slots by host name or alias (e.g. 'proxmox-lab', 'proxmox-mini', 'esxi-intel-192-168-123-176', or 'all')."),
+    hypervisorType: z
+        .enum(["proxmox", "esxi", "any"])
+        .optional()
+        .default("any")
+        .describe("Filter slots by hypervisor type: 'proxmox', 'esxi', or 'any'."),
+    tag: z
+        .string()
+        .optional()
+        .describe("Filter slots by requester tag or Linear issue."),
+    requester: z
+        .string()
+        .optional()
+        .describe("Filter slots by requester identifier."),
+    linearIssue: z
+        .string()
+        .optional()
+        .describe("Filter slots by Linear issue key."),
+    activeOnly: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("If true, returns only actively claimed slots."),
+};
+export const ListSlotsInputSchema = z.object(ListSlotsInputShape);
+export async function handleListSlots(rawArgs = {}, context) {
+    try {
+        const args = ListSlotsInputSchema.parse(rawArgs);
+        const hostFilter = args.host === "all" ? undefined : args.host;
+        const slots = await context.slotManager.listSlots({
+            host: hostFilter,
+            hypervisorType: args.hypervisorType,
+            tag: args.tag,
+            requester: args.requester,
+            linearIssue: args.linearIssue,
+            activeOnly: args.activeOnly,
+        });
+        const summary = (await context.slotManager.listHosts());
+        const formatted = formatSlotList(slots, summary);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatted.markdown,
+                },
+            ],
+            structuredContent: formatted.structuredContent,
+        };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return createToolErrorResult(ProxmoxErrorCode.UPSTREAM_API_ERROR, msg);
+    }
+}
+//# sourceMappingURL=slot-tools.js.map

package/dist/src/tools/slot-tools.js.map

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

package/dist/src/tools/vm-action.d.ts

@@ -0,0 +1,189 @@
+/**
+ * VM Action MCP Tool Handler
+ *
+ * Handles VM lifecycle operations (start, stop, reboot, shutdown, reset, status, clone, destroy)
+ * with non-bypassable safety guardrail enforcement protecting core fixtures and templates.
+ */
+import { z } from "zod";
+import { CallToolResult } from "../types/index.js";
+import { ToolContext } from "./index.js";
+export declare const VmActionInputShape: {
+    vmIdOrName: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    vmid: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    host: z.ZodOptional<z.ZodString>;
+    targetHost: z.ZodOptional<z.ZodString>;
+    action: z.ZodEnum<["start", "stop", "reboot", "shutdown", "reset", "status", "clone", "destroy", "config"]>;
+    cloneOptions: z.ZodOptional<z.ZodObject<{
+        newid: z.ZodOptional<z.ZodNumber>;
+        newVmId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        name: z.ZodOptional<z.ZodString>;
+        newVmName: z.ZodOptional<z.ZodString>;
+        targetHost: z.ZodOptional<z.ZodString>;
+        full: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        vlan: z.ZodOptional<z.ZodNumber>;
+        ipAddress: z.ZodOptional<z.ZodString>;
+        macAddress: z.ZodOptional<z.ZodString>;
+        linearIssue: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        full: boolean;
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    }, {
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        full?: boolean | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    }>>;
+    force: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+};
+export declare const VmActionInputSchema: z.ZodEffects<z.ZodObject<{
+    vmIdOrName: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    vmid: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    host: z.ZodOptional<z.ZodString>;
+    targetHost: z.ZodOptional<z.ZodString>;
+    action: z.ZodEnum<["start", "stop", "reboot", "shutdown", "reset", "status", "clone", "destroy", "config"]>;
+    cloneOptions: z.ZodOptional<z.ZodObject<{
+        newid: z.ZodOptional<z.ZodNumber>;
+        newVmId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        name: z.ZodOptional<z.ZodString>;
+        newVmName: z.ZodOptional<z.ZodString>;
+        targetHost: z.ZodOptional<z.ZodString>;
+        full: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        vlan: z.ZodOptional<z.ZodNumber>;
+        ipAddress: z.ZodOptional<z.ZodString>;
+        macAddress: z.ZodOptional<z.ZodString>;
+        linearIssue: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        full: boolean;
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    }, {
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        full?: boolean | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    }>>;
+    force: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    action: "config" | "start" | "stop" | "reboot" | "shutdown" | "reset" | "status" | "destroy" | "clone";
+    force: boolean;
+    host?: string | undefined;
+    vmid?: string | number | undefined;
+    targetHost?: string | undefined;
+    vmIdOrName?: string | number | undefined;
+    cloneOptions?: {
+        full: boolean;
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    } | undefined;
+    timeoutSeconds?: number | undefined;
+}, {
+    action: "config" | "start" | "stop" | "reboot" | "shutdown" | "reset" | "status" | "destroy" | "clone";
+    host?: string | undefined;
+    vmid?: string | number | undefined;
+    targetHost?: string | undefined;
+    vmIdOrName?: string | number | undefined;
+    cloneOptions?: {
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        full?: boolean | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    } | undefined;
+    force?: boolean | undefined;
+    timeoutSeconds?: number | undefined;
+}>, {
+    action: "config" | "start" | "stop" | "reboot" | "shutdown" | "reset" | "status" | "destroy" | "clone";
+    force: boolean;
+    host?: string | undefined;
+    vmid?: string | number | undefined;
+    targetHost?: string | undefined;
+    vmIdOrName?: string | number | undefined;
+    cloneOptions?: {
+        full: boolean;
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    } | undefined;
+    timeoutSeconds?: number | undefined;
+}, {
+    action: "config" | "start" | "stop" | "reboot" | "shutdown" | "reset" | "status" | "destroy" | "clone";
+    host?: string | undefined;
+    vmid?: string | number | undefined;
+    targetHost?: string | undefined;
+    vmIdOrName?: string | number | undefined;
+    cloneOptions?: {
+        name?: string | undefined;
+        tags?: string | string[] | undefined;
+        newid?: number | undefined;
+        full?: boolean | undefined;
+        vlan?: number | undefined;
+        linearIssue?: string | undefined;
+        ipAddress?: string | undefined;
+        targetHost?: string | undefined;
+        newVmName?: string | undefined;
+        newVmId?: string | number | undefined;
+        macAddress?: string | undefined;
+    } | undefined;
+    force?: boolean | undefined;
+    timeoutSeconds?: number | undefined;
+}>;
+export type VmActionInput = z.infer<typeof VmActionInputSchema>;
+export type VmActionRawInput = z.input<typeof VmActionInputSchema>;
+export declare function handleVmAction(rawArgs: VmActionRawInput, context: ToolContext): Promise<CallToolResult>;
+//# sourceMappingURL=vm-action.d.ts.map

package/dist/src/tools/vm-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-action.d.ts","sourceRoot":"","sources":["../../../src/tools/vm-action.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EAKf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAUzC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD9B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAwRzB"}