@aristanetworks/eos-mcp-server 0.6.1-beta

package/dist/mcp/tools/getRunningConfig.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { getRunningConfig } from "../../configuration/getRunningConfig.js";
+import { buildJsonToolResult } from "../toolResult.js";
+export const getRunningConfigInputSchema = z
+    .object({
+    target: z.string().min(1),
+    section: z.string().min(1).optional()
+})
+    .strict();
+export async function buildGetRunningConfigToolResult(inventoryModel, config, args, reader) {
+    const payload = await getRunningConfig(inventoryModel, config, {
+        target: args.target,
+        ...(args.section !== undefined ? { section: args.section } : {})
+    }, reader);
+    return buildJsonToolResult(payload);
+}
+//# sourceMappingURL=getRunningConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRunningConfig.js","sourceRoot":"","sources":["../../../src/mcp/tools/getRunningConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,cAA8B,EAC9B,MAA4B,EAC5B,IAAiD,EACjD,MAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CACpC,cAAc,EACd,MAAM,EACN;QACE,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,EACD,MAAM,CACP,CAAC;IAEF,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { ServerRuntimeContext } from "../../serverInfo/types.js";
+export declare const getServerInfoInputSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare function buildGetServerInfoToolResult(runtimeContext: ServerRuntimeContext): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+};

package/dist/mcp/tools/getServerInfo.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { buildServerInfo } from "../../serverInfo/buildServerInfo.js";
+import { buildJsonToolResult } from "../toolResult.js";
+export const getServerInfoInputSchema = z.object({}).strict();
+export function buildGetServerInfoToolResult(runtimeContext) {
+    const info = buildServerInfo(runtimeContext);
+    return buildJsonToolResult(info);
+}
+//# sourceMappingURL=getServerInfo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getServerInfo.js","sourceRoot":"","sources":["../../../src/mcp/tools/getServerInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE9D,MAAM,UAAU,4BAA4B,CAAC,cAAoC;IAC/E,MAAM,IAAI,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IAE7C,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { InventoryModel } from "../../inventory/types.js";
+export declare const listInventoryInputSchema: z.ZodObject<{
+    include_ineligible: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
+    include_ineligible: boolean;
+}, {
+    include_ineligible?: boolean | undefined;
+}>;
+export declare function buildListInventoryToolResult(inventoryModel: InventoryModel, args: z.infer<typeof listInventoryInputSchema>): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+};

