npm - @usex/mikrotik-mcp - Versions diffs - 3.57.0 → 3.59.0 - Mend

@usex/mikrotik-mcp 3.57.0 → 3.59.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

package/dist/cli.js +84 -64
package/dist/index.d.ts +5 -0
package/dist/index.js +21 -15
package/dist/shared/{cli-0ctwspf1.js → cli-2dyvnv9v.js} +1 -1
package/dist/shared/{cli-thhk9f7n.js → cli-jq168zrj.js} +829 -597
package/dist/shared/{library-jve65pzw.js → library-0zd2tej9.js} +1 -1
package/dist/shared/{library-ymtf9zyk.js → library-21t1cncr.js} +828 -597
package/dist/ui/aaa.html +1 -1
package/dist/ui/connected-devices.html +1 -1
package/dist/ui/dashboard.html +1 -1
package/dist/ui/firewall-audit.html +1 -1
package/dist/ui/firewall.html +1 -1
package/dist/ui/interfaces.html +1 -1
package/dist/ui/observability.html +1 -1
package/dist/ui/records.html +1 -1
package/package.json +1 -1
package/schemas/README.md +5 -5
package/schemas/config.schema.json +47 -10
package/schemas/tool-catalog.json +2941 -736
package/schemas/tools/check_server_pulse.json +12 -0
package/schemas/tools/config_check_drift.json +5 -1
package/schemas/tools/config_reconcile.json +3 -1
package/schemas/tools/config_set_baseline.json +4 -1
package/schemas/tools/correlate_events.json +4 -1
package/schemas/tools/diagnose.json +3 -1
package/schemas/tools/get_filter_rule.json +1 -1
package/schemas/tools/memory_add_observations.json +7 -2
package/schemas/tools/memory_create_entities.json +7 -2
package/schemas/tools/memory_create_relations.json +8 -2
package/schemas/tools/memory_delete_entities.json +3 -1
package/schemas/tools/memory_delete_observations.json +7 -2
package/schemas/tools/memory_delete_relations.json +8 -2
package/schemas/tools/memory_open_nodes.json +3 -1
package/schemas/tools/memory_search_nodes.json +3 -1
package/schemas/tools/suggest_fix.json +3 -1
package/schemas/tools/trace_path.json +5 -1

package/dist/cli.js CHANGED Viewed

