odelic 0.2.0 → 0.2.2

package/dist/crypto.js

@@ -0,0 +1,111 @@
+/**
+ * Pairlink connected-mesh crypto.
+ *
+ * Reverse-engineered from libnative-lib.so in the ODELIC app (jp.co.odelic.smt.remote10):
+ *
+ * - key material = HomeID (4B, little endian) and password (4 ASCII bytes) interleaved
+ *                  -> h0 p0 h1 p1 h2 p2 h3 p3
+ * - login key    = material + "LOGINKEY"   (AES-128)
+ * - event key    = material + "EVENTKEY"   (AES-128)
+ * - login        : node sends 02 20 <AES_LK(homeid | session4 | pad)>,
+ *                  we answer 01 16 03 <AES_LK(homeid | pwd | session4 | pad)>
+ * - data packets : 03 <dst4> <ch> <payload>  ->  06 <dst4> <ch> XOR4(AES_EK(pkcs7(payload)), session4)
+ */
+import { createCipheriv, createDecipheriv } from 'node:crypto';
+import { InputError, LoginError } from './errors.js';
+/** AES-128-ECB without padding; `data` must be a multiple of 16 bytes. */
+export function aes128(key, data, { decrypt = false } = {}) {
+    const c = decrypt ? createDecipheriv('aes-128-ecb', key, null) : createCipheriv('aes-128-ecb', key, null);
+    c.setAutoPadding(false);
+    return Buffer.concat([c.update(data), c.final()]);
+}
+export function pkcs7Pad(data) {
+    const n = 16 - (data.length % 16);
+    return Buffer.concat([data, Buffer.alloc(n, n)]);
+}
+export function pkcs7Unpad(data) {
+    const n = data.length ? data[data.length - 1] : 0;
+    if (n < 1 || n > 16 || n > data.length || !data.subarray(-n).every((b) => b === n)) {
+        throw new InputError('bad padding');
+    }
+    return data.subarray(0, data.length - n);
+}
+/** Keys for one mesh (HomeID + password) and the per-connection session value. */
+export class MeshCrypto {
+    homeid;
+    password;
+    /** Per-connection value from the login challenge; null until logged in. */
+    session = null;
+    loginKey;
+    eventKey;
+    /** @param password 4 ASCII characters */
+    constructor(homeid, password) {
+        if (!Number.isInteger(homeid) || homeid < 0 || homeid > 0xffffffff) {
+            throw new InputError(`HomeID must be a 32-bit unsigned integer (got ${homeid})`);
+        }
+        if (typeof password !== 'string' || !/^[\x00-\x7f]{4}$/.test(password)) {
+            throw new InputError('password must be 4 ASCII characters');
+        }
+        this.homeid = Buffer.alloc(4);
+        this.homeid.writeUInt32LE(homeid);
+        this.password = Buffer.from(password, 'ascii');
+        const mat = Buffer.alloc(8);
+        for (let i = 0; i < 4; i++) {
+            mat[2 * i] = this.homeid[i];
+            mat[2 * i + 1] = this.password[i];
+        }
+        this.loginKey = Buffer.concat([mat, Buffer.from('LOGINKEY')]);
+        this.eventKey = Buffer.concat([mat, Buffer.from('EVENTKEY')]);
+    }
+    /** `challenge` = the 16 encrypted bytes following `02 20`. Returns the login packet. */
+    answerChallenge(challenge) {
+        const plain = aes128(this.loginKey, Buffer.from(challenge).subarray(0, 16), { decrypt: true });
+        if (!plain.subarray(0, 4).equals(this.homeid)) {
+            throw new LoginError(`node belongs to another HomeID (${plain.readUInt32LE(0)})`);
+        }
+        this.session = Buffer.from(plain.subarray(4, 8));
+        const body = aes128(this.loginKey, pkcs7Pad(Buffer.concat([this.homeid, this.password, this.session])));
+        return Buffer.concat([Buffer.from([0x01, 0x16, 0x03]), body]);
+    }
+    /**
+     * Follow a login challenge we did not ask for.
+     *
+     * The node switches to the session value of every new challenge, even when that login is
+     * later refused with status 08. On macOS all processes share one BLE link per peripheral,
+     * so another program logging in through the same link silently invalidates our session
+     * unless we switch too. Returns true if the session changed.
+     */
+    adoptChallenge(challenge) {
+        const plain = aes128(this.loginKey, Buffer.from(challenge).subarray(0, 16), { decrypt: true });
+        if (!plain.subarray(0, 4).equals(this.homeid))
+            return false;
+        const next = Buffer.from(plain.subarray(4, 8));
+        const changed = this.session === null || !next.equals(this.session);
+        this.session = next;
+        return changed;
+    }
+    xor(data, key) {
+        return Buffer.from(data.map((b, i) => b ^ key[i % 4]));
+    }
+    /** `03 <dst4> <ch> <payload>`  ->  `06 <dst4> <ch> <cipher>` */
+    encrypt(packet) {
+        const plain = Buffer.from(packet);
+        if (this.session === null)
+            throw new LoginError('not logged in');
+        if (plain.length < 7 || plain[0] !== 0x03)
+            throw new InputError('expected a data-event packet (type 3)');
+        const cipher = aes128(this.eventKey, pkcs7Pad(plain.subarray(6)));
+        return Buffer.concat([Buffer.from([0x06]), plain.subarray(1, 6), this.xor(cipher, this.session)]);
+    }
+    /** `06 <src/dst4> <ch> <cipher>`  ->  `03 <...> <payload>`; other packet types pass through. */
+    decrypt(data) {
+        const packet = Buffer.from(data);
+        if (!packet.length || packet[0] !== 0x06 || this.session === null)
+            return packet;
+        let body = this.xor(packet.subarray(6), this.session);
+        body = body.subarray(0, body.length - (body.length % 16));
+        const plain = pkcs7Unpad(aes128(this.eventKey, body, { decrypt: true }));
+        return Buffer.concat([Buffer.from([0x03]), packet.subarray(1, 6), plain]);
+    }
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+/** Error types. `InputError` = bad user input (HTTP 400); the others come from the mesh / BLE side. */
+export declare class OdelicError extends Error {
+    constructor(message?: string, options?: ErrorOptions);
+}
+/** Invalid argument: unknown light name, malformed vaddr / ID, out-of-range number, ... */
+export declare class InputError extends OdelicError {
+}
+/** The node rejected the login (wrong HomeID / password, or another controller is connected). */
+export declare class LoginError extends OdelicError {
+}
+/** No mesh node found, or the BLE link could not be established. */
+export declare class ConnectionError extends OdelicError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,qBAAa,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGnD;CACF;AAED,2FAA2F;AAC3F,qBAAa,UAAW,SAAQ,WAAW;CAAG;AAE9C,iGAAiG;AACjG,qBAAa,UAAW,SAAQ,WAAW;CAAG;AAE9C,oEAAoE;AACpE,qBAAa,eAAgB,SAAQ,WAAW;CAAG"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+/** Error types. `InputError` = bad user input (HTTP 400); the others come from the mesh / BLE side. */
+export class OdelicError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+/** Invalid argument: unknown light name, malformed vaddr / ID, out-of-range number, ... */
+export class InputError extends OdelicError {
+}
+/** The node rejected the login (wrong HomeID / password, or another controller is connected). */
+export class LoginError extends OdelicError {
+}
+/** No mesh node found, or the BLE link could not be established. */
+export class ConnectionError extends OdelicError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAgB,EAAE,OAAsB;QAClD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,2FAA2F;AAC3F,MAAM,OAAO,UAAW,SAAQ,WAAW;CAAG;AAE9C,iGAAiG;AACjG,MAAM,OAAO,UAAW,SAAQ,WAAW;CAAG;AAE9C,oEAAoE;AACpE,MAAM,OAAO,eAAgB,SAAQ,WAAW;CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/** Unofficial Node.js library for ODELIC Bluetooth lights (Pairlink connected-mesh). */
+export { OdelicMesh, findNodes } from './client.ts';
+export type { MeshNode, OdelicMeshOptions, PacketListener, SetGroupOptions, SetLightOptions } from './client.ts';
+export { Config, configPath, parseIdle } from './config.ts';
+export type { ConfigData } from './config.ts';
+export { Controller } from './controller.ts';
+export type { ActionResult, ControllerInfo, ControllerOptions, LightInfo, LightStatus, Target } from './controller.ts';
+export { MeshCrypto } from './crypto.ts';
+export { ConnectionError, InputError, LoginError, OdelicError } from './errors.ts';
+export { setLogLevel } from './log.ts';
+export type { LogLevel } from './log.ts';
+export { BROADCAST, Device, LightState, parseAppId } from './protocol.ts';
+export type { LightStateJSON, VaddrLike } from './protocol.ts';
+export * as protocol from './protocol.ts';
+export { serve } from './server.ts';
+export type { ServeOptions } from './server.ts';
+export { VERSION } from './version.ts';
+//# 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":"AAAA,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACjH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACvH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/{src → dist}/index.js

@@ -9,3 +9,4 @@ export { BROADCAST, Device, LightState, parseAppId } from './protocol.js';
 export * as protocol from './protocol.js';
 export { serve } from './server.js';
 export { VERSION } from './version.js';
+//# 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,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/log.d.ts

@@ -0,0 +1,18 @@
+/** Minimal leveled logger writing to stderr (stdout stays clean for the CLI output and MCP stdio). */
+declare const LEVELS: {
+    readonly debug: 10;
+    readonly info: 20;
+    readonly warning: 30;
+    readonly error: 40;
+    readonly silent: 100;
+};
+export type LogLevel = keyof typeof LEVELS;
+export declare function setLogLevel(level: LogLevel): void;
+export declare const log: {
+    debug: (...a: unknown[]) => void;
+    info: (...a: unknown[]) => void;
+    warning: (...a: unknown[]) => void;
+    error: (...a: unknown[]) => void;
+};
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,QAAA,MAAM,MAAM;aAAK,KAAK,EAAE,EAAE;aAAE,IAAI,EAAE,EAAE;aAAE,OAAO,EAAE,EAAE;aAAE,KAAK,EAAE,EAAE;aAAE,MAAM,EAAE,GAAG;CAAW,CAAC;AACrF,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,MAAM,CAAC;AAM3C,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAGjD;AAMD,eAAO,MAAM,GAAG;IACd,KAAK,SAAS,OAAO,EAAE;IACvB,IAAI,SAAS,OAAO,EAAE;IACtB,OAAO,SAAS,OAAO,EAAE;IACzB,KAAK,SAAS,OAAO,EAAE;CACxB,CAAC"}

package/dist/log.js

@@ -0,0 +1,21 @@
+/** Minimal leveled logger writing to stderr (stdout stays clean for the CLI output and MCP stdio). */
+const LEVELS = { debug: 10, info: 20, warning: 30, error: 40, silent: 100 };
+const isLevel = (v) => Object.hasOwn(LEVELS, v);
+const fromEnv = String(process.env.ODELIC_LOG ?? '').toLowerCase();
+let current = isLevel(fromEnv) ? LEVELS[fromEnv] : LEVELS.warning;
+export function setLogLevel(level) {
+    if (!isLevel(level))
+        throw new RangeError(`unknown log level ${level}`);
+    current = LEVELS[level];
+}
+function emit(level, args) {
+    if (LEVELS[level] >= current)
+        console.error('odelic:', ...args);
+}
+export const log = {
+    debug: (...a) => emit('debug', a),
+    info: (...a) => emit('info', a),
+    warning: (...a) => emit('warning', a),
+    error: (...a) => emit('error', a),
+};
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAW,CAAC;AAGrF,MAAM,OAAO,GAAG,CAAC,CAAS,EAAiB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACvE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACnE,IAAI,OAAO,GAAW,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;AAE1E,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;IACxE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,IAAI,CAAC,KAAe,EAAE,IAAe;IAC5C,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,IAAI,EAAE,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,CAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;CAC7C,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP server exposing ODELIC lights to AI assistants (stdio).
+ *
+ *     npm install odelic @modelcontextprotocol/sdk zod
+ *     odelic-mcp       # reads the ID from ODELIC_ID or the config file (`odelic setup --id ...`)
+ *
+ * The BLE link is opened on the first command. By default it is released after 60 s without
+ * commands so the official phone app can still connect; set ODELIC_IDLE_TIMEOUT (seconds, 0 = stay
+ * connected) or `odelic setup --keep-connected` to change that.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Controller } from './controller.ts';
+export declare const INSTRUCTIONS = "Controls ODELIC Bluetooth ceiling/room lights in the user's home.\nTargets: a light name (see list_lights), or \"all\" for every light.\nColour is 0 = warm/\u96FB\u7403\u8272 (orange) ... 100 = cool/\u663C\u5149\u8272 (bluish white); brightness is 1..100 %.\nCommands are fire-and-forget; use light_status to confirm the result if needed.";
+/** The part of Controller the MCP tools use. */
+export type McpController = Pick<Controller, 'lights' | 'status' | 'on' | 'off' | 'setLight' | 'nightLight' | 'group' | 'scene' | 'nameLight' | 'forgetName'>;
+/**
+ * Build the MCP server.
+ * @param getController called lazily on the first tool call
+ */
+export declare function createMcpServer(getController?: () => McpController): McpServer;
+/** Run the MCP server on stdio (logs go to stderr). */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,eAAO,MAAM,YAAY,uVAGuD,CAAC;AAEjF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EACzC,QAAQ,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC,CAAC;AAanH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,aAAa,GAAE,MAAM,aAAgC,GAAG,SAAS,CA6ChG;AAQD,uDAAuD;AACvD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}

