@coffeerunhobby/mcp-ha-connect 0.5.0

package/dist/localAI/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Local AI Client Types
+ * Shared interfaces for AI provider implementations
+ */
+/**
+ * Supported AI provider types
+ * Use 'none' to explicitly disable AI features
+ */
+export type AIProviderType = 'ollama' | 'openai' | 'none';
+/**
+ * Sensor data input for analysis
+ */
+export interface SensorData {
+    [entity_id: string]: {
+        state: string;
+        unit?: string;
+        attributes?: Record<string, unknown>;
+    };
+}
+/**
+ * AI analysis result
+ */
+export interface AnalysisResult {
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    issue: string;
+    reasoning: string;
+    recommended_actions: string[];
+    ssh_diagnostics: string[];
+    confidence: number;
+    model: string;
+    provider: string;
+    response_time: number;
+}
+/**
+ * AI provider configuration
+ */
+export interface AIProviderConfig {
+    provider: AIProviderType;
+    baseUrl: string;
+    model: string;
+    timeout: number;
+    apiKey?: string;
+}
+/**
+ * AI provider interface - all providers must implement this
+ */
+export interface AIProviderInterface {
+    /**
+     * Analyze sensor data using AI
+     */
+    analyzeSensors(sensors: SensorData): Promise<AnalysisResult>;
+    /**
+     * Check if the AI provider is available
+     */
+    checkHealth(): Promise<boolean>;
+    /**
+     * Get the provider name
+     */
+    getProviderName(): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/localAI/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/localAI/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,SAAS,EAAE,MAAM,GAAG;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE7D;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;CAC3B"}

package/dist/localAI/types.js

@@ -0,0 +1,6 @@
+/**
+ * Local AI Client Types
+ * Shared interfaces for AI provider implementations
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/localAI/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/localAI/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/ollamaClient.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Ollama AI Client
+ * Handles AI analysis requests to Ollama
+ */
+import type { EnvironmentConfig } from './config.js';
+export interface SensorData {
+    [entity_id: string]: {
+        state: string;
+        unit?: string;
+        attributes?: Record<string, unknown>;
+    };
+}
+export interface AnalysisResult {
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    issue: string;
+    reasoning: string;
+    recommended_actions: string[];
+    ssh_diagnostics: string[];
+    confidence: number;
+    model: string;
+    response_time: number;
+}
+export declare class OllamaClient {
+    private baseUrl;
+    private model;
+    private timeout;
+    constructor(config: EnvironmentConfig);
+    /**
+     * Analyze sensors using Ollama AI
+     */
+    analyzeSensors(sensors: SensorData): Promise<AnalysisResult>;
+    /**
+     * Check if Ollama is available
+     */
+    checkHealth(): Promise<boolean>;
+}
+//# sourceMappingURL=ollamaClient.d.ts.map

package/dist/ollamaClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollamaClient.d.ts","sourceRoot":"","sources":["../src/ollamaClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAwBrD,MAAM,WAAW,UAAU;IACzB,CAAC,SAAS,EAAE,MAAM,GAAG;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,iBAAiB;IAMrC;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAmElE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAUtC"}

package/dist/ollamaClient.js

@@ -0,0 +1,110 @@
+/**
+ * Ollama AI Client
+ * Handles AI analysis requests to Ollama
+ */
+import { logger } from './utils/logger.js';
+// AI System prompt for sensor analysis (from original implementation)
+const AI_SYSTEM_PROMPT = `You are a home automation AI analyzing Home Assistant sensors.
+
+SEVERITY RULES:
+- critical: Gas/smoke/CO detected, fire, temp>40°C indoors, power spike>500%, door open>2h with alarm
+- high: Battery<10%, power spike>300%, door open>30min with alarm, temp>35°C
+- medium: Battery<20%, connectivity issues, minor anomalies
+- low: Informational warnings
+
+OUTPUT FORMAT (JSON only, no markdown):
+{
+  "severity": "critical|high|medium|low",
+  "issue": "brief description",
+  "reasoning": "detailed explanation",
+  "recommended_actions": ["action1", "action2"],
+  "ssh_diagnostics": ["command1", "command2"],
+  "confidence": 0.85
+}
+
+Respond with JSON only. No extra text.`;
+export class OllamaClient {
+    baseUrl;
+    model;
+    timeout;
+    constructor(config) {
+        this.baseUrl = config.ollamaUrl;
+        this.model = config.ollamaModel;
+        this.timeout = config.ollamaTimeout;
+    }
+    /**
+     * Analyze sensors using Ollama AI
+     */
+    async analyzeSensors(sensors) {
+        const sensorCount = Object.keys(sensors).length;
+        logger.info('Starting AI analysis', { sensorCount, model: this.model });
+        const startTime = Date.now();
+        const prompt = `${AI_SYSTEM_PROMPT}\n\nAnalyze these sensors: ${JSON.stringify(sensors)}\n\nProvide JSON only:`;
+        try {
+            const response = await fetch(`${this.baseUrl}/api/generate`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.model,
+                    prompt,
+                    stream: false,
+                    options: {
+                        temperature: 0.3,
+                        num_predict: 2000,
+                        num_ctx: 4096,
+                    },
+                }),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Ollama request failed: ${response.status} ${errorText}`);
+            }
+            const result = await response.json();
+            const aiText = result.response ?? '';
+            if (!aiText) {
+                throw new Error('Empty response from Ollama');
+            }
+            // Extract JSON from response (handles potential text around JSON)
+            const jsonMatch = aiText.match(/\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}/);
+            if (!jsonMatch) {
+                throw new Error(`No JSON found in AI response: ${aiText.substring(0, 200)}`);
+            }
+            const analysis = JSON.parse(jsonMatch[0]);
+            const elapsed = (Date.now() - startTime) / 1000;
+            logger.info('AI analysis complete', {
+                severity: analysis.severity,
+                elapsed: `${elapsed.toFixed(2)}s`,
+                model: this.model,
+            });
+            return {
+                ...analysis,
+                model: this.model,
+                response_time: parseFloat(elapsed.toFixed(2)),
+            };
+        }
+        catch (error) {
+            const elapsed = (Date.now() - startTime) / 1000;
+            logger.error('AI analysis failed', {
+                error: error instanceof Error ? error.message : String(error),
+                elapsed: `${elapsed.toFixed(2)}s`,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Check if Ollama is available
+     */
+    async checkHealth() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/tags`, {
+                signal: AbortSignal.timeout(5000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=ollamaClient.js.map

package/dist/ollamaClient.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Resources Registry
+ * Provides URI-based access to Home Assistant entities
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { HaClient } from '../haClient/index.js';
+/**
+ * Register all Home Assistant resources with the MCP server
+ */
+export declare function registerAllResources(server: Server, client: HaClient): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAwP3E"}

package/dist/resources/index.js

@@ -0,0 +1,238 @@
+/**
+ * MCP Resources Registry
+ * Provides URI-based access to Home Assistant entities
+ */
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, ListResourceTemplatesRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Register all Home Assistant resources with the MCP server
+ */
+export function registerAllResources(server, client) {
+    logger.debug('Registering MCP resources');
+    // List available resource templates
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+        return {
+            resourceTemplates: [
+                {
+                    uriTemplate: 'hass://entities/{entity_id}',
+                    name: 'Entity State',
+                    description: 'Get the current state of a specific Home Assistant entity',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'hass://entities/{entity_id}/detailed',
+                    name: 'Entity Detailed',
+                    description: 'Get detailed information about an entity including all attributes',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'hass://entities/domain/{domain}',
+                    name: 'Domain Entities',
+                    description: 'Get all entities for a specific domain',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'hass://search/{query}/{limit}',
+                    name: 'Search Entities',
+                    description: 'Search for entities matching a query with result limit',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // List concrete resources (the static entities resource)
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: 'hass://entities',
+                    name: 'All Entities',
+                    description: 'List all Home Assistant entities grouped by domain',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // Read resource content
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        logger.debug('Reading resource', { uri });
+        try {
+            // Parse the URI
+            const url = new URL(uri);
+            const path = url.pathname;
+            // hass://entities - List all entities grouped by domain
+            if (uri === 'hass://entities') {
+                const entities = await client.getStates();
+                // Group by domain
+                const grouped = {};
+                for (const entity of entities) {
+                    const domain = entity.entity_id.split('.')[0];
+                    if (!grouped[domain]) {
+                        grouped[domain] = [];
+                    }
+                    grouped[domain].push({
+                        entity_id: entity.entity_id,
+                        state: entity.state,
+                        friendly_name: entity.attributes.friendly_name,
+                    });
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                total: entities.length,
+                                domains: Object.keys(grouped).length,
+                                entities: grouped,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // hass://entities/{entity_id}/detailed - Detailed entity info
+            if (path.endsWith('/detailed')) {
+                const entityId = path.replace('/detailed', '').replace(/^\//, '');
+                const entity = await client.getState(entityId);
+                if (!entity) {
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({ error: 'Entity not found', entity_id: entityId }),
+                            },
+                        ],
+                    };
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                entity_id: entity.entity_id,
+                                state: entity.state,
+                                attributes: entity.attributes,
+                                last_changed: entity.last_changed,
+                                last_updated: entity.last_updated,
+                                context: entity.context,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // hass://entities/domain/{domain} - Entities by domain
+            if (path.startsWith('/domain/')) {
+                const domain = path.replace('/domain/', '');
+                const entities = await client.getEntitiesByDomain(domain);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                domain,
+                                count: entities.length,
+                                entities: entities.map(e => ({
+                                    entity_id: e.entity_id,
+                                    state: e.state,
+                                    friendly_name: e.attributes.friendly_name,
+                                })),
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // hass://search/{query}/{limit} - Search entities
+            if (path.startsWith('/search/')) {
+                const parts = path.replace('/search/', '').split('/');
+                const query = decodeURIComponent(parts[0] || '');
+                const limit = parseInt(parts[1] || '50', 10);
+                let entities = await client.searchEntities(query);
+                if (limit > 0) {
+                    entities = entities.slice(0, limit);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                query,
+                                limit,
+                                count: entities.length,
+                                entities: entities.map(e => ({
+                                    entity_id: e.entity_id,
+                                    state: e.state,
+                                    friendly_name: e.attributes.friendly_name,
+                                })),
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // hass://entities/{entity_id} - Simple entity state
+            const entityId = path.replace(/^\//, '');
+            if (entityId && !entityId.includes('/')) {
+                const entity = await client.getState(entityId);
+                if (!entity) {
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({ error: 'Entity not found', entity_id: entityId }),
+                            },
+                        ],
+                    };
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                entity_id: entity.entity_id,
+                                state: entity.state,
+                                friendly_name: entity.attributes.friendly_name,
+                                last_changed: entity.last_changed,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Unknown resource
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({ error: 'Unknown resource', uri }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Failed to read resource', {
+                uri,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            error: 'Failed to read resource',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    logger.info('MCP resources registered successfully', { resourceCount: 5 });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

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

package/dist/server/common.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Common MCP server creation
+ * Shared across all transport types (stdio, SSE, stream)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { HaClient } from '../haClient/index.js';
+import type { LocalAIClient } from '../localAI/index.js';
+export declare function createServer(client: HaClient, aiClient?: LocalAIClient): Server;
+//# sourceMappingURL=common.d.ts.map

package/dist/server/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/server/common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,CAyB/E"}

package/dist/server/common.js

@@ -0,0 +1,27 @@
+/**
+ * Common MCP server creation
+ * Shared across all transport types (stdio, SSE, stream)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { registerAllTools } from '../tools/registry.js';
+import { registerAllResources } from '../resources/index.js';
+import { logger } from '../utils/logger.js';
+export function createServer(client, aiClient) {
+    logger.debug('Creating MCP server instance');
+    const server = new Server({
+        name: 'mcp-ha-connect',
+        version: '0.4.0',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // Register all Home Assistant tools
+    registerAllTools(server, client, aiClient);
+    // Register all Home Assistant resources
+    registerAllResources(server, client);
+    logger.debug('MCP server instance created with 15 tools and 5 resources registered');
+    return server;
+}
+//# sourceMappingURL=common.js.map

package/dist/server/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/server/common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,YAAY,CAAC,MAAgB,EAAE,QAAwB;IACrE,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACd;KACF,CACF,CAAC;IAEF,oCAAoC;IACpC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE3C,wCAAwC;IACxC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,MAAM,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAErF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/eventSubscription.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SSE Event Subscription Endpoint
+ * Allows HTTP clients to subscribe to Home Assistant events via Server-Sent Events
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { EventSubscriber } from '../haClient/events.js';
+export interface SSEClient {
+    id: string;
+    res: ServerResponse;
+    subscriptionIds: string[];
+    domain?: string;
+    entityId?: string;
+    eventTypes?: string[];
+    createdAt: Date;
+    lastEventAt?: Date;
+    eventCount: number;
+}
+/**
+ * Handle SSE subscription request
+ */
+export declare function handleEventSubscription(req: IncomingMessage, res: ServerResponse, eventSubscriber: EventSubscriber): Promise<void>;
+/**
+ * Get list of active SSE clients
+ */
+export declare function getActiveClients(): Array<{
+    id: string;
+    domain?: string;
+    entityId?: string;
+    eventTypes?: string[];
+    createdAt: Date;
+    lastEventAt?: Date;
+    eventCount: number;
+}>;
+/**
+ * Get count of active SSE clients
+ */
+export declare function getClientCount(): number;
+/**
+ * Broadcast event to all matching clients
+ */
+export declare function broadcastEvent(event: string, data: unknown, filter?: {
+    domain?: string;
+    entityId?: string;
+}): void;
+/**
+ * Disconnect a specific client
+ */
+export declare function disconnectClient(clientId: string): boolean;
+/**
+ * Disconnect all clients
+ */
+export declare function disconnectAllClients(): number;
+//# sourceMappingURL=eventSubscription.d.ts.map

package/dist/server/eventSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventSubscription.d.ts","sourceRoot":"","sources":["../../src/server/eventSubscription.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAW,MAAM,uBAAuB,CAAC;AAGtE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,cAAc,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAuCD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,IAAI,CAAC,CAyKf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAUD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAcP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAW1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C"}