@calltelemetry/ct-lab-mcp 0.1.0

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

@@ -0,0 +1,289 @@
+/**
+ * MCP Tool: provision_vm
+ *
+ * Provisions a new disposable appliance VM on Proxmox VE or VMware ESXi from a template
+ * with IP/VLAN networking and auto-attached or pre-claimed 8GB slot lease.
+ */
+import { z } from "zod";
+import { ProxmoxErrorCode, createToolErrorResult } from "../types/mcp.js";
+import { formatProvisionResult } from "../utils/formatters.js";
+import { CapacityExceededError, GlobalCapacityExceededError, DatastoreCapacityExceededError, } from "../slot/types.js";
+import { ProtectedVmViolationError } from "../guardrails/types.js";
+export const ProvisionVmInputShape = {
+    sourceVmIdOrName: z
+        .union([z.string(), z.number()])
+        .optional()
+        .describe("Source VM template ID or template name to clone from (e.g. '9000', 'CT-ALMALINUX9-TEMPLATE', '102')."),
+    template: z
+        .union([z.string(), z.number()])
+        .optional()
+        .describe("Alias for sourceVmIdOrName."),
+    newVmName: z
+        .string()
+        .optional()
+        .describe("Name for the newly provisioned disposable VM (e.g. 'ct-appliance-uat-105')."),
+    name: z
+        .string()
+        .optional()
+        .describe("Alias for newVmName."),
+    newVmId: z
+        .union([z.string(), z.number()])
+        .optional()
+        .describe("Optional explicit VMID for Proxmox. Auto-allocated if omitted."),
+    vmid: z
+        .union([z.string(), z.number()])
+        .optional()
+        .describe("Alias for newVmId."),
+    targetHost: z
+        .string()
+        .optional()
+        .describe("Target hypervisor host ('proxmox-lab', 'proxmox-mini', 'esxi-intel-192-168-123-176', or omit for auto-placement)."),
+    host: z
+        .string()
+        .optional()
+        .describe("Alias for targetHost."),
+    hypervisorType: z
+        .enum(["proxmox", "esxi", "any"])
+        .optional()
+        .default("any")
+        .describe("Target hypervisor platform preference: 'proxmox', 'esxi', or 'any'."),
+    memoryBytes: z
+        .number()
+        .optional()
+        .describe("RAM allocation in bytes (default: 8GB / 8589934592)."),
+    memoryMb: z
+        .number()
+        .optional()
+        .describe("RAM allocation in MB (default: 8192 MB)."),
+    cpuCores: z
+        .number()
+        .int()
+        .min(1)
+        .max(32)
+        .optional()
+        .describe("Number of CPU cores (default: 2)."),
+    cores: z
+        .number()
+        .int()
+        .optional()
+        .describe("Alias for cpuCores."),
+    vlan: z
+        .number()
+        .int()
+        .min(1)
+        .max(4094)
+        .optional()
+        .describe("VLAN tag assignment (e.g. 124, 125)."),
+    ipAddress: z
+        .string()
+        .optional()
+        .describe("Static IP address assignment for the guest VM (e.g. '192.168.124.105')."),
+    macAddress: z
+        .string()
+        .optional()
+        .describe("Static MAC address assignment for the guest VM network interface."),
+    networkBridge: z
+        .string()
+        .optional()
+        .describe("Network bridge interface (e.g. 'vmbr0', 'VM Network')."),
+    storage: z
+        .string()
+        .optional()
+        .describe("Target storage pool / datastore name."),
+    linearIssue: z
+        .string()
+        .optional()
+        .describe("Linear issue key tracking this test VM (e.g. 'CTUAT-693')."),
+    slotClaimId: z
+        .string()
+        .optional()
+        .describe("Pre-claimed slot claim ID. If omitted, an 8GB slot lease is automatically acquired."),
+    startOnDeploy: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Whether to immediately power on the VM after cloning completes (default: true)."),
+    start: z
+        .boolean()
+        .optional()
+        .describe("Alias for startOnDeploy."),
+    tags: z
+        .union([z.array(z.string()), z.string()])
+        .optional()
+        .describe("Tags to attach to the VM (e.g. ['disposable', 'uat', '0.8.7-stable'])."),
+    requester: z
+        .string()
+        .optional()
+        .describe("Requester name or agent identifier."),
+    fullClone: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Whether to perform a full disk clone (default: true)."),
+    description: z
+        .string()
+        .optional()
+        .describe("Optional notes/description for the new VM."),
+};
+export const ProvisionVmInputSchema = z
+    .object(ProvisionVmInputShape)
+    .refine((data) => Boolean(data.sourceVmIdOrName || data.template), { message: "Either 'sourceVmIdOrName' or 'template' must be provided." })
+    .refine((data) => Boolean(data.newVmName || data.name), { message: "Either 'newVmName' or 'name' must be provided." });
+export async function handleProvisionVm(rawArgs, context) {
+    let autoClaimId;
+    let slotClaim;
+    try {
+        const parseResult = ProvisionVmInputSchema.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 source = (args.sourceVmIdOrName ?? args.template);
+        const newName = (args.newVmName ?? args.name);
+        const targetHost = args.targetHost || args.host;
+        const newVmId = args.newVmId ?? args.vmid;
+        const linearIssue = args.linearIssue;
+        const requester = args.requester;
+        const startOnDeploy = args.start !== undefined ? args.start : args.startOnDeploy;
+        let parsedTags = [];
+        if (args.tags) {
+            if (Array.isArray(args.tags)) {
+                parsedTags = args.tags;
+            }
+            else if (typeof args.tags === "string") {
+                parsedTags = args.tags.split(/[;, ]+/).map((t) => t.trim()).filter(Boolean);
+            }
+        }
+        // 1. Slot Lease Management: Use provided claim ID or automatically acquire one
+        let effectiveTargetHost = targetHost;
+        if (!effectiveTargetHost && context.hypervisorManager) {
+            const sourceFound = await context.hypervisorManager.findVm(source);
+            if (sourceFound) {
+                effectiveTargetHost = sourceFound.driver.hostName;
+            }
+        }
+        let claimId = args.slotClaimId;
+        if (!claimId) {
+            const claimResult = await context.slotManager.claimSlot({
+                tag: linearIssue || newName,
+                requester: requester || newName,
+                linearIssue: linearIssue || (newName.startsWith("CTUAT-") ? newName : undefined),
+                targetHost: effectiveTargetHost,
+                hypervisorType: args.hypervisorType,
+                durationMinutes: 60,
+                purpose: `Disposable test VM: ${newName}`,
+            });
+            autoClaimId = claimResult.claimId;
+            claimId = claimResult.claimId;
+            slotClaim = claimResult;
+        }
+        // 2. Perform VM Provisioning via MultiHypervisorManager
+        const hypervisorPref = args.hypervisorType === "any" ? undefined : args.hypervisorType;
+        const cloneParams = {
+            sourceVmIdOrName: source,
+            newVmName: newName,
+            newVmId: newVmId,
+            targetHost: effectiveTargetHost || (slotClaim ? String(slotClaim.hostId) : undefined),
+            hypervisorType: hypervisorPref,
+            fullClone: args.fullClone,
+            description: args.description || `Call Telemetry test VM (${linearIssue || "disposable"})`,
+            memoryBytes: args.memoryBytes || (args.memoryMb ? args.memoryMb * 1024 * 1024 : 8192 * 1024 * 1024),
+            cpuCores: args.cpuCores ?? args.cores ?? 2,
+            vlan: args.vlan,
+            ipAddress: args.ipAddress,
+            macAddress: args.macAddress,
+            networkBridge: args.networkBridge,
+            storage: args.storage,
+            linearIssue: linearIssue,
+            startOnDeploy: startOnDeploy,
+            tags: parsedTags,
+            requester: requester,
+            slotClaimId: claimId,
+        };
+        let provisionResult;
+        if (context.hypervisorManager) {
+            provisionResult = await context.hypervisorManager.provisionVm(cloneParams);
+        }
+        else if (context.proxmoxManager) {
+            // Fallback for standalone Proxmox mode
+            const hostId = (targetHost || "proxmox-mini");
+            const client = context.proxmoxManager.getClient(hostId);
+            const newVmidNum = typeof newVmId === "number" ? newVmId : parseInt(String(newVmId || "0"), 10);
+            const sourceVmidNum = typeof source === "number" ? source : parseInt(String(source), 10);
+            const targetVmid = newVmidNum > 0 ? newVmidNum : 105;
+            const cloneTask = await client.cloneVm(sourceVmidNum, targetVmid, newName, {
+                full: cloneParams.fullClone,
+                description: cloneParams.description,
+            });
+            if (startOnDeploy) {
+                try {
+                    await client.startVm(targetVmid);
+                }
+                catch {
+                    // ignore start error
+                }
+            }
+            provisionResult = {
+                vmId: String(targetVmid),
+                name: newName,
+                hostName: hostId,
+                hypervisor: "proxmox",
+                status: startOnDeploy ? "running" : "stopped",
+                ipAddresses: args.ipAddress ? [args.ipAddress] : [],
+                vlan: args.vlan,
+                linearIssue: linearIssue,
+                slotClaimId: claimId,
+                taskUpid: cloneTask.upid,
+                createdAt: new Date().toISOString(),
+            };
+        }
+        else {
+            throw new Error("No hypervisor manager available to provision VM.");
+        }
+        // 3. Attach VM ID/Name to the claimed slot
+        if (claimId) {
+            try {
+                await context.slotManager.attachVm(claimId, provisionResult.vmId, provisionResult.name);
+            }
+            catch (attachErr) {
+                console.error("[provision_vm] Warning attaching VM to slot lease:", attachErr);
+            }
+        }
+        const formatted = formatProvisionResult(provisionResult, slotClaim);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatted.markdown,
+                },
+            ],
+            structuredContent: formatted.structuredContent,
+        };
+    }
+    catch (error) {
+        // If we auto-acquired a slot and provisioning failed, roll back the slot lease
+        if (autoClaimId) {
+            try {
+                await context.slotManager.releaseSlot(autoClaimId);
+            }
+            catch {
+                // ignore rollback error
+            }
+        }
+        if (error instanceof ProtectedVmViolationError) {
+            return createToolErrorResult(ProxmoxErrorCode.PROTECTED_VM_ACTION_DENIED, error.message, {
+                vmid: error.vmid,
+                vmName: error.vmName,
+                action: error.action,
+                reason: error.reason,
+            });
+        }
+        if (error instanceof CapacityExceededError || error instanceof GlobalCapacityExceededError || error instanceof DatastoreCapacityExceededError) {
+            return createToolErrorResult(ProxmoxErrorCode.CAPACITY_EXCEEDED, error.message);
+        }
+        const msg = error instanceof Error ? error.message : String(error);
+        return createToolErrorResult(ProxmoxErrorCode.UPSTREAM_API_ERROR, msg);
+    }
+}
+//# sourceMappingURL=provision-tools.js.map

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

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

