@mp-consulting/homebridge-ai-kit 2.0.0

package/dist/mcp/tools/accessories.d.ts

@@ -0,0 +1,15 @@
+import type { CharacteristicInfo, RegisterTools } from '../types.js';
+type Value = string | number | boolean;
+/**
+ * Check `value` against a characteristic's metadata (format, range, step,
+ * valid values, write permission) and coerce it to the expected type,
+ * e.g. "50" → 50 or 1 → true. Returns an error message when it cannot be set.
+ */
+export declare function checkCharacteristicValue(info: CharacteristicInfo, value: Value): {
+    value: Value;
+} | {
+    error: string;
+};
+export declare const register: RegisterTools;
+export {};
+//# sourceMappingURL=accessories.d.ts.map

package/dist/mcp/tools/accessories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessories.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/accessories.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgBhF,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAkDrH;AAED,eAAO,MAAM,QAAQ,EAAE,aA0ItB,CAAC"}

package/dist/mcp/tools/accessories.js

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+import { READ, errorResult, handle, jsonResult } from './helpers.js';
+function compactAccessory(acc) {
+    return {
+        uniqueId: acc.uniqueId,
+        serviceName: acc.serviceName,
+        type: acc.type,
+        manufacturer: acc.accessoryInformation?.Manufacturer ?? null,
+        model: acc.accessoryInformation?.Model ?? null,
+        values: acc.values ?? {},
+    };
+}
+const INTEGER_FORMATS = new Set(['int', 'uint8', 'uint16', 'uint32', 'uint64']);
+/**
+ * Check `value` against a characteristic's metadata (format, range, step,
+ * valid values, write permission) and coerce it to the expected type,
+ * e.g. "50" → 50 or 1 → true. Returns an error message when it cannot be set.
+ */
+export function checkCharacteristicValue(info, value) {
+    const name = info.type;
+    if (info.canWrite === false) {
+        return { error: `${name} is read-only.` };
+    }
+    const format = info.format?.toLowerCase();
+    if (format === 'bool') {
+        if (typeof value === 'boolean') {
+            return { value };
+        }
+        if (value === 1 || value === 0 || value === '1' || value === '0' || value === 'true' || value === 'false') {
+            return { value: value === 1 || value === '1' || value === 'true' };
+        }
+        return { error: `${name} expects true or false, got ${JSON.stringify(value)}.` };
+    }
+    if (format === 'string' || format === 'data' || format === 'tlv8') {
+        const s = String(value);
+        if (info.maxLen !== undefined && s.length > info.maxLen) {
+            return { error: `${name} accepts at most ${info.maxLen} characters.` };
+        }
+        return { value: s };
+    }
+    if (format === 'float' || (format && INTEGER_FORMATS.has(format))) {
+        const n = Number(value);
+        if ((typeof value === 'string' && value.trim() === '') || !Number.isFinite(n)) {
+            return { error: `${name} expects a number, got ${JSON.stringify(value)}.` };
+        }
+        if (format !== 'float' && !Number.isInteger(n)) {
+            return { error: `${name} expects a whole number, got ${n}.` };
+        }
+        const range = [info.minValue !== undefined ? `min ${info.minValue}` : '', info.maxValue !== undefined ? `max ${info.maxValue}` : '']
+            .filter(Boolean)
+            .join(', ');
+        if ((info.minValue !== undefined && n < info.minValue) || (info.maxValue !== undefined && n > info.maxValue)) {
+            return { error: `${name} must be within range (${range}), got ${n}.` };
+        }
+        if (info.validValues?.length && !info.validValues.includes(n)) {
+            return { error: `${name} must be one of ${info.validValues.join(', ')}, got ${n}.` };
+        }
+        if (info.minStep) {
+            const base = info.minValue ?? 0;
+            const steps = (n - base) / info.minStep;
+            if (Math.abs(steps - Math.round(steps)) > 1e-6) {
+                const nearest = base + Math.round(steps) * info.minStep;
+                return { error: `${name} moves in steps of ${info.minStep}; try ${Number(nearest.toFixed(6))}.` };
+            }
+        }
+        return { value: n };
+    }
+    return { value };
+}
+export const register = (tool, client) => {
+    tool('list_accessories', {
+        title: 'List accessories',
+        description: 'List all Homebridge accessories with their current state (on/off, brightness, temperature, etc.)',
+        inputSchema: {
+            room: z.string().optional().describe('Filter by room name (case-insensitive)'),
+            type: z.string().optional().describe("Filter by accessory type (e.g. 'Lightbulb', 'Switch', 'Thermostat')"),
+            manufacturer: z.string().optional().describe('Filter by manufacturer (case-insensitive, contains match)'),
+            excludeManufacturer: z.string().optional().describe('Exclude accessories from this manufacturer (case-insensitive, contains match)'),
+            name: z.string().optional().describe('Filter by service name (case-insensitive, contains match)'),
+        },
+        annotations: READ,
+    }, handle('listing accessories', async ({ room, type, manufacturer, excludeManufacturer, name }) => {
+        const [all, layout] = await Promise.all([
+            client.getAccessories(),
+            room ? client.getAccessoryLayout() : undefined,
+        ]);
+        let accessories = all;
+        // Room filter: resolve UIDs from layout
+        if (room && layout) {
+            const matchedRoom = layout.find((r) => r.name.toLowerCase() === room.toLowerCase());
+            if (!matchedRoom) {
+                return errorResult(`Room not found: "${room}". Available rooms: ${layout.map((r) => r.name).join(', ')}`);
+            }
+            const roomUids = new Set(matchedRoom.services.map((s) => s.uniqueId));
+            accessories = accessories.filter((a) => roomUids.has(a.uniqueId));
+        }
+        if (type) {
+            const t = type.toLowerCase();
+            accessories = accessories.filter((a) => a.type?.toLowerCase() === t);
+        }
+        if (manufacturer) {
+            const mfr = manufacturer.toLowerCase();
+            accessories = accessories.filter((a) => a.accessoryInformation?.Manufacturer?.toLowerCase().includes(mfr));
+        }
+        if (excludeManufacturer) {
+            const excl = excludeManufacturer.toLowerCase();
+            accessories = accessories.filter((a) => !a.accessoryInformation?.Manufacturer?.toLowerCase().includes(excl));
+        }
+        if (name) {
+            const n = name.toLowerCase();
+            accessories = accessories.filter((a) => a.serviceName?.toLowerCase().includes(n));
+        }
+        return jsonResult(accessories.map(compactAccessory));
+    }));
+    tool('get_accessory', {
+        title: 'Get accessory',
+        description: 'Get detailed information about a specific accessory by its uniqueId. Use list_accessories first to find the uniqueId.',
+        inputSchema: { uniqueId: z.string().min(1).describe('The unique identifier of the accessory') },
+        annotations: READ,
+    }, handle('getting accessory', async ({ uniqueId }) => jsonResult(await client.getAccessory(uniqueId))));
+    tool('set_accessory', {
+        title: 'Control accessory',
+        description: 'Control a Homebridge accessory — turn it on/off, set brightness, color temperature, etc. ' +
+            'Use list_accessories first to find the uniqueId and available characteristicTypes. ' +
+            'The value is checked against the characteristic (format, min/max, step, valid values, writable) before it is sent.',
+        inputSchema: {
+            uniqueId: z.string().min(1).describe('The unique identifier of the accessory'),
+            characteristicType: z
+                .string()
+                .min(1)
+                .describe("The characteristic to set (e.g. 'On', 'Brightness', 'ColorTemperature', 'Hue', 'Saturation', 'TargetTemperature', 'TargetDoorState')"),
+            value: z
+                .union([z.string(), z.number(), z.boolean()])
+                .describe('The value to set (e.g. true/false for On, 0-100 for Brightness)'),
+        },
+        // Changes physical device state (locks, garage doors) but doesn't destroy data.
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, handle('setting accessory', async ({ uniqueId, characteristicType, value }) => {
+        const accessory = await client.getAccessory(uniqueId);
+        const characteristics = accessory?.serviceCharacteristics;
+        let toSend = value;
+        if (characteristics?.length) {
+            const info = characteristics.find((c) => c.type.toLowerCase() === characteristicType.toLowerCase());
+            if (!info) {
+                const writable = characteristics.filter((c) => c.canWrite !== false).map((c) => c.type);
+                return errorResult(`${accessory.serviceName ?? uniqueId} has no characteristic "${characteristicType}". Writable: ${writable.join(', ') || 'none'}.`);
+            }
+            const checked = checkCharacteristicValue(info, value);
+            if ('error' in checked) {
+                return errorResult(checked.error);
+            }
+            toSend = checked.value;
+            characteristicType = info.type;
+        }
+        return jsonResult(await client.setAccessoryCharacteristic(uniqueId, characteristicType, toSend));
+    }));
+    tool('get_accessory_layout', {
+        title: 'Get room layout',
+        description: 'Get the accessories room layout as configured in the Homebridge UI.',
+        annotations: READ,
+    }, handle('getting layout', async () => {
+        const [layout, accessories] = await Promise.all([client.getAccessoryLayout(), client.getAccessories()]);
+        const accessoryMap = new Map(accessories.map((acc) => [acc.uniqueId, acc]));
+        const enriched = layout.map((room) => ({
+            name: room.name,
+            services: room.services.map((svc) => {
+                const acc = accessoryMap.get(svc.uniqueId);
+                return {
+                    uniqueId: svc.uniqueId,
+                    serviceName: acc?.serviceName ?? svc.customName ?? 'Unknown',
+                    type: acc?.type ?? 'Unknown',
+                    manufacturer: acc?.accessoryInformation?.Manufacturer ?? null,
+                };
+            }),
+        }));
+        return jsonResult(enriched);
+    }));
+};
+//# sourceMappingURL=accessories.js.map

package/dist/mcp/tools/accessories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessories.js","sourceRoot":"","sources":["../../../src/mcp/tools/accessories.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/child-bridges.d.ts

@@ -0,0 +1,3 @@
+import type { RegisterTools } from '../types.js';
+export declare const register: RegisterTools;
+//# sourceMappingURL=child-bridges.d.ts.map

package/dist/mcp/tools/child-bridges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-bridges.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/child-bridges.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAUjD,eAAO,MAAM,QAAQ,EAAE,aA8BtB,CAAC"}

package/dist/mcp/tools/child-bridges.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { READ, handle, jsonResult, pick, textResult } from './helpers.js';
+const FIELDS = ['username', 'name', 'plugin', 'identifier', 'status', 'paired', 'pid', 'port', 'manuallyStopped'];
+const deviceId = z
+    .string()
+    .regex(/^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$|^[0-9A-Fa-f]{12}$/, 'must be a child bridge username like 0E:3C:12:AB:CD:EF')
+    .describe('The child bridge username (deviceId) from list_child_bridges');
+export const register = (tool, client) => {
+    tool('list_child_bridges', {
+        title: 'List child bridges',
+        description: 'List the child bridges (plugins running in their own process) with their status (ok, pending, down) and whether they were stopped manually.',
+        annotations: READ,
+    }, handle('listing child bridges', async () => jsonResult((await client.getChildBridges()).map((b) => pick(b, FIELDS)))));
+    const control = (action, title, description) => tool(`${action}_child_bridge`, {
+        title,
+        description,
+        inputSchema: { deviceId },
+        // Starting only brings accessories back; stopping and restarting interrupt them.
+        annotations: { readOnlyHint: false, destructiveHint: action !== 'start', idempotentHint: true, openWorldHint: false },
+    }, handle(`${action === 'stop' ? 'stopp' : action}ing child bridge`, async ({ deviceId }) => {
+        await client.controlChildBridge(action, deviceId);
+        return textResult(`Child bridge ${deviceId}: ${action} requested. Check list_child_bridges for its status.`);
+    }));
+    control('restart', 'Restart child bridge', 'Restart one child bridge without restarting Homebridge. Its accessories are briefly unavailable.');
+    control('stop', 'Stop child bridge', 'Stop one child bridge. Its accessories stay unavailable until it is started again.');
+    control('start', 'Start child bridge', 'Start a child bridge that was stopped.');
+};
+//# sourceMappingURL=child-bridges.js.map

package/dist/mcp/tools/child-bridges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-bridges.js","sourceRoot":"","sources":["../../../src/mcp/tools/child-bridges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1E,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAU,CAAC;AAE3H,MAAM,QAAQ,GAAG,CAAC;KACf,MAAM,EAAE;KACR,KAAK,CAAC,wDAAwD,EAAE,wDAAwD,CAAC;KACzH,QAAQ,CAAC,8DAA8D,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACtD,IAAI,CACF,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,6IAA6I;QAC1J,WAAW,EAAE,IAAI;KAClB,EACD,MAAM,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CACtH,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,MAAoC,EAAE,KAAa,EAAE,WAAmB,EAAE,EAAE,CAC3F,IAAI,CACF,GAAG,MAAM,eAAe,EACxB;QACE,KAAK;QACL,WAAW;QACX,WAAW,EAAE,EAAE,QAAQ,EAAE;QACzB,iFAAiF;QACjF,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACtH,EACD,MAAM,CAAC,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,kBAAkB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACvF,MAAM,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,gBAAgB,QAAQ,KAAK,MAAM,sDAAsD,CAAC,CAAC;IAC/G,CAAC,CAAC,CACH,CAAC;IAEJ,OAAO,CAAC,SAAS,EAAE,sBAAsB,EAAE,kGAAkG,CAAC,CAAC;IAC/I,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,oFAAoF,CAAC,CAAC;IAC3H,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,wCAAwC,CAAC,CAAC;AACnF,CAAC,CAAC"}

package/dist/mcp/tools/config.d.ts

@@ -0,0 +1,7 @@
+import type { RegisterTools } from '../types.js';
+type Block = Record<string, unknown>;
+/** Deep merge: objects merge key by key, `null` deletes a key, anything else (arrays included) replaces. */
+export declare function mergePatch(target: Block, patch: Block): Block;
+export declare const register: RegisterTools;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/mcp/tools/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAcjD,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMrC,4GAA4G;AAC5G,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAY7D;AAMD,eAAO,MAAM,QAAQ,EAAE,aA4FtB,CAAC"}

package/dist/mcp/tools/config.js

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+import { REDACTED, containsRedacted, redactSecrets, restoreSecrets } from '@mp-consulting/homebridge-ai-core';
+import { READ, errorResult, handle, jsonResult, textResult } from './helpers.js';
+/**
+ * The minimum shape Homebridge needs. Extra keys pass through untouched; this
+ * only stops an empty or truncated object from replacing the whole file.
+ */
+const configSchema = z.looseObject({
+    bridge: z.looseObject({}).describe('The bridge block (name, username, port, pin, ...)'),
+    accessories: z.array(z.looseObject({})).optional(),
+    platforms: z.array(z.looseObject({})).optional(),
+});
+function isBlock(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/** Deep merge: objects merge key by key, `null` deletes a key, anything else (arrays included) replaces. */
+export function mergePatch(target, patch) {
+    const out = { ...target };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete out[key];
+        }
+        else if (isBlock(value) && isBlock(out[key])) {
+            out[key] = mergePatch(out[key], value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+function describeBlock(b) {
+    return [b.platform && `platform=${b.platform}`, b.accessory && `accessory=${b.accessory}`, b.name && `name=${b.name}`].filter(Boolean).join(' ');
+}
+export const register = (tool, client) => {
+    tool('get_config', {
+        title: 'Read config.json',
+        description: 'Read the current Homebridge config.json file content. Returns the full configuration including bridge settings, accessories, and platforms. ' +
+            `Passwords, tokens, API keys and the bridge pin are replaced by "${REDACTED}"; leave those placeholders as-is when calling update_config ` +
+            'and the real values are kept.',
+        inputSchema: {
+            includeSecrets: z
+                .boolean()
+                .optional()
+                .describe('Return real secret values instead of placeholders. Only use when the user explicitly asks to see a credential.'),
+        },
+        annotations: READ,
+    }, handle('getting config', async ({ includeSecrets }) => {
+        const config = await client.getConfig();
+        return jsonResult(includeSecrets ? config : redactSecrets(config));
+    }));
+    tool('update_config', {
+        title: 'Write config.json',
+        description: 'Update the Homebridge config.json file. You must provide the FULL config object — it replaces the entire file. ' +
+            `Use get_config first to read the current config, then modify and pass back the complete object. "${REDACTED}" placeholders ` +
+            'are swapped back to the current real values before saving.',
+        inputSchema: {
+            config: configSchema.describe('The complete config.json object to write'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, handle('updating config', async ({ config }) => {
+        const toWrite = containsRedacted(config) ? restoreSecrets(config, await client.getConfig()) : config;
+        const result = await client.updateConfig(toWrite);
+        return result
+            ? jsonResult(result)
+            : textResult('Config updated successfully. A Homebridge restart may be required for changes to take effect.');
+    }));
+    tool('patch_config', {
+        title: 'Edit one config block',
+        description: 'Change one platform or accessory block in config.json without sending the whole file. Identify the block by `platform` or `accessory` ' +
+            '(plus `name` when several blocks share it). `patch` is deep-merged: objects merge, arrays and values replace, and null removes a key. ' +
+            `"${REDACTED}" placeholders in the patch keep the current secret. Returns the updated block (secrets redacted).`,
+        inputSchema: {
+            platform: z.string().min(1).optional().describe("The block's `platform` value, e.g. 'Camera-ffmpeg'"),
+            accessory: z.string().min(1).optional().describe("The block's `accessory` value, for accessory plugins"),
+            name: z.string().min(1).optional().describe("The block's `name`, to pick one of several blocks of the same platform"),
+            patch: z.looseObject({}).describe('Keys to change'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, handle('patching config', async ({ platform, accessory, name, patch }) => {
+        if (!platform === !accessory) {
+            return errorResult('Pass exactly one of `platform` or `accessory`.');
+        }
+        const config = await client.getConfig();
+        const listKey = platform ? 'platforms' : 'accessories';
+        const idKey = platform ? 'platform' : 'accessory';
+        const id = (platform ?? accessory);
+        const list = Array.isArray(config[listKey]) ? config[listKey] : [];
+        const matches = list
+            .map((b, index) => ({ b, index }))
+            .filter(({ b }) => isBlock(b) && b[idKey] === id && (name === undefined || b.name === name));
+        if (matches.length === 0) {
+            return errorResult(`No ${idKey} block "${id}"${name ? ` named "${name}"` : ''} in config.json.`);
+        }
+        if (matches.length > 1) {
+            return errorResult(`Several ${idKey} blocks match "${id}": ${matches.map(({ b }) => describeBlock(b)).join('; ')}. Pass \`name\` to pick one.`);
+        }
+        const { b, index } = matches[0];
+        const current = b;
+        let updated = mergePatch(current, patch);
+        if (containsRedacted(updated)) {
+            updated = restoreSecrets(updated, current);
+        }
+        updated[idKey] = id;
+        const nextList = [...list];
+        nextList[index] = updated;
+        await client.updateConfig({ ...config, [listKey]: nextList });
+        return jsonResult({ updated: redactSecrets(updated), note: 'Saved. A Homebridge (or child bridge) restart may be required.' });
+    }));
+};
+//# sourceMappingURL=config.js.map

package/dist/mcp/tools/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/mcp/tools/config.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/helpers.d.ts

@@ -0,0 +1,31 @@
+import type { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+export interface ToolConfig<Args extends ZodRawShapeCompat | undefined> {
+    title: string;
+    description: string;
+    inputSchema?: Args;
+    /** Required so every tool states whether it reads or writes. */
+    annotations: ToolAnnotations & {
+        readOnlyHint: boolean;
+    };
+}
+/** Registers a tool, or silently skips it when the server runs read-only and the tool writes. */
+export type ToolRegistrar = <Args extends ZodRawShapeCompat | undefined = undefined>(name: string, config: ToolConfig<Args>, cb: ToolCallback<Args>) => void;
+export declare function createRegistrar(server: McpServer, { readOnly }?: {
+    readOnly?: boolean;
+}): ToolRegistrar;
+/** Reads Homebridge state, changes nothing. */
+export declare const READ: ToolConfig<undefined>['annotations'];
+/** Reads from the npm registry via Homebridge. */
+export declare const READ_REGISTRY: ToolConfig<undefined>['annotations'];
+export declare function textResult(text: string): CallToolResult;
+/** Compact JSON: pretty-printing costs ~25% more tokens for the same data. */
+export declare function jsonResult(data: unknown): CallToolResult;
+export declare function errorResult(text: string): CallToolResult;
+export declare function errorMessage(error: unknown): string;
+/** Wraps a tool handler so a thrown error becomes an `isError` result prefixed with `action`. */
+export declare function handle<A extends unknown[]>(action: string, fn: (...args: A) => Promise<CallToolResult>): (...args: A) => Promise<CallToolResult>;
+/** Copies only the listed keys that are present on `obj`. */
+export declare function pick<T extends object, K extends string>(obj: T, keys: readonly K[]): Partial<Record<K, unknown>>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/mcp/tools/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1F,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,iBAAiB,GAAG,SAAS;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,gEAAgE;IAChE,WAAW,EAAE,eAAe,GAAG;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1D;AAED,iGAAiG;AACjG,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,SAAS,iBAAiB,GAAG,SAAS,GAAG,SAAS,EACjF,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EACxB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,KACnB,IAAI,CAAC;AAEV,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,QAAgB,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAOnH;AAID,+CAA+C;AAC/C,eAAO,MAAM,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAgD,CAAC;AAEvG,kDAAkD;AAClD,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAA+C,CAAC;AAI/G,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEvD;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAExD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAExD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,iGAAiG;AACjG,wBAAgB,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,EACxC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,GAC1C,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAQzC;AAED,6DAA6D;AAC7D,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAQhH"}

package/dist/mcp/tools/helpers.js

@@ -0,0 +1,49 @@
+export function createRegistrar(server, { readOnly = false } = {}) {
+    return (name, config, cb) => {
+        if (readOnly && !config.annotations.readOnlyHint) {
+            return;
+        }
+        server.registerTool(name, config, cb);
+    };
+}
+// ── Annotation presets ─────────────────────────────────────────────
+/** Reads Homebridge state, changes nothing. */
+export const READ = { readOnlyHint: true, openWorldHint: false };
+/** Reads from the npm registry via Homebridge. */
+export const READ_REGISTRY = { readOnlyHint: true, openWorldHint: true };
+// ── Results ────────────────────────────────────────────────────────
+export function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+/** Compact JSON: pretty-printing costs ~25% more tokens for the same data. */
+export function jsonResult(data) {
+    return textResult(JSON.stringify(data));
+}
+export function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Wraps a tool handler so a thrown error becomes an `isError` result prefixed with `action`. */
+export function handle(action, fn) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            return errorResult(`Error ${action}: ${errorMessage(error)}`);
+        }
+    };
+}
+/** Copies only the listed keys that are present on `obj`. */
+export function pick(obj, keys) {
+    const out = {};
+    for (const key of keys) {
+        if (key in obj) {
+            out[key] = obj[key];
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/mcp/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/mcp/tools/helpers.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,EAAE,QAAQ,GAAG,KAAK,KAA6B,EAAE;IAClG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE;QAC1B,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED,sEAAsE;AAEtE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,IAAI,GAAyC,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEvG,kDAAkD;AAClD,MAAM,CAAC,MAAM,aAAa,GAAyC,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AAE/G,sEAAsE;AAEtE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,MAAM,CACpB,MAAc,EACd,EAA2C;IAE3C,OAAO,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,SAAS,MAAM,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,IAAI,CAAqC,GAAM,EAAE,IAAkB;IACjF,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YACf,GAAG,CAAC,GAAG,CAAC,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mcp/tools/logs.d.ts

@@ -0,0 +1,7 @@
+import type { RegisterTools } from '../types.js';
+/** Cap on how much of the log we keep in memory, in bytes. The rest is streamed past. */
+export declare const MAX_BYTES: number;
+/** Wall-clock budget for a regex search, so a pathological pattern can't hang the server. */
+export declare const SEARCH_BUDGET_MS = 5000;
+export declare const register: RegisterTools;
+//# sourceMappingURL=logs.d.ts.map

package/dist/mcp/tools/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/logs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,yFAAyF;AACzF,eAAO,MAAM,SAAS,QAAmB,CAAC;AAE1C,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAwCrC,eAAO,MAAM,QAAQ,EAAE,aA+FtB,CAAC"}

package/dist/mcp/tools/logs.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { RegexTimeoutError, regexSearch } from '../regex-search.js';
+import { READ, errorResult, handle, textResult } from './helpers.js';
+// The UI strips colour codes server-side, but a custom log path or an older UI
+// can still return them, so strip defensively before matching *and* displaying.
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /\u001B\[[0-9;]*m/g;
+/** Cap on how much of the log we keep in memory, in bytes. The rest is streamed past. */
+export const MAX_BYTES = 16 * 1024 * 1024;
+/** Wall-clock budget for a regex search, so a pathological pattern can't hang the server. */
+export const SEARCH_BUDGET_MS = 5000;
+function stripAnsi(s) {
+    return s.replace(ANSI_REGEX, '');
+}
+function splitLines(text) {
+    const lines = text.split('\n');
+    if (lines.length > 0 && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return lines;
+}
+/**
+ * Fetch the log and return its most recent lines, ANSI-stripped. Lines are
+ * stripped before they are handed back so that searching and displaying both
+ * operate on the same text the user sees.
+ */
+async function readLogTail(client) {
+    const { text, truncated } = await client.getLogTail(MAX_BYTES);
+    const lines = splitLines(text).map(stripAnsi);
+    // The first line of a truncated read is the tail end of an earlier line.
+    if (truncated) {
+        lines.shift();
+    }
+    return { lines, truncated };
+}
+function truncationNote(truncated) {
+    return truncated ? `Log is large; only the most recent ${MAX_BYTES / 1024 / 1024} MB was read.` : '';
+}
+export const register = (tool, client) => {
+    tool('get_recent_logs', {
+        title: 'Recent log lines',
+        description: 'Return the most recent lines from the Homebridge log (ANSI-stripped). Requires an hb-service based Homebridge install.',
+        inputSchema: {
+            lines: z
+                .number()
+                .int()
+                .min(1)
+                .max(5000)
+                .optional()
+                .describe('Number of lines to return from the tail (default 200, max 5000).'),
+        },
+        annotations: READ,
+    }, handle('reading Homebridge log', async ({ lines }) => {
+        const n = lines ?? 200;
+        const { lines: all, truncated } = await readLogTail(client);
+        const body = all.slice(-n).join('\n');
+        const note = truncationNote(truncated);
+        return textResult(note && body ? `${note}\n\n${body}` : note || body);
+    }));
+    tool('search_logs', {
+        title: 'Search logs',
+        description: 'Search the Homebridge log for matching lines. Returns up to `limit` most recent matches (ANSI-stripped). ' +
+            'Useful for finding errors, warnings, or events involving a specific device.',
+        inputSchema: {
+            pattern: z.string().min(1).describe('Substring or regex pattern to match against each log line.'),
+            regex: z
+                .boolean()
+                .optional()
+                .describe('Treat pattern as a JavaScript regex (default: false, treats pattern as a literal substring).'),
+            caseSensitive: z.boolean().optional().describe('Case-sensitive match (default: false).'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(2000)
+                .optional()
+                .describe('Maximum matches to return, taken from the most recent (default 100, max 2000).'),
+        },
+        annotations: READ,
+    }, handle('searching Homebridge log', async ({ pattern, regex, caseSensitive, limit }) => {
+        const max = limit ?? 100;
+        const cs = caseSensitive ?? false;
+        const flags = cs ? '' : 'i';
+        const label = regex ? `/${pattern}/${flags}` : JSON.stringify(pattern) + (cs ? ' (case-sensitive)' : '');
+        if (regex) {
+            try {
+                new RegExp(pattern, flags);
+            }
+            catch (error) {
+                return errorResult(`Invalid regex ${label}: ${error}`);
+            }
+        }
+        const { lines, truncated } = await readLogTail(client);
+        let matches;
+        if (regex) {
+            try {
+                matches = (await regexSearch(lines, pattern, flags, SEARCH_BUDGET_MS)).map((i) => lines[i]);
+            }
+            catch (error) {
+                if (error instanceof RegexTimeoutError) {
+                    return errorResult(`Search for ${label} exceeded ${SEARCH_BUDGET_MS}ms and was stopped. Try a simpler pattern or a literal substring.`);
+                }
+                throw error;
+            }
+        }
+        else {
+            // Substring search is linear, so it is safe on the main thread.
+            const needle = cs ? pattern : pattern.toLowerCase();
+            matches = lines.filter((line) => (cs ? line : line.toLowerCase()).includes(needle));
+        }
+        const taken = matches.slice(-max);
+        const parts = [`Showing ${taken.length} of ${matches.length} match${matches.length === 1 ? '' : 'es'} for ${label}.`];
+        const note = truncationNote(truncated);
+        if (note) {
+            parts.push(note);
+        }
+        const header = parts.join(' ');
+        const body = taken.join('\n');
+        return textResult(body ? `${header}\n\n${body}` : header);
+    }));
+};
+//# sourceMappingURL=logs.js.map