@calltelemetry/cucm-mcp 0.1.8 → 0.2.3

package/dist/dime.js

@@ -3,308 +3,270 @@ import { extractBoundary, parseMultipartRelated } from "./multipart.js";
 import { formatCucmDateTime, guessTimezoneString } from "./time.js";
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-// Default to accepting self-signed/invalid certs (common on CUCM lab/dev).
-// Opt back into strict verification with CUCM_MCP_TLS_MODE=strict.
 const tlsMode = (process.env.CUCM_MCP_TLS_MODE || process.env.MCP_TLS_MODE || "").toLowerCase();
 const strictTls = tlsMode === "strict" || tlsMode === "verify";
-if (!strictTls)
-    process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+if (!strictTls) process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
 const parser = new XMLParser({
-    ignoreAttributes: false,
-    attributeNamePrefix: "@",
-    removeNSPrefix: true,
-    trimValues: true,
+  ignoreAttributes: false,
+  attributeNamePrefix: "@",
+  removeNSPrefix: true,
+  trimValues: true
 });
 function isXmlContentType(contentType) {
-    const ct = String(contentType || "").toLowerCase();
-    if (!ct)
-        return false;
-    return ct === "text/xml" || ct === "application/xml" || ct === "application/soap+xml" || ct.endsWith("+xml") || ct.includes("/xml");
+  const ct = String(contentType || "").toLowerCase();
+  if (!ct) return false;
+  return ct === "text/xml" || ct === "application/xml" || ct === "application/soap+xml" || ct.endsWith("+xml") || ct.includes("/xml");
 }
 function dimeXmlBytes(contentType, bytes) {
-    const boundary = extractBoundary(contentType);
-    if (!boundary)
-        return bytes;
-    const parts = parseMultipartRelated(bytes, boundary);
-    const xmlParts = parts.filter((p) => isXmlContentType(p.contentType));
-    if (xmlParts.length === 0) {
-        // Some CUCM versions have been observed returning multipart bodies where the XML part
-        // does not advertise a classic XML content-type. Fall back to sniffing the payload.
-        const sniffed = parts.find((p) => {
-            const head = p.body.subarray(0, 64).toString("utf8");
-            return head.includes("<?xml") || head.trimStart().startsWith("<");
-        });
-        if (sniffed)
-            return sniffed.body;
-        const partTypes = parts.map((p) => p.contentType).join(", ");
-        throw new Error(`DIME response missing text/xml part (boundary=${boundary}; parts=[${partTypes || "none"}])`);
-    }
-    return xmlParts[0].body;
+  const boundary = extractBoundary(contentType);
+  if (!boundary) return bytes;
+  const parts = parseMultipartRelated(bytes, boundary);
+  const xmlParts = parts.filter((p) => isXmlContentType(p.contentType));
+  if (xmlParts.length === 0) {
+    const sniffed = parts.find((p) => {
+      const head = p.body.subarray(0, 64).toString("utf8");
+      return head.includes("<?xml") || head.trimStart().startsWith("<");
+    });
+    if (sniffed) return sniffed.body;
+    const partTypes = parts.map((p) => p.contentType).join(", ");
+    throw new Error(`DIME response missing text/xml part (boundary=${boundary}; parts=[${partTypes || "none"}])`);
+  }
+  return xmlParts[0].body;
 }