package/dist/src/tools/release-slot.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export for release_slot tool
+ */
+export * from "./slot-tools.js";
+//# sourceMappingURL=release-slot.d.ts.map

package/dist/src/tools/release-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-slot.d.ts","sourceRoot":"","sources":["../../../src/tools/release-slot.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export for release_slot tool
+ */
+export * from "./slot-tools.js";
+//# sourceMappingURL=release-slot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"release-slot.js","sourceRoot":"","sources":["../../../src/tools/release-slot.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iBAAiB,CAAC"}

package/dist/src/tools/slot-tools.d.ts

@@ -0,0 +1,173 @@
+/**
+ * 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 { CallToolResult } from "../types/mcp.js";
+import { ToolContext } from "./list-hosts.js";
+export declare const ClaimSlotInputShape: {
+    tag: z.ZodOptional<z.ZodString>;
+    requester: z.ZodOptional<z.ZodString>;
+    linearIssue: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    targetHost: z.ZodOptional<z.ZodString>;
+    hypervisorType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["proxmox", "esxi", "any"]>>>;
+    durationMinutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    ttlMinutes: z.ZodOptional<z.ZodNumber>;
+    ttlSeconds: z.ZodOptional<z.ZodNumber>;
+    purpose: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+};
+export declare const ClaimSlotInputSchema: z.ZodEffects<z.ZodObject<{
+    tag: z.ZodOptional<z.ZodString>;
+    requester: z.ZodOptional<z.ZodString>;
+    linearIssue: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    targetHost: z.ZodOptional<z.ZodString>;
+    hypervisorType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["proxmox", "esxi", "any"]>>>;
+    durationMinutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    ttlMinutes: z.ZodOptional<z.ZodNumber>;
+    ttlSeconds: z.ZodOptional<z.ZodNumber>;
+    purpose: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    hypervisorType: "proxmox" | "esxi" | "any";
+    durationMinutes: number;
+    linearIssue?: string | undefined;
+    tag?: string | undefined;
+    ttlMinutes?: number | undefined;
+    requester?: string | undefined;
+    ttlSeconds?: number | undefined;
+    purpose?: string | undefined;
+    sessionId?: string | undefined;
+    targetHost?: string | undefined;
+}, {
+    host?: string | undefined;
+    linearIssue?: string | undefined;
+    hypervisorType?: "proxmox" | "esxi" | "any" | undefined;
+    tag?: string | undefined;
+    durationMinutes?: number | undefined;
+    ttlMinutes?: number | undefined;
+    requester?: string | undefined;
+    ttlSeconds?: number | undefined;
+    purpose?: string | undefined;
+    sessionId?: string | undefined;
+    targetHost?: string | undefined;
+}>, {
+    host: string;
+    hypervisorType: "proxmox" | "esxi" | "any";
+    durationMinutes: number;
+    linearIssue?: string | undefined;
+    tag?: string | undefined;
+    ttlMinutes?: number | undefined;
+    requester?: string | undefined;
+    ttlSeconds?: number | undefined;
+    purpose?: string | undefined;
+    sessionId?: string | undefined;
+    targetHost?: string | undefined;
+}, {
+    host?: string | undefined;
+    linearIssue?: string | undefined;
+    hypervisorType?: "proxmox" | "esxi" | "any" | undefined;
+    tag?: string | undefined;
+    durationMinutes?: number | undefined;
+    ttlMinutes?: number | undefined;
+    requester?: string | undefined;
+    ttlSeconds?: number | undefined;
+    purpose?: string | undefined;
+    sessionId?: string | undefined;
+    targetHost?: string | undefined;
+}>;
+export type ClaimSlotInput = z.infer<typeof ClaimSlotInputSchema>;
+export type ClaimSlotRawInput = z.input<typeof ClaimSlotInputSchema>;
+export declare function handleClaimSlot(rawArgs: ClaimSlotRawInput, context: ToolContext): Promise<CallToolResult>;
+export declare const ReleaseSlotInputShape: {
+    claimId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    requester: z.ZodOptional<z.ZodString>;
+    linearIssue: z.ZodOptional<z.ZodString>;
+    slotId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    destroyVm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+};
+export declare const ReleaseSlotInputSchema: z.ZodEffects<z.ZodObject<{
+    claimId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    requester: z.ZodOptional<z.ZodString>;
+    linearIssue: z.ZodOptional<z.ZodString>;
+    slotId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    destroyVm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    destroyVm: boolean;
+    linearIssue?: string | undefined;
+    claimId?: string | undefined;
+    slotId?: string | undefined;
+    tag?: string | undefined;
+    requester?: string | undefined;
+    sessionId?: string | undefined;
+}, {
+    linearIssue?: string | undefined;
+    claimId?: string | undefined;
+    slotId?: string | undefined;
+    tag?: string | undefined;
+    requester?: string | undefined;
+    sessionId?: string | undefined;
+    destroyVm?: boolean | undefined;
+}>, {
+    destroyVm: boolean;
+    linearIssue?: string | undefined;
+    claimId?: string | undefined;
+    slotId?: string | undefined;
+    tag?: string | undefined;
+    requester?: string | undefined;
+    sessionId?: string | undefined;
+}, {
+    linearIssue?: string | undefined;
+    claimId?: string | undefined;
+    slotId?: string | undefined;
+    tag?: string | undefined;
+    requester?: string | undefined;
+    sessionId?: string | undefined;
+    destroyVm?: boolean | undefined;
+}>;
+export type ReleaseSlotInput = z.infer<typeof ReleaseSlotInputSchema>;
+export type ReleaseSlotRawInput = z.input<typeof ReleaseSlotInputSchema>;
+export declare function handleReleaseSlot(rawArgs: ReleaseSlotRawInput, context: ToolContext): Promise<CallToolResult>;
+export declare const ListSlotsInputShape: {
+    host: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    hypervisorType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["proxmox", "esxi", "any"]>>>;
+    tag: z.ZodOptional<z.ZodString>;
+    requester: z.ZodOptional<z.ZodString>;
+    linearIssue: z.ZodOptional<z.ZodString>;
+    activeOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+};
+export declare const ListSlotsInputSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    hypervisorType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["proxmox", "esxi", "any"]>>>;
+    tag: z.ZodOptional<z.ZodString>;
+    requester: z.ZodOptional<z.ZodString>;
+    linearIssue: z.ZodOptional<z.ZodString>;
+    activeOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    hypervisorType: "proxmox" | "esxi" | "any";
+    activeOnly: boolean;
+    linearIssue?: string | undefined;
+    tag?: string | undefined;
+    requester?: string | undefined;
+}, {
+    host?: string | undefined;
+    linearIssue?: string | undefined;
+    hypervisorType?: "proxmox" | "esxi" | "any" | undefined;
+    tag?: string | undefined;
+    requester?: string | undefined;
+    activeOnly?: boolean | undefined;
+}>;
+export type ListSlotsInput = z.infer<typeof ListSlotsInputSchema>;
+export type ListSlotsRawInput = z.input<typeof ListSlotsInputSchema>;
+export declare function handleListSlots(rawArgs: ListSlotsRawInput | undefined, context: ToolContext): Promise<CallToolResult>;
+//# sourceMappingURL=slot-tools.d.ts.map

package/dist/src/tools/slot-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/slot-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAA2C,MAAM,iBAAiB,CAAC;AAE1F,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAc9C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;CAyD/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AAEJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAyEzB;AAMD,eAAO,MAAM,qBAAqB;;;;;;;;CA8BjC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEzE,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CA4DzB;AAMD,eAAO,MAAM,mBAAmB;;;;;;;CA4B/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAAgC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,YAAK,EAC/B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CA8BzB"}