@@ -8,12 +8,18 @@ import {
   DEFAULT_SNAPSHOT_DB,
   DEFAULT_TZSP_PORT,
   DeviceConfigSchema,
+  LOGO_URL,
   MikrotikConfigSchema,
-  PROJECT_ROOT,
+  PKG_META,
   PROMPTS_DIR,
   REDACTED,
+  SERVER_DESCRIPTION,
+  SERVER_NAME,
+  SERVER_TITLE,
   ToolFilterSchema,
   UI_DIST_DIR,
+  VERSION,
+  WEBSITE_URL,
   __require,
   addAaaEntity,
   allToolModules,
@@ -24,6 +30,7 @@ import {
   blockDevice,
   buildChangePlan,
   capture,
+  checkForUpdate,
   closeAll,
   closeMemoryStore,
   commandUnsupported,
@@ -39,6 +46,7 @@ import {
   diffLines,
   executeMikrotikCommand,
   fetchDevices,
+  fetchLatestRelease,
   getConfig,
   getConfigSource,
   getEventStore,
@@ -54,6 +62,7 @@ import {
   listBackups,
   listDevices,
   loadConfig,
+  loadFileCacheSync,
   logger,
   looksLikeError,
   makeDeviceStatic,
@@ -95,16 +104,17 @@ import {
   subscriberCount,
   toggleAaaEntity,
   updateAaaEntity,
+  updateSummaryLine,
   writeBackup
-} from "./shared/cli-thhk9f7n.js";
+} from "./shared/cli-jq168zrj.js";
 // src/cli.ts
 import { existsSync as existsSync2 } from "fs";
 // src/observability/dashboard.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 import { homedir, networkInterfaces } from "os";
-import { dirname as dirname4, join as join3 } from "path";
+import { dirname as dirname4, join as join2 } from "path";
 var {serve } = globalThis.Bun;
 import { z } from "zod";
@@ -1148,18 +1158,6 @@ function computeStats(events, opts) {
   };
 }
-// src/version.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
-var pkg = JSON.parse(readFileSync2(join2(PROJECT_ROOT, "package.json"), "utf-8"));
-var VERSION = pkg.version ?? "0.0.0";
-var WEBSITE_URL = pkg.homepage ?? "";
-var LOGO_URL = pkg.logoIcon ?? "";
-var SERVER_TITLE = "MikroTik MCP";
-var SERVER_DESCRIPTION = pkg.description ?? "";
-var SERVER_NAME = "mikrotik-mcp";
-var PKG_META = pkg;
 // src/observability/drift-routes.ts
 var storePromise = null;
 function getStore() {
@@ -1425,51 +1423,13 @@ async function memoryRoutes(req, url) {
 // src/observability/dashboard.ts
 var SERVER_TAG2 = "mikrotik-mcp";
-var releaseCache = null;
-var RELEASE_CACHE_TTL = 15 * 60 * 1000;
-function compareVersions(a, b) {
-  const pa = a.replace(/^v/, "").split(".").map(Number);
-  const pb = b.replace(/^v/, "").split(".").map(Number);
-  for (let i = 0;i < Math.max(pa.length, pb.length); i++) {
-    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
-    if (diff !== 0)
-      return diff;
-  }
-  return 0;
-}
-async function fetchLatestRelease() {
-  if (releaseCache && Date.now() - releaseCache.fetchedAt < RELEASE_CACHE_TTL) {
-    return releaseCache.data;
-  }
-  const res = await fetch("https://api.github.com/repos/ali-master/mikrotik-mcp/releases/latest", {
-    headers: {
-      accept: "application/vnd.github+json",
-      "user-agent": "mikrotik-mcp-dashboard"
-    }
-  });
-  if (!res.ok)
-    throw new Error(`GitHub API ${res.status}`);
-  const gh = await res.json();
-  const latestVersion = gh.tag_name.replace(/^v/, "");
-  const data = {
-    version: latestVersion,
-    name: gh.name || `v${latestVersion}`,
-    body: gh.body || "",
-    publishedAt: gh.published_at,
-    url: gh.html_url,
-    isNewer: compareVersions(latestVersion, VERSION) > 0,
-    currentVersion: VERSION
-  };
-  releaseCache = { data, fetchedAt: Date.now() };
-  return data;
-}
 var JSON_HEADERS3 = { "content-type": "application/json; charset=utf-8" };
 function json3(body, status = 200) {
   return new Response(JSON.stringify(body), { status, headers: JSON_HEADERS3 });
 }
 function dashboardHtml() {
   try {
-    return readFileSync3(join3(UI_DIST_DIR, "observability.html"), "utf8");
+    return readFileSync2(join2(UI_DIST_DIR, "observability.html"), "utf8");
   } catch {
     return `<!doctype html><meta charset=utf-8><body style="font:14px system-ui;padding:24px;background:#0b0d10;color:#e8eaed">
 <h2>MikroTik MCP \u2014 Observability Dashboard</h2>
@@ -1805,12 +1765,12 @@ async function configRoutes(req, url, admin) {
 }
 async function modulesRoutes(req, url) {
   const p = url.pathname;
-  if (p !== "/api/modules" && p !== "/api/modules/toggle")
+  if (p !== "/api/modules" && p !== "/api/modules/toggle" && p !== "/api/modules/app-views")
     return null;
   if (p === "/api/modules" && req.method === "GET") {
     const cfg = getConfig();
     const src = getConfigSource();
-    return json3({ ...moduleSurface(cfg.tools), filter: cfg.tools, source: src });
+    return json3({ ...moduleSurface(cfg.tools), filter: cfg.tools, source: src, appViews: cfg.mcp.appViews });
   }
   if (p === "/api/modules/toggle" && req.method === "POST") {
     const b = await readJson(req);
@@ -1847,6 +1807,34 @@ async function modulesRoutes(req, url) {
       source: getConfigSource()
     });
   }
+  if (p === "/api/modules/app-views" && req.method === "POST") {
+    const b = await readJson(req);
+    if (typeof b?.enabled !== "boolean") {
+      return json3({ error: "enabled (boolean) is required" }, 400);
+    }
+    const cfg = getConfig();
+    const next = { ...cfg, mcp: { ...cfg.mcp, appViews: b.enabled } };
+    setConfig(next);
+    let persisted = true;
+    let warning;
+    try {
+      atomicWrite(getConfigSource().path, serializeConfig(next));
+    } catch (e) {
+      persisted = false;
+      warning = `applied live but not saved to disk: ${e instanceof Error ? e.message : String(e)}`;
+    }
+    if (persisted) {
+      recordVersion(getConfig(), "auto", Date.now(), `app views ${b.enabled ? "enabled" : "disabled"}`);
+    }
+    return json3({
+      ok: true,
+      persisted,
+      requiresReconnect: true,
+      warning,
+      appViews: b.enabled,
+      source: getConfigSource()
+    });
+  }
   return null;
 }
 async function captureRoutes(req, url) {
@@ -2156,7 +2144,7 @@ async function featureRoutes(req, url) {
     const raw = b?.dir?.trim();
     if (!raw)
       return json3({ error: "dir required" }, 400);
-    const dir = raw === "~" || raw.startsWith("~/") ? join3(homedir(), raw.slice(1)) : raw;
+    const dir = raw === "~" || raw.startsWith("~/") ? join2(homedir(), raw.slice(1)) : raw;
     const next = { ...getConfig(), backupDir: dir };
     setConfig(next);
     try {
@@ -2264,7 +2252,7 @@ async function runDashboard(cfg, transportLabel) {
   });
   startHealthChecks(30000);
   try {
-    usageStore = await openUsageStore(join3(dirname4(cfg.dbPath), "usage.db"));
+    usageStore = await openUsageStore(join2(dirname4(cfg.dbPath), "usage.db"));
     startUsageSampler(usageStore);
   } catch (e) {
     logger.warn(`[${SERVER_TAG2}] usage history disabled: ${String(e)}`);
@@ -2281,7 +2269,7 @@ async function runDashboard(cfg, transportLabel) {
     source: getConfigSource,
     readFile: (pth) => {
       try {
-        return readFileSync3(pth, "utf8");
+        return readFileSync2(pth, "utf8");
       } catch {
         return null;
       }
@@ -2564,8 +2552,8 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 // src/prompts/index.ts
-import { readFileSync as readFileSync4, readdirSync as readdirSync2 } from "fs";
-import { join as join4 } from "path";
+import { readFileSync as readFileSync3, readdirSync as readdirSync2 } from "fs";
+import { join as join3 } from "path";
 import { z as z2 } from "zod";
 function parseFrontmatter(raw) {
   const match = raw.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
@@ -2648,7 +2636,7 @@ function registerPrompts(server, opts = {}) {
   for (const file of files) {
     let parsed;
     try {
-      parsed = parseFrontmatter(readFileSync4(join4(PROMPTS_DIR, file), "utf8"));
+      parsed = parseFrontmatter(readFileSync3(join3(PROMPTS_DIR, file), "utf8"));
     } catch (e) {
       logger.warn(`Skipping prompt ${file}: ${String(e)}`);
       continue;
@@ -2734,7 +2722,17 @@ function createServer(opts = {}) {
   process.title = `Mikrotik MCP Server v${VERSION}`;
   const { names, default: defaultDevice } = listDevices();
   const readOnly = getConfig().readOnly;
-  const instructions = names.length > 1 ? INSTRUCTIONS + MULTI_DEVICE_INSTRUCTIONS.replace("{{names}}", names.join(", ")).replace("{{default}}", defaultDevice) : INSTRUCTIONS;
+  let instructions = names.length > 1 ? INSTRUCTIONS + MULTI_DEVICE_INSTRUCTIONS.replace("{{names}}", names.join(", ")).replace("{{default}}", defaultDevice) : INSTRUCTIONS;
+  if (!getConfig().disableUpdateCheck) {
+    const cached = loadFileCacheSync();
+    if (cached) {
+      const note = updateSummaryLine(cached);
+      if (note)
+        instructions += `
+${note}`;
+    }
+  }
   const server = new McpServer({
     name: SERVER_NAME,
     version: VERSION,
@@ -2886,6 +2884,13 @@ async function runHttp(mcp) {
     }
   });
   logger.info(`MCP server ready on http://${mcp.host}:${mcp.port}${mcpPath} \u2014 ${toolCount} tools, ${promptCount} prompts, ${uiViewCount} app views ` + `(${mcp.transport})${readOnly ? " [READ-ONLY]" : ""}`);
+  if (!getConfig().disableUpdateCheck) {
+    checkForUpdate().then((r) => {
+      if (r.release?.isNewer) {
+        logger.info(`[update] MikroTik MCP v${r.release.version} available (running v${VERSION}). ` + `Upgrade: bun i -g @usex/mikrotik-mcp@latest`);
+      }
+    }).catch(() => {});
+  }
 }
 // src/transport/stdio.ts
@@ -2895,6 +2900,21 @@ async function runStdio() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
   logger.info(`MCP server ready on stdio \u2014 ${toolCount} tools, ${promptCount} prompts, ${uiViewCount} app views${readOnly ? " [READ-ONLY]" : ""}`);
+  if (!getConfig().disableUpdateCheck) {
+    whisperUpdate(server).catch(() => {});
+  }
+}
+async function whisperUpdate(server) {
+  const result = await checkForUpdate();
+  if (!result.release?.isNewer)
+    return;
+  const r = result.release;
+  try {
+    server.server.sendLoggingMessage({
+      level: "info",
+      data: `[MikroTik MCP] Update available: v${r.version} (running v${VERSION}). ` + `${r.name ? `"${r.name}" \u2014 ` : ""}` + `Call check_server_pulse for release notes, or upgrade: bun i -g @usex/mikrotik-mcp@latest`
+    }).catch(() => {});
+  } catch {}
 }
 // src/cli-logo.ts

package/dist/index.d.ts CHANGED Viewed

@@ -136,6 +136,11 @@ interface ToolDef<Shape extends ZodRawShape> {
 	* view (it still returns `text` for non-UI hosts).
 	*/
 	ui?: UiLink;
+	/**
+	* When true, skip the multi-device `device` selector injection for this tool.
+	* Use for server-introspection tools that never contact a RouterOS device.
+	*/
+	noDevice?: boolean;
 	/** Handler returning the result shown to the model (text, or text + structured data). */
 	handler: (args: any, ctx: ToolContext) => Promise<HandlerOutput> | HandlerOutput;
 }

package/dist/index.js CHANGED Viewed

@@ -1,11 +1,16 @@
 // @bun
 import {
   DeviceConfigSchema,
+  LOGO_URL,
   MikroTikSSHClient,
   MikrotikConfigSchema,
-  PROJECT_ROOT,
   PROMPTS_DIR,
+  SERVER_DESCRIPTION,
+  SERVER_NAME,
+  SERVER_TITLE,
   SafeModeManager,
+  VERSION,
+  WEBSITE_URL,
   allToolModules,
   defineTool,
   deviceDirectory,
@@ -16,13 +21,15 @@ import {
   getSafeModeManager,
   listDevices,
   loadConfig,
+  loadFileCacheSync,
   logger,
   registerTools,
   registerUiResources,
   resolveDeviceName,
   selectToolModules,
-  setConfig
-} from "./shared/library-ymtf9zyk.js";
+  setConfig,
+  updateSummaryLine
+} from "./shared/library-21t1cncr.js";
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
@@ -146,17 +153,6 @@ function registerPrompts(server, opts = {}) {
   return count;
 }
-// src/version.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
-var pkg = JSON.parse(readFileSync2(join2(PROJECT_ROOT, "package.json"), "utf-8"));
-var VERSION = pkg.version ?? "0.0.0";
-var WEBSITE_URL = pkg.homepage ?? "";
-var LOGO_URL = pkg.logoIcon ?? "";
-var SERVER_TITLE = "MikroTik MCP";
-var SERVER_DESCRIPTION = pkg.description ?? "";
-var SERVER_NAME = "mikrotik-mcp";
 // src/server.ts
 var INSTRUCTIONS = `MikroTik RouterOS management over SSH.
@@ -209,7 +205,17 @@ function createServer(opts = {}) {
   process.title = `Mikrotik MCP Server v${VERSION}`;
   const { names, default: defaultDevice } = listDevices();
   const readOnly = getConfig().readOnly;
-  const instructions = names.length > 1 ? INSTRUCTIONS + MULTI_DEVICE_INSTRUCTIONS.replace("{{names}}", names.join(", ")).replace("{{default}}", defaultDevice) : INSTRUCTIONS;
+  let instructions = names.length > 1 ? INSTRUCTIONS + MULTI_DEVICE_INSTRUCTIONS.replace("{{names}}", names.join(", ")).replace("{{default}}", defaultDevice) : INSTRUCTIONS;
+  if (!getConfig().disableUpdateCheck) {
+    const cached = loadFileCacheSync();
+    if (cached) {
+      const note = updateSummaryLine(cached);
+      if (note)
+        instructions += `
+${note}`;
+    }
+  }
   const server = new McpServer({
     name: SERVER_NAME,
     version: VERSION,

package/dist/shared/{cli-0ctwspf1.js → cli-2dyvnv9v.js} RENAMED Viewed

@@ -4,7 +4,7 @@ import {
   allToolModules,
   moduleCatalog,
   selectToolModules
-} from "./cli-thhk9f7n.js";
+} from "./cli-jq168zrj.js";
 export {
   selectToolModules,
   moduleCatalog,