@bldg-7/proxmox-mcp 0.1.0

package/dist/client/proxmox.d.ts

@@ -0,0 +1,14 @@
+import type { Config } from '../config/schema.js';
+export declare class ProxmoxApiError extends Error {
+    readonly statusCode: number;
+    readonly endpoint: string;
+    constructor(message: string, statusCode: number, endpoint: string);
+}
+export declare class ProxmoxApiClient {
+    private readonly baseUrl;
+    private readonly authHeader;
+    private readonly agent;
+    constructor(config: Config);
+    request<T>(endpoint: string, method?: string, body?: unknown): Promise<T>;
+}
+//# sourceMappingURL=proxmox.d.ts.map

package/dist/client/proxmox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxmox.d.ts","sourceRoot":"","sources":["../../src/client/proxmox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAKlD,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CAKnC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,MAAM,EAAE,MAAM;IAmBpB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAiE/E"}

package/dist/client/proxmox.js

@@ -0,0 +1,82 @@
+import https from 'node:https';
+import fs from 'node:fs';
+import { logger } from '../utils/index.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class ProxmoxApiError extends Error {
+    statusCode;
+    endpoint;
+    constructor(message, statusCode, endpoint) {
+        super(message);
+        this.statusCode = statusCode;
+        this.endpoint = endpoint;
+        this.name = 'ProxmoxApiError';
+    }
+}
+export class ProxmoxApiClient {
+    baseUrl;
+    authHeader;
+    agent;
+    constructor(config) {
+        this.baseUrl = `https://${config.host}:${config.port}/api2/json`;
+        this.authHeader = `PVEAPIToken=${config.user}!${config.tokenName}=${config.tokenValue}`;
+        if (config.sslVerify && config.sslCaCert) {
+            this.agent = new https.Agent({
+                ca: fs.readFileSync(config.sslCaCert),
+            });
+        }
+        else if (config.sslVerify) {
+            this.agent = new https.Agent({
+                rejectUnauthorized: true,
+            });
+        }
+        else {
+            this.agent = new https.Agent({
+                rejectUnauthorized: false,
+            });
+        }
+    }
+    async request(endpoint, method = 'GET', body) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const headers = {
+            'Authorization': this.authHeader,
+            'Content-Type': 'application/json',
+        };
+        const options = {
+            method,
+            headers,
+            signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+        };
+        // Pass the HTTPS agent via the Node.js-specific dispatcher
+        // Node's native fetch accepts an agent-like option
+        options['agent'] = this.agent;
+        if (body !== undefined) {
+            options.body = JSON.stringify(body);
+        }
+        logger.debug({ method, endpoint }, 'Proxmox API request');
+        try {
+            const response = await fetch(url, options);
+            if (!response.ok) {
+                const errorText = await response.text();
+                logger.error({ statusCode: response.status, endpoint, error: errorText }, 'Proxmox API error');
+                throw new ProxmoxApiError(`Proxmox API error: ${response.status} - ${errorText}`, response.status, endpoint);
+            }
+            const textResponse = await response.text();
+            if (!textResponse.trim()) {
+                throw new ProxmoxApiError('Empty response from Proxmox API', 0, endpoint);
+            }
+            const data = JSON.parse(textResponse);
+            return data.data;
+        }
+        catch (error) {
+            if (error instanceof ProxmoxApiError) {
+                throw error;
+            }
+            if (error instanceof SyntaxError) {
+                throw new ProxmoxApiError(`Failed to parse Proxmox API response: ${error.message}`, 0, endpoint);
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new ProxmoxApiError(`Failed to connect to Proxmox: ${message}`, 0, endpoint);
+        }
+    }
+}
+//# sourceMappingURL=proxmox.js.map

package/dist/client/proxmox.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+import { type Config } from './schema.js';
+export { type Config } from './schema.js';
+export declare function loadConfig(): Config;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,wBAAgB,UAAU,IAAI,MAAM,CAwBnC"}

package/dist/config/index.js

