@usex/mikrotik-mcp 3.22.0 → 3.24.0

package/dist/index.d.ts

@@ -49,9 +49,16 @@ interface UiLink {
 /** Options threaded into every tool registration. */
 interface RegisterOptions {
 	sendLog?: SendLog;
-	/** Configured device names; when more than one, a `device` selector is injected. */
+	/** Configured device KEYS; when more than one, a `device` selector is injected. */
 	deviceNames?: string[];
 	/**
+	* Extra accepted values for the `device` selector — a device's free-text
+	* label (`description`, e.g. "Ali Home") so the AI can target it by the
+	* friendly name as well as its config key. Resolved back to the key by
+	* {@link resolveDeviceName}. Does NOT affect the single-vs-multi decision.
+	*/
+	deviceAliases?: string[];
+	/**
 	* 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,11 +117,15 @@ declare function listDevices(): {
 	names: string[];
 	default: string;
 };
-/** Resolve a (possibly undefined) device name to a concrete, existing name. */
+/**
+* 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 name (or the default when
-* `name` is undefined). Throws if an explicit, unknown name is given.
+* 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";