@coffeerunhobby/mcp-ha-connect 2.2.1 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +1 -1
- package/README.md +24 -2
- package/dist/omadaClient/accessControl.d.ts +290 -0
- package/dist/omadaClient/accessControl.js +509 -0
- package/dist/omadaClient/accessControl.js.map +1 -0
- package/dist/omadaClient/client.d.ts +6 -1
- package/dist/omadaClient/client.js +12 -1
- package/dist/omadaClient/client.js.map +1 -1
- package/dist/omadaClient/diagnose.d.ts +68 -0
- package/dist/omadaClient/diagnose.js +164 -0
- package/dist/omadaClient/diagnose.js.map +1 -0
- package/dist/omadaClient/index.d.ts +9 -0
- package/dist/omadaClient/index.js +19 -0
- package/dist/omadaClient/index.js.map +1 -1
- package/dist/omadaClient/macGroups.d.ts +58 -0
- package/dist/omadaClient/macGroups.js +110 -0
- package/dist/omadaClient/macGroups.js.map +1 -0
- package/dist/omadaClient/serialize.d.ts +13 -0
- package/dist/omadaClient/serialize.js +29 -0
- package/dist/omadaClient/serialize.js.map +1 -0
- package/dist/omadaClient/timeRange.d.ts +41 -0
- package/dist/omadaClient/timeRange.js +109 -0
- package/dist/omadaClient/timeRange.js.map +1 -0
- package/dist/tools/infra/actions.d.ts +1 -1
- package/dist/tools/infra/actions.js +1 -1
- package/dist/tools/omada/accessControl.d.ts +151 -0
- package/dist/tools/omada/accessControl.js +158 -0
- package/dist/tools/omada/accessControl.js.map +1 -0
- package/dist/tools/omada/index.js +9 -0
- package/dist/tools/omada/index.js.map +1 -1
- package/dist/tools/omada/macGroups.d.ts +19 -0
- package/dist/tools/omada/macGroups.js +77 -0
- package/dist/tools/omada/macGroups.js.map +1 -0
- package/dist/tools/omada/namespace.js +16 -0
- package/dist/tools/omada/namespace.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +5 -1
- package/.codex/review-rules.md +0 -16
- package/.dockerignore +0 -8
- package/.gitattributes +0 -30
- package/.github/workflows/ci.yml +0 -193
- package/AGENTS.md +0 -389
- package/Dockerfile +0 -50
- package/docker-compose.yml +0 -23
- package/docs/CHANGELOG.md +0 -341
- package/docs/COVERAGE.md +0 -219
- package/docs/QUICK_START.md +0 -240
- package/eslint.config.js +0 -33
- package/n8n/ai-agent-safety-monitor.json +0 -355
- package/openapi.json +0 -1259
- package/scripts/check-version-sync.mjs +0 -69
- package/scripts/generate-jwt.ts +0 -121
- package/src/config.ts +0 -440
- package/src/haClient/automations.ts +0 -261
- package/src/haClient/calendars.ts +0 -94
- package/src/haClient/config.ts +0 -52
- package/src/haClient/devices.ts +0 -653
- package/src/haClient/entities.ts +0 -128
- package/src/haClient/events.ts +0 -689
- package/src/haClient/history.ts +0 -73
- package/src/haClient/index.ts +0 -336
- package/src/haClient/request.ts +0 -142
- package/src/haClient/services.ts +0 -45
- package/src/haClient/states.ts +0 -60
- package/src/haClient/updates.ts +0 -58
- package/src/haClient/wsCommand.ts +0 -44
- package/src/index.ts +0 -164
- package/src/localAI/index.ts +0 -88
- package/src/localAI/prompts.ts +0 -50
- package/src/localAI/providers/base.ts +0 -120
- package/src/localAI/providers/ollama.ts +0 -78
- package/src/localAI/providers/openai.ts +0 -86
- package/src/localAI/types.ts +0 -67
- package/src/omadaClient/auth.ts +0 -178
- package/src/omadaClient/client.ts +0 -337
- package/src/omadaClient/device.ts +0 -118
- package/src/omadaClient/index.ts +0 -310
- package/src/omadaClient/network.ts +0 -284
- package/src/omadaClient/request.ts +0 -365
- package/src/omadaClient/security.ts +0 -51
- package/src/omadaClient/site.ts +0 -344
- package/src/ownerQuestions/service.ts +0 -536
- package/src/permissions/index.ts +0 -143
- package/src/resources/index.ts +0 -213
- package/src/server/auth.ts +0 -175
- package/src/server/chatFace.ts +0 -789
- package/src/server/chatSlice.ts +0 -57
- package/src/server/common.ts +0 -170
- package/src/server/eventSubscription.ts +0 -343
- package/src/server/http.ts +0 -626
- package/src/server/instructions.ts +0 -97
- package/src/server/rateLimiter.ts +0 -227
- package/src/server/stdio.ts +0 -41
- package/src/server/stream.ts +0 -205
- package/src/tools/ai/analyzeSensors.ts +0 -33
- package/src/tools/ai/index.ts +0 -20
- package/src/tools/common.ts +0 -442
- package/src/tools/homeassistant/askOwner.ts +0 -133
- package/src/tools/homeassistant/automationControls.ts +0 -66
- package/src/tools/homeassistant/calendar.ts +0 -97
- package/src/tools/homeassistant/callService.ts +0 -25
- package/src/tools/homeassistant/controlClimate.ts +0 -68
- package/src/tools/homeassistant/controlCover.ts +0 -48
- package/src/tools/homeassistant/controlFan.ts +0 -44
- package/src/tools/homeassistant/controlLight.ts +0 -38
- package/src/tools/homeassistant/controlMediaPlayer.ts +0 -50
- package/src/tools/homeassistant/createAutomation.ts +0 -35
- package/src/tools/homeassistant/deleteAutomation.ts +0 -24
- package/src/tools/homeassistant/entityAction.ts +0 -35
- package/src/tools/homeassistant/entityGuard.ts +0 -28
- package/src/tools/homeassistant/getAllSensors.ts +0 -46
- package/src/tools/homeassistant/getAutomationTrace.ts +0 -30
- package/src/tools/homeassistant/getDomainSummary.ts +0 -29
- package/src/tools/homeassistant/getEntitiesByDomain.ts +0 -56
- package/src/tools/homeassistant/getHistory.ts +0 -24
- package/src/tools/homeassistant/getState.ts +0 -24
- package/src/tools/homeassistant/getStates.ts +0 -46
- package/src/tools/homeassistant/getVersion.ts +0 -21
- package/src/tools/homeassistant/index.ts +0 -121
- package/src/tools/homeassistant/listAutomations.ts +0 -35
- package/src/tools/homeassistant/listEntities.ts +0 -44
- package/src/tools/homeassistant/listPersons.ts +0 -46
- package/src/tools/homeassistant/sceneAndScript.ts +0 -53
- package/src/tools/homeassistant/searchEntities.ts +0 -58
- package/src/tools/homeassistant/sendNotification.ts +0 -179
- package/src/tools/homeassistant/systemTools.ts +0 -52
- package/src/tools/homeassistant/triggerAutomation.ts +0 -24
- package/src/tools/index.ts +0 -78
- package/src/tools/infra/actions.ts +0 -95
- package/src/tools/infra/index.ts +0 -138
- package/src/tools/omada/blockClient.ts +0 -28
- package/src/tools/omada/cyclePoePort.ts +0 -32
- package/src/tools/omada/deleteClient.ts +0 -27
- package/src/tools/omada/disableClientRateLimit.ts +0 -23
- package/src/tools/omada/getClient.ts +0 -14
- package/src/tools/omada/getDevice.ts +0 -14
- package/src/tools/omada/getFirewallSetting.ts +0 -14
- package/src/tools/omada/getInternetInfo.ts +0 -14
- package/src/tools/omada/getLanNetworkList.ts +0 -14
- package/src/tools/omada/getLanProfileList.ts +0 -14
- package/src/tools/omada/getPortForwardingStatus.ts +0 -26
- package/src/tools/omada/getRateLimitProfiles.ts +0 -14
- package/src/tools/omada/getSiteNtpStatus.ts +0 -14
- package/src/tools/omada/getSsidDetail.ts +0 -22
- package/src/tools/omada/getSsidList.ts +0 -21
- package/src/tools/omada/getSwitchStackDetail.ts +0 -14
- package/src/tools/omada/getThreatList.ts +0 -42
- package/src/tools/omada/getWlanGroupList.ts +0 -14
- package/src/tools/omada/graph.ts +0 -187
- package/src/tools/omada/index.ts +0 -153
- package/src/tools/omada/listBlockedClients.ts +0 -17
- package/src/tools/omada/listClients.ts +0 -14
- package/src/tools/omada/listClientsActivity.ts +0 -25
- package/src/tools/omada/listClientsPastConnections.ts +0 -44
- package/src/tools/omada/listDevices.ts +0 -14
- package/src/tools/omada/listDevicesStats.ts +0 -41
- package/src/tools/omada/listMostActiveClients.ts +0 -14
- package/src/tools/omada/listSites.ts +0 -18
- package/src/tools/omada/namespace.ts +0 -1164
- package/src/tools/omada/searchDevices.ts +0 -20
- package/src/tools/omada/setClientRateLimit.ts +0 -26
- package/src/tools/omada/setClientRateLimitProfile.ts +0 -25
- package/src/tools/omada/setSiteNtpServers.ts +0 -36
- package/src/tools/omada/setSsidEnabled.ts +0 -38
- package/src/tools/omada/unblockClient.ts +0 -26
- package/src/tools/types.ts +0 -11
- package/src/tools/utils/pagination-schema.ts +0 -27
- package/src/types/ai/index.ts +0 -11
- package/src/types/ai/types.ts +0 -67
- package/src/types/homeassistant/automations.ts +0 -43
- package/src/types/homeassistant/calendars.ts +0 -26
- package/src/types/homeassistant/config.ts +0 -14
- package/src/types/homeassistant/entities.ts +0 -14
- package/src/types/homeassistant/errors.ts +0 -33
- package/src/types/homeassistant/haConfig.ts +0 -7
- package/src/types/homeassistant/history.ts +0 -13
- package/src/types/homeassistant/index.ts +0 -46
- package/src/types/homeassistant/request.ts +0 -6
- package/src/types/homeassistant/serviceCall.ts +0 -18
- package/src/types/homeassistant/states.ts +0 -58
- package/src/types/homeassistant/updates.ts +0 -28
- package/src/types/index.ts +0 -12
- package/src/types/omada/activeClientInfo.ts +0 -17
- package/src/types/omada/clientActivity.ts +0 -32
- package/src/types/omada/clientBlockStatus.ts +0 -11
- package/src/types/omada/clientPastConnection.ts +0 -82
- package/src/types/omada/index.ts +0 -14
- package/src/types/omada/omadaApiResponse.ts +0 -5
- package/src/types/omada/omadaClientInfo.ts +0 -11
- package/src/types/omada/omadaDeviceInfo.ts +0 -11
- package/src/types/omada/omadaDeviceStats.ts +0 -31
- package/src/types/omada/omadaSiteSummary.ts +0 -5
- package/src/types/omada/oswStackDetail.ts +0 -11
- package/src/types/omada/paginatedResult.ts +0 -6
- package/src/types/omada/rateLimitProfile.ts +0 -58
- package/src/types/omada/threatInfo.ts +0 -38
- package/src/types/omada/tokenResult.ts +0 -6
- package/src/types.ts +0 -2
- package/src/utils/config-validations.ts +0 -68
- package/src/utils/jwt.ts +0 -112
- package/src/utils/logger.ts +0 -121
- package/src/utils/plainText.ts +0 -48
- package/src/utils/redact.ts +0 -59
- package/src/utils/sanitizeError.ts +0 -18
- package/src/utils/tlsDispatcher.ts +0 -69
- package/src/version.ts +0 -5
- package/tests/bdd/automation-creation.spec.ts +0 -214
- package/tests/bdd/automation-management.spec.ts +0 -267
- package/tests/bdd/calendar.spec.ts +0 -190
- package/tests/bdd/configuration.spec.ts +0 -283
- package/tests/bdd/device-control.spec.ts +0 -344
- package/tests/bdd/entity-listing.spec.ts +0 -208
- package/tests/bdd/entity-search.spec.ts +0 -183
- package/tests/bdd/history-retrieval.spec.ts +0 -195
- package/tests/bdd/notifications.spec.ts +0 -238
- package/tests/bdd/service-calls.spec.ts +0 -144
- package/tests/bdd/state-retrieval.spec.ts +0 -204
- package/tests/bench/hotpaths.bench.ts +0 -68
- package/tests/config.test.ts +0 -355
- package/tests/features/automation-creation.feature +0 -36
- package/tests/features/automation-management.feature +0 -54
- package/tests/features/calendar.feature +0 -37
- package/tests/features/configuration.feature +0 -70
- package/tests/features/device-control.feature +0 -100
- package/tests/features/entity-listing.feature +0 -51
- package/tests/features/entity-search.feature +0 -44
- package/tests/features/history-retrieval.feature +0 -38
- package/tests/features/notifications.feature +0 -37
- package/tests/features/service-calls.feature +0 -35
- package/tests/features/state-retrieval.feature +0 -37
- package/tests/fixtures/openapi-default-slice.json +0 -290
- package/tests/haClient/automationTrace.test.ts +0 -59
- package/tests/haClient/automations.test.ts +0 -149
- package/tests/haClient/config.test.ts +0 -117
- package/tests/haClient/entities.test.ts +0 -188
- package/tests/haClient/events.test.ts +0 -455
- package/tests/haClient/eventsTls.test.ts +0 -52
- package/tests/haClient/history.test.ts +0 -228
- package/tests/haClient/index.test.ts +0 -243
- package/tests/haClient/request.test.ts +0 -217
- package/tests/haClient/services.test.ts +0 -120
- package/tests/haClient/states.test.ts +0 -119
- package/tests/haClient/updates.test.ts +0 -193
- package/tests/index.test.ts +0 -160
- package/tests/integration/homeassistant.test.ts +0 -144
- package/tests/integration/omada.test.ts +0 -167
- package/tests/integration/server.test.ts +0 -151
- package/tests/localAI/index.test.ts +0 -177
- package/tests/localAI/ollama.test.ts +0 -187
- package/tests/localAI/openai.test.ts +0 -257
- package/tests/omadaClient/actions.test.ts +0 -161
- package/tests/omadaClient/clientBlocks.test.ts +0 -170
- package/tests/omadaClient/ntp.test.ts +0 -381
- package/tests/omadaClient/site.test.ts +0 -37
- package/tests/ownerQuestions/service.test.ts +0 -499
- package/tests/ownerQuestions/tools.test.ts +0 -186
- package/tests/permissions/index.test.ts +0 -217
- package/tests/resources/index.test.ts +0 -288
- package/tests/scripts/generateJwt.test.ts +0 -44
- package/tests/security/accessControl.test.ts +0 -223
- package/tests/security/authentication.test.ts +0 -117
- package/tests/security/configuration.test.ts +0 -170
- package/tests/security/cryptoTransport.test.ts +0 -172
- package/tests/security/dependencies.test.ts +0 -152
- package/tests/security/injection.test.ts +0 -117
- package/tests/security/insecureDesign.test.ts +0 -121
- package/tests/security/logging.test.ts +0 -131
- package/tests/security/resourceConsumption.test.ts +0 -142
- package/tests/server/auth.test.ts +0 -249
- package/tests/server/chatFace.test.ts +0 -320
- package/tests/server/common.test.ts +0 -84
- package/tests/server/http.test.ts +0 -561
- package/tests/server/instructions.test.ts +0 -152
- package/tests/server/memoizeJsonSchema.test.ts +0 -71
- package/tests/server/stdio.test.ts +0 -99
- package/tests/server/stream.test.ts +0 -285
- package/tests/server/toolVisibility.http.test.ts +0 -111
- package/tests/server/toolVisibility.test.ts +0 -129
- package/tests/tools/ai/analyzeSensors.test.ts +0 -227
- package/tests/tools/common.test.ts +0 -123
- package/tests/tools/homeassistant/handlers.test.ts +0 -872
- package/tests/tools/infra/invokeAction.test.ts +0 -280
- package/tests/tools/omada/graph.test.ts +0 -385
- package/tests/tools/omada/handlers.test.ts +0 -897
- package/tests/tools/omada/namespace.test.ts +0 -483
- package/tests/tools/registry.test.ts +0 -168
- package/tests/utils/config-validations.test.ts +0 -352
- package/tests/utils/jwt.test.ts +0 -115
- package/tests/utils/logger.test.ts +0 -327
- package/tests/utils/redact.test.ts +0 -105
- package/tsconfig.json +0 -24
- package/vitest.config.ts +0 -38
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* ServiceOperations tests
|
|
3
|
-
*/
|
|
4
|
-
|
|
5
|
-
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
|
6
|
-
import { ServiceOperations } from '../../src/haClient/services.js';
|
|
7
|
-
import type { RequestHandler } from '../../src/haClient/request.js';
|
|
8
|
-
|
|
9
|
-
describe('ServiceOperations', () => {
|
|
10
|
-
let mockRequest: RequestHandler;
|
|
11
|
-
let serviceOps: ServiceOperations;
|
|
12
|
-
|
|
13
|
-
beforeEach(() => {
|
|
14
|
-
mockRequest = {
|
|
15
|
-
post: vi.fn(),
|
|
16
|
-
} as unknown as RequestHandler;
|
|
17
|
-
|
|
18
|
-
serviceOps = new ServiceOperations(mockRequest);
|
|
19
|
-
});
|
|
20
|
-
|
|
21
|
-
describe('callService', () => {
|
|
22
|
-
it('should call service with domain and service name', async () => {
|
|
23
|
-
const mockResponse = {
|
|
24
|
-
context: { id: 'ctx-123', parent_id: null, user_id: 'user-456' },
|
|
25
|
-
};
|
|
26
|
-
(mockRequest.post as ReturnType<typeof vi.fn>).mockResolvedValue(mockResponse);
|
|
27
|
-
|
|
28
|
-
const result = await serviceOps.callService({
|
|
29
|
-
domain: 'light',
|
|
30
|
-
service: 'turn_on',
|
|
31
|
-
});
|
|
32
|
-
|
|
33
|
-
expect(result).toEqual(mockResponse);
|
|
34
|
-
expect(mockRequest.post).toHaveBeenCalledWith('/services/light/turn_on', {});
|
|
35
|
-
});
|
|
36
|
-
|
|
37
|
-
it('should include target entity_id', async () => {
|
|
38
|
-
const mockResponse = {
|
|
39
|
-
context: { id: 'ctx-123', parent_id: null, user_id: null },
|
|
40
|
-
};
|
|
41
|
-
(mockRequest.post as ReturnType<typeof vi.fn>).mockResolvedValue(mockResponse);
|
|
42
|
-
|
|
43
|
-
await serviceOps.callService({
|
|
44
|
-
domain: 'light',
|
|
45
|
-
service: 'turn_on',
|
|
46
|
-
target: { entity_id: 'light.living_room' },
|
|
47
|
-
});
|
|
48
|
-
|
|
49
|
-
expect(mockRequest.post).toHaveBeenCalledWith('/services/light/turn_on', {
|
|
50
|
-
entity_id: 'light.living_room',
|
|
51
|
-
});
|
|
52
|
-
});
|
|
53
|
-
|
|
54
|
-
it('should include service_data', async () => {
|
|
55
|
-
const mockResponse = {
|
|
56
|
-
context: { id: 'ctx-123', parent_id: null, user_id: null },
|
|
57
|
-
};
|
|
58
|
-
(mockRequest.post as ReturnType<typeof vi.fn>).mockResolvedValue(mockResponse);
|
|
59
|
-
|
|
60
|
-
await serviceOps.callService({
|
|
61
|
-
domain: 'light',
|
|
62
|
-
service: 'turn_on',
|
|
63
|
-
target: { entity_id: 'light.living_room' },
|
|
64
|
-
service_data: { brightness: 255, color_temp: 370 },
|
|
65
|
-
});
|
|
66
|
-
|
|
67
|
-
expect(mockRequest.post).toHaveBeenCalledWith('/services/light/turn_on', {
|
|
68
|
-
entity_id: 'light.living_room',
|
|
69
|
-
brightness: 255,
|
|
70
|
-
color_temp: 370,
|
|
71
|
-
});
|
|
72
|
-
});
|
|
73
|
-
|
|
74
|
-
it('should handle multiple entity targets', async () => {
|
|
75
|
-
const mockResponse = {
|
|
76
|
-
context: { id: 'ctx-123', parent_id: null, user_id: null },
|
|
77
|
-
};
|
|
78
|
-
(mockRequest.post as ReturnType<typeof vi.fn>).mockResolvedValue(mockResponse);
|
|
79
|
-
|
|
80
|
-
await serviceOps.callService({
|
|
81
|
-
domain: 'light',
|
|
82
|
-
service: 'turn_off',
|
|
83
|
-
target: { entity_id: ['light.living_room', 'light.bedroom'] },
|
|
84
|
-
});
|
|
85
|
-
|
|
86
|
-
expect(mockRequest.post).toHaveBeenCalledWith('/services/light/turn_off', {
|
|
87
|
-
entity_id: ['light.living_room', 'light.bedroom'],
|
|
88
|
-
});
|
|
89
|
-
});
|
|
90
|
-
|
|
91
|
-
it('should call climate service with temperature', async () => {
|
|
92
|
-
const mockResponse = {
|
|
93
|
-
context: { id: 'ctx-123', parent_id: null, user_id: null },
|
|
94
|
-
};
|
|
95
|
-
(mockRequest.post as ReturnType<typeof vi.fn>).mockResolvedValue(mockResponse);
|
|
96
|
-
|
|
97
|
-
await serviceOps.callService({
|
|
98
|
-
domain: 'climate',
|
|
99
|
-
service: 'set_temperature',
|
|
100
|
-
target: { entity_id: 'climate.living_room' },
|
|
101
|
-
service_data: { temperature: 22 },
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
expect(mockRequest.post).toHaveBeenCalledWith('/services/climate/set_temperature', {
|
|
105
|
-
entity_id: 'climate.living_room',
|
|
106
|
-
temperature: 22,
|
|
107
|
-
});
|
|
108
|
-
});
|
|
109
|
-
});
|
|
110
|
-
|
|
111
|
-
describe('restartServer', () => {
|
|
112
|
-
it('should call homeassistant restart service', async () => {
|
|
113
|
-
(mockRequest.post as ReturnType<typeof vi.fn>).mockResolvedValue({});
|
|
114
|
-
|
|
115
|
-
await serviceOps.restartServer();
|
|
116
|
-
|
|
117
|
-
expect(mockRequest.post).toHaveBeenCalledWith('/services/homeassistant/restart', {});
|
|
118
|
-
});
|
|
119
|
-
});
|
|
120
|
-
});
|
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* StateOperations tests
|
|
3
|
-
*/
|
|
4
|
-
|
|
5
|
-
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
|
6
|
-
import { StateOperations } from '../../src/haClient/states.js';
|
|
7
|
-
import type { RequestHandler } from '../../src/haClient/request.js';
|
|
8
|
-
import type { Entity } from '../../src/types/index.js';
|
|
9
|
-
import { ApiError } from '../../src/types/index.js';
|
|
10
|
-
|
|
11
|
-
describe('StateOperations', () => {
|
|
12
|
-
let mockRequest: RequestHandler;
|
|
13
|
-
let stateOps: StateOperations;
|
|
14
|
-
|
|
15
|
-
const mockEntities: Entity[] = [
|
|
16
|
-
{
|
|
17
|
-
entity_id: 'light.living_room',
|
|
18
|
-
state: 'on',
|
|
19
|
-
attributes: { friendly_name: 'Living Room Light', brightness: 255 },
|
|
20
|
-
last_changed: '2026-01-08T10:00:00.000Z',
|
|
21
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
22
|
-
context: { id: 'ctx-1', parent_id: null, user_id: null },
|
|
23
|
-
},
|
|
24
|
-
{
|
|
25
|
-
entity_id: 'sensor.temperature',
|
|
26
|
-
state: '22.5',
|
|
27
|
-
attributes: { friendly_name: 'Temperature', unit_of_measurement: '°C' },
|
|
28
|
-
last_changed: '2026-01-08T10:00:00.000Z',
|
|
29
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
30
|
-
context: { id: 'ctx-2', parent_id: null, user_id: null },
|
|
31
|
-
},
|
|
32
|
-
{
|
|
33
|
-
entity_id: 'binary_sensor.motion',
|
|
34
|
-
state: 'off',
|
|
35
|
-
attributes: { friendly_name: 'Motion Sensor', device_class: 'motion' },
|
|
36
|
-
last_changed: '2026-01-08T09:00:00.000Z',
|
|
37
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
38
|
-
context: { id: 'ctx-3', parent_id: null, user_id: null },
|
|
39
|
-
},
|
|
40
|
-
];
|
|
41
|
-
|
|
42
|
-
beforeEach(() => {
|
|
43
|
-
mockRequest = {
|
|
44
|
-
get: vi.fn(),
|
|
45
|
-
} as unknown as RequestHandler;
|
|
46
|
-
|
|
47
|
-
stateOps = new StateOperations(mockRequest);
|
|
48
|
-
});
|
|
49
|
-
|
|
50
|
-
describe('getStates', () => {
|
|
51
|
-
it('should fetch all states', async () => {
|
|
52
|
-
(mockRequest.get as ReturnType<typeof vi.fn>).mockResolvedValue(mockEntities);
|
|
53
|
-
|
|
54
|
-
const states = await stateOps.getStates();
|
|
55
|
-
|
|
56
|
-
expect(states).toEqual(mockEntities);
|
|
57
|
-
expect(mockRequest.get).toHaveBeenCalledWith('/states');
|
|
58
|
-
});
|
|
59
|
-
|
|
60
|
-
it('should return empty array when no entities exist', async () => {
|
|
61
|
-
(mockRequest.get as ReturnType<typeof vi.fn>).mockResolvedValue([]);
|
|
62
|
-
|
|
63
|
-
const states = await stateOps.getStates();
|
|
64
|
-
|
|
65
|
-
expect(states).toEqual([]);
|
|
66
|
-
});
|
|
67
|
-
});
|
|
68
|
-
|
|
69
|
-
describe('getState', () => {
|
|
70
|
-
it('should fetch specific entity state', async () => {
|
|
71
|
-
const entity = mockEntities[0];
|
|
72
|
-
(mockRequest.get as ReturnType<typeof vi.fn>).mockResolvedValue(entity);
|
|
73
|
-
|
|
74
|
-
const state = await stateOps.getState('light.living_room');
|
|
75
|
-
|
|
76
|
-
expect(state).toEqual(entity);
|
|
77
|
-
expect(mockRequest.get).toHaveBeenCalledWith('/states/light.living_room');
|
|
78
|
-
});
|
|
79
|
-
|
|
80
|
-
it('should return null when entity not found', async () => {
|
|
81
|
-
const error = new ApiError('Not found', 404, { path: '/states/nonexistent' });
|
|
82
|
-
(mockRequest.get as ReturnType<typeof vi.fn>).mockRejectedValue(error);
|
|
83
|
-
|
|
84
|
-
const state = await stateOps.getState('nonexistent');
|
|
85
|
-
|
|
86
|
-
expect(state).toBeNull();
|
|
87
|
-
});
|
|
88
|
-
|
|
89
|
-
it('should throw error for non-404 errors', async () => {
|
|
90
|
-
const error = new ApiError('Server error', 500, { path: '/states/test' });
|
|
91
|
-
(mockRequest.get as ReturnType<typeof vi.fn>).mockRejectedValue(error);
|
|
92
|
-
|
|
93
|
-
await expect(stateOps.getState('test')).rejects.toThrow(ApiError);
|
|
94
|
-
});
|
|
95
|
-
});
|
|
96
|
-
|
|
97
|
-
describe('getAllSensors', () => {
|
|
98
|
-
it('should return only sensor and binary_sensor entities', async () => {
|
|
99
|
-
(mockRequest.get as ReturnType<typeof vi.fn>).mockResolvedValue(mockEntities);
|
|
100
|
-
|
|
101
|
-
const sensors = await stateOps.getAllSensors();
|
|
102
|
-
|
|
103
|
-
expect(sensors).toHaveLength(2);
|
|
104
|
-
expect(sensors.map(s => s.entity_id)).toContain('sensor.temperature');
|
|
105
|
-
expect(sensors.map(s => s.entity_id)).toContain('binary_sensor.motion');
|
|
106
|
-
expect(sensors.map(s => s.entity_id)).not.toContain('light.living_room');
|
|
107
|
-
});
|
|
108
|
-
|
|
109
|
-
it('should return empty array when no sensors exist', async () => {
|
|
110
|
-
(mockRequest.get as ReturnType<typeof vi.fn>).mockResolvedValue([
|
|
111
|
-
{ ...mockEntities[0] }, // Only light entity
|
|
112
|
-
]);
|
|
113
|
-
|
|
114
|
-
const sensors = await stateOps.getAllSensors();
|
|
115
|
-
|
|
116
|
-
expect(sensors).toEqual([]);
|
|
117
|
-
});
|
|
118
|
-
});
|
|
119
|
-
});
|
|
@@ -1,193 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* UpdateOperations tests
|
|
3
|
-
*/
|
|
4
|
-
|
|
5
|
-
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
|
6
|
-
import { UpdateOperations } from '../../src/haClient/updates.js';
|
|
7
|
-
import type { EntityOperations } from '../../src/haClient/entities.js';
|
|
8
|
-
import type { Entity } from '../../src/types/index.js';
|
|
9
|
-
|
|
10
|
-
describe('UpdateOperations', () => {
|
|
11
|
-
let mockEntityOps: EntityOperations;
|
|
12
|
-
let updateOps: UpdateOperations;
|
|
13
|
-
|
|
14
|
-
const mockUpdateEntities: Entity[] = [
|
|
15
|
-
{
|
|
16
|
-
entity_id: 'update.home_assistant_core_update',
|
|
17
|
-
state: 'on', // Update available
|
|
18
|
-
attributes: {
|
|
19
|
-
friendly_name: 'Home Assistant Core Update',
|
|
20
|
-
title: 'Home Assistant Core',
|
|
21
|
-
installed_version: '2026.1.0',
|
|
22
|
-
latest_version: '2026.1.1',
|
|
23
|
-
},
|
|
24
|
-
last_changed: '2026-01-08T10:00:00.000Z',
|
|
25
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
26
|
-
context: { id: 'ctx-1', parent_id: null, user_id: null },
|
|
27
|
-
},
|
|
28
|
-
{
|
|
29
|
-
entity_id: 'update.home_assistant_supervisor_update',
|
|
30
|
-
state: 'off', // No update
|
|
31
|
-
attributes: {
|
|
32
|
-
friendly_name: 'Home Assistant Supervisor Update',
|
|
33
|
-
title: 'Home Assistant Supervisor',
|
|
34
|
-
installed_version: '2026.01.1',
|
|
35
|
-
latest_version: '2026.01.1',
|
|
36
|
-
},
|
|
37
|
-
last_changed: '2026-01-08T09:00:00.000Z',
|
|
38
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
39
|
-
context: { id: 'ctx-2', parent_id: null, user_id: null },
|
|
40
|
-
},
|
|
41
|
-
{
|
|
42
|
-
entity_id: 'update.home_assistant_operating_system_update',
|
|
43
|
-
state: 'on', // Update available
|
|
44
|
-
attributes: {
|
|
45
|
-
friendly_name: 'Home Assistant Operating System Update',
|
|
46
|
-
title: 'Home Assistant OS',
|
|
47
|
-
installed_version: '11.2',
|
|
48
|
-
latest_version: '11.3',
|
|
49
|
-
},
|
|
50
|
-
last_changed: '2026-01-08T08:00:00.000Z',
|
|
51
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
52
|
-
context: { id: 'ctx-3', parent_id: null, user_id: null },
|
|
53
|
-
},
|
|
54
|
-
{
|
|
55
|
-
entity_id: 'update.esphome_update',
|
|
56
|
-
state: 'on', // Update available
|
|
57
|
-
attributes: {
|
|
58
|
-
friendly_name: 'ESPHome Update',
|
|
59
|
-
title: 'ESPHome',
|
|
60
|
-
installed_version: '2025.12.1',
|
|
61
|
-
latest_version: '2026.1.0',
|
|
62
|
-
},
|
|
63
|
-
last_changed: '2026-01-08T07:00:00.000Z',
|
|
64
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
65
|
-
context: { id: 'ctx-4', parent_id: null, user_id: null },
|
|
66
|
-
},
|
|
67
|
-
];
|
|
68
|
-
|
|
69
|
-
beforeEach(() => {
|
|
70
|
-
mockEntityOps = {
|
|
71
|
-
getEntitiesByDomain: vi.fn().mockResolvedValue(mockUpdateEntities),
|
|
72
|
-
} as unknown as EntityOperations;
|
|
73
|
-
|
|
74
|
-
updateOps = new UpdateOperations(mockEntityOps);
|
|
75
|
-
});
|
|
76
|
-
|
|
77
|
-
describe('getAvailableUpdates', () => {
|
|
78
|
-
it('should fetch update entities', async () => {
|
|
79
|
-
const result = await updateOps.getAvailableUpdates();
|
|
80
|
-
|
|
81
|
-
expect(mockEntityOps.getEntitiesByDomain).toHaveBeenCalledWith('update');
|
|
82
|
-
expect(result.entities).toEqual(mockUpdateEntities);
|
|
83
|
-
});
|
|
84
|
-
|
|
85
|
-
it('should filter to only available updates (state = on)', async () => {
|
|
86
|
-
const result = await updateOps.getAvailableUpdates();
|
|
87
|
-
|
|
88
|
-
expect(result.updates).toHaveLength(3);
|
|
89
|
-
expect(result.updates.every(u => u.version_current !== u.version_latest)).toBe(true);
|
|
90
|
-
});
|
|
91
|
-
|
|
92
|
-
it('should categorize core updates', async () => {
|
|
93
|
-
const result = await updateOps.getAvailableUpdates();
|
|
94
|
-
|
|
95
|
-
const coreUpdate = result.updates.find(u => u.update_type === 'core');
|
|
96
|
-
expect(coreUpdate).toEqual({
|
|
97
|
-
update_type: 'core',
|
|
98
|
-
name: 'Home Assistant Core',
|
|
99
|
-
version_current: '2026.1.0',
|
|
100
|
-
version_latest: '2026.1.1',
|
|
101
|
-
});
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
it('should categorize OS updates', async () => {
|
|
105
|
-
const result = await updateOps.getAvailableUpdates();
|
|
106
|
-
|
|
107
|
-
const osUpdate = result.updates.find(u => u.update_type === 'os');
|
|
108
|
-
expect(osUpdate).toEqual({
|
|
109
|
-
update_type: 'os',
|
|
110
|
-
name: 'Home Assistant OS',
|
|
111
|
-
version_current: '11.2',
|
|
112
|
-
version_latest: '11.3',
|
|
113
|
-
});
|
|
114
|
-
});
|
|
115
|
-
|
|
116
|
-
it('should categorize addon updates', async () => {
|
|
117
|
-
const result = await updateOps.getAvailableUpdates();
|
|
118
|
-
|
|
119
|
-
const addonUpdate = result.updates.find(u => u.update_type === 'addon');
|
|
120
|
-
expect(addonUpdate).toEqual({
|
|
121
|
-
update_type: 'addon',
|
|
122
|
-
name: 'ESPHome',
|
|
123
|
-
version_current: '2025.12.1',
|
|
124
|
-
version_latest: '2026.1.0',
|
|
125
|
-
});
|
|
126
|
-
});
|
|
127
|
-
|
|
128
|
-
it('should return empty updates when all entities are up to date', async () => {
|
|
129
|
-
(mockEntityOps.getEntitiesByDomain as ReturnType<typeof vi.fn>).mockResolvedValue([
|
|
130
|
-
{
|
|
131
|
-
entity_id: 'update.test',
|
|
132
|
-
state: 'off', // No update
|
|
133
|
-
attributes: {
|
|
134
|
-
title: 'Test',
|
|
135
|
-
installed_version: '1.0.0',
|
|
136
|
-
latest_version: '1.0.0',
|
|
137
|
-
},
|
|
138
|
-
last_changed: '2026-01-08T10:00:00.000Z',
|
|
139
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
140
|
-
context: { id: 'ctx-1', parent_id: null, user_id: null },
|
|
141
|
-
},
|
|
142
|
-
]);
|
|
143
|
-
|
|
144
|
-
const result = await updateOps.getAvailableUpdates();
|
|
145
|
-
|
|
146
|
-
expect(result.updates).toEqual([]);
|
|
147
|
-
expect(result.entities).toHaveLength(1);
|
|
148
|
-
});
|
|
149
|
-
|
|
150
|
-
it('should handle entities without version info', async () => {
|
|
151
|
-
(mockEntityOps.getEntitiesByDomain as ReturnType<typeof vi.fn>).mockResolvedValue([
|
|
152
|
-
{
|
|
153
|
-
entity_id: 'update.incomplete',
|
|
154
|
-
state: 'on',
|
|
155
|
-
attributes: {
|
|
156
|
-
title: 'Incomplete',
|
|
157
|
-
// Missing installed_version and latest_version
|
|
158
|
-
},
|
|
159
|
-
last_changed: '2026-01-08T10:00:00.000Z',
|
|
160
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
161
|
-
context: { id: 'ctx-1', parent_id: null, user_id: null },
|
|
162
|
-
},
|
|
163
|
-
]);
|
|
164
|
-
|
|
165
|
-
const result = await updateOps.getAvailableUpdates();
|
|
166
|
-
|
|
167
|
-
// Should not include entities without version info
|
|
168
|
-
expect(result.updates).toEqual([]);
|
|
169
|
-
});
|
|
170
|
-
|
|
171
|
-
it('should use title or friendly_name for name', async () => {
|
|
172
|
-
(mockEntityOps.getEntitiesByDomain as ReturnType<typeof vi.fn>).mockResolvedValue([
|
|
173
|
-
{
|
|
174
|
-
entity_id: 'update.with_title',
|
|
175
|
-
state: 'on',
|
|
176
|
-
attributes: {
|
|
177
|
-
title: 'Title Name',
|
|
178
|
-
friendly_name: 'Friendly Name',
|
|
179
|
-
installed_version: '1.0',
|
|
180
|
-
latest_version: '2.0',
|
|
181
|
-
},
|
|
182
|
-
last_changed: '2026-01-08T10:00:00.000Z',
|
|
183
|
-
last_updated: '2026-01-08T10:00:00.000Z',
|
|
184
|
-
context: { id: 'ctx-1', parent_id: null, user_id: null },
|
|
185
|
-
},
|
|
186
|
-
]);
|
|
187
|
-
|
|
188
|
-
const result = await updateOps.getAvailableUpdates();
|
|
189
|
-
|
|
190
|
-
expect(result.updates[0].name).toBe('Title Name');
|
|
191
|
-
});
|
|
192
|
-
});
|
|
193
|
-
});
|
package/tests/index.test.ts
DELETED
|
@@ -1,160 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Index/Main entry point tests
|
|
3
|
-
*/
|
|
4
|
-
|
|
5
|
-
import { describe, it, expect } from 'vitest';
|
|
6
|
-
import type { EnvironmentConfig } from '../src/config.js';
|
|
7
|
-
|
|
8
|
-
describe('Main entry point', () => {
|
|
9
|
-
describe('Configuration loading', () => {
|
|
10
|
-
it('should require baseUrl and token', () => {
|
|
11
|
-
const validConfig: EnvironmentConfig = {
|
|
12
|
-
baseUrl: 'http://homeassistant.10.0.0.19.nip.io:8123',
|
|
13
|
-
token: 'test-token',
|
|
14
|
-
strictSsl: false,
|
|
15
|
-
timeout: 30000,
|
|
16
|
-
aiProvider: 'ollama',
|
|
17
|
-
aiUrl: 'http://ollama.10.0.0.17.nip.io:11434',
|
|
18
|
-
aiModel: 'qwen3:14b',
|
|
19
|
-
aiTimeout: 60000,
|
|
20
|
-
logLevel: 'info',
|
|
21
|
-
logFormat: 'plain',
|
|
22
|
-
useHttp: false,
|
|
23
|
-
stateful: false,
|
|
24
|
-
|
|
25
|
-
httpEnableHealthcheck: true,
|
|
26
|
-
httpAllowCors: true,
|
|
27
|
-
};
|
|
28
|
-
|
|
29
|
-
expect(validConfig.baseUrl).toBeDefined();
|
|
30
|
-
expect(validConfig.token).toBeDefined();
|
|
31
|
-
});
|
|
32
|
-
});
|
|
33
|
-
|
|
34
|
-
describe('Logger initialization', () => {
|
|
35
|
-
it('should use stderr in stdio mode to avoid MCP protocol interference', () => {
|
|
36
|
-
const stdioConfig = {
|
|
37
|
-
useHttp: false,
|
|
38
|
-
};
|
|
39
|
-
|
|
40
|
-
const useStderr = !stdioConfig.useHttp;
|
|
41
|
-
expect(useStderr).toBe(true);
|
|
42
|
-
});
|
|
43
|
-
|
|
44
|
-
it('should use stdout in HTTP mode', () => {
|
|
45
|
-
const httpConfig = {
|
|
46
|
-
useHttp: true,
|
|
47
|
-
};
|
|
48
|
-
|
|
49
|
-
const useStderr = !httpConfig.useHttp;
|
|
50
|
-
expect(useStderr).toBe(false);
|
|
51
|
-
});
|
|
52
|
-
});
|
|
53
|
-
|
|
54
|
-
describe('Server mode selection', () => {
|
|
55
|
-
it('should start stdio server when useHttp is false', () => {
|
|
56
|
-
const config = {
|
|
57
|
-
useHttp: false,
|
|
58
|
-
};
|
|
59
|
-
|
|
60
|
-
expect(config.useHttp).toBe(false);
|
|
61
|
-
// Would call startStdioServer
|
|
62
|
-
});
|
|
63
|
-
|
|
64
|
-
it('should start HTTP server when useHttp is true', () => {
|
|
65
|
-
const config = {
|
|
66
|
-
useHttp: true,
|
|
67
|
-
};
|
|
68
|
-
|
|
69
|
-
expect(config.useHttp).toBe(true);
|
|
70
|
-
// Would call startHttpServer
|
|
71
|
-
});
|
|
72
|
-
});
|
|
73
|
-
|
|
74
|
-
describe('Configuration logging', () => {
|
|
75
|
-
it('should log configuration without exposing token', () => {
|
|
76
|
-
const config = {
|
|
77
|
-
baseUrl: 'http://homeassistant.10.0.0.19.nip.io:8123',
|
|
78
|
-
token: 'super-secret-token',
|
|
79
|
-
strictSsl: false,
|
|
80
|
-
timeout: 30000,
|
|
81
|
-
useHttp: false,
|
|
82
|
-
};
|
|
83
|
-
|
|
84
|
-
// Log data should mask the token
|
|
85
|
-
const logData = {
|
|
86
|
-
baseUrl: config.baseUrl,
|
|
87
|
-
hasToken: !!config.token,
|
|
88
|
-
strictSsl: config.strictSsl,
|
|
89
|
-
timeout: config.timeout,
|
|
90
|
-
useHttp: config.useHttp,
|
|
91
|
-
};
|
|
92
|
-
|
|
93
|
-
expect(logData.hasToken).toBe(true);
|
|
94
|
-
expect(logData).not.toHaveProperty('token');
|
|
95
|
-
expect(JSON.stringify(logData)).not.toContain('super-secret-token');
|
|
96
|
-
});
|
|
97
|
-
|
|
98
|
-
it('should include useHttp in logs', () => {
|
|
99
|
-
const config = {
|
|
100
|
-
useHttp: true,
|
|
101
|
-
};
|
|
102
|
-
|
|
103
|
-
const logData = {
|
|
104
|
-
useHttp: config.useHttp,
|
|
105
|
-
};
|
|
106
|
-
|
|
107
|
-
expect(logData.useHttp).toBe(true);
|
|
108
|
-
});
|
|
109
|
-
|
|
110
|
-
it('should show useHttp as false in stdio mode logs', () => {
|
|
111
|
-
const config = {
|
|
112
|
-
useHttp: false,
|
|
113
|
-
};
|
|
114
|
-
|
|
115
|
-
const logData = {
|
|
116
|
-
useHttp: config.useHttp,
|
|
117
|
-
};
|
|
118
|
-
|
|
119
|
-
expect(logData.useHttp).toBe(false);
|
|
120
|
-
});
|
|
121
|
-
});
|
|
122
|
-
|
|
123
|
-
describe('Error handling', () => {
|
|
124
|
-
it('should set exit code on configuration error', () => {
|
|
125
|
-
let exitCode: number | undefined;
|
|
126
|
-
|
|
127
|
-
try {
|
|
128
|
-
throw new Error('Invalid configuration');
|
|
129
|
-
} catch (error) {
|
|
130
|
-
exitCode = 1;
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
expect(exitCode).toBe(1);
|
|
134
|
-
});
|
|
135
|
-
|
|
136
|
-
it('should set exit code on API connection error', () => {
|
|
137
|
-
let exitCode: number | undefined;
|
|
138
|
-
|
|
139
|
-
try {
|
|
140
|
-
throw new Error('Connection failed');
|
|
141
|
-
} catch (error) {
|
|
142
|
-
exitCode = 1;
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
expect(exitCode).toBe(1);
|
|
146
|
-
});
|
|
147
|
-
|
|
148
|
-
it('should set exit code on server start error', () => {
|
|
149
|
-
let exitCode: number | undefined;
|
|
150
|
-
|
|
151
|
-
try {
|
|
152
|
-
throw new Error('Server start failed');
|
|
153
|
-
} catch (error) {
|
|
154
|
-
exitCode = 1;
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
expect(exitCode).toBe(1);
|
|
158
|
-
});
|
|
159
|
-
});
|
|
160
|
-
});
|