package/dist/mcp/tools/listInventory.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { buildListInventoryView } from "../../inventory/listInventoryView.js";
+import { buildJsonToolResult } from "../toolResult.js";
+export const listInventoryInputSchema = z
+    .object({
+    include_ineligible: z.boolean().optional().default(false)
+})
+    .strict();
+export function buildListInventoryToolResult(inventoryModel, args) {
+    const payload = buildListInventoryView(inventoryModel, {
+        includeIneligible: args.include_ineligible ?? false
+    });
+    return buildJsonToolResult(payload);
+}
+//# sourceMappingURL=listInventory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listInventory.js","sourceRoot":"","sources":["../../../src/mcp/tools/listInventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC1D,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,4BAA4B,CAC1C,cAA8B,EAC9B,IAA8C;IAE9C,MAAM,OAAO,GAAG,sBAAsB,CAAC,cAAc,EAAE;QACrD,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,IAAI,KAAK;KACpD,CAAC,CAAC;IAEH,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/mcp/tools/probeDevices.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 probeDevicesInputSchema: 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 buildProbeDevicesToolResult(inventoryModel: InventoryModel, config: ResolvedServerConfig, args: z.infer<typeof probeDevicesInputSchema>, reader: EosDeviceReader): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/mcp/tools/probeDevices.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"probeDevices.js","sourceRoot":"","sources":["../../../src/mcp/tools/probeDevices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,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,2BAA2B,CAC/C,cAA8B,EAC9B,MAA4B,EAC5B,IAA6C,EAC7C,MAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,cAAc,EACd,MAAM,EACN,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,KAAK,EAAE,EAC/D,MAAM,CACP,CAAC;IAEF,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,30 @@
+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 runShowInputSchema: z.ZodObject<{
+    target: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    output_format: z.ZodDefault<z.ZodEnum<["auto", "json", "text"]>>;
+    include_raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
+    target: string;
+    include_raw: boolean;
+    output_format: "json" | "text" | "auto";
+    command?: string | undefined;
+    commands?: string[] | undefined;
+}, {
+    target: string;
+    include_raw?: boolean | undefined;
+    command?: string | undefined;
+    commands?: string[] | undefined;
+    output_format?: "json" | "text" | "auto" | undefined;
+}>;
+export declare function buildRunShowToolResult(inventoryModel: InventoryModel, config: ResolvedServerConfig, args: z.infer<typeof runShowInputSchema>, reader: EosDeviceReader): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/mcp/tools/runShow.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { AppError } from "../../core/errors.js";
+import { runShow } from "../../show/runShow.js";
+import { buildJsonToolResult } from "../toolResult.js";
+// NOTE: this schema intentionally ends at `.strict()` and validates the
+// `command` XOR `commands` requirement in the handler below. Wrapping the
+// ZodObject with `.superRefine()` (or `.refine()`) turns it into a ZodEffects
+// instance, which hides `.shape` from the MCP SDK's `normalizeObjectSchema`
+// and causes the tool to be advertised with an empty input schema.
+export const runShowInputSchema = z
+    .object({
+    target: z.string().min(1),
+    command: z.string().min(1).optional(),
+    commands: z.array(z.string().min(1)).optional(),
+    output_format: z.enum(["auto", "json", "text"]).default("auto"),
+    include_raw: z.boolean().optional().default(false)
+})
+    .strict();
+export async function buildRunShowToolResult(inventoryModel, config, args, reader) {
+    const hasCommand = args.command !== undefined;
+    const hasCommands = args.commands !== undefined;
+    if (hasCommand === hasCommands) {
+        throw new AppError("show_commands_input_invalid", "Exactly one of command or commands must be provided");
+    }
+    const commands = args.commands ?? (args.command ? [args.command] : []);
+    const payload = await runShow(inventoryModel, config, {
+        target: args.target,
+        commands,
+        outputFormat: args.output_format,
+        includeRaw: args.include_raw ?? false
+    }, reader);
+    return buildJsonToolResult(payload);
+}
+//# sourceMappingURL=runShow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runShow.js","sourceRoot":"","sources":["../../../src/mcp/tools/runShow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wEAAwE;AACxE,0EAA0E;AAC1E,8EAA8E;AAC9E,4EAA4E;AAC5E,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/D,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,sBAAsB,CAC1C,cAA8B,EAC9B,MAA4B,EAC5B,IAAwC,EACxC,MAAuB;IAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;IAChD,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAChB,6BAA6B,EAC7B,qDAAqD,CACtD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,cAAc,EACd,MAAM,EACN;QACE,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,UAAU,EAAE,IAAI,CAAC,WAAW,IAAI,KAAK;KACtC,EACD,MAAM,CACP,CAAC;IAEF,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,24 @@
+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 showLoggingInputSchema: z.ZodObject<{
+    target: z.ZodString;
+    minimum_severity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["emergencies", "alerts", "critical", "errors", "warnings", "notifications", "informational", "debugging"]>>>;
+    message_count: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strict", z.ZodTypeAny, {
+    target: string;
+    minimum_severity: "errors" | "emergencies" | "alerts" | "critical" | "warnings" | "notifications" | "informational" | "debugging";
+    message_count: number;
+}, {
+    target: string;
+    minimum_severity?: "errors" | "emergencies" | "alerts" | "critical" | "warnings" | "notifications" | "informational" | "debugging" | undefined;
+    message_count?: number | undefined;
+}>;
+export declare function buildShowLoggingToolResult(inventoryModel: InventoryModel, config: ResolvedServerConfig, args: z.infer<typeof showLoggingInputSchema>, reader: EosDeviceReader): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/mcp/tools/showLogging.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { LOGGING_SEVERITIES } from "../../logging/loggingQuery.js";
+import { showLogging } from "../../logging/showLogging.js";
+import { buildJsonToolResult } from "../toolResult.js";
+export const showLoggingInputSchema = z
+    .object({
+    target: z.string().min(1),
+    minimum_severity: z.enum(LOGGING_SEVERITIES).optional().default("warnings"),
+    message_count: z.number().int().min(1).max(9999).optional().default(100)
+})
+    .strict();
+export async function buildShowLoggingToolResult(inventoryModel, config, args, reader) {
+    const payload = await showLogging(inventoryModel, config, {
+        target: args.target,
+        minimumSeverity: args.minimum_severity,
+        messageCount: args.message_count
+    }, reader);
+    return buildJsonToolResult(payload);
+}
+//# sourceMappingURL=showLogging.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"showLogging.js","sourceRoot":"","sources":["../../../src/mcp/tools/showLogging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CACzE,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,cAA8B,EAC9B,MAA4B,EAC5B,IAA4C,EAC5C,MAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,cAAc,EACd,MAAM,EACN;QACE,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,eAAe,EAAE,IAAI,CAAC,gBAAgB;QACtC,YAAY,EAAE,IAAI,CAAC,aAAa;KACjC,EACD,MAAM,CACP,CAAC;IAEF,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/operations/readExecution.d.ts

