@mp-consulting/homebridge-ai-kit 2.0.0

package/dist/mcp/http.js

@@ -0,0 +1,124 @@
+/**
+ * Streamable HTTP transport for outside MCP clients. Every request needs
+ * `Authorization: Bearer <token>`; each MCP session gets its own server.
+ */
+import { randomUUID, timingSafeEqual, createHash } from 'node:crypto';
+import { createServer as createHttpServer } from 'node:http';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { createServer } from './create-server.js';
+export const MCP_PATH = '/mcp';
+const MAX_BODY_BYTES = 4 * 1024 * 1024;
+function sameToken(given, expected) {
+    // Hash both so the comparison is constant-time regardless of length.
+    const a = createHash('sha256').update(given).digest();
+    const b = createHash('sha256').update(expected).digest();
+    return timingSafeEqual(a, b);
+}
+function sendJson(res, status, body, headers = {}) {
+    res.writeHead(status, { 'Content-Type': 'application/json', ...headers }).end(JSON.stringify(body));
+}
+function rpcError(res, status, message, headers) {
+    sendJson(res, status, { jsonrpc: '2.0', error: { code: -32000, message }, id: null }, headers);
+}
+async function readBody(req) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        size += chunk.length;
+        if (size > MAX_BODY_BYTES) {
+            throw new Error('Request body too large');
+        }
+        chunks.push(chunk);
+    }
+    const text = Buffer.concat(chunks).toString('utf8');
+    return text ? JSON.parse(text) : undefined;
+}
+export async function runHttpServer(options) {
+    const { token, client } = options;
+    if (!token) {
+        throw new Error('A bearer token is required to serve MCP over HTTP (set HOMEBRIDGE_AI_MCP_TOKEN)');
+    }
+    const host = options.host ?? '127.0.0.1';
+    const transports = new Map();
+    const handle = async (req, res) => {
+        const path = new URL(req.url ?? '/', 'http://localhost').pathname;
+        if (path !== MCP_PATH) {
+            return rpcError(res, 404, `Not found; the MCP endpoint is ${MCP_PATH}`);
+        }
+        const auth = req.headers.authorization ?? '';
+        const given = /^Bearer\s+(.+)$/i.exec(auth)?.[1]?.trim() ?? '';
+        if (!given || !sameToken(given, token)) {
+            return rpcError(res, 401, 'Unauthorized', { 'WWW-Authenticate': 'Bearer realm="homebridge-ai-kit"' });
+        }
+        const sessionId = req.headers['mcp-session-id'];
+        const existing = typeof sessionId === 'string' ? transports.get(sessionId) : undefined;
+        if (req.method === 'POST') {
+            let body;
+            try {
+                body = await readBody(req);
+            }
+            catch (error) {
+                return rpcError(res, 400, `Invalid request body: ${error.message}`);
+            }
+            if (existing) {
+                return existing.handleRequest(req, res, body);
+            }
+            if (sessionId !== undefined || !isInitializeRequest(body)) {
+                return rpcError(res, sessionId === undefined ? 400 : 404, sessionId === undefined ? 'Missing mcp-session-id' : 'Unknown session');
+            }
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                onsessioninitialized: (id) => {
+                    transports.set(id, transport);
+                },
+            });
+            const server = createServer(client, { readOnly: options.readOnly, live: options.live });
+            transport.onclose = () => {
+                if (transport.sessionId) {
+                    transports.delete(transport.sessionId);
+                }
+                void server.close();
+            };
+            await server.connect(transport);
+            return transport.handleRequest(req, res, body);
+        }
+        if (req.method === 'GET' || req.method === 'DELETE') {
+            if (!existing) {
+                return rpcError(res, sessionId === undefined ? 400 : 404, sessionId === undefined ? 'Missing mcp-session-id' : 'Unknown session');
+            }
+            return existing.handleRequest(req, res);
+        }
+        return rpcError(res, 405, 'Method not allowed', { Allow: 'GET, POST, DELETE' });
+    };
+    const server = createHttpServer((req, res) => {
+        handle(req, res).catch((error) => {
+            if (!res.headersSent) {
+                rpcError(res, 500, error.message);
+            }
+            else {
+                res.end();
+            }
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(options.port ?? 8582, host, () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    const urlHost = address.family === 'IPv6' ? `[${address.address}]` : address.address;
+    return {
+        server,
+        url: `http://${urlHost}:${address.port}${MCP_PATH}`,
+        async close() {
+            await Promise.all([...transports.values()].map((t) => t.close()));
+            transports.clear();
+            server.closeAllConnections();
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/mcp/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/mcp/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC/B,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAoBvC,SAAS,SAAS,CAAC,KAAa,EAAE,QAAgB;IAChD,qEAAqE;IACrE,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IACtD,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;IACzD,OAAO,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,QAAQ,CAAC,GAAmB,EAAE,MAAc,EAAE,IAAa,EAAE,UAAkC,EAAE;IACxG,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,QAAQ,CAAC,GAAmB,EAAE,MAAc,EAAE,OAAe,EAAE,OAAgC;IACtG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AACjG,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAoB;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAA4B,EAAE,CAAC;QACvD,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;QACrB,IAAI,IAAI,GAAG,cAAc,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA0B;IAC5D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEpE,MAAM,MAAM,GAAG,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,EAAE;QACjE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC;QAClE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,kCAAkC,QAAQ,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/D,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,kBAAkB,EAAE,kCAAkC,EAAE,CAAC,CAAC;QACxG,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvF,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,IAAa,CAAC;YAClB,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,yBAA0B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,OAAO,QAAQ,CAAC,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;YACpI,CAAC;YACD,MAAM,SAAS,GAAkC,IAAI,6BAA6B,CAAC;gBACjF,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;gBACtC,oBAAoB,EAAE,CAAC,EAAE,EAAE,EAAE;oBAC3B,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;gBAChC,CAAC;aACF,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACxF,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;gBACvB,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;oBACxB,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBACzC,CAAC;gBACD,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC,CAAC;YACF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,QAAQ,CAAC,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;YACpI,CAAC;YACD,OAAO,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/B,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAiB,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACrF,OAAO;QACL,MAAM;QACN,GAAG,EAAE,UAAU,OAAO,IAAI,OAAO,CAAC,IAAI,GAAG,QAAQ,EAAE;QACnD,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAClE,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,12 @@
+export { VERSION, createServer, envFlag } from './create-server.js';
+export type { ServerOptions } from './create-server.js';
+export { HomebridgeClient } from './homebridge-client.js';
+export type { HomebridgeClientOptions, LogTail } from './homebridge-client.js';
+export { runHttpFromEnv, runStdioServer } from './stdio.js';
+export { MCP_PATH, runHttpServer } from './http.js';
+export type { HttpServerOptions, RunningHttpServer } from './http.js';
+export { LIVE_TOPICS, createLiveSource } from './live.js';
+export type { LiveOptions, LiveSource, LiveTopic, LiveWatch } from './live.js';
+export { RESOURCE_URIS } from './resources.js';
+export type { Accessory, CharacteristicInfo, ChildBridge, PluginJob, Room } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,7 @@
+export { VERSION, createServer, envFlag } from './create-server.js';
+export { HomebridgeClient } from './homebridge-client.js';
+export { runHttpFromEnv, runStdioServer } from './stdio.js';
+export { MCP_PATH, runHttpServer } from './http.js';
+export { LIVE_TOPICS, createLiveSource } from './live.js';
+export { RESOURCE_URIS } from './resources.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp/live.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Change notifications for the MCP resources. Listens on the Homebridge UI's
+ * socket.io namespaces (`/accessories`, `/log`, `/status`); when the socket
+ * cannot connect (e.g. the UI does not accept the token on sockets) it falls
+ * back to polling the REST API and comparing snapshots.
+ */
+import type { HomebridgeClient } from './homebridge-client.js';
+export type LiveTopic = 'accessories' | 'log' | 'status';
+export interface LiveWatch {
+    close(): void;
+}
+/** Starts watching `topic`, calling `onChange` (throttled) whenever it changes. */
+export type LiveSource = (topic: LiveTopic, onChange: () => void) => LiveWatch;
+/** The subset of a socket.io client socket this module uses. */
+export interface LiveSocket {
+    on(event: string, listener: (...args: unknown[]) => void): unknown;
+    emit(event: string, ...args: unknown[]): unknown;
+    close(): unknown;
+}
+export type SocketConnect = (url: string, options: {
+    auth: {
+        token: string;
+    };
+    transports: string[];
+    reconnectionDelayMax: number;
+}) => LiveSocket;
+interface TopicSpec {
+    /** Message that asks the namespace to start streaming. */
+    start: [string, ...unknown[]];
+    /** Event that carries updates. */
+    event: string;
+    pollMs: number;
+}
+/** Event names from the Glass UI (and homebridge-config-ui-x) gateways. */
+export declare const LIVE_TOPICS: Record<LiveTopic, TopicSpec>;
+export interface LiveOptions {
+    /** socket.io client factory (tests inject a fake). */
+    connect?: SocketConnect;
+    /** Minimum time between two notifications for one topic. */
+    throttleMs?: number;
+    /** Override the polling interval of every topic. */
+    pollMs?: number;
+}
+export declare function createLiveSource(client: HomebridgeClient, options?: LiveOptions): LiveSource;
+export {};
+//# sourceMappingURL=live.d.ts.map

package/dist/mcp/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/mcp/live.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;AAE/E,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IACnE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACjD,KAAK,IAAI,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,KAAK,UAAU,CAAC;AAElJ,UAAU,SAAS;IACjB,0DAA0D;IAC1D,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAIpD,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,CAkFhG"}

package/dist/mcp/live.js

@@ -0,0 +1,105 @@
+/**
+ * Change notifications for the MCP resources. Listens on the Homebridge UI's
+ * socket.io namespaces (`/accessories`, `/log`, `/status`); when the socket
+ * cannot connect (e.g. the UI does not accept the token on sockets) it falls
+ * back to polling the REST API and comparing snapshots.
+ */
+import { io } from 'socket.io-client';
+/** Event names from the Glass UI (and homebridge-config-ui-x) gateways. */
+export const LIVE_TOPICS = {
+    accessories: { start: ['get-accessories'], event: 'accessories-data', pollMs: 10_000 },
+    log: { start: ['tail-log', { cols: 200, rows: 50 }], event: 'stdout', pollMs: 5_000 },
+    status: { start: ['monitor-server-status'], event: 'homebridge-status', pollMs: 15_000 },
+};
+/** A snapshot of a topic used to detect changes while polling. */
+async function fingerprint(client, topic) {
+    switch (topic) {
+        case 'accessories':
+            return JSON.stringify((await client.getAccessories()).map((a) => [a.uniqueId, a.values]));
+        case 'log':
+            return (await client.getLogTail(8192)).text;
+        case 'status':
+            return JSON.stringify(await client.getHomebridgeStatus());
+    }
+}
+export function createLiveSource(client, options = {}) {
+    const connect = options.connect ?? io;
+    const throttleMs = options.throttleMs ?? 1000;
+    return (topic, onChange) => {
+        const spec = LIVE_TOPICS[topic];
+        let closed = false;
+        let socket;
+        let poller;
+        let pending;
+        let lastNotified = 0;
+        const notify = () => {
+            if (closed || pending) {
+                return;
+            }
+            const wait = lastNotified + throttleMs - Date.now();
+            const fire = () => {
+                pending = undefined;
+                lastNotified = Date.now();
+                if (!closed) {
+                    onChange();
+                }
+            };
+            if (wait <= 0) {
+                fire();
+            }
+            else {
+                pending = setTimeout(fire, wait);
+            }
+        };
+        const startPolling = async () => {
+            if (closed || poller) {
+                return;
+            }
+            let previous = await fingerprint(client, topic).catch(() => undefined);
+            if (closed) {
+                return;
+            }
+            poller = setInterval(async () => {
+                const current = await fingerprint(client, topic).catch(() => undefined);
+                if (current !== undefined && previous !== undefined && current !== previous) {
+                    notify();
+                }
+                previous = current ?? previous;
+            }, options.pollMs ?? spec.pollMs);
+        };
+        void (async () => {
+            let connected = false;
+            try {
+                const token = await client.accessToken();
+                if (closed) {
+                    return;
+                }
+                socket = connect(`${client.url}/${topic}`, { auth: { token }, transports: ['websocket'], reconnectionDelayMax: 30_000 });
+                socket.on('connect', () => {
+                    connected = true;
+                    socket.emit(...spec.start);
+                });
+                socket.on(spec.event, notify);
+                socket.on('connect_error', () => {
+                    if (!connected) {
+                        socket?.close();
+                        socket = undefined;
+                        void startPolling();
+                    }
+                });
+            }
+            catch {
+                void startPolling();
+            }
+        })();
+        return {
+            close() {
+                closed = true;
+                socket?.close();
+                clearInterval(poller);
+                clearTimeout(pending);
+            },
+        };
+    };
+}
+//# sourceMappingURL=live.js.map

package/dist/mcp/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/mcp/live.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AA6BtC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAiC;IACvD,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE;IACtF,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;IACrF,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,uBAAuB,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE;CACzF,CAAC;AAWF,kEAAkE;AAClE,KAAK,UAAU,WAAW,CAAC,MAAwB,EAAE,KAAgB;IACnE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5F,KAAK,KAAK;YACR,OAAO,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB,EAAE,UAAuB,EAAE;IAClF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAK,EAA+B,CAAC;IACpE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAE9C,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,MAA8B,CAAC;QACnC,IAAI,MAAkD,CAAC;QACvD,IAAI,OAAkD,CAAC;QACvD,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,YAAY,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,GAAG,EAAE;gBAChB,OAAO,GAAG,SAAS,CAAC;gBACpB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,QAAQ,EAAE,CAAC;gBACb,CAAC;YACH,CAAC,CAAC;YACF,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACd,IAAI,EAAE,CAAC;YACT,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;YAC9B,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACvE,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YACD,MAAM,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;gBAC9B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACxE,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC5E,MAAM,EAAE,CAAC;gBACX,CAAC;gBACD,QAAQ,GAAG,OAAO,IAAI,QAAQ,CAAC;YACjC,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;gBACzC,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO;gBACT,CAAC;gBACD,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC;gBACzH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;oBACxB,SAAS,GAAG,IAAI,CAAC;oBACjB,MAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC,CAAC,CAAC;gBACH,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC9B,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE;oBAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,MAAM,EAAE,KAAK,EAAE,CAAC;wBAChB,MAAM,GAAG,SAAS,CAAC;wBACnB,KAAK,YAAY,EAAE,CAAC;oBACtB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,YAAY,EAAE,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO;YACL,KAAK;gBACH,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM,EAAE,KAAK,EAAE,CAAC;gBAChB,aAAa,CAAC,MAAM,CAAC,CAAC;gBACtB,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/mcp/prompts.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** MCP prompts sharing their text with the built-in Assistant's templates. */
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/mcp/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/mcp/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4BvD"}

package/dist/mcp/prompts.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { PROMPTS } from '@mp-consulting/homebridge-ai-core';
+function message(text) {
+    return { messages: [{ role: 'user', content: { type: 'text', text } }] };
+}
+/** MCP prompts sharing their text with the built-in Assistant's templates. */
+export function registerPrompts(server) {
+    const p = PROMPTS.mcp;
+    server.registerPrompt('diagnose-logs', {
+        title: p['diagnose-logs'].title,
+        description: p['diagnose-logs'].description,
+        argsSchema: { focus: z.string().optional().describe('A plugin, device or symptom to focus on') },
+    }, ({ focus }) => message(p['diagnose-logs'].text({ focus })));
+    server.registerPrompt('plan-upgrade', {
+        title: p['plan-upgrade'].title,
+        description: p['plan-upgrade'].description,
+        argsSchema: { plugin: z.string().optional().describe('One plugin to plan for (default: all with updates)') },
+    }, ({ plugin }) => message(p['plan-upgrade'].text({ plugin })));
+    server.registerPrompt('audit-config', { title: p['audit-config'].title, description: p['audit-config'].description }, () => message(p['audit-config'].text()));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/mcp/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/mcp/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAE5D,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAEtB,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;QACE,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK;QAC/B,WAAW,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,WAAW;QAC3C,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC,EAAE;KACjG,EACD,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAC3D,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,cAAc,EACd;QACE,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK;QAC9B,WAAW,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,WAAW;QAC1C,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC,EAAE;KAC7G,EACD,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAC5D,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,cAAc,EACd,EAAE,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,EAC9E,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC,CACxC,CAAC;AACJ,CAAC"}

package/dist/mcp/regex-search.d.ts

@@ -0,0 +1,11 @@
+export declare class RegexTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/**
+ * Indices of the lines that match `pattern`, computed off the main thread.
+ * `flags` must not contain `g` or `y` (stateful `lastIndex` would skip matches).
+ * @throws RegexTimeoutError if matching takes longer than `timeoutMs`.
+ */
+export declare function regexSearch(lines: string[], pattern: string, flags: string, timeoutMs: number): Promise<number[]>;
+//# sourceMappingURL=regex-search.d.ts.map

package/dist/mcp/regex-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-search.d.ts","sourceRoot":"","sources":["../../src/mcp/regex-search.ts"],"names":[],"mappings":"AAuBA,qBAAa,iBAAkB,SAAQ,KAAK;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIvC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBjH"}

package/dist/mcp/regex-search.js

@@ -0,0 +1,53 @@
+import { Worker } from 'node:worker_threads';
+/**
+ * Runs in a worker so a catastrophically backtracking pattern can be killed.
+ * A time check in the main thread can't help there: a single `re.test()` call
+ * blocks the event loop until it returns, which can take hours.
+ *
+ * Loaded from a data: URL, which Node always evaluates as an ES module, so it
+ * needs no separate file in dist/ and works the same under tsx and vitest.
+ */
+const WORKER_SOURCE = `
+import { parentPort, workerData } from 'node:worker_threads';
+const { lines, pattern, flags } = workerData;
+const re = new RegExp(pattern, flags);
+const matches = [];
+for (let i = 0; i < lines.length; i++) {
+  if (re.test(lines[i])) matches.push(i);
+}
+parentPort.postMessage(matches);
+`;
+const WORKER_URL = new URL(`data:text/javascript,${encodeURIComponent(WORKER_SOURCE)}`);
+export class RegexTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`regex search exceeded ${timeoutMs}ms`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'RegexTimeoutError';
+    }
+}
+/**
+ * Indices of the lines that match `pattern`, computed off the main thread.
+ * `flags` must not contain `g` or `y` (stateful `lastIndex` would skip matches).
+ * @throws RegexTimeoutError if matching takes longer than `timeoutMs`.
+ */
+export function regexSearch(lines, pattern, flags, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const worker = new Worker(WORKER_URL, { workerData: { lines, pattern, flags } });
+        const timer = setTimeout(() => {
+            void worker.terminate();
+            reject(new RegexTimeoutError(timeoutMs));
+        }, timeoutMs);
+        const done = () => clearTimeout(timer);
+        worker.once('message', (matches) => {
+            done();
+            void worker.terminate();
+            resolve(matches);
+        });
+        worker.once('error', (error) => {
+            done();
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=regex-search.js.map

package/dist/mcp/regex-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-search.js","sourceRoot":"","sources":["../../src/mcp/regex-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG;;;;;;;;;CASrB,CAAC;AAEF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,wBAAwB,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAExF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACrB;IAArB,YAAqB,SAAiB;QACpC,KAAK,CAAC,yBAAyB,SAAS,IAAI,CAAC,CAAC;QAD3B,cAAS,GAAT,SAAS,CAAQ;QAEpC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe,EAAE,OAAe,EAAE,KAAa,EAAE,SAAiB;IAC5F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3C,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,OAAiB,EAAE,EAAE;YAC3C,IAAI,EAAE,CAAC;YACP,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC7B,IAAI,EAAE,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp/resources.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HomebridgeClient } from './homebridge-client.js';
+import type { LiveSource } from './live.js';
+export declare const RESOURCE_URIS: {
+    readonly accessories: "homebridge://accessories";
+    readonly logs: "homebridge://logs/recent";
+    readonly status: "homebridge://status";
+};
+/** Lines of log returned by `homebridge://logs/recent`. */
+export declare const RECENT_LOG_LINES = 200;
+/**
+ * Registers the live resources and, when `live` is given, `resources/subscribe`
+ * support: each subscribed URI gets a watch that sends `notifications/resources/updated`.
+ */
+export declare function registerResources(server: McpServer, client: HomebridgeClient, live: LiveSource | false): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,WAAW,CAAC;AAElE,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAQX,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AASpC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,IAAI,CAsE7G"}

package/dist/mcp/resources.js

@@ -0,0 +1,65 @@
+import { ErrorCode, McpError, SubscribeRequestSchema, UnsubscribeRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+export const RESOURCE_URIS = {
+    accessories: 'homebridge://accessories',
+    logs: 'homebridge://logs/recent',
+    status: 'homebridge://status',
+};
+const TOPIC_BY_URI = {
+    [RESOURCE_URIS.accessories]: 'accessories',
+    [RESOURCE_URIS.logs]: 'log',
+    [RESOURCE_URIS.status]: 'status',
+};
+/** Lines of log returned by `homebridge://logs/recent`. */
+export const RECENT_LOG_LINES = 200;
+// eslint-disable-next-line no-control-regex
+const ANSI = /\u001B\[[0-9;]*m/g;
+function json(uri, data) {
+    return { contents: [{ uri, mimeType: 'application/json', text: JSON.stringify(data) }] };
+}
+/**
+ * Registers the live resources and, when `live` is given, `resources/subscribe`
+ * support: each subscribed URI gets a watch that sends `notifications/resources/updated`.
+ */
+export function registerResources(server, client, live) {
+    server.registerResource('accessories', RESOURCE_URIS.accessories, { title: 'Accessories', description: 'Every accessory with its current values. Subscribe to hear about changes.', mimeType: 'application/json' }, async (uri) => json(uri.href, (await client.getAccessories()).map((a) => ({ uniqueId: a.uniqueId, serviceName: a.serviceName, type: a.type, values: a.values ?? {} }))));
+    server.registerResource('recent-logs', RESOURCE_URIS.logs, { title: 'Recent log', description: `The last ${RECENT_LOG_LINES} Homebridge log lines. Subscribe to follow the log.`, mimeType: 'text/plain' }, async (uri) => {
+        const { text } = await client.getLogTail(64 * 1024);
+        const lines = text.replace(ANSI, '').split('\n');
+        return { contents: [{ uri: uri.href, mimeType: 'text/plain', text: lines.slice(-RECENT_LOG_LINES).join('\n') }] };
+    });
+    server.registerResource('status', RESOURCE_URIS.status, { title: 'Homebridge status', description: 'Whether Homebridge is up, and its child bridges. Subscribe to hear about changes.', mimeType: 'application/json' }, async (uri) => {
+        const [status, childBridges] = await Promise.all([client.getHomebridgeStatus(), client.getChildBridges().catch(() => undefined)]);
+        return json(uri.href, { status, childBridges });
+    });
+    if (!live) {
+        return;
+    }
+    const watches = new Map();
+    server.server.registerCapabilities({ resources: { subscribe: true } });
+    server.server.setRequestHandler(SubscribeRequestSchema, async ({ params }) => {
+        const topic = TOPIC_BY_URI[params.uri];
+        if (!topic) {
+            throw new McpError(ErrorCode.InvalidParams, `Cannot subscribe to ${params.uri}`);
+        }
+        if (!watches.has(params.uri)) {
+            watches.set(params.uri, live(topic, () => {
+                server.server.sendResourceUpdated({ uri: params.uri }).catch(() => undefined);
+            }));
+        }
+        return {};
+    });
+    server.server.setRequestHandler(UnsubscribeRequestSchema, async ({ params }) => {
+        watches.get(params.uri)?.close();
+        watches.delete(params.uri);
+        return {};
+    });
+    const previous = server.server.onclose;
+    server.server.onclose = () => {
+        for (const watch of watches.values()) {
+            watch.close();
+        }
+        watches.clear();
+        previous?.();
+    };
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

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

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Starts the MCP server on stdio, configured from HOMEBRIDGE_* env vars.
+ * `prog` prefixes every message so users see the command name they actually ran.
+ */
+export declare function runStdioServer(prog: string): Promise<void>;
+/** Starts the Streamable HTTP MCP server; the bearer token comes from HOMEBRIDGE_AI_MCP_TOKEN. */
+export declare function runHttpFromEnv(prog: string, { port, host }?: {
+    port?: number;
+    host?: string;
+}): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/mcp/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhE;AAED,kGAAkG;AAClG,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBvH"}

package/dist/mcp/stdio.js

@@ -0,0 +1,56 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { HomebridgeClient } from './homebridge-client.js';
+import { createServer, envFlag } from './create-server.js';
+import { runHttpServer } from './http.js';
+/** Builds the client from HOMEBRIDGE_* env vars, exiting with a readable message on bad config. */
+function clientFromEnv(prog) {
+    let client;
+    try {
+        client = new HomebridgeClient();
+    }
+    catch (error) {
+        console.error(`${prog}: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+    if (client.transportWarning) {
+        console.error(`${prog}: warning: ${client.transportWarning}`);
+    }
+    const readOnly = envFlag(process.env.HOMEBRIDGE_READ_ONLY);
+    if (readOnly) {
+        console.error(`${prog}: read-only mode, write tools are disabled`);
+    }
+    return { client, readOnly };
+}
+/**
+ * Starts the MCP server on stdio, configured from HOMEBRIDGE_* env vars.
+ * `prog` prefixes every message so users see the command name they actually ran.
+ */
+export async function runStdioServer(prog) {
+    // stdout carries the MCP protocol, so every human-facing message goes to stderr.
+    const { client, readOnly } = clientFromEnv(prog);
+    const server = createServer(client, { readOnly });
+    await server.connect(new StdioServerTransport());
+}
+/** Starts the Streamable HTTP MCP server; the bearer token comes from HOMEBRIDGE_AI_MCP_TOKEN. */
+export async function runHttpFromEnv(prog, { port, host } = {}) {
+    const token = process.env.HOMEBRIDGE_AI_MCP_TOKEN?.trim();
+    if (!token) {
+        console.error(`${prog}: HOMEBRIDGE_AI_MCP_TOKEN is required with --http (clients must send it as a bearer token)`);
+        process.exit(1);
+    }
+    const { client, readOnly } = clientFromEnv(prog);
+    try {
+        const running = await runHttpServer({ port, host, token, client, readOnly });
+        console.error(`${prog}: MCP over HTTP at ${running.url}`);
+        const stop = () => {
+            void running.close().then(() => process.exit(0));
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    }
+    catch (error) {
+        console.error(`${prog}: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

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