-export function normalizeHost(hostOrUrl) {
-    const s = String(hostOrUrl || "").trim();
-    if (!s)
-        throw new Error("host is required");
-    if (s.includes("://")) {
-        const u = new URL(s);
-        return u.hostname;
-    }
-    return s.replace(/^https?:\/\//, "").replace(/\/+$/, "").split("/")[0];
+function normalizeHost(hostOrUrl) {
+  const s = String(hostOrUrl || "").trim();
+  if (!s) throw new Error("host is required");
+  if (s.includes("://")) {
+    const u = new URL(s);
+    return u.hostname;
+  }
+  return s.replace(/^https?:\/\//, "").replace(/\/+$/, "").split("/")[0];
 }
-export function resolveAuth(auth) {
-    const username = auth?.username || process.env.CUCM_DIME_USERNAME || process.env.CUCM_USERNAME;
-    const password = auth?.password || process.env.CUCM_DIME_PASSWORD || process.env.CUCM_PASSWORD;
-    if (!username || !password) {
-        throw new Error("Missing DIME credentials (provide auth or set CUCM_DIME_USERNAME/CUCM_DIME_PASSWORD)");
-    }
-    return { username, password };
+function resolveAuth(auth) {
+  const username = auth?.username || process.env.CUCM_DIME_USERNAME || process.env.CUCM_USERNAME;
+  const password = auth?.password || process.env.CUCM_DIME_PASSWORD || process.env.CUCM_PASSWORD;
+  if (!username || !password) {
+    throw new Error("Missing DIME credentials (provide auth or set CUCM_DIME_USERNAME/CUCM_DIME_PASSWORD)");
+  }
+  return { username, password };
 }
-export function resolveTarget(hostOrUrl, port) {
-    const host = normalizeHost(hostOrUrl);
-    const envPort = process.env.CUCM_DIME_PORT ? Number.parseInt(process.env.CUCM_DIME_PORT, 10) : undefined;
-    const resolvedPort = port ?? envPort ?? 8443;
-    return { host, port: resolvedPort };
+function resolveTarget(hostOrUrl, port) {
+  const host = normalizeHost(hostOrUrl);
+  const envPort = process.env.CUCM_DIME_PORT ? Number.parseInt(process.env.CUCM_DIME_PORT, 10) : void 0;
+  const resolvedPort = port ?? envPort ?? 8443;
+  return { host, port: resolvedPort };
 }
 function basicAuthHeader(username, password) {
-    return `Basic ${Buffer.from(`${username}:${password}`, "utf8").toString("base64")}`;
+  return `Basic ${Buffer.from(`${username}:${password}`, "utf8").toString("base64")}`;
 }
 function escapeXml(s) {
-    return s
-        .replaceAll("&", "&amp;")
-        .replaceAll("<", "&lt;")
-        .replaceAll(">", "&gt;")
-        .replaceAll('"', "&quot;")
-        .replaceAll("'", "&apos;");
+  return s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
 }
 function soapEnvelopeList() {
-    return ('<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://schemas.cisco.com/ast/soap">' +
-        "<soapenv:Header/>" +
-        "<soapenv:Body>" +
-        "<soap:listNodeServiceLogs>" +
-        "<soap:ListRequest></soap:ListRequest>" +
-        "</soap:listNodeServiceLogs>" +
-        "</soapenv:Body>" +
-        "</soapenv:Envelope>");
+  return '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://schemas.cisco.com/ast/soap"><soapenv:Header/><soapenv:Body><soap:listNodeServiceLogs><soap:ListRequest></soap:ListRequest></soap:listNodeServiceLogs></soapenv:Body></soapenv:Envelope>';
 }
 function soapItems(tag, values) {
-    const vals = (values || []).filter((v) => String(v || "").trim() !== "");
-    if (vals.length === 0)
-        return `<soap:${tag}><soap:item></soap:item></soap:${tag}>`;
-    return `<soap:${tag}>${vals.map((v) => `<soap:item>${escapeXml(v)}</soap:item>`).join("")}</soap:${tag}>`;
+  const vals = (values || []).filter((v) => String(v || "").trim() !== "");
+  if (vals.length === 0) return `<soap:${tag}><soap:item></soap:item></soap:${tag}>`;
+  return `<soap:${tag}>${vals.map((v) => `<soap:item>${escapeXml(v)}</soap:item>`).join("")}</soap:${tag}>`;
 }
 function soapEnvelopeSelect(criteria) {
-    const serviceLogs = soapItems("ServiceLogs", criteria.serviceLogs);
-    const systemLogs = soapItems("SystemLogs", criteria.systemLogs);
-    const searchStr = escapeXml(criteria.searchStr || "");
-    return ('<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://schemas.cisco.com/ast/soap">' +
-        "<soapenv:Header/>" +
-        "<soapenv:Body>" +
-        "<soap:selectLogFiles>" +
-        "<soap:FileSelectionCriteria>" +
-        serviceLogs +
-        systemLogs +
-        `<soap:SearchStr>${searchStr}</soap:SearchStr>` +
-        "<soap:Frequency>OnDemand</soap:Frequency>" +
-        "<soap:JobType>DownloadtoClient</soap:JobType>" +
-        `<soap:ToDate>${escapeXml(criteria.toDate)}</soap:ToDate>` +
-        `<soap:FromDate>${escapeXml(criteria.fromDate)}</soap:FromDate>` +
-        `<soap:TimeZone>${escapeXml(criteria.timezone)}</soap:TimeZone>` +
-        "<soap:RelText>None</soap:RelText>" +
-        "<soap:RelTime>0</soap:RelTime>" +
-        "<soap:Port></soap:Port>" +
-        "<soap:IPAddress></soap:IPAddress>" +
-        "<soap:UserName></soap:UserName>" +
-        "<soap:Password></soap:Password>" +
-        "<soap:ZipInfo></soap:ZipInfo>" +
-        "<soap:RemoteFolder></soap:RemoteFolder>" +
-        "</soap:FileSelectionCriteria>" +
-        "</soap:selectLogFiles>" +
-        "</soapenv:Body>" +
-        "</soapenv:Envelope>");
+  const serviceLogs = soapItems("ServiceLogs", criteria.serviceLogs);
+  const systemLogs = soapItems("SystemLogs", criteria.systemLogs);
+  const searchStr = escapeXml(criteria.searchStr || "");
+  return '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://schemas.cisco.com/ast/soap"><soapenv:Header/><soapenv:Body><soap:selectLogFiles><soap:FileSelectionCriteria>' + serviceLogs + systemLogs + `<soap:SearchStr>${searchStr}</soap:SearchStr><soap:Frequency>OnDemand</soap:Frequency><soap:JobType>DownloadtoClient</soap:JobType><soap:ToDate>${escapeXml(criteria.toDate)}</soap:ToDate><soap:FromDate>${escapeXml(criteria.fromDate)}</soap:FromDate><soap:TimeZone>${escapeXml(criteria.timezone)}</soap:TimeZone><soap:RelText>None</soap:RelText><soap:RelTime>0</soap:RelTime><soap:Port></soap:Port><soap:IPAddress></soap:IPAddress><soap:UserName></soap:UserName><soap:Password></soap:Password><soap:ZipInfo></soap:ZipInfo><soap:RemoteFolder></soap:RemoteFolder></soap:FileSelectionCriteria></soap:selectLogFiles></soapenv:Body></soapenv:Envelope>`;
 }
 function soapEnvelopeGetOneFile(fileName) {
-    return ('<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://schemas.cisco.com/ast/soap/">' +
-        "<soapenv:Header/>" +
-        "<soapenv:Body>" +
-        '<soap:GetOneFile soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">' +
-        `<FileName xsi:type="get:FileName" xmlns:get="http://cisco.com/ccm/serviceability/soap/LogCollection/GetFile/">${escapeXml(fileName)}</FileName>` +
-        "</soap:GetOneFile>" +
-        "</soapenv:Body>" +
-        "</soapenv:Envelope>");
+  return `<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://schemas.cisco.com/ast/soap/"><soapenv:Header/><soapenv:Body><soap:GetOneFile soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><FileName xsi:type="get:FileName" xmlns:get="http://cisco.com/ccm/serviceability/soap/LogCollection/GetFile/">${escapeXml(fileName)}</FileName></soap:GetOneFile></soapenv:Body></soapenv:Envelope>`;
 }
-async function fetchSoap(target, auth, path, soapAction, xmlBody, timeoutMs = 30000) {
-    const url = `https://${target.host}:${target.port}${path}`;
-    const res = await fetch(url, {
-        method: "POST",
-        headers: {
-            Authorization: basicAuthHeader(auth.username, auth.password),
-            SOAPAction: soapAction,
-            "Content-Type": "text/xml;charset=UTF-8",
-            Accept: "*/*",
-        },
-        body: Buffer.from(xmlBody, "utf8"),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        throw new Error(`CUCM DIME HTTP ${res.status}: ${text || res.statusText}`);
-    }
-    const contentType = res.headers.get("content-type");
-    const ab = await res.arrayBuffer();
-    return { contentType, bytes: Buffer.from(ab) };
+async function fetchSoap(target, auth, path, soapAction, xmlBody, timeoutMs = 3e4) {
+  const url = `https://${target.host}:${target.port}${path}`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: basicAuthHeader(auth.username, auth.password),
+      SOAPAction: soapAction,
+      "Content-Type": "text/xml;charset=UTF-8",
+      Accept: "*/*"
+    },
+    body: Buffer.from(xmlBody, "utf8"),
+    signal: AbortSignal.timeout(timeoutMs)
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`CUCM DIME HTTP ${res.status}: ${text || res.statusText}`);
+  }
+  const contentType = res.headers.get("content-type");
+  const ab = await res.arrayBuffer();
+  return { contentType, bytes: Buffer.from(ab) };
 }
-export async function listNodeServiceLogs(hostOrUrl, auth, port) {
-    const target = resolveTarget(hostOrUrl, port);
-    const resolvedAuth = resolveAuth(auth);
-    const { contentType, bytes } = await fetchSoap(target, resolvedAuth, "/logcollectionservice2/services/LogCollectionPortTypeService", "listNodeServiceLogs", soapEnvelopeList());
-    const xml = dimeXmlBytes(contentType, bytes);
-    const parsed = parser.parse(xml.toString("utf8"));
-    const env = parsed.Envelope || parsed;
-    const body = env.Body || env;
-    const resp = body.listNodeServiceLogsResponse;
-    const ret = resp?.listNodeServiceLogsReturn;
-    if (!ret)
-        throw new Error("Unexpected listNodeServiceLogs response shape");
-    const items = Array.isArray(ret) ? ret : [ret];
-    return items.map((it) => {
-        const serviceLogsRaw = it?.ServiceLog?.item;
-        const serviceLogs = Array.isArray(serviceLogsRaw)
-            ? serviceLogsRaw
-            : typeof serviceLogsRaw === "string"
-                ? [serviceLogsRaw]
-                : [];
-        return {
-            server: String(it?.name || ""),
-            serviceLogs,
-            count: serviceLogs.length,
-        };
-    });
+async function listNodeServiceLogs(hostOrUrl, auth, port) {
+  const target = resolveTarget(hostOrUrl, port);
+  const resolvedAuth = resolveAuth(auth);
+  const { contentType, bytes } = await fetchSoap(
+    target,
+    resolvedAuth,
+    "/logcollectionservice2/services/LogCollectionPortTypeService",
+    "listNodeServiceLogs",
+    soapEnvelopeList()
+  );
+  const xml = dimeXmlBytes(contentType, bytes);
+  const parsed = parser.parse(xml.toString("utf8"));
+  const env = parsed.Envelope || parsed;
+  const body = env.Body || env;
+  const resp = body.listNodeServiceLogsResponse;
+  const ret = resp?.listNodeServiceLogsReturn;
+  if (!ret) throw new Error("Unexpected listNodeServiceLogs response shape");
+  const items = Array.isArray(ret) ? ret : [ret];
+  return items.map((it) => {
+    const serviceLogsRaw = it?.ServiceLog?.item;
+    const serviceLogs = Array.isArray(serviceLogsRaw) ? serviceLogsRaw : typeof serviceLogsRaw === "string" ? [serviceLogsRaw] : [];
+    return {
+      server: String(it?.name || ""),
+      serviceLogs,
+      count: serviceLogs.length
+    };
+  });
 }
-export async function selectLogs(hostOrUrl, criteria, auth, port) {
-    const target = resolveTarget(hostOrUrl, port);
-    const resolvedAuth = resolveAuth(auth);
-    const hasService = (criteria.serviceLogs || []).some((x) => String(x || "").trim() !== "");
-    const hasSystem = (criteria.systemLogs || []).some((x) => String(x || "").trim() !== "");
-    if (!hasService && !hasSystem) {
-        throw new Error("selectLogs requires at least one of serviceLogs or systemLogs");
-    }
-    const { contentType, bytes } = await fetchSoap(target, resolvedAuth, "/logcollectionservice2/services/LogCollectionPortTypeService", "selectLogFiles", soapEnvelopeSelect(criteria));
-    const xml = dimeXmlBytes(contentType, bytes);
-    const parsed = parser.parse(xml.toString("utf8"));
-    const env = parsed.Envelope || parsed;
-    const body = env.Body || env;
-    const resp = body.selectLogFilesResponse;
-    const resultSet = resp?.ResultSet;
-    const serviceFileList = resultSet?.SchemaFileSelectionResult?.Node?.ServiceList?.ServiceLogs?.SetOfFiles?.File;
-    const systemFileList = resultSet?.SchemaFileSelectionResult?.Node?.ServiceList?.SystemLogs?.SetOfFiles?.File;
-    const toArray = (x) => (x == null ? [] : Array.isArray(x) ? x : [x]);
-    const combined = [...toArray(serviceFileList), ...toArray(systemFileList)];
-    if (combined.length === 0)
-        throw new Error("No files found (missing ServiceLogs/SystemLogs SetOfFiles/File)");
-    return combined.map((f) => {
-        const absolutePath = f?.absolutepath || f?.AbsolutePath || f?.Absolutepath;
-        const fileName = f?.filename || f?.FileName || f?.Filename;
-        return {
-            server: target.host,
-            absolutePath: absolutePath ? String(absolutePath) : undefined,
-            fileName: fileName ? String(fileName) : undefined,
-            ...f,
-        };
-    });
+async function selectLogs(hostOrUrl, criteria, auth, port) {
+  const target = resolveTarget(hostOrUrl, port);
+  const resolvedAuth = resolveAuth(auth);
+  const hasService = (criteria.serviceLogs || []).some((x) => String(x || "").trim() !== "");
+  const hasSystem = (criteria.systemLogs || []).some((x) => String(x || "").trim() !== "");
+  if (!hasService && !hasSystem) {
+    throw new Error("selectLogs requires at least one of serviceLogs or systemLogs");
+  }
+  const { contentType, bytes } = await fetchSoap(
+    target,
+    resolvedAuth,
+    "/logcollectionservice2/services/LogCollectionPortTypeService",
+    "selectLogFiles",
+    soapEnvelopeSelect(criteria)
+  );
+  const xml = dimeXmlBytes(contentType, bytes);
+  const parsed = parser.parse(xml.toString("utf8"));
+  const env = parsed.Envelope || parsed;
+  const body = env.Body || env;
+  const resp = body.selectLogFilesResponse;
+  const resultSet = resp?.ResultSet;
+  const serviceFileList = resultSet?.SchemaFileSelectionResult?.Node?.ServiceList?.ServiceLogs?.SetOfFiles?.File;
+  const systemFileList = resultSet?.SchemaFileSelectionResult?.Node?.ServiceList?.SystemLogs?.SetOfFiles?.File;
+  const toArray = (x) => x == null ? [] : Array.isArray(x) ? x : [x];
+  const combined = [...toArray(serviceFileList), ...toArray(systemFileList)];
+  if (combined.length === 0) throw new Error("No files found (missing ServiceLogs/SystemLogs SetOfFiles/File)");
+  return combined.map((f) => {
+    const absolutePath = f?.absolutepath || f?.AbsolutePath || f?.Absolutepath;
+    const fileName = f?.filename || f?.FileName || f?.Filename;
+    return {
+      server: target.host,
+      absolutePath: absolutePath ? String(absolutePath) : void 0,
+      fileName: fileName ? String(fileName) : void 0,
+      ...f
+    };
+  });
 }
-export async function selectLogsMinutes(hostOrUrl, minutesBack, select, timezone, auth, port) {
-    const now = new Date();
-    const past = new Date(now.getTime() - minutesBack * 60_000);
-    const fromDate = formatCucmDateTime(past);
-    const toDate = formatCucmDateTime(now);
-    const tz = timezone || guessTimezoneString(now);
-    const files = await selectLogs(hostOrUrl, { ...select, fromDate, toDate, timezone: tz }, auth, port);
-    return { fromDate, toDate, timezone: tz, files };
+async function selectLogsMinutes(hostOrUrl, minutesBack, select, timezone, auth, port) {
+  const now = /* @__PURE__ */ new Date();
+  const past = new Date(now.getTime() - minutesBack * 6e4);
+  const fromDate = formatCucmDateTime(past);
+  const toDate = formatCucmDateTime(now);
+  const tz = timezone || guessTimezoneString(now);
+  const files = await selectLogs(
+    hostOrUrl,
+    { ...select, fromDate, toDate, timezone: tz },
+    auth,
+    port
+  );
+  return { fromDate, toDate, timezone: tz, files };
 }
-export async function getOneFile(hostOrUrl, filePath, auth, port) {
-    const target = resolveTarget(hostOrUrl, port);
-    const resolvedAuth = resolveAuth(auth);
-    const { contentType, bytes } = await fetchSoap(target, resolvedAuth, "/logcollectionservice/services/DimeGetFileService", "http://schemas.cisco.com/ast/soap/action/#LogCollectionPort#GetOneFile", soapEnvelopeGetOneFile(filePath));
-    const boundary = extractBoundary(contentType);
-    if (!boundary) {
-        // Some environments respond with a non-multipart body. Prefer treating non-XML bodies as raw file bytes.
-        const ct = (contentType || "").toLowerCase();
-        if (ct.includes("text/xml") || ct.includes("application/soap+xml")) {
-            // Best-effort fault detection
-            const asText = bytes.toString("utf8");
-            if (/\bFault\b/i.test(asText))
-                throw new Error(`CUCM DIME GetOneFile returned SOAP fault: ${asText}`);
-            // If it's XML but not a fault, still return raw bytes.
-        }
-        return { server: target.host, filename: filePath, data: bytes };
+async function getOneFile(hostOrUrl, filePath, auth, port) {
+  const target = resolveTarget(hostOrUrl, port);
+  const resolvedAuth = resolveAuth(auth);
+  const { contentType, bytes } = await fetchSoap(
+    target,
+    resolvedAuth,
+    "/logcollectionservice/services/DimeGetFileService",
+    "http://schemas.cisco.com/ast/soap/action/#LogCollectionPort#GetOneFile",
+    soapEnvelopeGetOneFile(filePath)
+  );
+  const boundary = extractBoundary(contentType);
+  if (!boundary) {
+    const ct = (contentType || "").toLowerCase();
+    if (ct.includes("text/xml") || ct.includes("application/soap+xml")) {
+      const asText = bytes.toString("utf8");
+      if (/\bFault\b/i.test(asText)) throw new Error(`CUCM DIME GetOneFile returned SOAP fault: ${asText}`);
     }
-    const parts = parseMultipartRelated(bytes, boundary);
-    if (parts.length === 0)
-        throw new Error("DIME GetOneFile returned no multipart parts");
-    const nonXml = parts.find((p) => !isXmlContentType(p.contentType));
-    if (!nonXml)
-        throw new Error("DIME GetOneFile response missing non-XML file part");
-    return { server: target.host, filename: filePath, data: nonXml.body };
+    return { server: target.host, filename: filePath, data: bytes };
+  }
+  const parts = parseMultipartRelated(bytes, boundary);
+  if (parts.length === 0) throw new Error("DIME GetOneFile returned no multipart parts");
+  const nonXml = parts.find((p) => !isXmlContentType(p.contentType));
+  if (!nonXml) throw new Error("DIME GetOneFile response missing non-XML file part");
+  return { server: target.host, filename: filePath, data: nonXml.body };
 }
 function isDimeMissingFileError(e) {
-    const msg = e instanceof Error ? e.message : String(e || "");
-    // CUCM DIME commonly responds with HTTP 500 and a SOAP fault like:
-    //   "FileName ... do not exist"
-    return /DIME HTTP 500/i.test(msg) && /do not exist/i.test(msg);
+  const msg = e instanceof Error ? e.message : String(e || "");
+  return /DIME HTTP 500/i.test(msg) && /do not exist/i.test(msg);
 }
-export async function getOneFileWithRetry(hostOrUrl, filePath, opts) {
-    const timeoutMs = Math.max(1000, opts?.timeoutMs ?? 120_000);
-    const pollIntervalMs = Math.max(250, opts?.pollIntervalMs ?? 2000);
-    const start = Date.now();
-    let attempts = 0;
-    // Simple fixed-interval poll; CUCM can take time to flush capture files to disk.
-    while (true) {
-        attempts++;
-        try {
-            const r = await getOneFile(hostOrUrl, filePath, opts?.auth, opts?.port);
-            return { ...r, attempts, waitedMs: Date.now() - start };
-        }
-        catch (e) {
-            const elapsed = Date.now() - start;
-            if (!isDimeMissingFileError(e) || elapsed >= timeoutMs)
-                throw e;
-            await new Promise((r) => setTimeout(r, pollIntervalMs));
-        }
+async function getOneFileWithRetry(hostOrUrl, filePath, opts) {
+  const timeoutMs = Math.max(1e3, opts?.timeoutMs ?? 12e4);
+  const pollIntervalMs = Math.max(250, opts?.pollIntervalMs ?? 2e3);
+  const start = Date.now();
+  let attempts = 0;
+  while (true) {
+    attempts++;
+    try {
+      const r = await getOneFile(hostOrUrl, filePath, opts?.auth, opts?.port);
+      return { ...r, attempts, waitedMs: Date.now() - start };
+    } catch (e) {
+      const elapsed = Date.now() - start;
+      if (!isDimeMissingFileError(e) || elapsed >= timeoutMs) throw e;
+      await new Promise((r) => setTimeout(r, pollIntervalMs));
     }
+  }
 }
-export async function getOneFileAnyWithRetry(hostOrUrl, filePaths, opts) {
-    const paths = (filePaths || []).map(String).filter((p) => p.trim() !== "");
-    if (paths.length === 0)
-        throw new Error("getOneFileAnyWithRetry requires at least one filePath");
-    const timeoutMs = Math.max(1000, opts?.timeoutMs ?? 120_000);
-    const pollIntervalMs = Math.max(250, opts?.pollIntervalMs ?? 2000);
-    const start = Date.now();
-    let attempts = 0;
-    while (true) {
-        attempts++;
-        for (const p of paths) {
-            try {
-                const r = await getOneFile(hostOrUrl, p, opts?.auth, opts?.port);
-                return { ...r, attempts, waitedMs: Date.now() - start };
-            }
-            catch (e) {
-                if (!isDimeMissingFileError(e))
-                    throw e;
-            }
-        }
-        const elapsed = Date.now() - start;
-        if (elapsed >= timeoutMs) {
-            // If timeout, throw the same missing-file style error for the first candidate.
-            throw new Error(`DIME HTTP 500: FileName ${paths[0]} do not exist (timed out after ${elapsed}ms)`);
-        }
-        await new Promise((r) => setTimeout(r, pollIntervalMs));
+async function getOneFileAnyWithRetry(hostOrUrl, filePaths, opts) {
+  const paths = (filePaths || []).map(String).filter((p) => p.trim() !== "");
+  if (paths.length === 0) throw new Error("getOneFileAnyWithRetry requires at least one filePath");
+  const timeoutMs = Math.max(1e3, opts?.timeoutMs ?? 12e4);
+  const pollIntervalMs = Math.max(250, opts?.pollIntervalMs ?? 2e3);
+  const start = Date.now();
+  let attempts = 0;
+  while (true) {
+    attempts++;
+    for (const p of paths) {
+      try {
+        const r = await getOneFile(hostOrUrl, p, opts?.auth, opts?.port);
+        return { ...r, attempts, waitedMs: Date.now() - start };
+      } catch (e) {
+        if (!isDimeMissingFileError(e)) throw e;
+      }
+    }
+    const elapsed = Date.now() - start;
+    if (elapsed >= timeoutMs) {
+      throw new Error(`DIME HTTP 500: FileName ${paths[0]} do not exist (timed out after ${elapsed}ms)`);
     }
+    await new Promise((r) => setTimeout(r, pollIntervalMs));
+  }
 }
-export function writeDownloadedFile(result, outFile) {
-    const baseName = result.filename.split("/").filter(Boolean).pop() || "cucm-file.bin";
-    const defaultDir = join("/tmp", "cucm-mcp");
-    const filePath = outFile || join(defaultDir, baseName);
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, result.data);
-    return { filePath, bytes: result.data.length, baseName };
+function writeDownloadedFile(result, outFile) {
+  const baseName = result.filename.split("/").filter(Boolean).pop() || "cucm-file.bin";
+  const defaultDir = join("/tmp", "cucm-mcp");
+  const filePath = outFile || join(defaultDir, baseName);
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, result.data);
+  return { filePath, bytes: result.data.length, baseName };
 }
+export {
+  getOneFile,
+  getOneFileAnyWithRetry,
+  getOneFileWithRetry,
+  listNodeServiceLogs,
+  normalizeHost,
+  resolveAuth,
+  resolveTarget,
+  selectLogs,
+  selectLogsMinutes,
+  writeDownloadedFile
+};
+//# sourceMappingURL=dime.js.map

package/dist/dime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/dime.ts"],
+  "sourcesContent": ["import { XMLParser } from \"fast-xml-parser\";\nimport { extractBoundary, parseMultipartRelated } from \"./multipart.js\";\nimport { formatCucmDateTime, guessTimezoneString } from \"./time.js\";\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\n// Default to accepting self-signed/invalid certs (common on CUCM lab/dev).\n// Opt back into strict verification with CUCM_MCP_TLS_MODE=strict.\nconst tlsMode = (process.env.CUCM_MCP_TLS_MODE || process.env.MCP_TLS_MODE || \"\").toLowerCase();\nconst strictTls = tlsMode === \"strict\" || tlsMode === \"verify\";\nif (!strictTls) process.env.NODE_TLS_REJECT_UNAUTHORIZED = \"0\";\n\nexport type DimeAuth = { username?: string; password?: string };\n\nexport type DimeTarget = {\n  host: string;\n  port?: number;\n};\n\nexport type NodeServiceLogs = {\n  server: string;\n  serviceLogs: string[];\n  count: number;\n};\n\nexport type SelectedLogFile = {\n  server: string;\n  absolutePath?: string;\n  fileName?: string;\n  [k: string]: unknown;\n};\n\nexport type SelectLogsCriteria = {\n  serviceLogs?: string[];\n  systemLogs?: string[];\n  searchStr?: string;\n  fromDate: string;\n  toDate: string;\n  timezone: string;\n};\n\nconst parser = new XMLParser({\n  ignoreAttributes: false,\n  attributeNamePrefix: \"@\",\n  removeNSPrefix: true,\n  trimValues: true,\n});\n\nfunction isXmlContentType(contentType: string): boolean {\n  const ct = String(contentType || \"\").toLowerCase();\n  if (!ct) return false;\n  return ct === \"text/xml\" || ct === \"application/xml\" || ct === \"application/soap+xml\" || ct.endsWith(\"+xml\") || ct.includes(\"/xml\");\n}\n\nfunction dimeXmlBytes(contentType: string | null, bytes: Buffer): Buffer {\n  const boundary = extractBoundary(contentType);\n  if (!boundary) return bytes;\n  const parts = parseMultipartRelated(bytes, boundary);\n  const xmlParts = parts.filter((p) => isXmlContentType(p.contentType));\n  if (xmlParts.length === 0) {\n    // Some CUCM versions have been observed returning multipart bodies where the XML part\n    // does not advertise a classic XML content-type. Fall back to sniffing the payload.\n    const sniffed = parts.find((p) => {\n      const head = p.body.subarray(0, 64).toString(\"utf8\");\n      return head.includes(\"<?xml\") || head.trimStart().startsWith(\"<\");\n    });\n    if (sniffed) return sniffed.body;\n\n    const partTypes = parts.map((p) => p.contentType).join(\", \");\n    throw new Error(`DIME response missing text/xml part (boundary=${boundary}; parts=[${partTypes || \"none\"}])`);\n  }\n  return xmlParts[0].body;\n}\n\nexport function normalizeHost(hostOrUrl: string): string {\n  const s = String(hostOrUrl || \"\").trim();\n  if (!s) throw new Error(\"host is required\");\n  if (s.includes(\"://\")) {\n    const u = new URL(s);\n    return u.hostname;\n  }\n  return s.replace(/^https?:\\/\\//, \"\").replace(/\\/+$/, \"\").split(\"/\")[0];\n}\n\nexport function resolveAuth(auth?: DimeAuth): Required<DimeAuth> {\n  const username = auth?.username || process.env.CUCM_DIME_USERNAME || process.env.CUCM_USERNAME;\n  const password = auth?.password || process.env.CUCM_DIME_PASSWORD || process.env.CUCM_PASSWORD;\n  if (!username || !password) {\n    throw new Error(\"Missing DIME credentials (provide auth or set CUCM_DIME_USERNAME/CUCM_DIME_PASSWORD)\");\n  }\n  return { username, password };\n}\n\nexport function resolveTarget(hostOrUrl: string, port?: number): DimeTarget {\n  const host = normalizeHost(hostOrUrl);\n  const envPort = process.env.CUCM_DIME_PORT ? Number.parseInt(process.env.CUCM_DIME_PORT, 10) : undefined;\n  const resolvedPort = port ?? envPort ?? 8443;\n  return { host, port: resolvedPort };\n}\n\nfunction basicAuthHeader(username: string, password: string): string {\n  return `Basic ${Buffer.from(`${username}:${password}`, \"utf8\").toString(\"base64\")}`;\n}\n\nfunction escapeXml(s: string): string {\n  return s\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&apos;\");\n}\n\nfunction soapEnvelopeList(): string {\n  return (\n    '<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:soap=\"http://schemas.cisco.com/ast/soap\">' +\n    \"<soapenv:Header/>\" +\n    \"<soapenv:Body>\" +\n    \"<soap:listNodeServiceLogs>\" +\n    \"<soap:ListRequest></soap:ListRequest>\" +\n    \"</soap:listNodeServiceLogs>\" +\n    \"</soapenv:Body>\" +\n    \"</soapenv:Envelope>\"\n  );\n}\n\nfunction soapItems(tag: string, values?: string[]): string {\n  const vals = (values || []).filter((v) => String(v || \"\").trim() !== \"\");\n  if (vals.length === 0) return `<soap:${tag}><soap:item></soap:item></soap:${tag}>`;\n  return `<soap:${tag}>${vals.map((v) => `<soap:item>${escapeXml(v)}</soap:item>`).join(\"\")}</soap:${tag}>`;\n}\n\nfunction soapEnvelopeSelect(criteria: SelectLogsCriteria): string {\n  const serviceLogs = soapItems(\"ServiceLogs\", criteria.serviceLogs);\n  const systemLogs = soapItems(\"SystemLogs\", criteria.systemLogs);\n  const searchStr = escapeXml(criteria.searchStr || \"\");\n\n  return (\n    '<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:soap=\"http://schemas.cisco.com/ast/soap\">' +\n    \"<soapenv:Header/>\" +\n    \"<soapenv:Body>\" +\n    \"<soap:selectLogFiles>\" +\n    \"<soap:FileSelectionCriteria>\" +\n    serviceLogs +\n    systemLogs +\n    `<soap:SearchStr>${searchStr}</soap:SearchStr>` +\n    \"<soap:Frequency>OnDemand</soap:Frequency>\" +\n    \"<soap:JobType>DownloadtoClient</soap:JobType>\" +\n    `<soap:ToDate>${escapeXml(criteria.toDate)}</soap:ToDate>` +\n    `<soap:FromDate>${escapeXml(criteria.fromDate)}</soap:FromDate>` +\n    `<soap:TimeZone>${escapeXml(criteria.timezone)}</soap:TimeZone>` +\n    \"<soap:RelText>None</soap:RelText>\" +\n    \"<soap:RelTime>0</soap:RelTime>\" +\n    \"<soap:Port></soap:Port>\" +\n    \"<soap:IPAddress></soap:IPAddress>\" +\n    \"<soap:UserName></soap:UserName>\" +\n    \"<soap:Password></soap:Password>\" +\n    \"<soap:ZipInfo></soap:ZipInfo>\" +\n    \"<soap:RemoteFolder></soap:RemoteFolder>\" +\n    \"</soap:FileSelectionCriteria>\" +\n    \"</soap:selectLogFiles>\" +\n    \"</soapenv:Body>\" +\n    \"</soapenv:Envelope>\"\n  );\n}\n\nfunction soapEnvelopeGetOneFile(fileName: string): string {\n  return (\n    '<soapenv:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:soap=\"http://schemas.cisco.com/ast/soap/\">' +\n    \"<soapenv:Header/>\" +\n    \"<soapenv:Body>\" +\n    '<soap:GetOneFile soapenv:encodingStyle=\"http://schemas.xmlsoap.org/soap/encoding/\">' +\n    `<FileName xsi:type=\"get:FileName\" xmlns:get=\"http://cisco.com/ccm/serviceability/soap/LogCollection/GetFile/\">${escapeXml(fileName)}</FileName>` +\n    \"</soap:GetOneFile>\" +\n    \"</soapenv:Body>\" +\n    \"</soapenv:Envelope>\"\n  );\n}\n\nasync function fetchSoap(\n  target: DimeTarget,\n  auth: Required<DimeAuth>,\n  path: string,\n  soapAction: string,\n  xmlBody: string,\n  timeoutMs = 30000\n): Promise<{ contentType: string | null; bytes: Buffer }> {\n  const url = `https://${target.host}:${target.port}${path}`;\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      Authorization: basicAuthHeader(auth.username, auth.password),\n      SOAPAction: soapAction,\n      \"Content-Type\": \"text/xml;charset=UTF-8\",\n      Accept: \"*/*\",\n    },\n    body: Buffer.from(xmlBody, \"utf8\"),\n    signal: AbortSignal.timeout(timeoutMs),\n  });\n\n  if (!res.ok) {\n    const text = await res.text().catch(() => \"\");\n    throw new Error(`CUCM DIME HTTP ${res.status}: ${text || res.statusText}`);\n  }\n\n  const contentType = res.headers.get(\"content-type\");\n  const ab = await res.arrayBuffer();\n  return { contentType, bytes: Buffer.from(ab) };\n}\n\nexport async function listNodeServiceLogs(hostOrUrl: string, auth?: DimeAuth, port?: number): Promise<NodeServiceLogs[]> {\n  const target = resolveTarget(hostOrUrl, port);\n  const resolvedAuth = resolveAuth(auth);\n\n  const { contentType, bytes } = await fetchSoap(\n    target,\n    resolvedAuth,\n    \"/logcollectionservice2/services/LogCollectionPortTypeService\",\n    \"listNodeServiceLogs\",\n    soapEnvelopeList()\n  );\n\n  const xml = dimeXmlBytes(contentType, bytes);\n  const parsed = parser.parse(xml.toString(\"utf8\"));\n  const env = parsed.Envelope || parsed;\n  const body = env.Body || env;\n  const resp = body.listNodeServiceLogsResponse;\n  const ret = resp?.listNodeServiceLogsReturn;\n  if (!ret) throw new Error(\"Unexpected listNodeServiceLogs response shape\");\n\n  const items = Array.isArray(ret) ? ret : [ret];\n  return items.map((it: any) => {\n    const serviceLogsRaw = it?.ServiceLog?.item;\n    const serviceLogs = Array.isArray(serviceLogsRaw)\n      ? serviceLogsRaw\n      : typeof serviceLogsRaw === \"string\"\n      ? [serviceLogsRaw]\n      : [];\n    return {\n      server: String(it?.name || \"\"),\n      serviceLogs,\n      count: serviceLogs.length,\n    };\n  });\n}\n\nexport async function selectLogs(\n  hostOrUrl: string,\n  criteria: SelectLogsCriteria,\n  auth?: DimeAuth,\n  port?: number\n): Promise<SelectedLogFile[]> {\n  const target = resolveTarget(hostOrUrl, port);\n  const resolvedAuth = resolveAuth(auth);\n\n  const hasService = (criteria.serviceLogs || []).some((x) => String(x || \"\").trim() !== \"\");\n  const hasSystem = (criteria.systemLogs || []).some((x) => String(x || \"\").trim() !== \"\");\n  if (!hasService && !hasSystem) {\n    throw new Error(\"selectLogs requires at least one of serviceLogs or systemLogs\");\n  }\n\n  const { contentType, bytes } = await fetchSoap(\n    target,\n    resolvedAuth,\n    \"/logcollectionservice2/services/LogCollectionPortTypeService\",\n    \"selectLogFiles\",\n    soapEnvelopeSelect(criteria)\n  );\n\n  const xml = dimeXmlBytes(contentType, bytes);\n  const parsed = parser.parse(xml.toString(\"utf8\"));\n  const env = parsed.Envelope || parsed;\n  const body = env.Body || env;\n  const resp = body.selectLogFilesResponse;\n  const resultSet = resp?.ResultSet;\n  const serviceFileList =\n    resultSet?.SchemaFileSelectionResult?.Node?.ServiceList?.ServiceLogs?.SetOfFiles?.File;\n  const systemFileList =\n    resultSet?.SchemaFileSelectionResult?.Node?.ServiceList?.SystemLogs?.SetOfFiles?.File;\n\n  const toArray = (x: any) => (x == null ? [] : Array.isArray(x) ? x : [x]);\n  const combined = [...toArray(serviceFileList), ...toArray(systemFileList)];\n\n  if (combined.length === 0) throw new Error(\"No files found (missing ServiceLogs/SystemLogs SetOfFiles/File)\");\n\n  return combined.map((f: any) => {\n    const absolutePath = f?.absolutepath || f?.AbsolutePath || f?.Absolutepath;\n    const fileName = f?.filename || f?.FileName || f?.Filename;\n    return {\n      server: target.host,\n      absolutePath: absolutePath ? String(absolutePath) : undefined,\n      fileName: fileName ? String(fileName) : undefined,\n      ...f,\n    };\n  });\n}\n\nexport async function selectLogsMinutes(\n  hostOrUrl: string,\n  minutesBack: number,\n  select: Pick<SelectLogsCriteria, \"serviceLogs\" | \"systemLogs\" | \"searchStr\">,\n  timezone?: string,\n  auth?: DimeAuth,\n  port?: number\n): Promise<{ fromDate: string; toDate: string; timezone: string; files: SelectedLogFile[] }> {\n  const now = new Date();\n  const past = new Date(now.getTime() - minutesBack * 60_000);\n  const fromDate = formatCucmDateTime(past);\n  const toDate = formatCucmDateTime(now);\n  const tz = timezone || guessTimezoneString(now);\n  const files = await selectLogs(\n    hostOrUrl,\n    { ...select, fromDate, toDate, timezone: tz },\n    auth,\n    port\n  );\n  return { fromDate, toDate, timezone: tz, files };\n}\n\nexport async function getOneFile(\n  hostOrUrl: string,\n  filePath: string,\n  auth?: DimeAuth,\n  port?: number\n): Promise<{ server: string; filename: string; data: Buffer }> {\n  const target = resolveTarget(hostOrUrl, port);\n  const resolvedAuth = resolveAuth(auth);\n\n  const { contentType, bytes } = await fetchSoap(\n    target,\n    resolvedAuth,\n    \"/logcollectionservice/services/DimeGetFileService\",\n    \"http://schemas.cisco.com/ast/soap/action/#LogCollectionPort#GetOneFile\",\n    soapEnvelopeGetOneFile(filePath)\n  );\n\n  const boundary = extractBoundary(contentType);\n  if (!boundary) {\n    // Some environments respond with a non-multipart body. Prefer treating non-XML bodies as raw file bytes.\n    const ct = (contentType || \"\").toLowerCase();\n    if (ct.includes(\"text/xml\") || ct.includes(\"application/soap+xml\")) {\n      // Best-effort fault detection\n      const asText = bytes.toString(\"utf8\");\n      if (/\\bFault\\b/i.test(asText)) throw new Error(`CUCM DIME GetOneFile returned SOAP fault: ${asText}`);\n      // If it's XML but not a fault, still return raw bytes.\n    }\n    return { server: target.host, filename: filePath, data: bytes };\n  }\n\n  const parts = parseMultipartRelated(bytes, boundary);\n  if (parts.length === 0) throw new Error(\"DIME GetOneFile returned no multipart parts\");\n\n  const nonXml = parts.find((p) => !isXmlContentType(p.contentType));\n  if (!nonXml) throw new Error(\"DIME GetOneFile response missing non-XML file part\");\n\n  return { server: target.host, filename: filePath, data: nonXml.body };\n}\n\nfunction isDimeMissingFileError(e: unknown): boolean {\n  const msg = e instanceof Error ? e.message : String(e || \"\");\n  // CUCM DIME commonly responds with HTTP 500 and a SOAP fault like:\n  //   \"FileName ... do not exist\"\n  return /DIME HTTP 500/i.test(msg) && /do not exist/i.test(msg);\n}\n\nexport async function getOneFileWithRetry(\n  hostOrUrl: string,\n  filePath: string,\n  opts?: {\n    auth?: DimeAuth;\n    port?: number;\n    timeoutMs?: number;\n    pollIntervalMs?: number;\n  }\n): Promise<{ server: string; filename: string; data: Buffer; attempts: number; waitedMs: number }> {\n  const timeoutMs = Math.max(1000, opts?.timeoutMs ?? 120_000);\n  const pollIntervalMs = Math.max(250, opts?.pollIntervalMs ?? 2000);\n\n  const start = Date.now();\n  let attempts = 0;\n  // Simple fixed-interval poll; CUCM can take time to flush capture files to disk.\n  while (true) {\n    attempts++;\n    try {\n      const r = await getOneFile(hostOrUrl, filePath, opts?.auth, opts?.port);\n      return { ...r, attempts, waitedMs: Date.now() - start };\n    } catch (e) {\n      const elapsed = Date.now() - start;\n      if (!isDimeMissingFileError(e) || elapsed >= timeoutMs) throw e;\n      await new Promise((r) => setTimeout(r, pollIntervalMs));\n    }\n  }\n}\n\nexport async function getOneFileAnyWithRetry(\n  hostOrUrl: string,\n  filePaths: string[],\n  opts?: {\n    auth?: DimeAuth;\n    port?: number;\n    timeoutMs?: number;\n    pollIntervalMs?: number;\n  }\n): Promise<{ server: string; filename: string; data: Buffer; attempts: number; waitedMs: number }> {\n  const paths = (filePaths || []).map(String).filter((p) => p.trim() !== \"\");\n  if (paths.length === 0) throw new Error(\"getOneFileAnyWithRetry requires at least one filePath\");\n\n  const timeoutMs = Math.max(1000, opts?.timeoutMs ?? 120_000);\n  const pollIntervalMs = Math.max(250, opts?.pollIntervalMs ?? 2000);\n\n  const start = Date.now();\n  let attempts = 0;\n\n  while (true) {\n    attempts++;\n    for (const p of paths) {\n      try {\n        const r = await getOneFile(hostOrUrl, p, opts?.auth, opts?.port);\n        return { ...r, attempts, waitedMs: Date.now() - start };\n      } catch (e) {\n        if (!isDimeMissingFileError(e)) throw e;\n      }\n    }\n\n    const elapsed = Date.now() - start;\n    if (elapsed >= timeoutMs) {\n      // If timeout, throw the same missing-file style error for the first candidate.\n      throw new Error(`DIME HTTP 500: FileName ${paths[0]} do not exist (timed out after ${elapsed}ms)`);\n    }\n\n    await new Promise((r) => setTimeout(r, pollIntervalMs));\n  }\n}\n\nexport function writeDownloadedFile(result: { server: string; filename: string; data: Buffer }, outFile?: string) {\n  const baseName = result.filename.split(\"/\").filter(Boolean).pop() || \"cucm-file.bin\";\n  const defaultDir = join(\"/tmp\", \"cucm-mcp\");\n  const filePath = outFile || join(defaultDir, baseName);\n  mkdirSync(dirname(filePath), { recursive: true });\n  writeFileSync(filePath, result.data);\n  return { filePath, bytes: result.data.length, baseName };\n}\n"],
+  "mappings": "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",
+  "names": []
+}