@@ -0,0 +1,57 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+import { type ResolvedInventoryTarget } from "../inventory/resolveTarget.js";
+import type { InventoryHostModel, InventoryModel } from "../inventory/types.js";
+export interface ReadDeviceResultBase {
+    inventory_hostname: string;
+    resolved_endpoint: string;
+    status: "success" | "failed";
+    error_code?: string;
+    message?: string;
+}
+export interface DeviceResultSummary {
+    total_count: number;
+    success_count: number;
+    failed_count: number;
+}
+export interface ExecuteReadOperationResult<TDeviceResult extends ReadDeviceResultBase> {
+    resolvedTarget: ResolvedInventoryTarget;
+    results: TDeviceResult[];
+    summary: DeviceResultSummary;
+}
+export interface ReadOperationResultEnvelope<TDeviceResult extends ReadDeviceResultBase> {
+    target: string;
+    target_type: "host" | "group";
+    resolved_devices: string[];
+    summary: DeviceResultSummary;
+    results: TDeviceResult[];
+}
+interface ResponseSizeLimitOptions {
+    config: ResolvedServerConfig;
+    operationName: string;
+    narrowingGuidance?: string;
+}
+interface ReadOperationResultEnvelopeOptions<TExtra extends Record<string, unknown>> {
+    extra?: TExtra;
+    responseSizeLimit?: ResponseSizeLimitOptions;
+}
+export declare function executeReadOperation<TDeviceResult extends ReadDeviceResultBase>(model: InventoryModel, config: ResolvedServerConfig, options: {
+    target: string;
+    operationName: string;
+    validateTarget?: (resolvedTarget: ResolvedInventoryTarget) => void;
+    run: (host: InventoryHostModel, signal: AbortSignal) => Promise<TDeviceResult>;
+    onError: (host: InventoryHostModel, error: unknown) => TDeviceResult;
+}): Promise<ExecuteReadOperationResult<TDeviceResult>>;
+export declare function buildReadOperationResultEnvelope<TDeviceResult extends ReadDeviceResultBase>(target: string, operation: ExecuteReadOperationResult<TDeviceResult>): ReadOperationResultEnvelope<TDeviceResult>;
+export declare function buildReadOperationResultEnvelope<TDeviceResult extends ReadDeviceResultBase, TExtra extends Record<string, unknown>>(target: string, operation: ExecuteReadOperationResult<TDeviceResult>, options: ReadOperationResultEnvelopeOptions<TExtra>): ReadOperationResultEnvelope<TDeviceResult> & TExtra;
+export declare function buildReadDeviceSuccess<TExtra extends Record<string, unknown>>(host: InventoryHostModel, extra: TExtra): ReadDeviceResultBase & {
+    status: "success";
+} & TExtra;
+export declare function buildReadDeviceFailure(host: InventoryHostModel, errorCode: string, error: unknown): ReadDeviceResultBase & {
+    status: "failed";
+};
+export declare function enforceReadTargetLimit(config: ResolvedServerConfig, targetCount: number): void;
+export declare function enforceShowCommandLimit(config: ResolvedServerConfig, commandCount: number): void;
+export declare function mapWithConcurrency<T, R>(items: T[], concurrencyLimit: number, worker: (item: T) => Promise<R>, signal?: AbortSignal): Promise<R[]>;
+export declare function runWithOperationTimeout<T>(config: ResolvedServerConfig, operationName: string, run: (signal: AbortSignal) => Promise<T>): Promise<T>;
+export declare function enforceResponseSizeLimit(config: ResolvedServerConfig, payload: unknown, operationName: string, narrowingGuidance?: string): void;
+export {};

