@aristanetworks/eos-mcp-server 0.6.1-beta

package/dist/inventory/resolveTarget.js

@@ -0,0 +1,55 @@
+import { AppError } from "../core/errors.js";
+export class InventoryResolutionError extends AppError {
+    constructor(code, message) {
+        super(code, message);
+    }
+}
+export function resolveInventoryTarget(model, options) {
+    const { target } = options;
+    const directHost = model.hostMap.get(target);
+    if (directHost) {
+        validateHostsForOperation([directHost], target);
+        return {
+            target,
+            targetType: "host",
+            resolvedHosts: [directHost]
+        };
+    }
+    const group = model.groupMap.get(target);
+    if (!group) {
+        throw new InventoryResolutionError("target_not_found", `Unknown inventory target ${target}`);
+    }
+    const resolvedHosts = group.resolvedHosts.map((hostName) => {
+        const host = model.hostMap.get(hostName);
+        if (!host) {
+            throw new InventoryResolutionError("target_resolution_failed", `Resolved host ${hostName} is missing from inventory host map`);
+        }
+        return host;
+    });
+    validateHostsForOperation(resolvedHosts, target);
+    return {
+        target,
+        targetType: "group",
+        resolvedHosts
+    };
+}
+function validateHostsForOperation(hosts, target) {
+    if (hosts.length === 0) {
+        throw new InventoryResolutionError("no_eligible_targets", `Target ${target} resolved to zero hosts`);
+    }
+    const deniedHosts = [];
+    for (const host of hosts) {
+        if (!host.eligible) {
+            deniedHosts.push(host.inventoryHostname);
+            continue;
+        }
+        if (!host.readAllowed) {
+            deniedHosts.push(host.inventoryHostname);
+            continue;
+        }
+    }
+    if (deniedHosts.length > 0) {
+        throw new InventoryResolutionError("policy_denied", `Policy denied: target ${target} includes host(s) not permitted for read operations: ${deniedHosts.sort().join(", ")}`);
+    }
+}
+//# sourceMappingURL=resolveTarget.js.map

package/dist/inventory/resolveTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTarget.js","sourceRoot":"","sources":["../../src/inventory/resolveTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAa7C,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;IACpD,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAqB,EACrB,OAAsC;IAEtC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,UAAU,EAAE,CAAC;QACf,yBAAyB,CAAC,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO;YACL,MAAM;YACN,UAAU,EAAE,MAAM;YAClB,aAAa,EAAE,CAAC,UAAU,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,wBAAwB,CAAC,kBAAkB,EAAE,4BAA4B,MAAM,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,wBAAwB,CAAC,0BAA0B,EAAE,iBAAiB,QAAQ,qCAAqC,CAAC,CAAC;QACjI,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,yBAAyB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAEjD,OAAO;QACL,MAAM;QACN,UAAU,EAAE,OAAO;QACnB,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,KAA2B,EAC3B,MAAc;IAEd,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,wBAAwB,CAAC,qBAAqB,EAAE,UAAU,MAAM,yBAAyB,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,yBAAyB,MAAM,wDAAwD,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/inventory/types.d.ts

