@aristanetworks/eos-mcp-server 0.6.1-beta

package/dist/cli.js

@@ -0,0 +1,188 @@
+import { AppError } from "./core/errors.js";
+import { APP_NAME, APP_VERSION } from "./core/version.js";
+const COMMAND_NAMES = new Set(["serve", "validate-inventory", "print-server-info", "probe"]);
+const OPTION_NAMES = new Set([
+    "--help",
+    "-h",
+    "--version",
+    "-V",
+    "--config",
+    "--inventory",
+    "--actor",
+    "--json",
+    "--inventory-only",
+    "--target"
+]);
+const COMMAND_OPTIONS = {
+    "serve": new Set([
+        "--help",
+        "-h",
+        "--version",
+        "-V",
+        "--config",
+        "--inventory",
+        "--actor"
+    ]),
+    "validate-inventory": new Set(["--help", "-h", "--version", "-V", "--config", "--inventory", "--inventory-only", "--json"]),
+    "print-server-info": new Set(["--help", "-h", "--version", "-V", "--config", "--inventory", "--json"]),
+    "probe": new Set(["--help", "-h", "--version", "-V", "--config", "--inventory", "--target", "--json"])
+};
+export function parseCliArgs(argv) {
+    let command = "serve";
+    let index = 0;
+    const first = argv[0];
+    if (first === "--help" || first === "-h") {
+        return { command, help: true };
+    }
+    if (first === "--version" || first === "-V") {
+        return { command, version: true };
+    }
+    let explicitCommand = false;
+    if (first !== undefined && COMMAND_NAMES.has(first)) {
+        command = first;
+        explicitCommand = true;
+        index = 1;
+    }
+    const options = { command, ...(explicitCommand ? { explicitCommand: true } : {}) };
+    while (index < argv.length) {
+        const arg = argv[index];
+        if (arg !== undefined && OPTION_NAMES.has(arg)) {
+            assertOptionAllowed(command, arg);
+        }
+        switch (arg) {
+            case "--help":
+            case "-h":
+                options.help = true;
+                return options;
+            case "--version":
+            case "-V":
+                options.version = true;
+                return options;
+            case "--config": {
+                const value = argv[index + 1];
+                if (!value) {
+                    throw new AppError("cli_missing_value", "Missing value for --config");
+                }
+                options.configPath = value;
+                index += 2;
+                break;
+            }
+            case "--inventory": {
+                const value = argv[index + 1];
+                if (!value) {
+                    throw new AppError("cli_missing_value", "Missing value for --inventory");
+                }
+                options.inventoryPath = value;
+                index += 2;
+                break;
+            }
+            case "--actor": {
+                const value = argv[index + 1];
+                if (!value) {
+                    throw new AppError("cli_missing_value", "Missing value for --actor");
+                }
+                options.actor = value;
+                index += 2;
+                break;
+            }
+            case "--json":
+                options.json = true;
+                index += 1;
+                break;
+            case "--inventory-only":
+                options.inventoryOnly = true;
+                index += 1;
+                break;
+            case "--target": {
+                const value = argv[index + 1];
+                if (!value) {
+                    throw new AppError("cli_missing_value", "Missing value for --target");
+                }
+                options.target = value;
+                index += 2;
+                break;
+            }
+            default:
+                throw new AppError("cli_unknown_argument", `Unknown argument: ${arg}`);
+        }
+    }
+    return options;
+}
+function assertOptionAllowed(command, option) {
+    if (!COMMAND_OPTIONS[command].has(option)) {
+        throw new AppError("cli_option_not_allowed", `Option ${option} is not valid for command ${command}`);
+    }
+}
+const VERSION_BANNER = `${APP_NAME} v${APP_VERSION}`;
+const HELP_TOP = `${VERSION_BANNER}
+MCP server for Arista EOS eAPI (JSON-RPC over HTTPS)
+
+Usage: ${APP_NAME} [command] [options]
+
+Commands:
+  serve                 Start the MCP server over stdio (default)
+  validate-inventory    Validate an inventory file
+  print-server-info     Print server runtime/config summary
+  probe                 Probe device readiness for a target
+
+Global options:
+  --config <path>       Path to server config YAML file
+  --inventory <path>    Path to inventory YAML file
+  -h, --help            Show this help message
+  -V, --version         Show version number
+
+Run '${APP_NAME} <command> --help' for command-specific options.`;
+const HELP_SERVE = `Usage: ${APP_NAME} serve [options]
+
+Start the MCP server over stdio.
+
+Options:
+  --config <path>       Path to server config YAML file
+  --inventory <path>    Path to inventory YAML file
+  --actor <name>        Actor label for audit logging
+  -h, --help            Show this help message`;
+const HELP_VALIDATE_INVENTORY = `Usage: ${APP_NAME} validate-inventory [options]
+
+Validate an inventory file. Performs structural parsing, effective
+inventory validation, and startup-style connection checks by default.
+
+Options:
+  --config <path>       Path to server config YAML file
+  --inventory <path>    Path to inventory YAML file
+  --inventory-only      Skip startup connection checks
+  --json                Output results as JSON
+  -h, --help            Show this help message`;
+const HELP_PRINT_SERVER_INFO = `Usage: ${APP_NAME} print-server-info [options]
+
+Print a sanitized summary of server runtime configuration.
+
+Options:
+  --config <path>       Path to server config YAML file
+  --inventory <path>    Path to inventory YAML file
+  --json                Output as JSON
+  -h, --help            Show this help message`;
+const HELP_PROBE = `Usage: ${APP_NAME} probe [options]
+
+Probe device readiness for a host or group target. Tests connectivity,
+authentication, and harmless command execution.
+
+Options:
+  --config <path>       Path to server config YAML file
+  --inventory <path>    Path to inventory YAML file
+  --target <name>       Host or group name to probe (required)
+  --json                Output as JSON
+  -h, --help            Show this help message`;
+const COMMAND_HELP = {
+    "serve": HELP_SERVE,
+    "validate-inventory": HELP_VALIDATE_INVENTORY,
+    "print-server-info": HELP_PRINT_SERVER_INFO,
+    "probe": HELP_PROBE
+};
+export function printHelp(cli) {
+    const helpText = cli.explicitCommand ? COMMAND_HELP[cli.command] : HELP_TOP;
+    console.log(helpText);
+}
+export function printVersion() {
+    console.log(VERSION_BANNER);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/printServerInfo.d.ts

@@ -0,0 +1,2 @@
+import type { ServerRuntimeContext } from "../serverInfo/types.js";
+export declare function printServerInfo(runtimeContext: ServerRuntimeContext, asJson: boolean): void;

package/dist/commands/printServerInfo.js

@@ -0,0 +1,14 @@
+import { buildServerInfo } from "../serverInfo/buildServerInfo.js";
+import { prettyJson } from "../utils/json.js";
+export function printServerInfo(runtimeContext, asJson) {
+    const info = buildServerInfo(runtimeContext);
+    if (asJson) {
+        console.log(prettyJson(info));
+        return;
+    }
+    console.log(`Server: ${info.server_name} ${info.server_version}`);
+    console.log(`Mode: ${info.runtime_mode}`);
+    console.log(`Inventory: ${info.inventory.basename ?? "(none)"}`);
+    console.log(`Read timeout (ms): ${info.limits.read_timeout_ms}`);
+}
+//# sourceMappingURL=printServerInfo.js.map

package/dist/commands/printServerInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printServerInfo.js","sourceRoot":"","sources":["../../src/commands/printServerInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,eAAe,CAAC,cAAoC,EAAE,MAAe;IACnF,MAAM,IAAI,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IAE7C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/commands/probe.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+export declare function runProbe(config: ResolvedServerConfig, target: string, asJson: boolean): Promise<number>;

package/dist/commands/probe.js

@@ -0,0 +1,26 @@
+import { EapiDeviceReader } from "../connection/eosDeviceReader.js";
+import { EapiClient } from "../eapi/client.js";
+import { loadInventoryModel } from "../inventory/loadInventory.js";
+import { probeDevices } from "../probe/probeDevices.js";
+import { AppError } from "../core/errors.js";
+import { prettyJson } from "../utils/json.js";
+export async function runProbe(config, target, asJson) {
+    if (!config.inventoryPath) {
+        throw new AppError("cli_missing_inventory", "probe requires an inventory path via --inventory or config file");
+    }
+    const model = await loadInventoryModel(config.inventoryPath);
+    const result = await probeDevices(model, config, { target, include_raw: false }, new EapiDeviceReader(config, new EapiClient()));
+    if (asJson) {
+        console.log(prettyJson(result));
+    }
+    else {
+        console.log(`Probe target: ${result.target}`);
+        console.log(`Devices: ${result.summary.success_count}/${result.summary.total_count} succeeded`);
+        for (const entry of result.results) {
+            const suffix = entry.status === "success" ? "" : ` - ${entry.message ?? entry.error_code ?? "failed"}`;
+            console.log(`- ${entry.inventory_hostname}: ${entry.status}${suffix}`);
+        }
+    }
+    return result.summary.failed_count === 0 ? 0 : 1;
+}
+//# sourceMappingURL=probe.js.map

package/dist/commands/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/commands/probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAA4B,EAAE,MAAc,EAAE,MAAe;IAC1F,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,uBAAuB,EAAE,iEAAiE,CAAC,CAAC;IACjH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,KAAK,EACL,MAAM,EACN,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,EAC9B,IAAI,gBAAgB,CAAC,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC,CAC/C,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,YAAY,CAAC,CAAC;QAEhG,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC;YACvG,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,kBAAkB,KAAK,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/commands/validateInventory.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+import type { InventoryValidationResult } from "../inventory/types.js";
+export declare function buildValidateInventoryResult(config: ResolvedServerConfig, options: {
+    inventoryOnly: boolean;
+}): Promise<InventoryValidationResult>;
+export declare function runValidateInventory(config: ResolvedServerConfig, options: {
+    asJson: boolean;
+    inventoryOnly: boolean;
+}): Promise<number>;

package/dist/commands/validateInventory.js

@@ -0,0 +1,59 @@
+import { AppError } from "../core/errors.js";
+import { collectStartupConnectionValidationErrors } from "../connection/validateStartupConnections.js";
+import { loadInventoryModel, validateInventory } from "../inventory/loadInventory.js";
+import { prettyJson } from "../utils/json.js";
+export async function buildValidateInventoryResult(config, options) {
+    if (!config.inventoryPath) {
+        throw new AppError("inventory_path_missing", "validate-inventory requires an inventory path via --inventory or config file");
+    }
+    const inventoryPath = config.inventoryPath;
+    const inventoryResult = await validateInventory(inventoryPath);
+    if (!inventoryResult.ok) {
+        return {
+            ...inventoryResult,
+            notes: options.inventoryOnly
+                ? [...inventoryResult.notes, "Inventory-only mode skips startup connection validation."]
+                : [...inventoryResult.notes, "Effective validation stopped before startup connection checks due to inventory errors."]
+        };
+    }
+    if (options.inventoryOnly) {
+        return {
+            ...inventoryResult,
+            notes: [...inventoryResult.notes, "Inventory-only mode skips startup connection validation."]
+        };
+    }
+    const model = await loadInventoryModel(inventoryPath);
+    const startupErrors = collectStartupConnectionValidationErrors(config, model);
+    return {
+        ...inventoryResult,
+        ok: startupErrors.length === 0,
+        errors: [...inventoryResult.errors, ...startupErrors],
+        notes: [...inventoryResult.notes, "Effective validation included startup connection checks for EOS-eligible hosts."]
+    };
+}
+export async function runValidateInventory(config, options) {
+    const result = await buildValidateInventoryResult(config, { inventoryOnly: options.inventoryOnly });
+    if (options.asJson) {
+        console.log(prettyJson(result));
+    }
+    else if (result.ok) {
+        console.log(`Inventory valid: ${result.summary?.basename ?? config.inventoryPath ?? "(unknown)"}`);
+        console.log(`Schema: ${result.schemaKind}`);
+        console.log(`Hosts: ${result.summary?.totalHostCount ?? 0}`);
+        console.log(`Groups: ${result.summary?.totalGroupCount ?? 0}`);
+        for (const note of result.notes) {
+            console.log(`Note: ${note}`);
+        }
+    }
+    else {
+        console.error("Inventory validation failed:");
+        for (const error of result.errors) {
+            console.error(`- [${error.code}] ${error.message}`);
+        }
+        for (const note of result.notes) {
+            console.error(`Note: ${note}`);
+        }
+    }
+    return result.ok ? 0 : 1;
+}
+//# sourceMappingURL=validateInventory.js.map

package/dist/commands/validateInventory.js.map

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

package/dist/config/loadConfig.d.ts

@@ -0,0 +1,3 @@
+import type { CliOptions } from "../cli.js";
+import { type ResolvedServerConfig } from "./schema.js";
+export declare function loadServerConfig(options: CliOptions): Promise<ResolvedServerConfig>;

package/dist/config/loadConfig.js

@@ -0,0 +1,84 @@
+import fs from "node:fs/promises";
+import { parseDocument } from "yaml";
+import { ZodError } from "zod";
+import { AppError } from "../core/errors.js";
+import { resolvePathFromConfig, resolvePathFromCwd } from "../utils/path.js";
+import { resolvedServerConfigSchema, serverConfigFileSchema } from "./schema.js";
+export async function loadServerConfig(options) {
+    let fileConfig = {};
+    let resolvedConfigPath;
+    if (options.configPath) {
+        resolvedConfigPath = resolvePathFromCwd(options.configPath);
+        const text = await readConfigFile(resolvedConfigPath);
+        const doc = parseDocument(text, { uniqueKeys: true, merge: true, prettyErrors: true });
+        if (doc.errors.length > 0) {
+            throw new AppError("config_invalid_yaml", `Invalid server config YAML: ${doc.errors.map((error) => error.message).join("; ")}`);
+        }
+        const raw = doc.toJS();
+        fileConfig = parseConfigSchema(() => serverConfigFileSchema.parse(raw), "config_schema_invalid");
+    }
+    const merged = {
+        configPath: resolvedConfigPath,
+        inventoryPath: resolveMaybePath(fileConfig.inventory, resolvedConfigPath),
+        actor: fileConfig.actor,
+        logFile: resolveMaybePath(fileConfig.logFile, resolvedConfigPath),
+        caFile: resolveMaybePath(fileConfig.caFile, resolvedConfigPath),
+        readTimeoutMs: fileConfig.readTimeoutMs,
+        overallOperationTimeoutMs: fileConfig.overallOperationTimeoutMs,
+        deviceConcurrency: fileConfig.deviceConcurrency,
+        maxReadTargets: fileConfig.maxReadTargets,
+        maxShowCommandsPerRequest: fileConfig.maxShowCommandsPerRequest,
+        maxLoggingMessagesPerRequest: fileConfig.maxLoggingMessagesPerRequest,
+        maxResponseSizeBytes: fileConfig.maxResponseSizeBytes,
+        eapiVersion: fileConfig.eapiVersion,
+        secretEnvPrefixes: fileConfig.secretEnvPrefixes,
+        defaultConnection: fileConfig.defaultConnection
+    };
+    if (options.inventoryPath) {
+        merged.inventoryPath = resolvePathFromCwd(options.inventoryPath);
+    }
+    if (options.actor !== undefined) {
+        merged.actor = options.actor;
+    }
+    return parseConfigSchema(() => resolvedServerConfigSchema.parse(merged), "config_resolved_invalid");
+}
+async function readConfigFile(configPath) {
+    try {
+        return await fs.readFile(configPath, "utf8");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new AppError("config_read_failed", `Failed to read server config ${configPath}: ${message}`, { configPath });
+    }
+}
+function resolveMaybePath(value, configPath) {
+    if (!value) {
+        return undefined;
+    }
+    if (!configPath) {
+        return resolvePathFromCwd(value);
+    }
+    return resolvePathFromConfig(configPath, value);
+}
+function parseConfigSchema(parse, code) {
+    try {
+        return parse();
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            throw new AppError(code, `Invalid server config: ${formatZodIssues(error)}`, {
+                issues: error.issues
+            });
+        }
+        throw error;
+    }
+}
+function formatZodIssues(error) {
+    return error.issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+        return `${path}${issue.message}`;
+    })
+        .join("; ");
+}
+//# sourceMappingURL=loadConfig.js.map