@@ -0,0 +1,24 @@
+import dotenv from 'dotenv';
+import { configSchema } from './schema.js';
+export function loadConfig() {
+    dotenv.config();
+    const rawConfig = {
+        host: process.env.PROXMOX_HOST,
+        port: process.env.PROXMOX_PORT ? parseInt(process.env.PROXMOX_PORT, 10) : undefined,
+        user: process.env.PROXMOX_USER || undefined,
+        tokenName: process.env.PROXMOX_TOKEN_NAME,
+        tokenValue: process.env.PROXMOX_TOKEN_VALUE,
+        allowElevated: process.env.PROXMOX_ALLOW_ELEVATED === 'true',
+        sslVerify: process.env.PROXMOX_SSL_VERIFY === 'true',
+        sslCaCert: process.env.PROXMOX_SSL_CA_CERT || undefined,
+    };
+    const result = configSchema.safeParse(rawConfig);
+    if (!result.success) {
+        const errors = result.error.issues
+            .map((issue) => `  ${issue.path.join('.')}: ${issue.message}`)
+            .join('\n');
+        throw new Error(`Invalid configuration:\n${errors}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAIxD,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QAC9B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QACnF,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,SAAS;QAC3C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;QACzC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAC3C,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,MAAM;QAC5D,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM;QACpD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS;KACxD,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const configSchema: z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    user: z.ZodDefault<z.ZodString>;
+    tokenName: z.ZodString;
+    tokenValue: z.ZodString;
+    allowElevated: z.ZodDefault<z.ZodBoolean>;
+    sslVerify: z.ZodDefault<z.ZodBoolean>;
+    sslCaCert: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    port: number;
+    user: string;
+    tokenName: string;
+    tokenValue: string;
+    allowElevated: boolean;
+    sslVerify: boolean;
+    sslCaCert?: string | undefined;
+}, {
+    host: string;
+    tokenName: string;
+    tokenValue: string;
+    port?: number | undefined;
+    user?: string | undefined;
+    allowElevated?: boolean | undefined;
+    sslVerify?: boolean | undefined;
+    sslCaCert?: string | undefined;
+}>;
+export type Config = z.infer<typeof configSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export const configSchema = z.object({
+    host: z
+        .string({ required_error: 'PROXMOX_HOST is required' })
+        .min(1, 'PROXMOX_HOST cannot be empty'),
+    port: z
+        .number()
+        .int()
+        .min(1)
+        .max(65535)
+        .default(8006),
+    user: z
+        .string()
+        .min(1)
+        .default('root@pam'),
+    tokenName: z
+        .string({ required_error: 'PROXMOX_TOKEN_NAME is required' })
+        .min(1, 'PROXMOX_TOKEN_NAME cannot be empty'),
+    tokenValue: z
+        .string({ required_error: 'PROXMOX_TOKEN_VALUE is required' })
+        .min(1, 'PROXMOX_TOKEN_VALUE cannot be empty'),
+    allowElevated: z
+        .boolean()
+        .default(false),
+    sslVerify: z
+        .boolean()
+        .default(false),
+    sslCaCert: z
+        .string()
+        .optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,cAAc,EAAE,0BAA0B,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;IACzC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,IAAI,CAAC;IAChB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,UAAU,CAAC;IACtB,SAAS,EAAE,CAAC;SACT,MAAM,CAAC,EAAE,cAAc,EAAE,gCAAgC,EAAE,CAAC;SAC5D,GAAG,CAAC,CAAC,EAAE,oCAAoC,CAAC;IAC/C,UAAU,EAAE,CAAC;SACV,MAAM,CAAC,EAAE,cAAc,EAAE,iCAAiC,EAAE,CAAC;SAC7D,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;IAChD,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;IACjB,SAAS,EAAE,CAAC;SACT,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;IACjB,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/dist/formatters/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Format a byte count into a human-readable string.
+ *
+ * @example formatBytes(0)          // '0 B'
+ * @example formatBytes(1024)       // '1 KB'
+ * @example formatBytes(1073741824) // '1 GB'
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format an uptime value (in seconds) into a human-readable string.
+ *
+ * @example formatUptime(60)    // '1 minute'
+ * @example formatUptime(3600)  // '1 hour'
+ * @example formatUptime(86400) // '1 day'
+ */
+export declare function formatUptime(seconds: number): string;
+/**
+ * Format a CPU usage fraction as a percentage string.
+ *
+ * @example formatCpuPercent(0.5123) // '51.23%'
+ */
+export declare function formatCpuPercent(fraction: number): string;
+import type { ToolResponse } from '../types/tools.js';
+/**
+ * Format a successful tool response.
+ *
+ * @example formatToolResponse('VM started successfully')
+ */
+export declare function formatToolResponse(text: string): ToolResponse;
+/**
+ * Format an error response with context.
+ *
+ * @example formatErrorResponse(new Error('Connection failed'), 'Get VM Status')
+ */
+export declare function formatErrorResponse(error: Error, context: string): ToolResponse;
+/**
+ * Format a permission denied response.
+ *
+ * @example formatPermissionDenied('delete_vm')
+ */
+export declare function formatPermissionDenied(action: string): ToolResponse;
+//# sourceMappingURL=index.d.ts.map

package/dist/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAepD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CASnE"}

package/dist/formatters/index.js

@@ -0,0 +1,85 @@
+/**
+ * Format a byte count into a human-readable string.
+ *
+ * @example formatBytes(0)          // '0 B'
+ * @example formatBytes(1024)       // '1 KB'
+ * @example formatBytes(1073741824) // '1 GB'
+ */
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
+    const k = 1024;
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const value = bytes / Math.pow(k, i);
+    return `${parseFloat(value.toFixed(2))} ${units[i]}`;
+}
+/**
+ * Format an uptime value (in seconds) into a human-readable string.
+ *
+ * @example formatUptime(60)    // '1 minute'
+ * @example formatUptime(3600)  // '1 hour'
+ * @example formatUptime(86400) // '1 day'
+ */
+export function formatUptime(seconds) {
+    if (seconds < 60) {
+        return `${seconds} second${seconds !== 1 ? 's' : ''}`;
+    }
+    const days = Math.floor(seconds / 86400);
+    const hours = Math.floor((seconds % 86400) / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const parts = [];
+    if (days > 0)
+        parts.push(`${days} day${days !== 1 ? 's' : ''}`);
+    if (hours > 0)
+        parts.push(`${hours} hour${hours !== 1 ? 's' : ''}`);
+    if (minutes > 0 && days === 0)
+        parts.push(`${minutes} minute${minutes !== 1 ? 's' : ''}`);
+    return parts.join(', ');
+}
+/**
+ * Format a CPU usage fraction as a percentage string.
+ *
+ * @example formatCpuPercent(0.5123) // '51.23%'
+ */
+export function formatCpuPercent(fraction) {
+    return `${(fraction * 100).toFixed(2)}%`;
+}
+/**
+ * Format a successful tool response.
+ *
+ * @example formatToolResponse('VM started successfully')
+ */
+export function formatToolResponse(text) {
+    return {
+        content: [{ type: 'text', text }],
+        isError: false,
+    };
+}
+/**
+ * Format an error response with context.
+ *
+ * @example formatErrorResponse(new Error('Connection failed'), 'Get VM Status')
+ */
+export function formatErrorResponse(error, context) {
+    const message = `❌ **Error in ${context}**\n\n${error.message}`;
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+/**
+ * Format a permission denied response.
+ *
+ * @example formatPermissionDenied('delete_vm')
+ */
+export function formatPermissionDenied(action) {
+    const message = `🚫 **Permission Denied**\n\n` +
+        `The action "${action}" requires elevated permissions.\n` +
+        `Set PROXMOX_ALLOW_ELEVATED=true to enable.`;
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/formatters/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAQA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB1C"}

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadConfig } from './config/index.js';
+import { ProxmoxApiClient } from './client/proxmox.js';
+import { createServer } from './server.js';
+import { logger } from './utils/index.js';
+export async function main() {
+    try {
+        // Load configuration from environment variables
+        const config = loadConfig();
+        logger.info('Configuration loaded successfully');
+        // Create Proxmox API client
+        const client = new ProxmoxApiClient(config);
+        logger.info('Proxmox API client initialized');
+        // Create MCP server with all tools registered
+        const server = createServer(client, config);
+        logger.info('MCP server created with 55 tools registered');
+        // Create stdio transport and connect server
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('MCP server started on stdio transport');
+    }
+    catch (error) {
+        logger.error({ error }, 'Fatal error during startup');
+        process.exit(1);
+    }
+}
+// Handle uncaught exceptions
+process.on('uncaughtException', (error) => {
+    logger.error({ error }, 'Uncaught exception');
+    process.exit(1);
+});
+// Handle unhandled promise rejections
+process.on('unhandledRejection', (reason) => {
+    logger.error({ reason }, 'Unhandled rejection');
+    process.exit(1);
+});
+// Start the server
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAEjD,4BAA4B;QAC5B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAE9C,8CAA8C;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAE3D,4CAA4C;QAC5C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,4BAA4B,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,6BAA6B;AAC7B,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,sCAAsC;AACtC,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,IAAI,EAAE,CAAC"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,41 @@
+import type { Config } from '../config/index.js';
+/**
+ * Checks if elevated permissions are allowed and throws if not.
+ * Used to guard dangerous operations that require explicit opt-in.
+ *
+ * @throws {Error} If elevated permissions are not allowed
+ */
+export declare function requireElevated(config: Config, action: string): void;
+/**
+ * Simple in-memory rate limiter using a sliding window approach.
+ * Tracks requests per key and enforces a maximum request count within a time window.
+ */
+export declare class RateLimiter {
+    private maxRequests;
+    private windowMs;
+    private requests;
+    /**
+     * @param maxRequests Maximum number of requests allowed in the window
+     * @param windowMs Time window in milliseconds
+     */
+    constructor(maxRequests: number, windowMs: number);
+    /**
+     * Check if a request is allowed for the given key.
+     * Returns true if allowed, false if rate limited.
+     *
+     * @param key Identifier for the rate limit bucket (e.g., user ID, IP address)
+     * @returns true if request is allowed, false if rate limited
+     */
+    check(key: string): boolean;
+    /**
+     * Reset the rate limiter (clear all tracked requests).
+     * Useful for testing or manual reset.
+     */
+    reset(): void;
+    /**
+     * Get the number of requests for a key within the current window.
+     * Useful for monitoring and testing.
+     */
+    getRequestCount(key: string): number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIpE;AAED;;;GAGG;AACH,qBAAa,WAAW;IAQpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;IARlB,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;OAGG;gBAEO,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM;IAG1B;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAsB3B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAMrC"}

package/dist/middleware/index.js

@@ -0,0 +1,69 @@
+/**
+ * Checks if elevated permissions are allowed and throws if not.
+ * Used to guard dangerous operations that require explicit opt-in.
+ *
+ * @throws {Error} If elevated permissions are not allowed
+ */
+export function requireElevated(config, action) {
+    if (!config.allowElevated) {
+        throw new Error(`Permission denied: ${action} requires elevated permissions`);
+    }
+}
+/**
+ * Simple in-memory rate limiter using a sliding window approach.
+ * Tracks requests per key and enforces a maximum request count within a time window.
+ */
+export class RateLimiter {
+    maxRequests;
+    windowMs;
+    requests = new Map();
+    /**
+     * @param maxRequests Maximum number of requests allowed in the window
+     * @param windowMs Time window in milliseconds
+     */
+    constructor(maxRequests, windowMs) {
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+    }
+    /**
+     * Check if a request is allowed for the given key.
+     * Returns true if allowed, false if rate limited.
+     *
+     * @param key Identifier for the rate limit bucket (e.g., user ID, IP address)
+     * @returns true if request is allowed, false if rate limited
+     */
+    check(key) {
+        const now = Date.now();
+        const windowStart = now - this.windowMs;
+        // Get or initialize request timestamps for this key
+        let timestamps = this.requests.get(key) || [];
+        // Remove timestamps outside the window
+        timestamps = timestamps.filter((ts) => ts > windowStart);
+        // Check if we've exceeded the limit
+        if (timestamps.length >= this.maxRequests) {
+            return false;
+        }
+        // Add current request timestamp
+        timestamps.push(now);
+        this.requests.set(key, timestamps);
+        return true;
+    }
+    /**
+     * Reset the rate limiter (clear all tracked requests).
+     * Useful for testing or manual reset.
+     */
+    reset() {
+        this.requests.clear();
+    }
+    /**
+     * Get the number of requests for a key within the current window.
+     * Useful for monitoring and testing.
+     */
+    getRequestCount(key) {
+        const now = Date.now();
+        const windowStart = now - this.windowMs;
+        const timestamps = this.requests.get(key) || [];
+        return timestamps.filter((ts) => ts > windowStart).length;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc;IAC5D,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,gCAAgC,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,WAAW;IAQZ;IACA;IARF,QAAQ,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEpD;;;OAGG;IACH,YACU,WAAmB,EACnB,QAAgB;QADhB,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAQ;IACvB,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,GAAW;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAExC,oDAAoD;QACpD,IAAI,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAE9C,uCAAuC;QACvC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;QAEzD,oCAAoC;QACpC,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gCAAgC;QAChC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAEnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,GAAW;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,MAAM,CAAC;IAC5D,CAAC;CACF"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/prompts/index.js

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

package/dist/prompts/index.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/resources/index.js

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

package/dist/resources/index.js.map

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