package/dist/operations/readExecution.js

@@ -0,0 +1,132 @@
+import { AppError, toErrorCode, toErrorMessage } from "../core/errors.js";
+import { resolveInventoryTarget } from "../inventory/resolveTarget.js";
+export async function executeReadOperation(model, config, options) {
+    const resolvedTarget = resolveInventoryTarget(model, { target: options.target });
+    enforceReadTargetLimit(config, resolvedTarget.resolvedHosts.length);
+    options.validateTarget?.(resolvedTarget);
+    const results = await runWithOperationTimeout(config, options.operationName, (signal) => mapWithConcurrency(resolvedTarget.resolvedHosts, config.deviceConcurrency, async (host) => {
+        try {
+            return await options.run(host, signal);
+        }
+        catch (error) {
+            return options.onError(host, error);
+        }
+    }, signal));
+    return {
+        resolvedTarget,
+        results,
+        summary: buildDeviceResultSummary(results)
+    };
+}
+export function buildReadOperationResultEnvelope(target, operation, options) {
+    const payload = {
+        target,
+        target_type: operation.resolvedTarget.targetType,
+        resolved_devices: operation.resolvedTarget.resolvedHosts.map((host) => host.inventoryHostname),
+        summary: operation.summary,
+        results: operation.results,
+        ...(options?.extra ?? {})
+    };
+    const responseSizeLimit = options?.responseSizeLimit;
+    if (responseSizeLimit !== undefined) {
+        enforceResponseSizeLimit(responseSizeLimit.config, payload, responseSizeLimit.operationName, responseSizeLimit.narrowingGuidance);
+    }
+    return payload;
+}
+export function buildReadDeviceSuccess(host, extra) {
+    return {
+        inventory_hostname: host.inventoryHostname,
+        resolved_endpoint: host.resolvedEndpoint,
+        status: "success",
+        ...extra
+    };
+}
+export function buildReadDeviceFailure(host, errorCode, error) {
+    return {
+        inventory_hostname: host.inventoryHostname,
+        resolved_endpoint: host.resolvedEndpoint,
+        status: "failed",
+        error_code: toErrorCode(error, errorCode),
+        message: toErrorMessage(error)
+    };
+}
+export function enforceReadTargetLimit(config, targetCount) {
+    if (targetCount > config.maxReadTargets) {
+        throw new AppError("read_target_limit_exceeded", `Read target count ${targetCount} exceeds configured maxReadTargets ${config.maxReadTargets}`);
+    }
+}
+export function enforceShowCommandLimit(config, commandCount) {
+    if (commandCount > config.maxShowCommandsPerRequest) {
+        throw new AppError("show_command_limit_exceeded", `Show command count ${commandCount} exceeds configured maxShowCommandsPerRequest ${config.maxShowCommandsPerRequest}`);
+    }
+}
+export async function mapWithConcurrency(items, concurrencyLimit, worker, signal) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function runWorker() {
+        while (nextIndex < items.length) {
+            throwIfAborted(signal);
+            const currentIndex = nextIndex;
+            nextIndex += 1;
+            const item = items[currentIndex];
+            if (item === undefined) {
+                continue;
+            }
+            results[currentIndex] = await worker(item);
+        }
+    }
+    const workerCount = Math.min(Math.max(concurrencyLimit, 1), items.length);
+    await Promise.all(Array.from({ length: workerCount }, () => runWorker()));
+    return results;
+}
+export async function runWithOperationTimeout(config, operationName, run) {
+    const controller = new AbortController();
+    const operation = run(controller.signal);
+    if (config.overallOperationTimeoutMs === undefined) {
+        return operation;
+    }
+    let timeout;
+    try {
+        return await Promise.race([
+            operation,
+            new Promise((_resolve, reject) => {
+                timeout = setTimeout(() => {
+                    const error = new AppError("operation_timeout", `${operationName} exceeded overallOperationTimeoutMs ${config.overallOperationTimeoutMs}`);
+                    reject(error);
+                    controller.abort(error);
+                }, config.overallOperationTimeoutMs);
+            })
+        ]);
+    }
+    finally {
+        if (timeout !== undefined) {
+            clearTimeout(timeout);
+        }
+    }
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted === true) {
+        throw new AppError("operation_timeout", "Operation was aborted");
+    }
+}
+export function enforceResponseSizeLimit(config, payload, operationName, narrowingGuidance) {
+    const serialized = JSON.stringify(payload);
+    const sizeBytes = Buffer.byteLength(serialized, "utf8");
+    if (sizeBytes > config.maxResponseSizeBytes) {
+        const defaultGuidance = "Reduce the number of target devices or narrow the request scope.";
+        throw new AppError("response_size_exceeded", `${operationName} response size ${sizeBytes} bytes exceeds configured maxResponseSizeBytes ${config.maxResponseSizeBytes}`, {
+            responseSizeBytes: sizeBytes,
+            maxResponseSizeBytes: config.maxResponseSizeBytes,
+            ...(Array.isArray(payload) ? { deviceCount: payload.length } : {}),
+            guidance: narrowingGuidance ?? defaultGuidance
+        });
+    }
+}
+function buildDeviceResultSummary(results) {
+    return {
+        total_count: results.length,
+        success_count: results.filter((result) => result.status === "success").length,
+        failed_count: results.filter((result) => result.status === "failed").length
+    };
+}
+//# sourceMappingURL=readExecution.js.map

