@mp-consulting/homebridge-ai-kit 2.0.0

package/dist/bin/homebridge-mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"homebridge-mcp-server.d.ts","sourceRoot":"","sources":["../../src/bin/homebridge-mcp-server.ts"],"names":[],"mappings":""}

package/dist/bin/homebridge-mcp-server.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// Kept so MCP client configs written for the old package name keep working.
+import { runStdioServer } from '../mcp/stdio.js';
+await runStdioServer('homebridge-mcp-server');
+//# sourceMappingURL=homebridge-mcp-server.js.map

package/dist/bin/homebridge-mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"homebridge-mcp-server.js","sourceRoot":"","sources":["../../src/bin/homebridge-mcp-server.ts"],"names":[],"mappings":";AAEA,4EAA4E;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,cAAc,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from '@mp-consulting/homebridge-ai-core';
+export { runAgent } from './agent/run-agent.js';
+export type { AgentEvent, AgentResult, AgentToolCall, RunAgentOptions } from './agent/run-agent.js';
+/** Homebridge plugin entry point. */
+declare const _default: (api: {
+    registerPlatform(name: string, constructor: unknown): void;
+}) => void;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,mCAAmC,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEpG,qCAAqC;yBACrB,KAAK;IAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,KAAG,IAAI;AAA1F,wBAEE"}

package/dist/index.js

