@usex/mikrotik-mcp 4.24.0 → 5.0.0

package/dist/index.d.ts

@@ -14,7 +14,28 @@ interface ToolContext {
 	* `undefined` means "use the configured default device".
 	*/
 	device?: string;
+	/**
+	* Which transport actually carried the last device command of this call.
+	*
+	* Recorded here rather than in a module-level global because tool calls run
+	* concurrently — a shared "last transport used" would be overwritten by
+	* whichever device answered most recently. One context per call makes this
+	* safe for free.
+	*
+	* A tool that issues several commands reports the LAST one; that is exact for
+	* the single-command majority and representative otherwise.
+	*/
+	transport?: DeviceTransport;
+	/**
+	* Why REST fell back to SSH on the last command, when it did. Present only
+	* for a device with `api: true` that could not use REST — the reason is the
+	* whole diagnostic value, since a silent fallback otherwise looks like REST
+	* simply never being enabled.
+	*/
+	restFallback?: string;
 }
+/** How a device command was actually carried. */
+type DeviceTransport = "ssh" | "rest" | "mac-telnet";
 type SendLog = (level: "info" | "error", message: string) => void;
 /**
 * Execute a RouterOS command and return its raw text output.
@@ -75,6 +96,29 @@ interface DeviceDirectoryEntry {
 * label, or if the device is disabled.
 */
 declare function getDevice(name?: string): DeviceConfig;
+/** Which wireless stack a device actually answers on. */
+type WirelessStack = "wifi" | "wireless" | "capsman-legacy" | "none";
+/**
+* What a tool needs from the device. Every field is optional and ANDed; an
+* absent `requires` means universally available, which is true of the large
+* majority of the catalog.
+*/
+interface ToolRequires {
+	/** Inclusive lower bound, e.g. `"7.13"`. */
+	minVersion?: string;
+	/** Exclusive upper bound, for menus removed in a later release. */
+	maxVersion?: string;
+	/** Every named package must be installed AND enabled. */
+	packages?: string[];
+	/** The device must answer on one of these wireless stacks. */
+	wirelessStack?: WirelessStack | WirelessStack[];
+	/** Board-name test, e.g. `/^CRS3/` for a switch-chip-only menu. */
+	board?: RegExp;
+	/** A device-mode permission that must be granted. */
+	deviceMode?: "container" | "scheduler" | "fetch";
+	/** The device must be a RouterBOARD (excludes CHR and x86). */
+	routerBoard?: boolean;
+}
 /** Options threaded into every tool registration. */
 interface RegisterOptions {
 	sendLog?: SendLog;
@@ -141,6 +185,17 @@ interface ToolDef<Shape extends ZodRawShape> {
 	* Use for server-introspection tools that never contact a RouterOS device.
 	*/
 	noDevice?: boolean;
+	/**
+	* What this tool needs from the device — a RouterOS version floor, a package,
+	* a wireless stack, a board, a device-mode permission.
+	*
+	* Omit it unless the tool genuinely cannot run everywhere; the large majority
+	* of the catalog is universal, and a spurious requirement hides a working tool.
+	* Declaring it does two things: the description is annotated when the device is
+	* known to be unsupported, and the call is guarded so an unsupported invocation
+	* returns a clear reason instead of a RouterOS parser error.
+	*/
+	requires?: ToolRequires;
 	/** Handler returning the result shown to the model (text, or text + structured data). */
 	handler: (args: any, ctx: ToolContext) => Promise<HandlerOutput> | HandlerOutput;
 }
@@ -152,6 +207,8 @@ interface RegisterableTool {
 	description: string;
 	/** Present when the tool renders an MCP App view. */
 	ui?: UiLink;
+	/** Device requirements, if the tool declared any. */
+	requires?: ToolRequires;
 	/**
 	* The raw handler (pre-`device`-injection, pre-validation). Exposed so the
 	* tool-gateway dispatcher (`invoke_tool`) can run any tool by name through its

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   selectToolModules,
   setConfig,
   updateSummaryLine
-} from "./shared/library-2f8ty72a.js";
+} from "./shared/library-13dhfdnq.js";
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";