package/dist/config/loadConfig.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,151 @@
+import { z } from "zod";
+export declare const serverConfigFileSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodLiteral<1>>;
+    inventory: z.ZodOptional<z.ZodString>;
+    actor: z.ZodOptional<z.ZodString>;
+    logFile: z.ZodOptional<z.ZodString>;
+    caFile: z.ZodOptional<z.ZodString>;
+    readTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    overallOperationTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    deviceConcurrency: z.ZodOptional<z.ZodNumber>;
+    maxReadTargets: z.ZodOptional<z.ZodNumber>;
+    maxShowCommandsPerRequest: z.ZodOptional<z.ZodNumber>;
+    maxLoggingMessagesPerRequest: z.ZodOptional<z.ZodNumber>;
+    maxResponseSizeBytes: z.ZodOptional<z.ZodNumber>;
+    eapiVersion: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<"latest">]>>;
+    secretEnvPrefixes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    defaultConnection: z.ZodOptional<z.ZodObject<{
+        ansibleUser: z.ZodOptional<z.ZodString>;
+        ansibleHttpapiPort: z.ZodOptional<z.ZodNumber>;
+        mcpValidateCerts: z.ZodOptional<z.ZodBoolean>;
+        mcpPasswordEnv: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    }, {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    version?: 1 | undefined;
+    inventory?: string | undefined;
+    actor?: string | undefined;
+    logFile?: string | undefined;
+    caFile?: string | undefined;
+    readTimeoutMs?: number | undefined;
+    overallOperationTimeoutMs?: number | undefined;
+    deviceConcurrency?: number | undefined;
+    maxReadTargets?: number | undefined;
+    maxShowCommandsPerRequest?: number | undefined;
+    maxLoggingMessagesPerRequest?: number | undefined;
+    maxResponseSizeBytes?: number | undefined;
+    eapiVersion?: 1 | "latest" | undefined;
+    secretEnvPrefixes?: string[] | undefined;
+    defaultConnection?: {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    } | undefined;
+}, {
+    version?: 1 | undefined;
+    inventory?: string | undefined;
+    actor?: string | undefined;
+    logFile?: string | undefined;
+    caFile?: string | undefined;
+    readTimeoutMs?: number | undefined;
+    overallOperationTimeoutMs?: number | undefined;
+    deviceConcurrency?: number | undefined;
+    maxReadTargets?: number | undefined;
+    maxShowCommandsPerRequest?: number | undefined;
+    maxLoggingMessagesPerRequest?: number | undefined;
+    maxResponseSizeBytes?: number | undefined;
+    eapiVersion?: 1 | "latest" | undefined;
+    secretEnvPrefixes?: string[] | undefined;
+    defaultConnection?: {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    } | undefined;
+}>;
+export declare const resolvedServerConfigSchema: z.ZodObject<{
+    configPath: z.ZodOptional<z.ZodString>;
+    inventoryPath: z.ZodOptional<z.ZodString>;
+    actor: z.ZodOptional<z.ZodString>;
+    logFile: z.ZodOptional<z.ZodString>;
+    caFile: z.ZodOptional<z.ZodString>;
+    readTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    overallOperationTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    deviceConcurrency: z.ZodDefault<z.ZodNumber>;
+    maxReadTargets: z.ZodDefault<z.ZodNumber>;
+    maxShowCommandsPerRequest: z.ZodDefault<z.ZodNumber>;
+    maxLoggingMessagesPerRequest: z.ZodDefault<z.ZodNumber>;
+    maxResponseSizeBytes: z.ZodDefault<z.ZodNumber>;
+    eapiVersion: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<"latest">]>>;
+    secretEnvPrefixes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    defaultConnection: z.ZodDefault<z.ZodObject<{
+        ansibleUser: z.ZodOptional<z.ZodString>;
+        ansibleHttpapiPort: z.ZodOptional<z.ZodNumber>;
+        mcpValidateCerts: z.ZodOptional<z.ZodBoolean>;
+        mcpPasswordEnv: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    }, {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    readTimeoutMs: number;
+    deviceConcurrency: number;
+    maxReadTargets: number;
+    maxShowCommandsPerRequest: number;
+    maxLoggingMessagesPerRequest: number;
+    maxResponseSizeBytes: number;
+    eapiVersion: 1 | "latest";
+    secretEnvPrefixes: string[];
+    defaultConnection: {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    };
+    actor?: string | undefined;
+    logFile?: string | undefined;
+    caFile?: string | undefined;
+    overallOperationTimeoutMs?: number | undefined;
+    configPath?: string | undefined;
+    inventoryPath?: string | undefined;
+}, {
+    actor?: string | undefined;
+    logFile?: string | undefined;
+    caFile?: string | undefined;
+    readTimeoutMs?: number | undefined;
+    overallOperationTimeoutMs?: number | undefined;
+    deviceConcurrency?: number | undefined;
+    maxReadTargets?: number | undefined;
+    maxShowCommandsPerRequest?: number | undefined;
+    maxLoggingMessagesPerRequest?: number | undefined;
+    maxResponseSizeBytes?: number | undefined;
+    eapiVersion?: 1 | "latest" | undefined;
+    secretEnvPrefixes?: string[] | undefined;
+    defaultConnection?: {
+        ansibleUser?: string | undefined;
+        ansibleHttpapiPort?: number | undefined;
+        mcpValidateCerts?: boolean | undefined;
+        mcpPasswordEnv?: string | undefined;
+    } | undefined;
+    configPath?: string | undefined;
+    inventoryPath?: string | undefined;
+}>;
+export type ServerConfigFile = z.infer<typeof serverConfigFileSchema>;
+export type ResolvedServerConfig = z.infer<typeof resolvedServerConfigSchema>;