@@ -0,0 +1,50 @@
+export type InventorySchemaKind = "canonical-ansible-yaml" | "simplified-yaml";
+export interface InventorySummary {
+    path: string;
+    basename: string;
+    schemaKind: InventorySchemaKind;
+    totalHostCount: number;
+    totalGroupCount: number;
+    eosEligibleHostCount: number | null;
+    readAllowedHostCount: number | null;
+}
+export interface InventoryValidationError {
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface InventoryValidationResult {
+    ok: boolean;
+    schemaKind?: InventorySchemaKind;
+    summary?: InventorySummary;
+    errors: InventoryValidationError[];
+    notes: string[];
+}
+export interface InventoryHostModel {
+    inventoryHostname: string;
+    resolvedEndpoint: string;
+    effectiveVars: Record<string, unknown>;
+    eligible: boolean;
+    readAllowed: boolean;
+    ineligibilityReasons: string[];
+    groupMemberships: string[];
+}
+export interface InventoryGroupModel {
+    name: string;
+    hosts: string[];
+    children: string[];
+    resolvedHosts: string[];
+    eligibleHostCount: number;
+    ineligibleHostCount: number;
+    actionable: boolean;
+}
+export interface InventoryModel {
+    path: string;
+    basename: string;
+    schemaKind: InventorySchemaKind;
+    summary: InventorySummary;
+    hosts: InventoryHostModel[];
+    groups: InventoryGroupModel[];
+    hostMap: Map<string, InventoryHostModel>;
+    groupMap: Map<string, InventoryGroupModel>;
+}

package/dist/inventory/types.js

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

package/dist/inventory/types.js.map

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

package/dist/inventory/validateNormalized.d.ts

@@ -0,0 +1,2 @@
+import type { NormalizedInventory, ValidationContext } from "./internalTypes.js";
+export declare function validateNormalizedInventory(inventory: NormalizedInventory, context: ValidationContext): void;

package/dist/inventory/validateNormalized.js

@@ -0,0 +1,64 @@
+import { validateSafeName } from "./internalUtils.js";
+export function validateNormalizedInventory(inventory, context) {
+    validateGroupReferences(inventory, context);
+    validateGroupGraph(inventory, context);
+}
+function validateGroupReferences(inventory, context) {
+    for (const group of inventory.groups.values()) {
+        for (const hostName of group.hosts) {
+            validateSafeName(hostName, "host", context, `groups.${group.name}.hosts`);
+            if (!inventory.hosts.has(hostName)) {
+                context.errors.push({
+                    code: "inventory_group_host_missing",
+                    message: `Group ${group.name} references unknown host ${hostName}`,
+                    path: `groups.${group.name}.hosts`
+                });
+            }
+        }
+        for (const childName of group.children) {
+            validateSafeName(childName, "group", context, `groups.${group.name}.children`);
+            if (!inventory.groups.has(childName)) {
+                context.errors.push({
+                    code: "inventory_group_child_missing",
+                    message: `Group ${group.name} references unknown child group ${childName}`,
+                    path: `groups.${group.name}.children`
+                });
+            }
+        }
+    }
+}
+function validateGroupGraph(inventory, context) {
+    const visited = new Set();
+    const inStack = new Set();
+    const stack = [];
+    for (const groupName of inventory.groups.keys()) {
+        visit(groupName);
+    }
+    function visit(groupName) {
+        if (visited.has(groupName)) {
+            return;
+        }
+        if (inStack.has(groupName)) {
+            const cycleStart = stack.indexOf(groupName);
+            const cyclePath = [...stack.slice(cycleStart), groupName].join(" -> ");
+            context.errors.push({
+                code: "inventory_group_cycle",
+                message: `Inventory group graph contains a cycle: ${cyclePath}`,
+                path: groupName
+            });
+            return;
+        }
+        inStack.add(groupName);
+        stack.push(groupName);
+        const group = inventory.groups.get(groupName);
+        for (const child of group?.children ?? []) {
+            if (inventory.groups.has(child)) {
+                visit(child);
+            }
+        }
+        stack.pop();
+        inStack.delete(groupName);
+        visited.add(groupName);
+    }
+}
+//# sourceMappingURL=validateNormalized.js.map

package/dist/inventory/validateNormalized.js.map

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

package/dist/inventory/varValidation.d.ts

@@ -0,0 +1,2 @@
+import type { NormalizedInventory, ValidationContext } from "./internalTypes.js";
+export declare function validateKnownInventoryVarTypes(inventory: NormalizedInventory, context: ValidationContext): void;

package/dist/inventory/varValidation.js

@@ -0,0 +1,60 @@
+const BOOLEAN_VAR_KEYS = new Set([
+    "mcp_read_allowed",
+    "mcp_validate_certs",
+    "ansible_httpapi_validate_certs"
+]);
+const NON_EMPTY_STRING_VAR_KEYS = new Set([
+    "ansible_host",
+    "ansible_user",
+    "ansible_network_os",
+    "mcp_platform",
+    "mcp_password_env",
+    "ansible_password"
+]);
+const POSITIVE_INTEGER_VAR_KEYS = new Set(["ansible_httpapi_port"]);
+export function validateKnownInventoryVarTypes(inventory, context) {
+    validateVarSet(inventory.globalVars, "vars", context);
+    for (const group of inventory.groups.values()) {
+        validateVarSet(group.vars, `groups.${group.name}.vars`, context);
+    }
+    for (const [hostName, hostVars] of inventory.hosts.entries()) {
+        validateVarSet(hostVars, `hosts.${hostName}`, context);
+    }
+}
+function validateVarSet(vars, pathLabel, context) {
+    for (const [key, value] of Object.entries(vars)) {
+        const valuePath = `${pathLabel}.${key}`;
+        if (BOOLEAN_VAR_KEYS.has(key) && typeof value !== "boolean") {
+            addTypeError(context, valuePath, key, value, "a boolean");
+            continue;
+        }
+        if (NON_EMPTY_STRING_VAR_KEYS.has(key) && !isNonEmptyString(value)) {
+            addTypeError(context, valuePath, key, value, "a non-empty string");
+            continue;
+        }
+        if (POSITIVE_INTEGER_VAR_KEYS.has(key) && !isPositiveIntegerLike(value)) {
+            addTypeError(context, valuePath, key, value, "a positive integer or positive integer string");
+        }
+    }
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function isPositiveIntegerLike(value) {
+    if (typeof value === "number") {
+        return Number.isInteger(value) && value > 0;
+    }
+    if (typeof value === "string" && value.length > 0) {
+        const parsed = Number(value);
+        return Number.isInteger(parsed) && parsed > 0;
+    }
+    return false;
+}
+function addTypeError(context, path, key, value, expected) {
+    context.errors.push({
+        code: "inventory_var_type_invalid",
+        message: `${path} must be ${expected}; got ${key}=${JSON.stringify(value)}`,
+        path
+    });
+}
+//# sourceMappingURL=varValidation.js.map

package/dist/inventory/varValidation.js.map

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

package/dist/inventory/writePolicy.d.ts

@@ -0,0 +1,2 @@
+import type { InventoryVars, NormalizedInventory, ValidationContext } from "./internalTypes.js";
+export declare function validateWritePolicyContradictions(hostName: string, globalVars: InventoryVars, lineageGroups: Set<string>, hostVars: InventoryVars, inventory: NormalizedInventory, groupDepths: Map<string, number>, context: ValidationContext): void;

package/dist/inventory/writePolicy.js

@@ -0,0 +1,36 @@
+import { readBoolean } from "../utils/value.js";
+export function validateWritePolicyContradictions(hostName, globalVars, lineageGroups, hostVars, inventory, groupDepths, context) {
+    const falseDepths = [];
+    const globalWrite = readBoolean(globalVars.mcp_write_allowed);
+    if (globalWrite === false) {
+        falseDepths.push(0);
+    }
+    for (const groupName of lineageGroups) {
+        const groupWrite = readBoolean(inventory.groups.get(groupName)?.vars.mcp_write_allowed);
+        if (groupWrite === false) {
+            falseDepths.push(groupDepths.get(groupName) ?? 1);
+        }
+    }
+    if (falseDepths.length === 0) {
+        return;
+    }
+    if (readBoolean(hostVars.mcp_write_allowed) === true) {
+        context.errors.push({
+            code: "inventory_write_policy_contradiction",
+            message: `Host ${hostName} sets mcp_write_allowed=true beneath an inherited false`,
+            path: hostName
+        });
+    }
+    for (const groupName of lineageGroups) {
+        const groupWrite = readBoolean(inventory.groups.get(groupName)?.vars.mcp_write_allowed);
+        const depth = groupDepths.get(groupName) ?? 1;
+        if (groupWrite === true && falseDepths.some((falseDepth) => falseDepth < depth)) {
+            context.errors.push({
+                code: "inventory_write_policy_contradiction",
+                message: `Host ${hostName} inherits mcp_write_allowed=true in group ${groupName} beneath an inherited false`,
+                path: hostName
+            });
+        }
+    }
+}
+//# sourceMappingURL=writePolicy.js.map

package/dist/inventory/writePolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writePolicy.js","sourceRoot":"","sources":["../../src/inventory/writePolicy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,iCAAiC,CAC/C,QAAgB,EAChB,UAAyB,EACzB,aAA0B,EAC1B,QAAuB,EACvB,SAA8B,EAC9B,WAAgC,EAChC,OAA0B;IAE1B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC9D,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QAC1B,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACxF,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,IAAI,WAAW,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,IAAI,EAAE,CAAC;QACrD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YAClB,IAAI,EAAE,sCAAsC;YAC5C,OAAO,EAAE,QAAQ,QAAQ,yDAAyD;YAClF,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,UAAU,KAAK,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC;YAChF,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,sCAAsC;gBAC5C,OAAO,EAAE,QAAQ,QAAQ,6CAA6C,SAAS,6BAA6B;gBAC5G,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/logging/loggingQuery.d.ts

@@ -0,0 +1,15 @@
+export declare const LOGGING_SEVERITIES: readonly ["emergencies", "alerts", "critical", "errors", "warnings", "notifications", "informational", "debugging"];
+export type LoggingSeverity = (typeof LOGGING_SEVERITIES)[number];
+export interface BuildLoggingQueryOptions {
+    minimumSeverity?: string;
+    messageCount?: number;
+}
+export interface BuildLoggingQueryLimits {
+    maxMessageCount: number;
+}
+export interface LoggingQuery {
+    minimumSeverity: LoggingSeverity;
+    messageCount: number;
+    command: string;
+}
+export declare function buildLoggingQuery(options: BuildLoggingQueryOptions, limits: BuildLoggingQueryLimits): LoggingQuery;

package/dist/logging/loggingQuery.js

@@ -0,0 +1,38 @@
+import { AppError } from "../core/errors.js";
+export const LOGGING_SEVERITIES = [
+    "emergencies",
+    "alerts",
+    "critical",
+    "errors",
+    "warnings",
+    "notifications",
+    "informational",
+    "debugging"
+];
+const DEFAULT_LOGGING_MESSAGE_COUNT = 100;
+const EOS_MAX_LOGGING_MESSAGE_COUNT = 9999;
+export function buildLoggingQuery(options, limits) {
+    const minimumSeverity = normalizeLoggingSeverity(options.minimumSeverity ?? "warnings");
+    const messageCount = normalizeMessageCount(limits.maxMessageCount, options.messageCount ?? DEFAULT_LOGGING_MESSAGE_COUNT);
+    return {
+        minimumSeverity,
+        messageCount,
+        command: `show logging threshold ${minimumSeverity} ${messageCount}`
+    };
+}
+function normalizeLoggingSeverity(severity) {
+    if (LOGGING_SEVERITIES.includes(severity)) {
+        return severity;
+    }
+    throw new AppError("logging_severity_invalid", `Unsupported logging severity: ${severity}`);
+}
+function normalizeMessageCount(maxMessageCount, messageCount) {
+    if (!Number.isInteger(messageCount) || messageCount < 1 || messageCount > EOS_MAX_LOGGING_MESSAGE_COUNT) {
+        throw new AppError("logging_message_count_invalid", `Logging message_count must be an integer from 1 to ${EOS_MAX_LOGGING_MESSAGE_COUNT}`);
+    }
+    if (messageCount > maxMessageCount) {
+        throw new AppError("logging_message_count_limit_exceeded", `Logging message_count ${messageCount} exceeds configured maxLoggingMessagesPerRequest ${maxMessageCount}`);
+    }
+    return messageCount;
+}
+//# sourceMappingURL=loggingQuery.js.map

package/dist/logging/loggingQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggingQuery.js","sourceRoot":"","sources":["../../src/logging/loggingQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa;IACb,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,UAAU;IACV,eAAe;IACf,eAAe;IACf,WAAW;CACH,CAAC;AAIX,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAC1C,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAiB3C,MAAM,UAAU,iBAAiB,CAAC,OAAiC,EAAE,MAA+B;IAClG,MAAM,eAAe,GAAG,wBAAwB,CAAC,OAAO,CAAC,eAAe,IAAI,UAAU,CAAC,CAAC;IACxF,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,YAAY,IAAI,6BAA6B,CAAC,CAAC;IAE1H,OAAO;QACL,eAAe;QACf,YAAY;QACZ,OAAO,EAAE,0BAA0B,eAAe,IAAI,YAAY,EAAE;KACrE,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAgB;IAChD,IAAK,kBAAwC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjE,OAAO,QAA2B,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,QAAQ,CAAC,0BAA0B,EAAE,iCAAiC,QAAQ,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,qBAAqB,CAAC,eAAuB,EAAE,YAAoB;IAC1E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,6BAA6B,EAAE,CAAC;QACxG,MAAM,IAAI,QAAQ,CAChB,+BAA+B,EAC/B,sDAAsD,6BAA6B,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,GAAG,eAAe,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAChB,sCAAsC,EACtC,yBAAyB,YAAY,oDAAoD,eAAe,EAAE,CAC3G,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/logging/showLogging.d.ts

@@ -0,0 +1,28 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+import type { EosDeviceReader } from "../connection/eosDeviceReader.js";
+import type { InventoryModel } from "../inventory/types.js";
+import { type LoggingSeverity } from "./loggingQuery.js";
+import { type DeviceResultSummary } from "../operations/readExecution.js";
+export interface ShowLoggingOptions {
+    target: string;
+    minimumSeverity?: LoggingSeverity;
+    messageCount?: number;
+}
+export interface ShowLoggingResult {
+    target: string;
+    target_type: "host" | "group";
+    minimum_severity: LoggingSeverity;
+    message_count: number;
+    resolved_devices: string[];
+    summary: DeviceResultSummary;
+    results: Array<{
+        inventory_hostname: string;
+        resolved_endpoint: string;
+        status: "success" | "failed";
+        command?: string;
+        log_text?: string;
+        error_code?: string;
+        message?: string;
+    }>;
+}
+export declare function showLogging(model: InventoryModel, config: ResolvedServerConfig, options: ShowLoggingOptions, reader: EosDeviceReader): Promise<ShowLoggingResult>;

package/dist/logging/showLogging.js

@@ -0,0 +1,37 @@
+import { AppError } from "../core/errors.js";
+import { buildLoggingQuery } from "./loggingQuery.js";
+import { buildReadDeviceFailure, buildReadDeviceSuccess, buildReadOperationResultEnvelope, executeReadOperation } from "../operations/readExecution.js";
+export async function showLogging(model, config, options, reader) {
+    const query = buildLoggingQuery({
+        ...(options.minimumSeverity !== undefined ? { minimumSeverity: options.minimumSeverity } : {}),
+        ...(options.messageCount !== undefined ? { messageCount: options.messageCount } : {})
+    }, { maxMessageCount: config.maxLoggingMessagesPerRequest });
+    const operation = await executeReadOperation(model, config, {
+        target: options.target,
+        operationName: "eos_show_logging",
+        run: async (host, signal) => buildReadDeviceSuccess(host, {
+            command: query.command,
+            log_text: extractLogText(await reader.runShowCommands(host, [query.command], "text", { signal }))
+        }),
+        onError: (host, error) => buildReadDeviceFailure(host, "logging_failed", error)
+    });
+    return buildReadOperationResultEnvelope(options.target, operation, {
+        extra: {
+            minimum_severity: query.minimumSeverity,
+            message_count: query.messageCount
+        },
+        responseSizeLimit: {
+            config,
+            operationName: "eos_show_logging",
+            narrowingGuidance: "Reduce message_count, target fewer devices, or raise minimum_severity to return fewer log lines."
+        }
+    });
+}
+function extractLogText(commandResults) {
+    const first = commandResults[0]?.output;
+    if (typeof first === "string") {
+        return first;
+    }
+    throw new AppError("logging_payload_invalid", "Unexpected logging payload structure");
+}
+//# sourceMappingURL=showLogging.js.map

package/dist/logging/showLogging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showLogging.js","sourceRoot":"","sources":["../../src/logging/showLogging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK7C,OAAO,EAAE,iBAAiB,EAAwB,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,gCAAgC,EAChC,oBAAoB,EAErB,MAAM,gCAAgC,CAAC;AA0BxC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAqB,EACrB,MAA4B,EAC5B,OAA2B,EAC3B,MAAuB;IAEvB,MAAM,KAAK,GAAG,iBAAiB,CAC7B;QACE,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtF,EACD,EAAE,eAAe,EAAE,MAAM,CAAC,4BAA4B,EAAE,CACzD,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAuC,KAAK,EAAE,MAAM,EAAE;QAChG,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,kBAAkB;QACjC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAC1B,sBAAsB,CAAC,IAAI,EAAE;YAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,cAAc,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;SAClG,CAAC;QACJ,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC;KAChF,CAAC,CAAC;IAEH,OAAO,gCAAgC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE;QACjE,KAAK,EAAE;YACL,gBAAgB,EAAE,KAAK,CAAC,eAAe;YACvC,aAAa,EAAE,KAAK,CAAC,YAAY;SAClC;QACD,iBAAiB,EAAE;YACjB,MAAM;YACN,aAAa,EAAE,kBAAkB;YACjC,iBAAiB,EAAE,kGAAkG;SACtH;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,cAAkC;IACxD,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAExC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,QAAQ,CAAC,yBAAyB,EAAE,sCAAsC,CAAC,CAAC;AACxF,CAAC"}

package/dist/mcp/createServer.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+import type { InventoryModel } from "../inventory/types.js";
+export declare function startMcpServer(config: ResolvedServerConfig, inventoryModel: InventoryModel): Promise<void>;

package/dist/mcp/createServer.js

@@ -0,0 +1,82 @@
+import { randomUUID } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { EapiDeviceReader } from "../connection/eosDeviceReader.js";
+import { APP_NAME, APP_VERSION } from "../core/version.js";
+import { EapiClient } from "../eapi/client.js";
+import { buildGetFactsToolResult, getFactsInputSchema } from "./tools/getFacts.js";
+import { buildGetRunningConfigToolResult, getRunningConfigInputSchema } from "./tools/getRunningConfig.js";
+import { buildGetServerInfoToolResult, getServerInfoInputSchema } from "./tools/getServerInfo.js";
+import { buildListInventoryToolResult, listInventoryInputSchema } from "./tools/listInventory.js";
+import { buildProbeDevicesToolResult, probeDevicesInputSchema } from "./tools/probeDevices.js";
+import { buildRunShowToolResult, runShowInputSchema } from "./tools/runShow.js";
+import { buildShowLoggingToolResult, showLoggingInputSchema } from "./tools/showLogging.js";
+function buildToolDefinitions(deps) {
+    return [
+        {
+            name: "eos_get_server_info",
+            description: "Return a sanitized summary of current server capabilities, limits, runtime mode, and inventory summary.",
+            inputSchema: getServerInfoInputSchema,
+            handler: async () => buildGetServerInfoToolResult(deps.runtimeContext)
+        },
+        {
+            name: "eos_list_inventory",
+            description: "Return a sanitized operational view of the loaded inventory. By default only EOS-eligible hosts are shown, while all groups remain visible with actionable status.",
+            inputSchema: listInventoryInputSchema,
+            handler: async (args) => buildListInventoryToolResult(deps.inventoryModel, args)
+        },
+        {
+            name: "eos_probe_devices",
+            description: "Probe EOS device readiness for a host or group target by validating connectivity, authentication, and harmless command execution.",
+            inputSchema: probeDevicesInputSchema,
+            handler: async (args) => buildProbeDevicesToolResult(deps.inventoryModel, deps.config, args, deps.deviceReader)
+        },
+        {
+            name: "eos_run_show",
+            description: "Run one or more EOS show commands against a host or group target. Supports auto/json/text output modes with strict show-only validation.",
+            inputSchema: runShowInputSchema,
+            handler: async (args) => buildRunShowToolResult(deps.inventoryModel, deps.config, args, deps.deviceReader)
+        },
+        {
+            name: "eos_show_logging",
+            description: "Retrieve bounded EOS logging output for a host or group target using a minimum severity threshold and message-count limit.",
+            inputSchema: showLoggingInputSchema,
+            handler: async (args) => buildShowLoggingToolResult(deps.inventoryModel, deps.config, args, deps.deviceReader)
+        },
+        {
+            name: "eos_get_facts",
+            description: "Collect a fixed core set of EOS device facts for a host or group target.",
+            inputSchema: getFactsInputSchema,
+            handler: async (args) => buildGetFactsToolResult(deps.inventoryModel, deps.config, args, deps.deviceReader)
+        },
+        {
+            name: "eos_get_running_config",
+            description: "Retrieve running configuration text for a host target, or for a group target when a raw EOS section selector is provided.",
+            inputSchema: getRunningConfigInputSchema,
+            handler: async (args) => buildGetRunningConfigToolResult(deps.inventoryModel, deps.config, args, deps.deviceReader)
+        }
+    ];
+}
+export async function startMcpServer(config, inventoryModel) {
+    const runtimeContext = {
+        instanceId: randomUUID(),
+        startedAt: new Date().toISOString(),
+        config,
+        inventorySummary: inventoryModel.summary
+    };
+    const deviceReader = new EapiDeviceReader(config, new EapiClient());
+    const server = new McpServer({
+        name: APP_NAME,
+        version: APP_VERSION
+    });
+    const registerTool = server.registerTool.bind(server);
+    for (const tool of buildToolDefinitions({ runtimeContext, inventoryModel, config, deviceReader })) {
+        registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema
+        }, tool.handler);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=createServer.js.map

package/dist/mcp/createServer.js.map

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

package/dist/mcp/toolResult.d.ts

@@ -0,0 +1,7 @@
+export declare function buildJsonToolResult<TPayload>(payload: TPayload): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+};

package/dist/mcp/toolResult.js

@@ -0,0 +1,13 @@
+import { prettyJson } from "../utils/json.js";
+export function buildJsonToolResult(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: prettyJson(payload)
+            }
+        ],
+        structuredContent: payload
+    };
+}
+//# sourceMappingURL=toolResult.js.map