package/dist/mcp.js

@@ -0,0 +1,74 @@
+/**
+ * MCP server exposing ODELIC lights to AI assistants (stdio).
+ *
+ *     npm install odelic @modelcontextprotocol/sdk zod
+ *     odelic-mcp       # reads the ID from ODELIC_ID or the config file (`odelic setup --id ...`)
+ *
+ * The BLE link is opened on the first command. By default it is released after 60 s without
+ * commands so the official phone app can still connect; set ODELIC_IDLE_TIMEOUT (seconds, 0 = stay
+ * connected) or `odelic setup --keep-connected` to change that.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { Controller } from './controller.js';
+import { VERSION } from './version.js';
+export const INSTRUCTIONS = `Controls ODELIC Bluetooth ceiling/room lights in the user's home.
+Targets: a light name (see list_lights), or "all" for every light.
+Colour is 0 = warm/電球色 (orange) ... 100 = cool/昼光色 (bluish white); brightness is 1..100 %.
+Commands are fire-and-forget; use light_status to confirm the result if needed.`;
+const READ_ONLY = { readOnlyHint: true, idempotentHint: true, openWorldHint: false };
+const ACTION = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true, openWorldHint: false };
+const target = z.string().default('all').describe('light name, vaddr, or "all"');
+const color = z.number().int().min(0).max(100).default(50).describe('0 = warm/電球色 .. 50 = neutral .. 100 = cool/昼光色');
+const brightness = z.number().int().min(1).max(100).default(100).describe('1..100 (%)');
+const byte = z.number().int().min(0).max(255);
+const result = (value) => ({ content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] });
+/**
+ * Build the MCP server.
+ * @param getController called lazily on the first tool call
+ */
+export function createMcpServer(getController = lazyController()) {
+    const server = new McpServer({ name: 'odelic', version: VERSION }, { instructions: INSTRUCTIONS });
+    const ctl = () => getController();
+    function tool(name, description, annotations, inputSchema, fn) {
+        const handler = async (args) => {
+            try {
+                return result(await fn(args));
+            }
+            catch (e) {
+                const err = e;
+                return { ...result({ ok: false, error: `${err.name}: ${err.message}` }), isError: true };
+            }
+        };
+        // the SDK's registerTool generics do not narrow well through this helper
+        server.registerTool(name, { description, annotations, inputSchema }, handler);
+    }
+    tool('list_lights', 'List the lights in the mesh (name, vaddr, online, product). Takes a few seconds.', READ_ONLY, {}, () => ctl().lights());
+    tool('light_status', 'Current state of a light: on/off, colour (0 warm..100 cool) and brightness (%).', READ_ONLY, { target }, async (a) => {
+        const res = await ctl().status(a.target);
+        return Array.isArray(res) ? { lights: res } : res;
+    });
+    tool('turn_on', 'Turn a light (or "all") on with its previous colour and brightness.', ACTION, { target }, (a) => ctl().on(a.target));
+    tool('turn_off', 'Turn a light (or "all") off.', ACTION, { target }, (a) => ctl().off(a.target));
+    tool('set_light', 'Turn on with a given colour and brightness.', ACTION, { target, color, brightness }, (a) => ctl().setLight(a.target, a.color, a.brightness));
+    tool('night_light', 'Very dim warm night light. level 0..2.', ACTION, { target, level: z.number().int().min(0).max(2).default(0) }, (a) => ctl().nightLight(a.target, a.level));
+    tool('control_group', 'Control a group configured in the ODELIC app. action: "on", "off" or "light" (uses color/brightness).', ACTION, { group_id: byte, action: z.enum(['on', 'off', 'light']).default('on'), color, brightness }, (a) => ctl().group(a.group_id, a.action, a.color, a.brightness));
+    tool('play_scene', 'Recall a scene saved in the lights (index as in the app).', ACTION, { index: byte }, (a) => ctl().scene(a.index, false));
+    tool('save_scene', 'Store the current state of all lights as scene `index` (overwrites that scene).', DESTRUCTIVE, { index: byte }, (a) => ctl().scene(a.index, true));
+    tool('name_light', 'Give a light (vaddr from list_lights) a friendly name such as "living" or "リビング".', { readOnlyHint: false, destructiveHint: false, openWorldHint: false }, { name: z.string().min(1), vaddr: z.string() }, (a) => ctl().nameLight(a.name, a.vaddr));
+    tool('forget_light_name', 'Remove a light name from the config.', DESTRUCTIVE, { name: z.string() }, (a) => ctl().forgetName(a.name));
+    return server;
+}
+function lazyController() {
+    let c = null;
+    // idle timeout from $ODELIC_IDLE_TIMEOUT / config (0 = stay connected)
+    return () => (c ??= new Controller());
+}
+/** Run the MCP server on stdio (logs go to stderr). */
+export async function main() {
+    const server = createMcpServer(lazyController());
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,90 @@
+/** A light address: 4 bytes, a number (little endian) or a hex string ("00000000", "00:00:00:00"). */
+export type VaddrLike = Uint8Array | number | string;
+export declare const BROADCAST: Buffer;
+export declare const CH_TO_LIGHT = 32;
+export declare const CH_TO_LIGHT_BROADCAST = 42;
+export declare const CH_PING = 254;
+export declare const CH_PING_RESPONSE = 255;
+export declare const MSG_LIGHT = 192;
+export declare const MSG_LIGHT_GROUP = 193;
+export declare const MSG_CHANGE_COLOR = 226;
+export declare const MSG_SCENE_SAVE = 64;
+export declare const MSG_SCENE_PLAY = 66;
+export declare const MSG_STATUS = 112;
+export declare const MSG_STATUS_RESPONSES: readonly number[];
+export declare const XY_ON: readonly [55, 55];
+export declare const XY_OFF: readonly [50, 50];
+export declare const X_MAX = 20;
+export declare const Y_MAX = 19;
+/** 0 (warmest) .. 100 (coolest) -> x 0..20 */
+export declare function colorToX(color: number): number;
+/** 1..100 % -> y 19..0 (same rule as the app: (100 - b) / 5, clamped) */
+export declare function brightnessToY(brightness: number): number;
+/** 4-byte vaddr from a Buffer/Uint8Array, a number (little endian) or a hex string. */
+export declare function vaddr(v: VaddrLike): Buffer;
+export declare function dataEvent(dst: Uint8Array, channel: number, payload: Uint8Array): Buffer;
+/** ControllerAct.setlight: on/off/colour/brightness for one light or all (broadcast). */
+export declare function light(own: Uint8Array, dst: Buffer, x: number, y: number, index?: number): Buffer;
+/** ControllerAct.sendgroup_new */
+export declare function groupLight(own: Uint8Array, groupId: number, x: number, y: number): Buffer;
+export declare function changeColor(own: Uint8Array, dst: Uint8Array): Buffer;
+export declare function scene(own: Uint8Array, index: number, save: boolean, dst?: Uint8Array): Buffer;
+export declare function statusRequest(own: Uint8Array, dst: Uint8Array): Buffer;
+export declare function pingAll(own: Uint8Array): Buffer;
+/** A light that answered a mesh ping. */
+export declare class Device {
+    readonly vaddr: Buffer;
+    readonly mac: string;
+    readonly product: number;
+    readonly version: string;
+    constructor({ vaddr, mac, product, version }: {
+        vaddr: Buffer;
+        mac: string;
+        product: number;
+        version: string;
+    });
+    toString(): string;
+}
+/** MeshCommon.GetPingResponse; `p` is a decrypted type-3 packet with channel 0xFF. */
+export declare function parsePingResponse(p: Buffer): Device | null;
+export interface LightStateJSON {
+    vaddr: string;
+    on: boolean;
+    /** 0 = warm .. 100 = cool, null if unknown */
+    color: number | null;
+    /** 1..100 %, 0 when off, null if unknown */
+    brightness: number | null;
+    x: number;
+    y: number;
+}
+/** State reported by one light. */
+export declare class LightState {
+    readonly vaddr: Buffer;
+    readonly on: boolean;
+    readonly x: number;
+    readonly y: number;
+    constructor({ vaddr, on, x, y }: {
+        vaddr: Buffer;
+        on: boolean;
+        x: number;
+        y: number;
+    });
+    /** 0 = warm .. 100 = cool, null if unknown (light reports a plain "on"). */
+    get color(): number | null;
+    /** 1..100 %, 0 when off, null if unknown. */
+    get brightness(): number | null;
+    toJSON(): LightStateJSON;
+}
+/** Status reply (MeshBlePresenter.syncState): `03 <dst4> <ch> <src4> 71 <x> <y> ...` */
+export declare function parseStatus(p: Buffer): LightState | null;
+/** The app shows "ID:<HomeID><4-char password>", e.g. "ID:12345678" -> { homeid: 1234, password: "5678" }. */
+export declare function parseAppId(appId: string): {
+    homeid: number;
+    password: string;
+};
+/**
+ * HomeID advertised by a mesh node (manufacturer id 0xFFFF, c0/c1 ff 01|02 <homeid LE>).
+ * `manufacturerData` is the raw AD field as noble reports it, i.e. starting with the 2-byte company id.
+ */
+export declare function advHomeid(manufacturerData: Buffer | null | undefined): number | null;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,178 @@
+/**
+ * Packet builders/parsers for ODELIC lights on the Pairlink mesh.
+ *
+ * Mirrors jp.co.odelic.smt.remote03.act.module.ControllerAct in "central" (Tiger) mode:
+ *     03 <dst vaddr 4B> <channel> <own vaddr 4B> <msg id> <args...>
+ */
+import { InputError } from './errors.js';
+export const BROADCAST = Buffer.from([0xff, 0xff, 0xff, 0xff]);
+// channels
+export const CH_TO_LIGHT = 0x20;
+export const CH_TO_LIGHT_BROADCAST = 0x2a;
+export const CH_PING = 0xfe;
+export const CH_PING_RESPONSE = 0xff;
+// message ids (MeshProfile.DATAEVENT_MSGID_*)
+export const MSG_LIGHT = 0xc0; //         SM_BRIGHT_LIGHT
+export const MSG_LIGHT_GROUP = 0xc1; //   SM_BRIGHT_LIGHT_GROUP
+export const MSG_CHANGE_COLOR = 0xe2; //  SM_CHANGE_COLOR (cycle colour preset)
+export const MSG_SCENE_SAVE = 0x40; //    SM_SCENE_IN
+export const MSG_SCENE_PLAY = 0x42; //    SM_SCENE_PLAY
+export const MSG_STATUS = 0x70; //        SM_STATUS
+export const MSG_STATUS_RESPONSES = [0x71, 0x35]; // STATUS_MAIN / STATE_RESPONSE_FD
+// special (x, y) pairs
+export const XY_ON = [55, 55];
+export const XY_OFF = [50, 50];
+export const X_MAX = 20; // colour: 0 = warm (電球色) ... 20 = cool (昼光色)
+export const Y_MAX = 19; // brightness: 0 = brightest ... 19 = dimmest
+const clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
+/** 0 (warmest) .. 100 (coolest) -> x 0..20 */
+export function colorToX(color) {
+    return clamp(Math.round((color * X_MAX) / 100), 0, X_MAX);
+}
+/** 1..100 % -> y 19..0 (same rule as the app: (100 - b) / 5, clamped) */
+export function brightnessToY(brightness) {
+    return clamp(Math.floor((100 - brightness) / 5), 0, Y_MAX);
+}
+/** 4-byte vaddr from a Buffer/Uint8Array, a number (little endian) or a hex string. */
+export function vaddr(v) {
+    let b;
+    if (v instanceof Uint8Array) {
+        b = Buffer.from(v);
+    }
+    else if (typeof v === 'number') {
+        if (!Number.isInteger(v) || v < 0 || v > 0xffffffff)
+            throw new InputError(`vaddr out of range: ${v}`);
+        b = Buffer.alloc(4);
+        b.writeUInt32LE(v);
+    }
+    else {
+        const s = String(v).replace(/:/g, '');
+        if (!/^[0-9a-fA-F]*$/.test(s) || s.length % 2)
+            throw new InputError(`invalid vaddr: ${v}`);
+        b = Buffer.from(s, 'hex');
+    }
+    if (b.length !== 4)
+        throw new InputError('vaddr must be 4 bytes');
+    return b;
+}
+/** Concatenate Buffers and byte arrays; like Python's bytes(), array values must be integers 0..255. */
+function bytes(...parts) {
+    return Buffer.concat(parts.map((p) => {
+        if (p instanceof Uint8Array)
+            return p;
+        for (const v of p) {
+            if (!Number.isInteger(v) || v < 0 || v > 255)
+                throw new InputError(`byte value out of range: ${v}`);
+        }
+        return Buffer.from(p);
+    }));
+}
+export function dataEvent(dst, channel, payload) {
+    return bytes([0x03], dst, [channel], payload);
+}
+/** ControllerAct.setlight: on/off/colour/brightness for one light or all (broadcast). */
+export function light(own, dst, x, y, index = 0) {
+    const ch = dst.equals(BROADCAST) ? CH_TO_LIGHT_BROADCAST : CH_TO_LIGHT;
+    return dataEvent(dst, ch, bytes(own, [MSG_LIGHT, index, x, y, 0, 0, 0, 0]));
+}
+/** ControllerAct.sendgroup_new */
+export function groupLight(own, groupId, x, y) {
+    return dataEvent(BROADCAST, CH_TO_LIGHT, bytes(own, [MSG_LIGHT_GROUP, x, y, 0, 0, 0, 0, 0, 0, groupId]));
+}
+export function changeColor(own, dst) {
+    return dataEvent(dst, CH_TO_LIGHT, bytes(own, [MSG_CHANGE_COLOR]));
+}
+export function scene(own, index, save, dst = BROADCAST) {
+    const msg = save ? MSG_SCENE_SAVE : MSG_SCENE_PLAY;
+    return dataEvent(dst, CH_TO_LIGHT, bytes(own, [msg, 0, 0, 0, 0, 0, 0, index]));
+}
+export function statusRequest(own, dst) {
+    return dataEvent(dst, CH_TO_LIGHT, bytes(own, [MSG_STATUS]));
+}
+export function pingAll(own) {
+    return dataEvent(BROADCAST, CH_PING, own);
+}
+/** A light that answered a mesh ping. */
+export class Device {
+    vaddr;
+    mac;
+    product;
+    version;
+    constructor({ vaddr, mac, product, version }) {
+        this.vaddr = vaddr;
+        this.mac = mac;
+        this.product = product;
+        this.version = version;
+    }
+    toString() {
+        return `vaddr=${this.vaddr.toString('hex')} mac=${this.mac} product=${this.product} ver=${this.version}`;
+    }
+}
+/** MeshCommon.GetPingResponse; `p` is a decrypted type-3 packet with channel 0xFF. */
+export function parsePingResponse(p) {
+    if (p.length < 20 || p[0] !== 0x03 || p[5] !== CH_PING_RESPONSE)
+        return null;
+    const mac = [...p.subarray(6, 12)].reverse().map((b) => b.toString(16).toUpperCase().padStart(2, '0')).join(':');
+    const product = p[16] | (p[17] << 8);
+    return new Device({ vaddr: Buffer.from(p.subarray(12, 16)), mac, product, version: `${product}.${p[18]}.${p[19]}` });
+}
+/** State reported by one light. */
+export class LightState {
+    vaddr;
+    on;
+    x;
+    y;
+    constructor({ vaddr, on, x, y }) {
+        this.vaddr = vaddr;
+        this.on = on;
+        this.x = x;
+        this.y = y;
+    }
+    /** 0 = warm .. 100 = cool, null if unknown (light reports a plain "on"). */
+    get color() {
+        return !this.on || this.x > X_MAX ? null : this.x * 5;
+    }
+    /** 1..100 %, 0 when off, null if unknown. */
+    get brightness() {
+        if (!this.on)
+            return 0;
+        return this.y > Y_MAX ? null : 100 - this.y * 5;
+    }
+    toJSON() {
+        return { vaddr: this.vaddr.toString('hex'), on: this.on, color: this.color, brightness: this.brightness, x: this.x, y: this.y };
+    }
+}
+/** Status reply (MeshBlePresenter.syncState): `03 <dst4> <ch> <src4> 71 <x> <y> ...` */
+export function parseStatus(p) {
+    if (p.length < 13 || p[0] !== 0x03 || !MSG_STATUS_RESPONSES.includes(p[10]))
+        return null;
+    const x = p[11];
+    const y = p[12];
+    return new LightState({ vaddr: Buffer.from(p.subarray(6, 10)), on: !(x === XY_OFF[0] && y === XY_OFF[1]), x, y });
+}
+/** The app shows "ID:<HomeID><4-char password>", e.g. "ID:12345678" -> { homeid: 1234, password: "5678" }. */
+export function parseAppId(appId) {
+    let s = String(appId).trim();
+    if (s.toUpperCase().startsWith('ID:'))
+        s = s.slice(3);
+    if (s.length < 5)
+        throw new InputError(`ID looks too short: ${JSON.stringify(String(appId))}`);
+    const head = s.slice(0, -4);
+    if (!/^\d+$/.test(head))
+        throw new InputError(`ID must start with the numeric HomeID: ${JSON.stringify(String(appId))}`);
+    return { homeid: Number(head), password: s.slice(-4) };
+}
+/**
+ * HomeID advertised by a mesh node (manufacturer id 0xFFFF, c0/c1 ff 01|02 <homeid LE>).
+ * `manufacturerData` is the raw AD field as noble reports it, i.e. starting with the 2-byte company id.
+ */
+export function advHomeid(manufacturerData) {
+    const m = manufacturerData;
+    if (!m || m.length < 9 || m[0] !== 0xff || m[1] !== 0xff)
+        return null;
+    const v = m.subarray(2);
+    if ((v[0] === 0xc0 || v[0] === 0xc1) && v[1] === 0xff && (v[2] === 1 || v[2] === 2))
+        return v.readUInt32LE(3);
+    return null;
+}
+//# sourceMappingURL=protocol.js.map