package/dist/operations/readExecution.js.map

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

package/dist/probe/probeDevices.d.ts

@@ -0,0 +1,24 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+import type { EosCommandResult } from "../eapi/types.js";
+import type { EosDeviceReader } from "../connection/eosDeviceReader.js";
+import type { InventoryModel } from "../inventory/types.js";
+import { type DeviceResultSummary } from "../operations/readExecution.js";
+export interface ProbeDevicesOptions {
+    target: string;
+    include_raw: boolean;
+}
+export interface ProbeDevicesResult {
+    target: string;
+    target_type: "host" | "group";
+    resolved_devices: string[];
+    summary: DeviceResultSummary;
+    results: Array<{
+        inventory_hostname: string;
+        resolved_endpoint: string;
+        status: "success" | "failed";
+        error_code?: string;
+        message?: string;
+        command_results?: EosCommandResult[];
+    }>;
+}
+export declare function probeDevices(model: InventoryModel, config: ResolvedServerConfig, options: ProbeDevicesOptions, reader: EosDeviceReader): Promise<ProbeDevicesResult>;

package/dist/probe/probeDevices.js

@@ -0,0 +1,24 @@
+import { buildReadDeviceFailure, buildReadDeviceSuccess, buildReadOperationResultEnvelope, executeReadOperation } from "../operations/readExecution.js";
+export async function probeDevices(model, config, options, reader) {
+    const operation = await executeReadOperation(model, config, {
+        target: options.target,
+        operationName: "eos_probe_devices",
+        run: async (host, signal) => {
+            const commandResults = await reader.runShowCommands(host, ["show version"], "json", {
+                signal,
+                includeRawEntries: options.include_raw
+            });
+            return buildReadDeviceSuccess(host, {
+                ...(options.include_raw ? { command_results: commandResults } : {})
+            });
+        },
+        onError: (host, error) => buildReadDeviceFailure(host, "probe_failed", error)
+    });
+    return buildReadOperationResultEnvelope(options.target, operation, {
+        responseSizeLimit: {
+            config,
+            operationName: "eos_probe_devices"
+        }
+    });
+}
+//# sourceMappingURL=probeDevices.js.map

