@coffeerunhobby/mcp-ha-connect 2.1.1 → 2.2.1

package/dist/ownerQuestions/service.js

@@ -0,0 +1,439 @@
+/**
+ * Owner questions: ask the owner a yes/no-style question as an actionable phone
+ * notification and collect the button they tap.
+ *
+ * Stateless by design: everything needed to recognise a question travels in
+ * signed identifiers, so a server restart does not lose open questions.
+ *  - The requestId given to the caller carries the question, title, buttons,
+ *    target, expiry, the asking token's `sub` and a random nonce, signed with a
+ *    key derived from the server secret.
+ *  - Each button's action id carries the nonce, the button index, the expiry,
+ *    the target and its own signature, so a tap that arrives after a restart is
+ *    still verified and attributed. The secret never leaves the server, and the
+ *    requestId is not enough to forge a button id.
+ * Only answers (and cancellations) are kept in memory until they are read. A tap
+ * that lands while the server is down is lost; the question then expires as NO.
+ *
+ * A tap counts only if Home Assistant reports it as coming from a mobile app
+ * webhook (origin REMOTE, with a user), so an automation that fires a fake
+ * `mobile_app_notification_action` event (origin LOCAL) cannot approve anything.
+ * With `allowedUserIds` (MCP_OWNER_QUESTIONS_HA_USERS) only those HA users can answer.
+ *
+ * Known limit, accepted: cancellations and answers are remembered in memory
+ * only, while a button's signed id stays valid until the question expires. After
+ * a restart, re-sending an old button id through Home Assistant's own API (which
+ * needs an HA login, and the id from HA's history) could answer a question that
+ * had been cancelled or denied. The phone itself no longer shows the buttons.
+ * Anyone with that access can already control the house directly.
+ */
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+import { logger } from '../utils/logger.js';
+export const ACTION_EVENT = 'mobile_app_notification_action';
+export const LIMITS = {
+    questionChars: 256,
+    titleChars: 60,
+    buttonChars: 20,
+    maxButtons: 3,
+    minTimeoutSeconds: 60,
+    maxTimeoutSeconds: 7 * 24 * 60 * 60,
+    defaultTimeoutSeconds: 600,
+    maxWaitSeconds: 50,
+    maxOpenPerCaller: 3,
+    maxPerCallerPerHour: 30,
+};
+const REQUEST_PREFIX = 'q1';
+const ACTION_PREFIX = 'MCPASK';
+/** How long the confirmation that replaces an answered question stays on the phone. */
+const CONFIRMATION_SECONDS = 300;
+/** Outcomes stay readable this long after their question expired. */
+const OUTCOME_RETENTION_MS = 24 * 60 * 60 * 1000;
+const SWEEP_INTERVAL_MS = 10 * 60 * 1000;
+const b64url = (buffer) => buffer.toString('base64url');
+export class OwnerQuestionService {
+    deps;
+    key;
+    now;
+    /** Final outcomes by nonce, until the question's expiry passes. */
+    outcomes = new Map();
+    /** Open questions per caller sub: nonce -> expiry (ms). */
+    open = new Map();
+    /** Ask timestamps per caller sub, for the hourly cap. */
+    asked = new Map();
+    /** Pollers waiting for an outcome, by nonce. */
+    waiters = new Map();
+    /** Expiry timers by nonce (best effort: lost on restart; the phone also times out on its own). */
+    expiryTimers = new Map();
+    /** Labels and target of open questions, for nicer confirmations while the server stays up. */
+    known = new Map();
+    sweepTimer;
+    /** Why questions cannot be answered right now (Home Assistant refused the tap subscription). */
+    unavailable;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+        if (deps.secret) {
+            this.key = createHmac('sha256', deps.secret).update('mcp-ha-connect/owner-questions/v1').digest();
+        }
+        else {
+            this.key = randomBytes(32);
+            logger.warn('Owner questions: no server secret configured; open questions will not survive a restart');
+        }
+    }
+    async start() {
+        await this.deps.subscribe(ACTION_EVENT, (event) => this.handleActionEvent(event), () => {
+            this.unavailable =
+                'Home Assistant refused the subscription to notification taps (the server needs an admin Home Assistant token)';
+            logger.error(`Owner questions unavailable: ${this.unavailable}`);
+        });
+        this.sweepTimer = setInterval(() => this.sweep(), SWEEP_INTERVAL_MS);
+        this.sweepTimer.unref?.();
+        logger.info('Owner questions: listening for notification taps');
+        if (!this.deps.allowedUserIds?.length) {
+            logger.warn('Owner questions: any Home Assistant user can answer; set MCP_OWNER_QUESTIONS_HA_USERS to restrict it');
+        }
+    }
+    stop() {
+        clearInterval(this.sweepTimer);
+        for (const timer of this.expiryTimers.values())
+            clearTimeout(timer);
+        this.expiryTimers.clear();
+    }
+    async ask(input, caller) {
+        if (this.unavailable) {
+            throw new Error(`Owner questions are unavailable: ${this.unavailable}`);
+        }
+        const now = this.now();
+        this.enforceRateLimits(caller, now);
+        const nonce = b64url(randomBytes(16));
+        const expiresAtSec = Math.floor(now / 1000) + input.timeoutSeconds;
+        const payload = {
+            v: 1,
+            n: nonce,
+            s: caller,
+            t: input.target,
+            e: expiresAtSec,
+            b: input.buttons,
+            q: input.question,
+            ti: input.title,
+        };
+        const requestId = this.signRequest(payload);
+        const data = {
+            tag: this.tagFor(nonce),
+            actions: input.buttons.map((title, index) => ({
+                action: this.actionId(nonce, index, expiresAtSec, input.target),
+                title,
+            })),
+            // Stays until answered: not dismissed by tapping the body (sticky) or by
+            // swiping (persistent, needs the tag); the phone removes it at expiry.
+            sticky: true,
+            persistent: true,
+            priority: 'high',
+            ttl: 0,
+            timeout: input.timeoutSeconds,
+        };
+        if (input.channel)
+            data.channel = input.channel;
+        if (input.importance)
+            data.importance = input.importance;
+        // Reserve the slot before sending, so concurrent calls cannot all pass the limits.
+        this.reserve(caller, nonce, expiresAtSec * 1000, now);
+        try {
+            await this.deps.notify(input.target, { title: input.title, message: input.question, data });
+        }
+        catch {
+            // The underlying error can carry request details; neither the caller
+            // nor this log gets its text.
+            this.release(caller, nonce, now);
+            logger.warn('Owner questions: sending the notification failed', { target: input.target });
+            throw new Error(`Could not send the notification through Home Assistant (is '${input.target}' a valid notify target?)`);
+        }
+        this.known.set(nonce, { target: input.target, title: input.title, buttons: input.buttons, expiresAt: expiresAtSec * 1000 });
+        // Count from now, after delivery: the signed expiry is what matters.
+        this.scheduleExpiry(nonce, Math.max(expiresAtSec * 1000 - this.now(), 0));
+        logger.info('Owner question sent', { caller, target: input.target, buttons: input.buttons.length, expiresAt: expiresAtSec });
+        return { requestId, expiresAt: new Date(expiresAtSec * 1000).toISOString() };
+    }
+    async getAnswer(requestId, caller, waitSeconds) {
+        const payload = this.verifyRequest(requestId);
+        if (!payload) {
+            return { status: 'unknown', reason: 'Not a valid question id from this server (or the server secret changed)' };
+        }
+        this.assertOwner(payload, caller);
+        const settled = this.settledAnswer(payload);
+        if (settled || waitSeconds <= 0) {
+            return settled ?? this.pendingAnswer(payload);
+        }
+        const untilExpiry = payload.e * 1000 - this.now();
+        await this.waitForOutcome(payload.n, Math.min(waitSeconds * 1000, Math.max(untilExpiry, 0)));
+        return this.settledAnswer(payload) ?? this.pendingAnswer(payload);
+    }
+    async cancel(requestId, caller) {
+        const payload = this.verifyRequest(requestId);
+        if (!payload) {
+            return { status: 'unknown', reason: 'Not a valid question id from this server (or the server secret changed)' };
+        }
+        this.assertOwner(payload, caller);
+        const settled = this.settledAnswer(payload);
+        if (settled) {
+            return settled;
+        }
+        this.settle(payload.n, { status: 'cancelled', cancelledAt: this.now() }, payload.e * 1000);
+        await this.replaceNotification(payload.n, payload.t, payload.ti, 'Cancelled - no answer needed');
+        return this.settledAnswer(payload);
+    }
+    /** Handle a `mobile_app_notification_action` event. Exposed for tests. */
+    handleActionEvent(event) {
+        const parsed = this.parseActionId(event.data.action);
+        if (!parsed) {
+            return; // not one of ours
+        }
+        if (event.origin !== 'REMOTE' || !event.context.user_id) {
+            logger.warn('Owner questions: ignored a tap not coming from a mobile app', { origin: event.origin });
+            return;
+        }
+        if (this.deps.allowedUserIds?.length && !this.deps.allowedUserIds.includes(event.context.user_id)) {
+            logger.warn('Owner questions: ignored a tap from a Home Assistant user that may not answer');
+            return;
+        }
+        const { nonce, index, expiresAtSec, target } = parsed;
+        const known = this.known.get(nonce);
+        if (this.now() >= expiresAtSec * 1000) {
+            logger.info('Owner questions: ignored a tap after expiry');
+            void this.replaceNotification(nonce, target, known?.title ?? 'Question', 'Expired - the answer was not recorded');
+            return;
+        }
+        if (this.outcomes.has(nonce)) {
+            return; // first tap wins
+        }
+        this.settle(nonce, { status: 'answered', index, answeredAt: this.now(), answeredBy: event.context.user_id }, expiresAtSec * 1000);
+        logger.info('Owner question answered', { index });
+        const label = known?.buttons[index];
+        void this.replaceNotification(nonce, target, known?.title ?? 'Question', label ? `Answered: ${label}` : 'Answer recorded');
+    }
+    // ---- internals -------------------------------------------------------
+    signRequest(payload) {
+        const body = `${REQUEST_PREFIX}.${b64url(Buffer.from(JSON.stringify(payload), 'utf8'))}`;
+        return `${body}.${b64url(this.hmac(`request|${body}`))}`;
+    }
+    verifyRequest(requestId) {
+        const parts = typeof requestId === 'string' ? requestId.split('.') : [];
+        if (parts.length !== 3 || parts[0] !== REQUEST_PREFIX) {
+            return null;
+        }
+        const body = `${parts[0]}.${parts[1]}`;
+        if (!this.safeEqual(parts[2], b64url(this.hmac(`request|${body}`)))) {
+            return null;
+        }
+        try {
+            const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf8'));
+            return payload.v === 1 ? payload : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    actionId(nonce, index, expiresAtSec, target) {
+        const sig = b64url(this.hmac(`action|${nonce}|${index}|${expiresAtSec}|${target}`)).slice(0, 22);
+        return `${ACTION_PREFIX}.${nonce}.${index}.${expiresAtSec}.${target}.${sig}`;
+    }
+    parseActionId(action) {
+        if (typeof action !== 'string' || !action.startsWith(`${ACTION_PREFIX}.`)) {
+            return null;
+        }
+        const match = /^MCPASK\.([A-Za-z0-9_-]{22})\.([0-2])\.(\d{1,12})\.(mobile_app_[a-z0-9_]{1,64})\.([A-Za-z0-9_-]{22})$/.exec(action);
+        if (!match) {
+            logger.warn('Owner questions: ignored a malformed action id');
+            return null;
+        }
+        const [, nonce, index, expires, target, sig] = match;
+        const expected = b64url(this.hmac(`action|${nonce}|${index}|${expires}|${target}`)).slice(0, 22);
+        if (!this.safeEqual(sig, expected)) {
+            logger.warn('Owner questions: ignored a tap with an invalid signature');
+            return null;
+        }
+        return { nonce, index: Number(index), expiresAtSec: Number(expires), target };
+    }
+    hmac(message) {
+        return createHmac('sha256', this.key).update(message).digest();
+    }
+    safeEqual(a, b) {
+        const left = Buffer.from(a);
+        const right = Buffer.from(b);
+        return left.length === right.length && timingSafeEqual(left, right);
+    }
+    tagFor(nonce) {
+        return `mcpask-${nonce}`;
+    }
+    assertOwner(payload, caller) {
+        if (payload.s !== caller) {
+            throw new Error('This question was asked by a different client');
+        }
+    }
+    settledAnswer(payload) {
+        const base = { question: payload.q, buttons: payload.b };
+        const outcome = this.outcomes.get(payload.n);
+        if (outcome?.status === 'answered') {
+            return {
+                status: 'answered',
+                index: outcome.index,
+                button: payload.b[outcome.index] ?? `#${outcome.index}`,
+                answeredAt: new Date(outcome.answeredAt).toISOString(),
+                answeredBy: outcome.answeredBy,
+                ...base,
+            };
+        }
+        if (outcome?.status === 'cancelled') {
+            return { status: 'cancelled', cancelledAt: new Date(outcome.cancelledAt).toISOString(), ...base };
+        }
+        if (this.now() >= payload.e * 1000) {
+            return { status: 'timeout', expiredAt: new Date(payload.e * 1000).toISOString(), ...base };
+        }
+        return null;
+    }
+    pendingAnswer(payload) {
+        return { status: 'pending', expiresAt: new Date(payload.e * 1000).toISOString(), question: payload.q, buttons: payload.b };
+    }
+    settle(nonce, outcome, expiresAtMs) {
+        this.outcomes.set(nonce, { ...outcome, expiresAt: expiresAtMs });
+        this.known.delete(nonce);
+        for (const questions of this.open.values()) {
+            questions.delete(nonce);
+        }
+        const timer = this.expiryTimers.get(nonce);
+        if (timer) {
+            clearTimeout(timer);
+            this.expiryTimers.delete(nonce);
+        }
+        this.wake(nonce);
+    }
+    wake(nonce) {
+        for (const resolve of this.waiters.get(nonce) ?? []) {
+            resolve();
+        }
+        this.waiters.delete(nonce);
+    }
+    waitForOutcome(nonce, ms) {
+        return new Promise((resolve) => {
+            const waiters = this.waiters.get(nonce) ?? new Set();
+            this.waiters.set(nonce, waiters);
+            const done = () => {
+                clearTimeout(timer);
+                waiters.delete(done);
+                if (waiters.size === 0 && this.waiters.get(nonce) === waiters) {
+                    this.waiters.delete(nonce);
+                }
+                resolve();
+            };
+            const timer = setTimeout(done, ms);
+            waiters.add(done);
+        });
+    }
+    scheduleExpiry(nonce, ms) {
+        // Node timers overflow above ~24.8 days; questions last at most 7 days.
+        const timer = setTimeout(() => {
+            this.expiryTimers.delete(nonce);
+            if (this.outcomes.has(nonce)) {
+                return;
+            }
+            for (const questions of this.open.values()) {
+                questions.delete(nonce);
+            }
+            this.wake(nonce);
+            const known = this.known.get(nonce);
+            this.known.delete(nonce);
+            if (known) {
+                void this.replaceNotification(nonce, known.target, known.title, 'Expired - treated as no');
+            }
+        }, ms);
+        timer.unref?.();
+        this.expiryTimers.set(nonce, timer);
+    }
+    async replaceNotification(nonce, target, title, message) {
+        try {
+            // Same tag replaces the question; no actions, dismissible, gone after a while.
+            await this.deps.notify(target, {
+                title,
+                message,
+                data: { tag: this.tagFor(nonce), sticky: false, persistent: false, timeout: CONFIRMATION_SECONDS },
+            });
+        }
+        catch {
+            logger.warn('Owner questions: could not update the notification', { target });
+        }
+    }
+    enforceRateLimits(caller, now) {
+        const open = this.open.get(caller);
+        if (open) {
+            for (const [nonce, expiresAt] of open) {
+                if (expiresAt <= now)
+                    open.delete(nonce);
+            }
+            if (open.size >= LIMITS.maxOpenPerCaller) {
+                throw new Error(`Too many open questions (${open.size}); answer, cancel or wait for one to expire first`);
+            }
+        }
+        const recent = (this.asked.get(caller) ?? []).filter((t) => t > now - 60 * 60 * 1000);
+        if (recent.length >= LIMITS.maxPerCallerPerHour) {
+            throw new Error(`Too many questions in the last hour (limit ${LIMITS.maxPerCallerPerHour})`);
+        }
+        this.asked.set(caller, recent);
+    }
+    reserve(caller, nonce, expiresAtMs, now) {
+        const open = this.open.get(caller) ?? new Map();
+        open.set(nonce, expiresAtMs);
+        this.open.set(caller, open);
+        const asked = this.asked.get(caller) ?? [];
+        asked.push(now);
+        this.asked.set(caller, asked);
+    }
+    release(caller, nonce, now) {
+        this.open.get(caller)?.delete(nonce);
+        const asked = this.asked.get(caller);
+        const index = asked?.lastIndexOf(now) ?? -1;
+        if (asked && index >= 0)
+            asked.splice(index, 1);
+    }
+    /**
+     * Periodic cleanup, independent of new activity: outcomes a day after their
+     * question expired (a caller polling that late sees "timeout"), labels of
+     * expired questions, and rate-limit entries that no longer count.
+     * Exposed for tests.
+     */
+    sweep() {
+        const now = this.now();
+        for (const [nonce, outcome] of this.outcomes) {
+            if (outcome.expiresAt + OUTCOME_RETENTION_MS < now)
+                this.outcomes.delete(nonce);
+        }
+        for (const [nonce, known] of this.known) {
+            if (known.expiresAt < now)
+                this.known.delete(nonce);
+        }
+        for (const [caller, open] of this.open) {
+            for (const [nonce, expiresAt] of open) {
+                if (expiresAt <= now)
+                    open.delete(nonce);
+            }
+            if (open.size === 0)
+                this.open.delete(caller);
+        }
+        for (const [caller, asked] of this.asked) {
+            const recent = asked.filter((t) => t > now - 60 * 60 * 1000);
+            if (recent.length === 0)
+                this.asked.delete(caller);
+            else
+                this.asked.set(caller, recent);
+        }
+    }
+    /** Sizes of the in-memory state, for tests and diagnostics. */
+    stateSize() {
+        return {
+            outcomes: this.outcomes.size,
+            known: this.known.size,
+            open: this.open.size,
+            asked: this.asked.size,
+            waiters: this.waiters.size,
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/ownerQuestions/service.js.map

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

package/dist/server/common.d.ts

@@ -9,6 +9,7 @@ import type { LocalAIClient } from '../localAI/index.js';
 import type { OmadaClient } from '../omadaClient/index.js';
 import type { OmadaRegistrationMode } from '../tools/omada/index.js';
 import type { RestAction } from '../tools/infra/index.js';
+import type { OwnerQuestionService } from '../ownerQuestions/service.js';
 export interface CreateServerOptions {
     haClient?: HaClient;
     omadaClient?: OmadaClient;
@@ -24,6 +25,8 @@ export interface CreateServerOptions {
      * Execution-time RBAC in wrapToolHandler still applies either way.
      */
     callerPermissions?: number;
+    /** Owner questions service (askOwner & co.), when running. */
+    ownerQuestions?: OwnerQuestionService;
 }
 export declare function createServer(options: CreateServerOptions): McpServer;
 /**

package/dist/server/common.js

@@ -10,7 +10,7 @@ import { generateInstructions } from './instructions.js';
 import { logger } from '../utils/logger.js';
 import { VERSION } from '../version.js';
 export function createServer(options) {
-    const { haClient, omadaClient, aiClient, restActions, toolRegistrationMode, callerPermissions } = options;
+    const { haClient, omadaClient, aiClient, restActions, toolRegistrationMode, callerPermissions, ownerQuestions } = options;
     logger.debug('Creating MCP server instance');
     // Generate instructions based on enabled plugins
     const instructions = generateInstructions({
@@ -45,6 +45,7 @@ export function createServer(options) {
             aiClient,
             restActions,
             toolRegistrationMode,
+            ownerQuestions,
         });
     }
     finally {

package/dist/server/common.js.map

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

package/dist/server/http.js

@@ -10,6 +10,7 @@ import { handleEventSubscription } from './eventSubscription.js';
 import { RateLimiter } from './rateLimiter.js';
 import { createAuthMiddleware } from './auth.js';
 import { sanitizeError } from '../utils/sanitizeError.js';
+import { OwnerQuestionService } from '../ownerQuestions/service.js';
 import { LEGACY_BINDINGS, resolveChatBindings, buildOpenApiSpec, dispatchChatRequest, requiredPermissionFor, } from './chatFace.js';
 // Session storage for stateful mode
 const sessions = new Map();
@@ -278,23 +279,45 @@ export async function startHttpServer(options) {
         issuer: config.authIssuer,
         audience: config.authAudience,
     });
-    // Initialize event subscriber if SSE events are enabled and HA is configured
+    // Initialize the HA event subscriber when SSE events or owner questions need it
     let eventSubscriber = null;
-    if (config.sseEventsEnabled && config.baseUrl && config.token) {
+    if ((config.sseEventsEnabled || config.ownerQuestionsEnabled) && config.baseUrl && config.token) {
         eventSubscriber = new EventSubscriber({
             baseUrl: config.baseUrl,
             token: config.token,
+            strictSsl: config.strictSsl,
         });
-        // Connect to Home Assistant WebSocket
+        // Connect to Home Assistant WebSocket. On failure the subscriber keeps
+        // retrying in the background; it is kept (not dropped) so events and owner
+        // questions start working as soon as Home Assistant is reachable.
         try {
             await eventSubscriber.connect();
             logger.info('Event subscriber connected to Home Assistant');
         }
         catch (error) {
-            logger.warn('Failed to connect event subscriber, SSE events will be unavailable', {
+            logger.warn('Home Assistant WebSocket not reachable yet; retrying in the background', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // Owner questions (askOwner & co.) listen for notification taps on the subscriber.
+    let ownerQuestions;
+    if (config.ownerQuestionsEnabled && eventSubscriber && client) {
+        const subscriber = eventSubscriber;
+        const service = new OwnerQuestionService({
+            notify: (target, serviceData) => client.callService({ domain: 'notify', service: target, service_data: serviceData }),
+            subscribe: (eventType, callback, onRejected) => subscriber.subscribeEventType(eventType, callback, onRejected),
+            secret: config.authSecret,
+            allowedUserIds: config.ownerQuestionsHaUsers,
+        });
+        try {
+            await service.start();
+            ownerQuestions = service;
+        }
+        catch (error) {
+            logger.warn('Owner questions unavailable: could not subscribe to notification taps', {
                 error: error instanceof Error ? error.message : String(error),
             });
-            eventSubscriber = null;
         }
     }
     logger.info('Starting HTTP server', {
@@ -402,7 +425,7 @@ export async function startHttpServer(options) {
                 const sessionId = req.headers['mcp-session-id'];
                 const existingState = sessionId ? sessions.get(sessionId) : undefined;
                 const body = req.method !== 'GET' ? await parseBody(req) : undefined;
-                const streamOptions = { haClient: client, omadaClient, aiClient, config };
+                const streamOptions = { haClient: client, omadaClient, aiClient, config, ownerQuestions };
                 const state = await handleStreamRequest(streamOptions, req, res, body, existingState);
                 if (state && config.stateful && sessionId) {
                     sessions.set(sessionId, state);
@@ -474,6 +497,7 @@ export async function startHttpServer(options) {
         }
         sessions.clear();
         // Close event subscriber
+        ownerQuestions?.stop();
         if (eventSubscriber) {
             eventSubscriber.disconnect();
         }