@usex/mikrotik-mcp 3.26.0 → 3.28.0

package/dist/index.d.ts

@@ -46,6 +46,35 @@ interface UiLink {
 	*/
 	visibility?: ("model" | "app")[];
 }
+declare function setConfig(cfg: MikrotikConfig): void;
+declare function getConfig(): MikrotikConfig;
+/** Names of every configured device, plus which one is the default. */
+declare function listDevices(): {
+	names: string[];
+	default: string;
+};
+/**
+* Resolve a (possibly undefined) device name to a concrete, existing config key.
+* Accepts a config key OR a device's free-text label; falls back to the default.
+*
+* Matching is EXACT (key first, then label) — never fuzzy/substring — so a name
+* like "Ali Home" can never collapse onto a different device such as "home".
+*/
+declare function resolveDeviceName(name?: string): string;
+/** One row of the human-facing device directory shown in the `device` selector. */
+interface DeviceDirectoryEntry {
+	key: string;
+	label?: string;
+	/** Where it connects: `host:port`, or `MAC <addr>` for a MAC-Telnet device. */
+	target: string;
+	isDefault: boolean;
+}
+/**
+* Return the connection config for a device by key or label (or the default when
+* `name` is undefined). Throws if an explicit name matches neither a key nor a
+* label.
+*/
+declare function getDevice(name?: string): DeviceConfig;
 /** Options threaded into every tool registration. */
 interface RegisterOptions {
 	sendLog?: SendLog;
@@ -59,6 +88,12 @@ interface RegisterOptions {
 	*/
 	deviceAliases?: string[];
 	/**
+	* Human-facing directory of every device (key → label → target), used to make
+	* the `device` selector's description unambiguous so the model can tell
+	* similarly-named routers apart and never substitute one for another.
+	*/
+	deviceDirectory?: DeviceDirectoryEntry[];
+	/**
 	* Read-only mode: register only tools annotated `readOnlyHint`. Used to
 	* withhold every write/destructive tool from a publicly-exposed surface (e.g.
 	* a ChatGPT Apps connector) until authentication is in place.
@@ -110,24 +145,6 @@ declare function defineTool<Shape extends ZodRawShape>(def: ToolDef<Shape>): Reg
 type ToolModule = RegisterableTool[];
 /** Register every tool from every module, returning the total count. */
 declare function registerTools(server: McpServer, modules: ToolModule[], opts?: RegisterOptions): number;
-declare function setConfig(cfg: MikrotikConfig): void;
-declare function getConfig(): MikrotikConfig;
-/** Names of every configured device, plus which one is the default. */
-declare function listDevices(): {
-	names: string[];
-	default: string;
-};
-/**
-* Resolve a (possibly undefined) device name to a concrete, existing config key.
-* Accepts a config key OR a device's free-text label; falls back to the default.
-*/
-declare function resolveDeviceName(name?: string): string;
-/**
-* Return the connection config for a device by key or label (or the default when
-* `name` is undefined). Throws if an explicit name matches neither a key nor a
-* label.
-*/
-declare function getDevice(name?: string): DeviceConfig;
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
 interface CreatedServer {
 	server: McpServer2;