package/dist/probe/probeDevices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probeDevices.js","sourceRoot":"","sources":["../../src/probe/probeDevices.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,gCAAgC,EAChC,oBAAoB,EAErB,MAAM,gCAAgC,CAAC;AAsBxC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAqB,EACrB,MAA4B,EAC5B,OAA4B,EAC5B,MAAuB;IAEvB,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAwC,KAAK,EAAE,MAAM,EAAE;QACjG,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,mBAAmB;QAClC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC1B,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE;gBAClF,MAAM;gBACN,iBAAiB,EAAE,OAAO,CAAC,WAAW;aACvC,CAAC,CAAC;YACH,OAAO,sBAAsB,CAAC,IAAI,EAAE;gBAClC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC;KAC9E,CAAC,CAAC;IAEH,OAAO,gCAAgC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE;QACjE,iBAAiB,EAAE;YACjB,MAAM;YACN,aAAa,EAAE,mBAAmB;SACnC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/serverInfo/buildServerInfo.d.ts

@@ -0,0 +1,2 @@
+import type { ServerInfo, ServerRuntimeContext } from "./types.js";
+export declare function buildServerInfo(context: ServerRuntimeContext): ServerInfo;

package/dist/serverInfo/buildServerInfo.js

@@ -0,0 +1,49 @@
+import path from "node:path";
+import { APP_NAME, APP_VERSION } from "../core/version.js";
+export function buildServerInfo(context) {
+    const summary = context.inventorySummary;
+    return {
+        server_name: APP_NAME,
+        server_version: APP_VERSION,
+        instance_id: context.instanceId,
+        started_at: context.startedAt,
+        runtime_mode: "read-only",
+        inventory: {
+            basename: summary?.basename ?? sanitizeBasename(context.config.inventoryPath),
+            schema_kind: summary?.schemaKind ?? null,
+            total_hosts: summary?.totalHostCount ?? null,
+            total_groups: summary?.totalGroupCount ?? null,
+            eos_eligible_hosts: summary?.eosEligibleHostCount ?? null,
+            read_allowed_hosts: summary?.readAllowedHostCount ?? null
+        },
+        capabilities: {
+            tool_prefix: "eos_",
+            supported_inventory_schemas: ["canonical-ansible-yaml", "simplified-yaml"],
+            output_modes: ["auto", "json", "text"],
+            eapi_version: context.config.eapiVersion
+        },
+        limits: {
+            read_timeout_ms: context.config.readTimeoutMs,
+            overall_operation_timeout_ms: context.config.overallOperationTimeoutMs ?? null,
+            device_concurrency: context.config.deviceConcurrency,
+            max_read_targets: context.config.maxReadTargets,
+            max_show_commands_per_request: context.config.maxShowCommandsPerRequest,
+            max_logging_messages_per_request: context.config.maxLoggingMessagesPerRequest,
+            max_response_size_bytes: context.config.maxResponseSizeBytes
+        },
+        logging: {
+            actor: context.config.actor ?? null,
+            log_file_configured: context.config.logFile !== undefined
+        },
+        tls: {
+            custom_ca_configured: context.config.caFile !== undefined
+        }
+    };
+}
+function sanitizeBasename(filePath) {
+    if (!filePath) {
+        return null;
+    }
+    return path.basename(filePath);
+}
+//# sourceMappingURL=buildServerInfo.js.map