package/dist/mcp/toolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolResult.js","sourceRoot":"","sources":["../../src/mcp/toolResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,mBAAmB,CAAW,OAAiB;IAC7D,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC;aAC1B;SACF;QACD,iBAAiB,EAAE,OAA6C;KACjE,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/getFacts.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import type { ResolvedServerConfig } from "../../config/schema.js";
+import type { EosDeviceReader } from "../../connection/eosDeviceReader.js";
+import type { InventoryModel } from "../../inventory/types.js";
+export declare const getFactsInputSchema: z.ZodObject<{
+    target: z.ZodString;
+    include_raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
+    target: string;
+    include_raw: boolean;
+}, {
+    target: string;
+    include_raw?: boolean | undefined;
+}>;
+export declare function buildGetFactsToolResult(inventoryModel: InventoryModel, config: ResolvedServerConfig, args: z.infer<typeof getFactsInputSchema>, reader: EosDeviceReader): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/mcp/tools/getFacts.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { getFacts } from "../../facts/getFacts.js";
+import { buildJsonToolResult } from "../toolResult.js";
+export const getFactsInputSchema = z
+    .object({
+    target: z.string().min(1),
+    include_raw: z.boolean().optional().default(false)
+})
+    .strict();
+export async function buildGetFactsToolResult(inventoryModel, config, args, reader) {
+    const payload = await getFacts(inventoryModel, config, {
+        target: args.target,
+        include_raw: args.include_raw ?? false
+    }, reader);
+    return buildJsonToolResult(payload);
+}
+//# sourceMappingURL=getFacts.js.map

package/dist/mcp/tools/getFacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFacts.js","sourceRoot":"","sources":["../../../src/mcp/tools/getFacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,cAA8B,EAC9B,MAA4B,EAC5B,IAAyC,EACzC,MAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAC5B,cAAc,EACd,MAAM,EACN;QACE,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,KAAK;KACvC,EACD,MAAM,CACP,CAAC;IAEF,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/mcp/tools/getRunningConfig.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import type { ResolvedServerConfig } from "../../config/schema.js";
+import type { EosDeviceReader } from "../../connection/eosDeviceReader.js";
+import type { InventoryModel } from "../../inventory/types.js";
+export declare const getRunningConfigInputSchema: z.ZodObject<{
+    target: z.ZodString;
+    section: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    target: string;
+    section?: string | undefined;
+}, {
+    target: string;
+    section?: string | undefined;
+}>;
+export declare function buildGetRunningConfigToolResult(inventoryModel: InventoryModel, config: ResolvedServerConfig, args: z.infer<typeof getRunningConfigInputSchema>, reader: EosDeviceReader): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;