package/dist/config/schema.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+const eapiVersionSchema = z.union([z.literal(1), z.literal("latest")]);
+export const serverConfigFileSchema = z
+    .object({
+    version: z.literal(1).optional(),
+    inventory: z.string().min(1).optional(),
+    actor: z.string().min(1).optional(),
+    logFile: z.string().min(1).optional(),
+    caFile: z.string().min(1).optional(),
+    readTimeoutMs: z.number().int().positive().optional(),
+    overallOperationTimeoutMs: z.number().int().positive().optional(),
+    deviceConcurrency: z.number().int().positive().optional(),
+    maxReadTargets: z.number().int().positive().optional(),
+    maxShowCommandsPerRequest: z.number().int().positive().optional(),
+    maxLoggingMessagesPerRequest: z.number().int().positive().max(9999).optional(),
+    maxResponseSizeBytes: z.number().int().positive().optional(),
+    eapiVersion: eapiVersionSchema.optional(),
+    secretEnvPrefixes: z.array(z.string().min(1)).optional(),
+    defaultConnection: z
+        .object({
+        ansibleUser: z.string().min(1).optional(),
+        ansibleHttpapiPort: z.number().int().positive().optional(),
+        mcpValidateCerts: z.boolean().optional(),
+        mcpPasswordEnv: z.string().min(1).optional()
+    })
+        .optional()
+})
+    .strict();
+export const resolvedServerConfigSchema = z
+    .object({
+    configPath: z.string().min(1).optional(),
+    inventoryPath: z.string().min(1).optional(),
+    actor: z.string().min(1).optional(),
+    logFile: z.string().min(1).optional(),
+    caFile: z.string().min(1).optional(),
+    readTimeoutMs: z.number().int().positive().default(10_000),
+    overallOperationTimeoutMs: z.number().int().positive().optional(),
+    deviceConcurrency: z.number().int().positive().default(5),
+    maxReadTargets: z.number().int().positive().default(50),
+    maxShowCommandsPerRequest: z.number().int().positive().default(5),
+    maxLoggingMessagesPerRequest: z.number().int().positive().max(9999).default(1000),
+    maxResponseSizeBytes: z.number().int().positive().default(1_048_576),
+    eapiVersion: eapiVersionSchema.default("latest"),
+    secretEnvPrefixes: z.array(z.string().min(1)).default(["EOS_MCP_"]),
+    defaultConnection: z
+        .object({
+        ansibleUser: z.string().min(1).optional(),
+        ansibleHttpapiPort: z.number().int().positive().optional(),
+        mcpValidateCerts: z.boolean().optional(),
+        mcpPasswordEnv: z.string().min(1).optional()
+    })
+        .default({})
+});
+//# 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":"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"}