package/dist/serverInfo/buildServerInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildServerInfo.js","sourceRoot":"","sources":["../../src/serverInfo/buildServerInfo.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,UAAU,eAAe,CAAC,OAA6B;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAEzC,OAAO;QACL,WAAW,EAAE,QAAQ;QACrB,cAAc,EAAE,WAAW;QAC3B,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,UAAU,EAAE,OAAO,CAAC,SAAS;QAC7B,YAAY,EAAE,WAAW;QACzB,SAAS,EAAE;YACT,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;YAC7E,WAAW,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;YACxC,WAAW,EAAE,OAAO,EAAE,cAAc,IAAI,IAAI;YAC5C,YAAY,EAAE,OAAO,EAAE,eAAe,IAAI,IAAI;YAC9C,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,IAAI,IAAI;YACzD,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,IAAI,IAAI;SAC1D;QACD,YAAY,EAAE;YACZ,WAAW,EAAE,MAAM;YACnB,2BAA2B,EAAE,CAAC,wBAAwB,EAAE,iBAAiB,CAAC;YAC1E,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YACtC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;SACzC;QACD,MAAM,EAAE;YACN,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa;YAC7C,4BAA4B,EAAE,OAAO,CAAC,MAAM,CAAC,yBAAyB,IAAI,IAAI;YAC9E,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB;YACpD,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc;YAC/C,6BAA6B,EAAE,OAAO,CAAC,MAAM,CAAC,yBAAyB;YACvE,gCAAgC,EAAE,OAAO,CAAC,MAAM,CAAC,4BAA4B;YAC7E,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB;SAC7D;QACD,OAAO,EAAE;YACP,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI;YACnC,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS;SAC1D;QACD,GAAG,EAAE;YACH,oBAAoB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS;SAC1D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA4B;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC"}

package/dist/serverInfo/types.d.ts

@@ -0,0 +1,46 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+import type { EapiVersion } from "../eapi/types.js";
+import type { InventorySummary } from "../inventory/types.js";
+export interface ServerRuntimeContext {
+    instanceId: string;
+    startedAt: string;
+    config: ResolvedServerConfig;
+    inventorySummary?: InventorySummary;
+}
+export interface ServerInfo {
+    server_name: string;
+    server_version: string;
+    instance_id: string;
+    started_at: string;
+    runtime_mode: "read-only";
+    inventory: {
+        basename: string | null;
+        schema_kind: string | null;
+        total_hosts: number | null;
+        total_groups: number | null;
+        eos_eligible_hosts: number | null;
+        read_allowed_hosts: number | null;
+    };
+    capabilities: {
+        tool_prefix: "eos_";
+        supported_inventory_schemas: string[];
+        output_modes: Array<"auto" | "json" | "text">;
+        eapi_version: EapiVersion;
+    };
+    limits: {
+        read_timeout_ms: number;
+        overall_operation_timeout_ms: number | null;
+        device_concurrency: number;
+        max_read_targets: number;
+        max_show_commands_per_request: number;
+        max_logging_messages_per_request: number;
+        max_response_size_bytes: number;
+    };
+    logging: {
+        actor: string | null;
+        log_file_configured: boolean;
+    };
+    tls: {
+        custom_ca_configured: boolean;
+    };
+}

package/dist/serverInfo/types.js

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

package/dist/serverInfo/types.js.map

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