@@ -0,0 +1,12 @@
+import { PLATFORM_NAME } from '@mp-consulting/homebridge-ai-core';
+import { AiKitPlatform } from './plugin/platform.js';
+// ── AI core: redaction, config, providers, features, utilities ──
+// Everything from @mp-consulting/homebridge-ai-core, re-exported so existing imports keep working.
+export * from '@mp-consulting/homebridge-ai-core';
+// ── Agent ──
+export { runAgent } from './agent/run-agent.js';
+/** Homebridge plugin entry point. */
+export default (api) => {
+    api.registerPlatform(PLATFORM_NAME, AiKitPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,mEAAmE;AACnE,mGAAmG;AACnG,cAAc,mCAAmC,CAAC;AAElD,cAAc;AACd,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,qCAAqC;AACrC,eAAe,CAAC,GAAmE,EAAQ,EAAE;IAC3F,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/mcp/create-server.d.ts

@@ -0,0 +1,17 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HomebridgeClient } from './homebridge-client.js';
+import type { LiveSource } from './live.js';
+export declare const VERSION: string;
+export interface ServerOptions {
+    /** Register only tools annotated `readOnlyHint: true`. */
+    readOnly?: boolean;
+    /**
+     * Change feed behind `resources/subscribe`. Default: socket.io with polling
+     * fallback ({@link createLiveSource}); `false` disables subscriptions.
+     */
+    live?: LiveSource | false;
+}
+export declare function createServer(client: HomebridgeClient, options?: ServerOptions): McpServer;
+/** Parses a boolean env var: 1/true/yes/on (any case) are true, anything else is false. */
+export declare function envFlag(value: string | undefined): boolean;
+//# sourceMappingURL=create-server.d.ts.map

package/dist/mcp/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/mcp/create-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAa/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C,eAAO,MAAM,OAAO,QAAU,CAAC;AAa/B,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,aAAkB,GAAG,SAAS,CAS7F;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE1D"}

package/dist/mcp/create-server.js

@@ -0,0 +1,42 @@
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { createRegistrar } from './tools/helpers.js';
+import { register as registerAccessories } from './tools/accessories.js';
+import { register as registerServer } from './tools/server.js';
+import { register as registerConfig } from './tools/config.js';
+import { register as registerPlugins } from './tools/plugins.js';
+import { register as registerSystem } from './tools/system.js';
+import { register as registerLogs } from './tools/logs.js';
+import { register as registerPluginJobs } from './tools/plugin-jobs.js';
+import { register as registerChildBridges } from './tools/child-bridges.js';
+import { registerResources } from './resources.js';
+import { registerPrompts } from './prompts.js';
+import { createLiveSource } from './live.js';
+// package.json sits two levels above both src/mcp/ and dist/mcp/, and ships in the npm tarball.
+const { version } = createRequire(import.meta.url)('../../package.json');
+export const VERSION = version;
+const TOOL_GROUPS = [
+    registerAccessories,
+    registerServer,
+    registerConfig,
+    registerPlugins,
+    registerSystem,
+    registerLogs,
+    registerPluginJobs,
+    registerChildBridges,
+];
+export function createServer(client, options = {}) {
+    const server = new McpServer({ name: 'homebridge-ai-kit', version: VERSION });
+    const tool = createRegistrar(server, options);
+    for (const register of TOOL_GROUPS) {
+        register(tool, client);
+    }
+    registerResources(server, client, options.live ?? createLiveSource(client));
+    registerPrompts(server);
+    return server;
+}
+/** Parses a boolean env var: 1/true/yes/on (any case) are true, anything else is false. */
+export function envFlag(value) {
+    return /^(1|true|yes|on)$/i.test(value?.trim() ?? '');
+}
+//# sourceMappingURL=create-server.js.map

package/dist/mcp/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/mcp/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,gGAAgG;AAChG,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAwB,CAAC;AAEhG,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,WAAW,GAAoB;IACnC,mBAAmB;IACnB,cAAc;IACd,cAAc;IACd,eAAe;IACf,cAAc;IACd,YAAY;IACZ,kBAAkB;IAClB,oBAAoB;CACrB,CAAC;AAYF,MAAM,UAAU,YAAY,CAAC,MAAwB,EAAE,UAAyB,EAAE;IAChF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,WAAW,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC;IACD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,OAAO,CAAC,KAAyB;IAC/C,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/mcp/homebridge-client.d.ts

@@ -0,0 +1,105 @@
+/**
+ * HTTP client for the Homebridge Config UI REST API.
+ * Handles JWT authentication, token refresh, and all API calls.
+ */
+import type { Accessory, CachedAccessory, ChildBridge, Plugin, PluginJob, Room } from './types.js';
+export interface LogTail {
+    /** The last `maxBytes` of the log, decoded as UTF-8. May start mid-line when truncated. */
+    text: string;
+    truncated: boolean;
+}
+/**
+ * Returns a warning when credentials would cross the network unencrypted, i.e.
+ * plain http to something other than a loopback or private-range host.
+ */
+export declare function insecureTransportWarning(url: URL): string | null;
+export interface HomebridgeClientOptions {
+    /** Homebridge UI URL. Default: `HOMEBRIDGE_URL`. */
+    url?: string;
+    /** Default: `HOMEBRIDGE_USERNAME`. Not needed with a token. */
+    username?: string;
+    /** Default: `HOMEBRIDGE_PASSWORD`. Not needed with a token. */
+    password?: string;
+    /** A Homebridge UI API token (Glass UI `hbg_…`). Default: `HOMEBRIDGE_TOKEN`. Replaces username/password. */
+    token?: string;
+    /** Supplies a (short-lived) token per request, e.g. the current user's JWT. Takes precedence over everything else. */
+    getToken?: () => Promise<string>;
+    /** Per-request timeout. Default: `HOMEBRIDGE_TIMEOUT_MS`, else 30000. */
+    timeoutMs?: number;
+    /** The fetch to call Homebridge with, e.g. one that trusts a self-signed certificate. Default: the global fetch. */
+    fetch?: typeof fetch;
+}
+export declare class HomebridgeClient {
+    private readonly baseUrl;
+    private readonly auth;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    private token;
+    /** In-flight login/refresh, shared so concurrent callers don't each log in. */
+    private renewal;
+    constructor(options?: HomebridgeClientOptions);
+    /** The Homebridge UI base URL, without a trailing slash. */
+    get url(): string;
+    /** A warning to surface at startup if the configured URL is unsafe, else null. */
+    get transportWarning(): string | null;
+    /** fetch with a timeout, turning network failures into readable errors. */
+    private send;
+    private authenticate;
+    private refreshToken;
+    /**
+     * Replace `stale` with a fresh token (refresh, falling back to a full login).
+     * Concurrent callers share one renewal, and a caller whose stale token was
+     * already replaced by someone else returns immediately.
+     */
+    private renewToken;
+    /** A token for the current credentials (logging in if needed), e.g. for a socket.io handshake. */
+    accessToken(): Promise<string>;
+    /** Authenticated request returning the raw response; throws on a non-2xx status. */
+    private fetchAuthed;
+    private request;
+    getAccessories(): Promise<Accessory[]>;
+    getAccessory(uniqueId: string): Promise<Accessory>;
+    getAccessoryLayout(): Promise<Room[]>;
+    setAccessoryCharacteristic(uniqueId: string, characteristicType: string, value: string | number | boolean): Promise<unknown>;
+    getHomebridgeStatus(): Promise<unknown>;
+    getServerInformation(): Promise<unknown>;
+    restartServer(): Promise<unknown>;
+    getPairingInfo(): Promise<unknown>;
+    getCachedAccessories(): Promise<CachedAccessory[]>;
+    /**
+     * @param cacheFile Which cache holds the accessory (`$cacheFile` from the list). Omit for the
+     *   main bridge; child-bridge accessories live in their own file and can't be removed without it.
+     */
+    removeCachedAccessory(uuid: string, cacheFile?: string): Promise<unknown>;
+    resetCachedAccessories(): Promise<unknown>;
+    getConfig(): Promise<Record<string, unknown>>;
+    updateConfig(config: unknown): Promise<unknown>;
+    getPlugins(): Promise<Plugin[]>;
+    searchPlugins(query: string): Promise<Plugin[]>;
+    lookupPlugin(pluginName: string): Promise<unknown>;
+    getPluginVersions(pluginName: string): Promise<unknown>;
+    getPluginConfigSchema(pluginName: string): Promise<unknown>;
+    getPluginChangelog(pluginName: string): Promise<unknown>;
+    /** Starts an install job (Glass UI). */
+    installPlugin(name: string, version?: string): Promise<{
+        jobId: string;
+    }>;
+    updatePlugin(name: string, version?: string): Promise<{
+        jobId: string;
+    }>;
+    uninstallPlugin(name: string): Promise<{
+        jobId: string;
+    }>;
+    getPluginJob(jobId: string): Promise<PluginJob>;
+    getChildBridges(): Promise<ChildBridge[]>;
+    /** @param deviceId The child bridge's username (`0E:3C:…` or without colons). */
+    controlChildBridge(action: 'restart' | 'stop' | 'start', deviceId: string): Promise<unknown>;
+    getSystemInfo(): Promise<unknown>;
+    /**
+     * Stream the Homebridge log file and keep only its last `maxBytes`, so a
+     * multi-hundred-MB log never has to sit in memory whole. The UI strips ANSI
+     * colour codes unless `colour=yes` is passed. Requires an hb-service install.
+     */
+    getLogTail(maxBytes: number): Promise<LogTail>;
+}
+//# sourceMappingURL=homebridge-client.d.ts.map

package/dist/mcp/homebridge-client.d.ts.map

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

package/dist/mcp/homebridge-client.js

@@ -0,0 +1,341 @@
+/**
+ * HTTP client for the Homebridge Config UI REST API.
+ * Handles JWT authentication, token refresh, and all API calls.
+ */
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Returns a warning when credentials would cross the network unencrypted, i.e.
+ * plain http to something other than a loopback or private-range host.
+ */
+export function insecureTransportWarning(url) {
+    if (url.protocol !== 'http:') {
+        return null;
+    }
+    const host = url.hostname.replace(/^\[|\]$/g, '');
+    const local = host === 'localhost' ||
+        host.endsWith('.local') ||
+        host === '::1' ||
+        /^127\./.test(host) ||
+        /^10\./.test(host) ||
+        /^192\.168\./.test(host) ||
+        /^172\.(1[6-9]|2\d|3[01])\./.test(host) ||
+        /^f[cd][0-9a-f]{2}:/i.test(host);
+    return local
+        ? null
+        : `HOMEBRIDGE_URL uses plain http to a non-local host (${url.host}); your Homebridge credentials will be sent unencrypted.`;
+}
+export class HomebridgeClient {
+    baseUrl;
+    auth;
+    timeoutMs;
+    fetchImpl;
+    token = null;
+    /** In-flight login/refresh, shared so concurrent callers don't each log in. */
+    renewal = null;
+    constructor(options = {}) {
+        const env = process.env;
+        const url = options.url ?? env.HOMEBRIDGE_URL;
+        const timeout = options.timeoutMs ?? env.HOMEBRIDGE_TIMEOUT_MS;
+        if (!url) {
+            throw new Error('HOMEBRIDGE_URL environment variable is required');
+        }
+        if (options.getToken) {
+            this.auth = { kind: 'provider', getToken: options.getToken };
+        }
+        else if (options.token ?? env.HOMEBRIDGE_TOKEN) {
+            this.auth = { kind: 'static', token: (options.token ?? env.HOMEBRIDGE_TOKEN) };
+        }
+        else {
+            const username = options.username ?? env.HOMEBRIDGE_USERNAME;
+            const password = options.password ?? env.HOMEBRIDGE_PASSWORD;
+            if (!username) {
+                throw new Error('HOMEBRIDGE_USERNAME environment variable is required (or set HOMEBRIDGE_TOKEN)');
+            }
+            if (!password) {
+                throw new Error('HOMEBRIDGE_PASSWORD environment variable is required (or set HOMEBRIDGE_TOKEN)');
+            }
+            this.auth = { kind: 'login', username, password };
+        }
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch {
+            throw new Error(`HOMEBRIDGE_URL is not a valid URL: ${url}`);
+        }
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            throw new Error(`HOMEBRIDGE_URL must use http or https, got ${parsed.protocol}`);
+        }
+        this.timeoutMs = timeout !== undefined && timeout !== '' ? Number(timeout) : DEFAULT_TIMEOUT_MS;
+        if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
+            throw new Error(`HOMEBRIDGE_TIMEOUT_MS must be a positive number of milliseconds, got ${timeout}`);
+        }
+        this.baseUrl = url.replace(/\/+$/, '');
+        this.fetchImpl = options.fetch;
+    }
+    /** The Homebridge UI base URL, without a trailing slash. */
+    get url() {
+        return this.baseUrl;
+    }
+    /** A warning to surface at startup if the configured URL is unsafe, else null. */
+    get transportWarning() {
+        return insecureTransportWarning(new URL(this.baseUrl));
+    }
+    // ── Transport ───────────────────────────────────────────────────
+    /** fetch with a timeout, turning network failures into readable errors. */
+    async send(method, path, init = {}) {
+        try {
+            // The global is looked up per call, so it can be replaced after construction
+            return await (this.fetchImpl ?? fetch)(`${this.baseUrl}${path}`, {
+                ...init,
+                method,
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'TimeoutError') {
+                throw new Error(`Homebridge did not respond within ${this.timeoutMs}ms (${method} ${path})`, { cause: error });
+            }
+            const cause = error instanceof Error && error.cause instanceof Error ? `: ${error.cause.message}` : '';
+            throw new Error(`Cannot reach Homebridge at ${this.baseUrl} (${method} ${path})${cause}`, { cause: error });
+        }
+    }
+    // ── Authentication ──────────────────────────────────────────────
+    async authenticate() {
+        if (this.auth.kind === 'static') {
+            this.token = this.auth.token;
+            return;
+        }
+        if (this.auth.kind === 'provider') {
+            this.token = await this.auth.getToken();
+            return;
+        }
+        const res = await this.send('POST', '/api/auth/login', {
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ username: this.auth.username, password: this.auth.password }),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`Authentication failed (${res.status}): ${body}`);
+        }
+        const data = (await res.json());
+        this.token = data.access_token;
+    }
+    async refreshToken() {
+        // API tokens cannot be refreshed; a token provider is simply asked again.
+        if (!this.token || this.auth.kind !== 'login') {
+            return false;
+        }
+        try {
+            const res = await this.send('POST', '/api/auth/refresh', {
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.token}`,
+                },
+            });
+            if (!res.ok) {
+                return false;
+            }
+            const data = (await res.json());
+            this.token = data.access_token;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Replace `stale` with a fresh token (refresh, falling back to a full login).
+     * Concurrent callers share one renewal, and a caller whose stale token was
+     * already replaced by someone else returns immediately.
+     */
+    async renewToken(stale) {
+        if (this.token !== stale) {
+            return;
+        }
+        this.renewal ??= (async () => {
+            if (!(await this.refreshToken())) {
+                await this.authenticate();
+            }
+        })().finally(() => {
+            this.renewal = null;
+        });
+        await this.renewal;
+    }
+    // ── Generic request methods ─────────────────────────────────────
+    /** A token for the current credentials (logging in if needed), e.g. for a socket.io handshake. */
+    async accessToken() {
+        if (this.auth.kind === 'provider') {
+            return this.auth.getToken();
+        }
+        if (!this.token) {
+            await this.renewToken(null);
+        }
+        return this.token;
+    }
+    /** Authenticated request returning the raw response; throws on a non-2xx status. */
+    async fetchAuthed(method, path, body) {
+        if (this.auth.kind === 'provider') {
+            // Ask for a token on every request: the provider owns caching and expiry.
+            this.token = await this.auth.getToken();
+        }
+        else if (!this.token) {
+            await this.renewToken(null);
+        }
+        const doFetch = () => {
+            const headers = {
+                Authorization: `Bearer ${this.token}`,
+            };
+            if (body !== undefined) {
+                headers['Content-Type'] = 'application/json';
+            }
+            return this.send(method, path, {
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+            });
+        };
+        const usedToken = this.token;
+        let res = await doFetch();
+        // On 401, renew the token (refresh, else re-login) and retry once
+        if (res.status === 401 && this.auth.kind !== 'static') {
+            await res.body?.cancel();
+            await this.renewToken(usedToken);
+            res = await doFetch();
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Homebridge API error ${res.status} ${method} ${path}: ${text}`);
+        }
+        return res;
+    }
+    async request(method, path, body) {
+        const res = await this.fetchAuthed(method, path, body);
+        const contentType = res.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            return (await res.json());
+        }
+        return (await res.text());
+    }
+    // ── Accessories ─────────────────────────────────────────────────
+    async getAccessories() {
+        return this.request('GET', '/api/accessories');
+    }
+    async getAccessory(uniqueId) {
+        return this.request('GET', `/api/accessories/${encodeURIComponent(uniqueId)}`);
+    }
+    async getAccessoryLayout() {
+        return this.request('GET', '/api/accessories/layout');
+    }
+    async setAccessoryCharacteristic(uniqueId, characteristicType, value) {
+        return this.request('PUT', `/api/accessories/${encodeURIComponent(uniqueId)}`, {
+            characteristicType,
+            value,
+        });
+    }
+    // ── Server / Status ─────────────────────────────────────────────
+    async getHomebridgeStatus() {
+        return this.request('GET', '/api/status/homebridge');
+    }
+    async getServerInformation() {
+        return this.request('GET', '/api/status/server-information');
+    }
+    async restartServer() {
+        return this.request('PUT', '/api/server/restart');
+    }
+    async getPairingInfo() {
+        return this.request('GET', '/api/server/pairing');
+    }
+    async getCachedAccessories() {
+        return this.request('GET', '/api/server/cached-accessories');
+    }
+    /**
+     * @param cacheFile Which cache holds the accessory (`$cacheFile` from the list). Omit for the
+     *   main bridge; child-bridge accessories live in their own file and can't be removed without it.
+     */
+    async removeCachedAccessory(uuid, cacheFile) {
+        const query = cacheFile ? `?cacheFile=${encodeURIComponent(cacheFile)}` : '';
+        return this.request('DELETE', `/api/server/cached-accessories/${encodeURIComponent(uuid)}${query}`);
+    }
+    async resetCachedAccessories() {
+        return this.request('PUT', '/api/server/reset-cached-accessories');
+    }
+    // ── Config ──────────────────────────────────────────────────────
+    async getConfig() {
+        return this.request('GET', '/api/config-editor');
+    }
+    async updateConfig(config) {
+        return this.request('POST', '/api/config-editor', config);
+    }
+    // ── Plugins ─────────────────────────────────────────────────────
+    async getPlugins() {
+        return this.request('GET', '/api/plugins');
+    }
+    async searchPlugins(query) {
+        return this.request('GET', `/api/plugins/search/${encodeURIComponent(query)}`);
+    }
+    async lookupPlugin(pluginName) {
+        return this.request('GET', `/api/plugins/lookup/${encodeURIComponent(pluginName)}`);
+    }
+    async getPluginVersions(pluginName) {
+        return this.request('GET', `/api/plugins/lookup/${encodeURIComponent(pluginName)}/versions`);
+    }
+    async getPluginConfigSchema(pluginName) {
+        return this.request('GET', `/api/plugins/config-schema/${encodeURIComponent(pluginName)}`);
+    }
+    async getPluginChangelog(pluginName) {
+        return this.request('GET', `/api/plugins/changelog/${encodeURIComponent(pluginName)}`);
+    }
+    /** Starts an install job (Glass UI). */
+    async installPlugin(name, version) {
+        return this.request('POST', '/api/plugins/install', { name, ...(version ? { version } : {}) });
+    }
+    async updatePlugin(name, version) {
+        return this.request('POST', '/api/plugins/update', { name, ...(version ? { version } : {}) });
+    }
+    async uninstallPlugin(name) {
+        return this.request('POST', '/api/plugins/uninstall', { name });
+    }
+    async getPluginJob(jobId) {
+        return this.request('GET', `/api/plugins/jobs/${encodeURIComponent(jobId)}`);
+    }
+    // ── Child bridges ───────────────────────────────────────────────
+    async getChildBridges() {
+        return this.request('GET', '/api/status/homebridge/child-bridges');
+    }
+    /** @param deviceId The child bridge's username (`0E:3C:…` or without colons). */
+    async controlChildBridge(action, deviceId) {
+        return this.request('PUT', `/api/server/${action}/${encodeURIComponent(deviceId)}`);
+    }
+    // ── Platform Tools ──────────────────────────────────────────────
+    async getSystemInfo() {
+        return this.request('GET', '/api/platform-tools/system-information');
+    }
+    // ── Logs ────────────────────────────────────────────────────────
+    /**
+     * Stream the Homebridge log file and keep only its last `maxBytes`, so a
+     * multi-hundred-MB log never has to sit in memory whole. The UI strips ANSI
+     * colour codes unless `colour=yes` is passed. Requires an hb-service install.
+     */
+    async getLogTail(maxBytes) {
+        const res = await this.fetchAuthed('GET', '/api/platform-tools/hb-service/log/download');
+        if (!res.body) {
+            return { text: '', truncated: false };
+        }
+        const chunks = [];
+        let kept = 0;
+        let total = 0;
+        for await (const chunk of res.body) {
+            chunks.push(chunk);
+            kept += chunk.byteLength;
+            total += chunk.byteLength;
+            // Drop whole leading chunks that are no longer needed to cover maxBytes.
+            while (chunks.length > 1 && kept - chunks[0].byteLength >= maxBytes) {
+                kept -= chunks.shift().byteLength;
+            }
+        }
+        const buffer = Buffer.concat(chunks);
+        const tail = buffer.byteLength > maxBytes ? buffer.subarray(buffer.byteLength - maxBytes) : buffer;
+        return { text: tail.toString('utf8'), truncated: total > maxBytes };
+    }
+}
+//# sourceMappingURL=homebridge-client.js.map

package/dist/mcp/homebridge-client.js.map

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

package/dist/mcp/http.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Streamable HTTP transport for outside MCP clients. Every request needs
+ * `Authorization: Bearer <token>`; each MCP session gets its own server.
+ */
+import type { Server } from 'node:http';
+import type { HomebridgeClient } from './homebridge-client.js';
+import type { LiveSource } from './live.js';
+export declare const MCP_PATH = "/mcp";
+export interface HttpServerOptions {
+    port?: number;
+    /** Default 127.0.0.1. Binding elsewhere exposes Homebridge control to the network. */
+    host?: string;
+    /** Bearer token every request must carry. Required. */
+    token: string;
+    client: HomebridgeClient;
+    readOnly?: boolean;
+    live?: LiveSource | false;
+}
+export interface RunningHttpServer {
+    server: Server;
+    /** e.g. http://127.0.0.1:8582/mcp */
+    url: string;
+    close(): Promise<void>;
+}
+export declare function runHttpServer(options: HttpServerOptions): Promise<RunningHttpServer>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/mcp/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAC;AAKzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,eAAO,MAAM,QAAQ,SAAS,CAAC;AAG/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA+BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4F1F"}