iobroker.assistant 1.0.3 → 1.2.0

package/build/lib/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/lib/tools.ts"],"names":[],"mappings":";;;AAmCA,wCAIC;AAOD,8BAEC;AAsFD,sCAwBC;AAsKD,sCAwDC;AA1VD,8DAA8D;AAC9D,SAAgB,cAAc,CAAC,GAAmB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,QAAkB;IACxC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC;AAcD,0EAA0E;AAC1E,MAAM,aAAa,GAAiC;IAChD,UAAU,EAAE,WAAW;IACvB,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,SAAS;IACrB,cAAc,EAAE,SAAS;IACzB,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,eAAe;IAC3B,cAAc,EAAE,eAAe;IAC/B,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,UAAU;IACrB,aAAa,EAAE,SAAS;IACxB,SAAS,EAAE,OAAO;IAClB,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,OAAO;IACpB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,cAAc,EAAE,QAAQ;IACxB,aAAa,EAAE,QAAQ;IACvB,yBAAyB,EAAE,QAAQ;IACnC,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,cAAc;IAC1B,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,cAAc;IAC1B,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,cAAc;IAC3B,KAAK,EAAE,cAAc;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAElF,sEAAsE;AACzD,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;;GAIG;AACH,MAAa,SAAS;IAIG;IACA;IAJJ,KAAK,GAAG,IAAI,GAAG,EAAuC,CAAC;IAExE,YACqB,QAAgB,yBAAiB,EACjC,MAAoB,IAAI,CAAC,GAAG;QAD5B,UAAK,GAAL,KAAK,CAA4B;QACjC,QAAG,GAAH,GAAG,CAAyB;IAC9C,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,OAA8B;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC,GAAG,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACtC,OAAO,GAAG,CAAC;IACf,CAAC;IAED,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACJ;AAtBD,8BAsBC;AAED,sGAAsG;AACtG,SAAgB,aAAa,CAAC,IAAY,EAAE,MAAkB;IAC1D,QAAQ,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS;YACV,OAAO,IAAI,CAAC,CAAC,gDAAgD;QACjE,KAAK,YAAY;YACb,OAAO,MAAM,CAAC,gBAAgB,CAAC;QACnC,KAAK,eAAe;YAChB,OAAO,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC;QACxC,KAAK,SAAS;YACV,OAAO,MAAM,CAAC,aAAa,CAAC;QAChC,KAAK,UAAU;YACX,OAAO,MAAM,CAAC,cAAc,CAAC;QACjC,KAAK,SAAS;YACV,OAAO,MAAM,CAAC,YAAY,CAAC;QAC/B,KAAK,OAAO;YACR,OAAO,MAAM,CAAC,UAAU,CAAC;QAC7B,KAAK,QAAQ;YACT,OAAO,MAAM,CAAC,eAAe,CAAC;QAClC,KAAK,cAAc;YACf,OAAO,MAAM,CAAC,iBAAiB,CAAC;QACpC;YACI,OAAO,KAAK,CAAC,CAAC,iEAAiE;IACvF,CAAC;AACL,CAAC;AAED,4GAA4G;AAC5G,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpD;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAC7B,GAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAEjC,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC3B,uFAAuF;gBACvF,uCAAuC;gBACvC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;oBACnB,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC5B,CAAC;gBACD,IAAI,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC9D,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC/B,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,+CAA+C;IACnD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;AAC7C,CAAC;AAOD,qGAAqG;AACrG,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE7C;;;;GAIG;AACH,KAAK,UAAU,sBAAsB,CACjC,IAAY,EACZ,GAAc,EACd,WAAoE;IAEpE,IAAI,MAAyB,CAAC;IAC9B,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC/C,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACnD,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,MAAM,GAAG,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,0CAA0C;QACzF,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,IAAI,GACN,WAAW,IAAI,GAAG,CAAC,MAAM;gBACrB,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU;gBACrF,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;YACzB,6FAA6F;YAC7F,2FAA2F;YAC3F,MAAM,QAAQ,GAA6D,EAAE,CAAC;YAC9E,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;YAClE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,qFAAqF;AACrF,SAAS,SAAS,CACd,OAA4D,EAC5D,UAA+B,EAC/B,GAAc;IAEd,OAAO,KAAK,EAAE,IAA6B,EAAoB,EAAE;QAC7D,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAW,CAAC;QAC7C,IAAI,MAAiD,CAAC;QACtD,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA8C,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;QACnC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBACnC,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrD,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CACf,IAAY,EACZ,OAA4D,EAC5D,UAA+B,EAC/B,GAAc,EACd,iBAA8B;IAE9B,OAAO,KAAK,EAAE,IAA6B,EAAoB,EAAE;QAC7D,MAAM,GAAG,GACL,IAAI,KAAK,YAAY;YACjB,CAAC,CAAC,CAAE,IAAI,CAAC,MAAwC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxG,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;gBAC3B,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACX,CAAC,CAAC,EAAE,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACP,SAAS;YACb,CAAC;YACD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjF,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,SAAS,CAAC;oBAClB,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,YAAY,EAAE,6BAA6B,GAAG,2CAA2C;iBACnG,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,aAAa,CAC/B,GAAiB,EACjB,MAAkB,EAClB,QAAmB,IAAI,SAAS,EAAE,EAClC,WAAoE;IAEpE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACnC,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAC7C,iGAAiG;IACjG,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACxE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GACnC,YAAY,IAAI,WAAW;QACvB,CAAC,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC;QAC/B,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,GAAG,EAAkB,EAAE,iBAAiB,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;IAE1F,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,EAAE,IAA6B,EAAmB,EAAE;YACtE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACxD,6EAA6E;YAC7E,OAAO,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,CAAC,CAAC;QACF,kGAAkG;QAClG,MAAM,OAAO,GAAwD,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/F,CAAC,CAAC,CAAC,IAAI,EAAmB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1G,CAAC,CAAC,QAAQ,CAAC;QACf,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,IAAI,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,CAAC;YAC5E,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAC7E,CAAC;aAAM,IAAI,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACnD,GAAG,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,iGAAiG;IACjG,iGAAiG;IACjG,KAAK,CAAC,IAAI,CAAC;QACP,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACP,gSAAgS;QACpS,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC3E,GAAG,EAAE,GAAoB,EAAE;YACvB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAClF,CAAC;KACJ,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC","sourcesContent":["import type { InProcessMcp } from '@iobroker/mcp-server';\n\n/** An LLM-callable tool: name, description, JSON-schema parameters, and a runner. */\nexport interface Tool {\n    name: string;\n    description: string;\n    /** JSON schema for the tool arguments. */\n    parameters: Record<string, unknown>;\n    run(args: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Per-device read/write override, keyed by {@link deviceKey}. Absent → governed by the coarse toggles. */\nexport type DeviceAcl = Record<string, { read: boolean; write: boolean }>;\n\n/** The access toggles from the adapter config that gate which MCP tools the LLM may use. */\nexport interface ToolAccess {\n    allowWriteStates: boolean;\n    allowObjectChange: boolean;\n    readObjects: 'devices' | 'all';\n    allowReadLogs: boolean;\n    allowWriteLogs: boolean;\n    allowHistory: boolean;\n    allowFiles: boolean;\n    allowSystemInfo: boolean;\n    deviceAcl: DeviceAcl;\n}\n\n/** One `list_devices` device entry (as far as we care: its controls' state ids). */\nexport interface McpDeviceEntry {\n    deviceName?: string;\n    deviceType?: string;\n    controls?: Record<string, { stateId?: string; writable?: boolean }>;\n}\n\n/** All control state ids of a `list_devices` device entry. */\nexport function deviceStateIds(dev: McpDeviceEntry): string[] {\n    return Object.values(dev.controls || {})\n        .map(c => c?.stateId)\n        .filter((x): x is string => !!x);\n}\n\n/**\n * Stable per-device key used by both the backend write-guard and the admin ACL editor. Keyed by the\n * device's primary (lexicographically first) control state id — unique per device and independent of the\n * (often non-unique) type-detector name, so two \"SET\" controls no longer collide on one ACL entry.\n */\nexport function deviceKey(stateIds: string[]): string {\n    return [...stateIds].sort()[0] || '';\n}\n\ntype ToolCategory =\n    | 'stateRead'\n    | 'stateWrite'\n    | 'devices'\n    | 'objectReadAll'\n    | 'logRead'\n    | 'logWrite'\n    | 'history'\n    | 'files'\n    | 'system'\n    | 'objectChange';\n\n/** Maps every known `@iobroker/mcp-server` tool to an access category. */\nconst TOOL_CATEGORY: Record<string, ToolCategory> = {\n    get_states: 'stateRead',\n    list_devices: 'devices',\n    list_rooms: 'devices',\n    list_functions: 'devices',\n    set_state: 'stateWrite',\n    set_states: 'stateWrite',\n    get_object: 'objectReadAll',\n    search_objects: 'objectReadAll',\n    get_logs: 'logRead',\n    write_log: 'logWrite',\n    history_query: 'history',\n    read_file: 'files',\n    list_files: 'files',\n    file_exists: 'files',\n    system_info: 'system',\n    list_hosts: 'system',\n    list_instances: 'system',\n    list_adapters: 'system',\n    search_adapter_repository: 'system',\n    ping_host: 'system',\n    set_object: 'objectChange',\n    delete_object: 'objectChange',\n    create_state: 'objectChange',\n    create_scene: 'objectChange',\n    write_file: 'objectChange',\n    delete_file: 'objectChange',\n    rename_file: 'objectChange',\n    mkdir: 'objectChange',\n};\n\n/**\n * Read-only, system-wide-scan tools whose results are stable enough to serve from a short-TTL cache.\n * Each of these runs the ioBroker type-detector over *all* objects (`list_devices` alone does five\n * full `getObjectView` scans), so repeat calls inside one conversation are the main avoidable cost.\n */\nconst CACHEABLE_TOOLS = new Set(['list_devices', 'list_rooms', 'list_functions']);\n\n/** Default lifetime of a cached device/room/function listing (ms). */\nexport const LIST_CACHE_TTL_MS = 30_000;\n\n/**\n * Tiny time-based cache: memoizes a tool result per (tool, args) for {@link ttlMs}. Not invalidated on\n * object changes — a freshly added device appears after at most one TTL, which is fine for an assistant.\n * Call {@link ListCache.clear} to force a refresh (e.g. from an `objectChange` subscription).\n */\nexport class ListCache {\n    private readonly store = new Map<string, { at: number; val: string }>();\n\n    constructor(\n        private readonly ttlMs: number = LIST_CACHE_TTL_MS,\n        private readonly now: () => number = Date.now,\n    ) {}\n\n    async run(key: string, produce: () => Promise<string>): Promise<string> {\n        const hit = this.store.get(key);\n        const now = this.now();\n        if (hit && now - hit.at < this.ttlMs) {\n            return hit.val;\n        }\n        const val = await produce();\n        this.store.set(key, { at: now, val });\n        return val;\n    }\n\n    clear(): void {\n        this.store.clear();\n    }\n}\n\n/** Decide whether a tool is allowed by the current access configuration. Unknown tools are denied. */\nexport function isToolAllowed(name: string, access: ToolAccess): boolean {\n    switch (TOOL_CATEGORY[name]) {\n        case 'stateRead':\n        case 'devices':\n            return true; // reading device/state values is always allowed\n        case 'stateWrite':\n            return access.allowWriteStates;\n        case 'objectReadAll':\n            return access.readObjects === 'all';\n        case 'logRead':\n            return access.allowReadLogs;\n        case 'logWrite':\n            return access.allowWriteLogs;\n        case 'history':\n            return access.allowHistory;\n        case 'files':\n            return access.allowFiles;\n        case 'system':\n            return access.allowSystemInfo;\n        case 'objectChange':\n            return access.allowObjectChange;\n        default:\n            return false; // unknown/unmapped tool → deny (safe default for an access list)\n    }\n}\n\n/** Device types that default to write-disabled (must be explicitly allowed) for safety, e.g. door locks. */\nconst DEFAULT_WRITE_FALSE_TYPES = new Set(['lock']);\n\n/**\n * Build the stateId → deviceKey map and the set of keys that default to write-disabled (e.g. locks),\n * from the MCP `list_devices` tool (best-effort; empty on any error).\n */\nasync function loadStateDeviceMap(\n    mcp: InProcessMcp,\n): Promise<{ stateToKey: Map<string, string>; defaultWriteFalse: Set<string> }> {\n    const stateToKey = new Map<string, string>();\n    const defaultWriteFalse = new Set<string>();\n    try {\n        const res = await mcp.callTool('list_devices', {});\n        const parsed = JSON.parse(res.text) as {\n            data?: { rooms?: { devicesInRoom?: McpDeviceEntry[] }[] };\n        };\n        for (const room of parsed.data?.rooms || []) {\n            for (const dev of room.devicesInRoom || []) {\n                const ids = deviceStateIds(dev);\n                const key = deviceKey(ids);\n                // Every control of the device shares the device's key, so the write-guard resolves any\n                // of its states to the same ACL entry.\n                for (const id of ids) {\n                    stateToKey.set(id, key);\n                }\n                if (DEFAULT_WRITE_FALSE_TYPES.has(String(dev.deviceType ?? ''))) {\n                    defaultWriteFalse.add(key);\n                }\n            }\n        }\n    } catch {\n        /* no device map → no per-device enforcement */\n    }\n    return { stateToKey, defaultWriteFalse };\n}\n\n/** JSON shape of a `list_devices` result, for post-processing the device names the LLM sees. */\ninterface ListDevicesResult {\n    data?: { rooms?: { devicesInRoom?: McpDeviceEntry[] }[] };\n}\n\n/** Device types dropped from `list_devices` so the LLM never treats them as controllable devices. */\nconst HIDDEN_LLM_TYPES = new Set(['button']);\n\n/**\n * Post-process a `list_devices` result for the LLM: drop hidden types (write-only buttons) and devices\n * the user set to read-disabled (`acl[key].read === false`), and — when a resolver is given — rewrite\n * each `deviceName` to the friendly name (smartName → parent name). Original text on any parse problem.\n */\nasync function postProcessListDevices(\n    text: string,\n    acl: DeviceAcl,\n    resolveName?: (stateId: string, fallback: string) => Promise<string>,\n): Promise<string> {\n    let parsed: ListDevicesResult;\n    try {\n        parsed = JSON.parse(text) as ListDevicesResult;\n    } catch {\n        return text;\n    }\n    const rooms = parsed.data?.rooms;\n    if (!Array.isArray(rooms)) {\n        return text;\n    }\n    for (const room of rooms) {\n        const kept = (room.devicesInRoom || []).filter(d => {\n            if (HIDDEN_LLM_TYPES.has(String(d.deviceType ?? ''))) {\n                return false;\n            }\n            const key = deviceKey(deviceStateIds(d));\n            return !(key && acl[key]?.read === false); // hide read-disabled devices from the LLM\n        });\n        const trimmed: McpDeviceEntry[] = [];\n        for (const dev of kept) {\n            const ids = deviceStateIds(dev);\n            const name =\n                resolveName && ids.length\n                    ? (await resolveName(deviceKey(ids), String(dev.deviceName ?? ''))) || dev.deviceName\n                    : dev.deviceName;\n            // Keep only what the LLM needs to act (name/type + controlType→{stateId,writable}); drop the\n            // verbose role/unit/min/max/ioBrokerValueType/friendlyDeviceNames to cut tokens & latency.\n            const controls: Record<string, { stateId?: string; writable?: boolean }> = {};\n            for (const [ct, c] of Object.entries(dev.controls || {})) {\n                controls[ct] = { stateId: c?.stateId, writable: c?.writable };\n            }\n            trimmed.push({ deviceName: name, deviceType: dev.deviceType, controls });\n        }\n        room.devicesInRoom = trimmed;\n    }\n    return JSON.stringify(parsed);\n}\n\n/** Wrap `get_states` so it drops values of devices the user set to read-disabled. */\nfunction guardRead(\n    baseRun: (args: Record<string, unknown>) => Promise<unknown>,\n    stateToKey: Map<string, string>,\n    acl: DeviceAcl,\n): (args: Record<string, unknown>) => Promise<unknown> {\n    return async (args: Record<string, unknown>): Promise<unknown> => {\n        const text = (await baseRun(args)) as string;\n        let parsed: { data?: { states?: { id?: string }[] } };\n        try {\n            parsed = JSON.parse(text) as { data?: { states?: { id?: string }[] } };\n        } catch {\n            return text;\n        }\n        const states = parsed.data?.states;\n        if (Array.isArray(states) && parsed.data) {\n            parsed.data.states = states.filter(s => {\n                const key = s?.id ? stateToKey.get(s.id) : undefined;\n                return !(key && acl[key]?.read === false);\n            });\n        }\n        return JSON.stringify(parsed);\n    };\n}\n\n/**\n * Wrap a state-writing tool so it refuses writes to states of devices the user marked read-only.\n * Write is allowed when the explicit ACL entry says so; without an entry, the device type's default\n * applies (write-disabled for {@link DEFAULT_WRITE_FALSE_TYPES} like locks, allowed otherwise).\n */\nfunction guardWrite(\n    name: string,\n    baseRun: (args: Record<string, unknown>) => Promise<unknown>,\n    stateToKey: Map<string, string>,\n    acl: DeviceAcl,\n    defaultWriteFalse: Set<string>,\n): (args: Record<string, unknown>) => Promise<unknown> {\n    return async (args: Record<string, unknown>): Promise<unknown> => {\n        const ids =\n            name === 'set_states'\n                ? ((args.states as { id?: string }[] | undefined) || []).map(s => s?.id).filter((x): x is string => !!x)\n                : typeof args.id === 'string'\n                  ? [args.id]\n                  : [];\n        for (const id of ids) {\n            const key = stateToKey.get(id);\n            if (!key) {\n                continue;\n            }\n            const entry = acl[key];\n            const writeAllowed = entry ? entry.write !== false : !defaultWriteFalse.has(key);\n            if (!writeAllowed) {\n                return JSON.stringify({\n                    ok: false,\n                    error: `Writing \"${id}\" is not allowed: device \"${key}\" is read-only in the assistant settings.`,\n                });\n            }\n        }\n        return baseRun(args);\n    };\n}\n\n/**\n * Build the LLM tool set from the in-process ioBroker MCP server, filtered by the access config and\n * enforcing the per-device write ACL.\n *\n * All tools come from `@iobroker/mcp-server` — nothing is duplicated here. Gating layers:\n *  1. `createInProcessMcp({ allowSetState, allowObjectChange })` — which tools exist at all.\n *  2. `isToolAllowed()` — fine-grained category toggles (logs/history/files/object-read scope/…).\n *  3. `guardWrite()` — per-device write ACL (`access.deviceAcl`), e.g. keep a lock read-only.\n */\nexport async function buildMcpTools(\n    mcp: InProcessMcp,\n    access: ToolAccess,\n    cache: ListCache = new ListCache(),\n    resolveName?: (stateId: string, fallback: string) => Promise<string>,\n): Promise<{ tools: Tool[]; denied: string[]; cache: ListCache }> {\n    const infos = await mcp.listTools();\n    const acl = access.deviceAcl || {};\n    // Write guard: whenever writing is enabled (explicit ACL + type defaults like locks).\n    const enforceWrite = access.allowWriteStates;\n    // Read guard: whenever any device is set read-disabled (hide it from list_devices + get_states).\n    const enforceRead = Object.values(acl).some(a => a && a.read === false);\n    const { stateToKey, defaultWriteFalse } =\n        enforceWrite || enforceRead\n            ? await loadStateDeviceMap(mcp)\n            : { stateToKey: new Map<string, string>(), defaultWriteFalse: new Set<string>() };\n\n    const tools: Tool[] = [];\n    const denied: string[] = [];\n    for (const info of infos) {\n        if (!isToolAllowed(info.name, access)) {\n            denied.push(info.name);\n            continue;\n        }\n        const callTool = async (args: Record<string, unknown>): Promise<string> => {\n            const text = (await mcp.callTool(info.name, args)).text;\n            // For the LLM: drop buttons + read-disabled devices, and use friendly names.\n            return info.name === 'list_devices' ? postProcessListDevices(text, acl, resolveName) : text;\n        };\n        // Serve stable, expensive read-only listings from the short-TTL cache; everything else runs live.\n        const baseRun: (args: Record<string, unknown>) => Promise<unknown> = CACHEABLE_TOOLS.has(info.name)\n            ? (args): Promise<string> => cache.run(`${info.name}:${JSON.stringify(args ?? {})}`, () => callTool(args))\n            : callTool;\n        let run = baseRun;\n        if (enforceWrite && (info.name === 'set_state' || info.name === 'set_states')) {\n            run = guardWrite(info.name, baseRun, stateToKey, acl, defaultWriteFalse);\n        } else if (enforceRead && info.name === 'get_states') {\n            run = guardRead(baseRun, stateToKey, acl);\n        }\n        tools.push({ name: info.name, description: info.description || '', parameters: info.inputSchema, run });\n    }\n\n    // Synthetic (non-MCP) tool: lets the model bust the device/room cache and re-scan. Useful when a\n    // device the user mentions is missing from list_devices (stale cache) or was just added/renamed.\n    tools.push({\n        name: 'refresh_device_cache',\n        description:\n            'Clear the cached device, room and function listings so the next list_devices, list_rooms or list_functions call performs a fresh scan. Call this when a device or room the user mentions is not in the list, or when the user says a device was just added, renamed or reassigned, then retry.',\n        parameters: { type: 'object', properties: {}, additionalProperties: false },\n        run: (): Promise<string> => {\n            cache.clear();\n            return Promise.resolve(JSON.stringify({ ok: true, data: { cleared: true } }));\n        },\n    });\n\n    return { tools, denied, cache };\n}\n"]}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/lib/tools.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InProcessMcp } from '@iobroker/mcp-server';\n\n/** An LLM-callable tool: name, description, JSON-schema parameters, and a runner. */\nexport interface Tool {\n    name: string;\n    description: string;\n    /** JSON schema for the tool arguments. */\n    parameters: Record<string, unknown>;\n    run(args: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Per-device read/write override, keyed by {@link deviceKey}. Absent → governed by the coarse toggles. */\nexport type DeviceAcl = Record<string, { read: boolean; write: boolean }>;\n\n/** The access toggles from the adapter config that gate which MCP tools the LLM may use. */\nexport interface ToolAccess {\n    allowWriteStates: boolean;\n    allowObjectChange: boolean;\n    readObjects: 'devices' | 'all';\n    allowReadLogs: boolean;\n    allowWriteLogs: boolean;\n    allowHistory: boolean;\n    allowFiles: boolean;\n    allowSystemInfo: boolean;\n    deviceAcl: DeviceAcl;\n}\n\n/** One `list_devices` device entry (as far as we care: its controls' state ids). */\nexport interface McpDeviceEntry {\n    deviceName?: string;\n    deviceType?: string;\n    controls?: Record<string, { stateId?: string; writable?: boolean }>;\n}\n\n/** All control state ids of a `list_devices` device entry. */\nexport function deviceStateIds(dev: McpDeviceEntry): string[] {\n    return Object.values(dev.controls || {})\n        .map(c => c?.stateId)\n        .filter((x): x is string => !!x);\n}\n\n/**\n * Stable per-device key used by both the backend write-guard and the admin ACL editor. Keyed by the\n * device's primary (lexicographically first) control state id — unique per device and independent of the\n * (often non-unique) type-detector name, so two \"SET\" controls no longer collide on one ACL entry.\n */\nexport function deviceKey(stateIds: string[]): string {\n    return [...stateIds].sort()[0] || '';\n}\n\ntype ToolCategory =\n    | 'stateRead'\n    | 'stateWrite'\n    | 'devices'\n    | 'objectReadAll'\n    | 'logRead'\n    | 'logWrite'\n    | 'history'\n    | 'files'\n    | 'system'\n    | 'objectChange';\n\n/** Maps every known `@iobroker/mcp-server` tool to an access category. */\nconst TOOL_CATEGORY: Record<string, ToolCategory> = {\n    get_states: 'stateRead',\n    list_devices: 'devices',\n    list_rooms: 'devices',\n    list_functions: 'devices',\n    set_state: 'stateWrite',\n    set_states: 'stateWrite',\n    get_object: 'objectReadAll',\n    search_objects: 'objectReadAll',\n    get_logs: 'logRead',\n    write_log: 'logWrite',\n    history_query: 'history',\n    read_file: 'files',\n    list_files: 'files',\n    file_exists: 'files',\n    system_info: 'system',\n    list_hosts: 'system',\n    list_instances: 'system',\n    list_adapters: 'system',\n    search_adapter_repository: 'system',\n    ping_host: 'system',\n    set_object: 'objectChange',\n    delete_object: 'objectChange',\n    create_state: 'objectChange',\n    create_scene: 'objectChange',\n    write_file: 'objectChange',\n    delete_file: 'objectChange',\n    rename_file: 'objectChange',\n    mkdir: 'objectChange',\n};\n\n/**\n * Read-only, system-wide-scan tools whose results are stable enough to serve from a short-TTL cache.\n * Each of these runs the ioBroker type-detector over *all* objects (`list_devices` alone does five\n * full `getObjectView` scans), so repeat calls inside one conversation are the main avoidable cost.\n */\nconst CACHEABLE_TOOLS = new Set(['list_devices', 'list_rooms', 'list_functions']);\n\n/** Default lifetime of a cached device/room/function listing (ms). */\nexport const LIST_CACHE_TTL_MS = 30_000;\n\n/**\n * Tiny time-based cache: memoizes a tool result per (tool, args) for {@link ttlMs}. Not invalidated on\n * object changes — a freshly added device appears after at most one TTL, which is fine for an assistant.\n * Call {@link ListCache.clear} to force a refresh (e.g. from an `objectChange` subscription).\n */\nexport class ListCache {\n    private readonly store = new Map<string, { at: number; val: string }>();\n\n    constructor(\n        private readonly ttlMs: number = LIST_CACHE_TTL_MS,\n        private readonly now: () => number = Date.now,\n    ) {}\n\n    async run(key: string, produce: () => Promise<string>): Promise<string> {\n        const hit = this.store.get(key);\n        const now = this.now();\n        if (hit && now - hit.at < this.ttlMs) {\n            return hit.val;\n        }\n        const val = await produce();\n        this.store.set(key, { at: now, val });\n        return val;\n    }\n\n    /** Called after every {@link clear}, so caches built on top of these listings can drop theirs too. */\n    onClear: (() => void) | null = null;\n\n    clear(): void {\n        this.store.clear();\n        this.onClear?.();\n    }\n}\n\n/** Decide whether a tool is allowed by the current access configuration. Unknown tools are denied. */\nexport function isToolAllowed(name: string, access: ToolAccess): boolean {\n    switch (TOOL_CATEGORY[name]) {\n        case 'stateRead':\n        case 'devices':\n            return true; // reading device/state values is always allowed\n        case 'stateWrite':\n            return access.allowWriteStates;\n        case 'objectReadAll':\n            return access.readObjects === 'all';\n        case 'logRead':\n            return access.allowReadLogs;\n        case 'logWrite':\n            return access.allowWriteLogs;\n        case 'history':\n            return access.allowHistory;\n        case 'files':\n            return access.allowFiles;\n        case 'system':\n            return access.allowSystemInfo;\n        case 'objectChange':\n            return access.allowObjectChange;\n        default:\n            return false; // unknown/unmapped tool → deny (safe default for an access list)\n    }\n}\n\n/** Device types that default to write-disabled (must be explicitly allowed) for safety, e.g. door locks. */\nconst DEFAULT_WRITE_FALSE_TYPES = new Set(['lock']);\n\n/**\n * Build the stateId → deviceKey map and the set of keys that default to write-disabled (e.g. locks),\n * from the MCP `list_devices` tool (best-effort; empty on any error).\n */\nasync function loadStateDeviceMap(\n    mcp: InProcessMcp,\n): Promise<{ stateToKey: Map<string, string>; defaultWriteFalse: Set<string> }> {\n    const stateToKey = new Map<string, string>();\n    const defaultWriteFalse = new Set<string>();\n    try {\n        const res = await mcp.callTool('list_devices', {});\n        const parsed = JSON.parse(res.text) as {\n            data?: { rooms?: { devicesInRoom?: McpDeviceEntry[] }[] };\n        };\n        for (const room of parsed.data?.rooms || []) {\n            for (const dev of room.devicesInRoom || []) {\n                const ids = deviceStateIds(dev);\n                const key = deviceKey(ids);\n                // Every control of the device shares the device's key, so the write-guard resolves any\n                // of its states to the same ACL entry.\n                for (const id of ids) {\n                    stateToKey.set(id, key);\n                }\n                if (DEFAULT_WRITE_FALSE_TYPES.has(String(dev.deviceType ?? ''))) {\n                    defaultWriteFalse.add(key);\n                }\n            }\n        }\n    } catch {\n        /* no device map → no per-device enforcement */\n    }\n    return { stateToKey, defaultWriteFalse };\n}\n\n/** JSON shape of a `list_devices` result, for post-processing the device names the LLM sees. */\ninterface ListDevicesResult {\n    data?: { rooms?: { devicesInRoom?: McpDeviceEntry[] }[] };\n}\n\n/** Device types dropped from `list_devices` so the LLM never treats them as controllable devices. */\nconst HIDDEN_LLM_TYPES = new Set(['button']);\n\n/**\n * Post-process a `list_devices` result for the LLM: drop hidden types (write-only buttons) and devices\n * the user set to read-disabled (`acl[key].read === false`), and — when a resolver is given — rewrite\n * each `deviceName` to the friendly name (smartName → parent name). Original text on any parse problem.\n */\nasync function postProcessListDevices(\n    text: string,\n    acl: DeviceAcl,\n    resolveName?: (stateId: string, fallback: string) => Promise<string>,\n): Promise<string> {\n    let parsed: ListDevicesResult;\n    try {\n        parsed = JSON.parse(text) as ListDevicesResult;\n    } catch {\n        return text;\n    }\n    const rooms = parsed.data?.rooms;\n    if (!Array.isArray(rooms)) {\n        return text;\n    }\n    for (const room of rooms) {\n        const kept = (room.devicesInRoom || []).filter(d => {\n            if (HIDDEN_LLM_TYPES.has(String(d.deviceType ?? ''))) {\n                return false;\n            }\n            const key = deviceKey(deviceStateIds(d));\n            return !(key && acl[key]?.read === false); // hide read-disabled devices from the LLM\n        });\n        const trimmed: McpDeviceEntry[] = [];\n        for (const dev of kept) {\n            const ids = deviceStateIds(dev);\n            const name =\n                resolveName && ids.length\n                    ? (await resolveName(deviceKey(ids), String(dev.deviceName ?? ''))) || dev.deviceName\n                    : dev.deviceName;\n            // Keep only what the LLM needs to act (name/type + controlType→{stateId,writable}); drop the\n            // verbose role/unit/min/max/ioBrokerValueType/friendlyDeviceNames to cut tokens & latency.\n            const controls: Record<string, { stateId?: string; writable?: boolean }> = {};\n            for (const [ct, c] of Object.entries(dev.controls || {})) {\n                controls[ct] = { stateId: c?.stateId, writable: c?.writable };\n            }\n            trimmed.push({ deviceName: name, deviceType: dev.deviceType, controls });\n        }\n        room.devicesInRoom = trimmed;\n    }\n    return JSON.stringify(parsed);\n}\n\n/** Wrap `get_states` so it drops values of devices the user set to read-disabled. */\nfunction guardRead(\n    baseRun: (args: Record<string, unknown>) => Promise<unknown>,\n    stateToKey: Map<string, string>,\n    acl: DeviceAcl,\n): (args: Record<string, unknown>) => Promise<unknown> {\n    return async (args: Record<string, unknown>): Promise<unknown> => {\n        const text = (await baseRun(args)) as string;\n        let parsed: { data?: { states?: { id?: string }[] } };\n        try {\n            parsed = JSON.parse(text) as { data?: { states?: { id?: string }[] } };\n        } catch {\n            return text;\n        }\n        const states = parsed.data?.states;\n        if (Array.isArray(states) && parsed.data) {\n            parsed.data.states = states.filter(s => {\n                const key = s?.id ? stateToKey.get(s.id) : undefined;\n                return !(key && acl[key]?.read === false);\n            });\n        }\n        return JSON.stringify(parsed);\n    };\n}\n\n/**\n * Wrap a state-writing tool so it refuses writes to states of devices the user marked read-only.\n * Write is allowed when the explicit ACL entry says so; without an entry, the device type's default\n * applies (write-disabled for {@link DEFAULT_WRITE_FALSE_TYPES} like locks, allowed otherwise).\n */\nfunction guardWrite(\n    name: string,\n    baseRun: (args: Record<string, unknown>) => Promise<unknown>,\n    stateToKey: Map<string, string>,\n    acl: DeviceAcl,\n    defaultWriteFalse: Set<string>,\n): (args: Record<string, unknown>) => Promise<unknown> {\n    return async (args: Record<string, unknown>): Promise<unknown> => {\n        const ids =\n            name === 'set_states'\n                ? ((args.states as { id?: string }[] | undefined) || []).map(s => s?.id).filter((x): x is string => !!x)\n                : typeof args.id === 'string'\n                  ? [args.id]\n                  : [];\n        for (const id of ids) {\n            const key = stateToKey.get(id);\n            if (!key) {\n                continue;\n            }\n            const entry = acl[key];\n            const writeAllowed = entry ? entry.write !== false : !defaultWriteFalse.has(key);\n            if (!writeAllowed) {\n                return JSON.stringify({\n                    ok: false,\n                    error: `Writing \"${id}\" is not allowed: device \"${key}\" is read-only in the assistant settings.`,\n                });\n            }\n        }\n        return baseRun(args);\n    };\n}\n\n/**\n * Build the LLM tool set from the in-process ioBroker MCP server, filtered by the access config and\n * enforcing the per-device write ACL.\n *\n * All tools come from `@iobroker/mcp-server` — nothing is duplicated here. Gating layers:\n *  1. `createInProcessMcp({ allowSetState, allowObjectChange })` — which tools exist at all.\n *  2. `isToolAllowed()` — fine-grained category toggles (logs/history/files/object-read scope/…).\n *  3. `guardWrite()` — per-device write ACL (`access.deviceAcl`), e.g. keep a lock read-only.\n */\nexport async function buildMcpTools(\n    mcp: InProcessMcp,\n    access: ToolAccess,\n    cache: ListCache = new ListCache(),\n    resolveName?: (stateId: string, fallback: string) => Promise<string>,\n): Promise<{ tools: Tool[]; denied: string[]; cache: ListCache }> {\n    const infos = await mcp.listTools();\n    const acl = access.deviceAcl || {};\n    // Write guard: whenever writing is enabled (explicit ACL + type defaults like locks).\n    const enforceWrite = access.allowWriteStates;\n    // Read guard: whenever any device is set read-disabled (hide it from list_devices + get_states).\n    const enforceRead = Object.values(acl).some(a => a && a.read === false);\n    const { stateToKey, defaultWriteFalse } =\n        enforceWrite || enforceRead\n            ? await loadStateDeviceMap(mcp)\n            : { stateToKey: new Map<string, string>(), defaultWriteFalse: new Set<string>() };\n\n    const tools: Tool[] = [];\n    const denied: string[] = [];\n    for (const info of infos) {\n        if (!isToolAllowed(info.name, access)) {\n            denied.push(info.name);\n            continue;\n        }\n        const callTool = async (args: Record<string, unknown>): Promise<string> => {\n            const text = (await mcp.callTool(info.name, args)).text;\n            // For the LLM: drop buttons + read-disabled devices, and use friendly names.\n            return info.name === 'list_devices' ? postProcessListDevices(text, acl, resolveName) : text;\n        };\n        // Serve stable, expensive read-only listings from the short-TTL cache; everything else runs live.\n        const baseRun: (args: Record<string, unknown>) => Promise<unknown> = CACHEABLE_TOOLS.has(info.name)\n            ? (args): Promise<string> => cache.run(`${info.name}:${JSON.stringify(args ?? {})}`, () => callTool(args))\n            : callTool;\n        let run = baseRun;\n        if (enforceWrite && (info.name === 'set_state' || info.name === 'set_states')) {\n            run = guardWrite(info.name, baseRun, stateToKey, acl, defaultWriteFalse);\n        } else if (enforceRead && info.name === 'get_states') {\n            run = guardRead(baseRun, stateToKey, acl);\n        }\n        tools.push({ name: info.name, description: info.description || '', parameters: info.inputSchema, run });\n    }\n\n    // Synthetic (non-MCP) tool: lets the model bust the device/room cache and re-scan. Useful when a\n    // device the user mentions is missing from list_devices (stale cache) or was just added/renamed.\n    tools.push({\n        name: 'refresh_device_cache',\n        description:\n            'Clear the cached device, room and function listings so the next list_devices, list_rooms or list_functions call performs a fresh scan. Call this when a device or room the user mentions is not in the list, or when the user says a device was just added, renamed or reassigned, then retry.',\n        parameters: { type: 'object', properties: {}, additionalProperties: false },\n        run: (): Promise<string> => {\n            cache.clear();\n            return Promise.resolve(JSON.stringify({ ok: true, data: { cleared: true } }));\n        },\n    });\n\n    return { tools, denied, cache };\n}\n"]}

package/build/lib/voice/esphome.js

@@ -160,6 +160,15 @@ class EsphomeSatellites {
         target.setWakeWords(ids);
         return true;
     }
+    /**
+     * Offer the current custom wake words to every connected satellite again — after one was uploaded
+     * or deleted. Each device answers with its new configuration (→ `onWakeWords`).
+     */
+    refreshWakeWords() {
+        const online = this.connections.filter(c => c.online);
+        online.forEach(c => c.requestWakeWordConfig());
+        return online.length;
+    }
     /** Everything one satellite exposes besides the voice pipeline (gain, noise suppression, …). */
     entities(device) {
         return this.connections.find(c => c.online && c.deviceName === device)?.entities.list() ?? [];
@@ -208,6 +217,12 @@ class EsphomeConnection {
     online = false;
     /** Last wake-word configuration the device reported; null until the handshake answers. */
     wakeWordConfig = null;
+    /**
+     * One entry per configuration request in flight, in send order (the device answers each one, in
+     * order): the ids a preceding `SetConfiguration` asked for, or null. The read-back is the only
+     * failure signal the device gives.
+     */
+    configChecks = [];
     /** Everything else the device exposes — rebuilt from scratch on every reconnect. */
     entities = new esphomeEntities_1.EntityRegistry();
     host;
@@ -261,6 +276,7 @@ class EsphomeConnection {
         // The device re-announces everything after a reconnect, and the keys are not stable across
         // reboots, so starting from a clean slate is the only safe option.
         this.entities.clear();
+        this.configChecks = [];
         const socket = net.createConnection({ host: this.host, port: this.port }, () => {
             this.opts.log.debug(`ESPHome ${this.host}:${this.port} connected`);
             this.handshake();
@@ -379,7 +395,7 @@ class EsphomeConnection {
         subscribe.setSubscribe(true);
         subscribe.setFlags(SUBSCRIBE_API_AUDIO);
         this.send(subscribe);
-        this.send(new esphomeProto_1.pb.VoiceAssistantConfigurationRequest());
+        this.requestWakeWordConfig();
         this.pingTimer = setInterval(() => {
             if (++this.missedPings > 2) {
                 this.opts.log.info(`ESPHome ${this.deviceName}: no reply to keepalive — reconnecting`);
@@ -413,18 +429,32 @@ class EsphomeConnection {
             }
             case 'VoiceAssistantConfigurationResponse': {
                 const config = message;
+                // A custom wake word the device already downloaded is listed twice: once from its own
+                // model folder and once from our offer.
+                const seen = new Set();
                 this.wakeWordConfig = {
                     active: config.getActiveWakeWordsList(),
-                    available: config.getAvailableWakeWordsList().map(w => ({
+                    available: config
+                        .getAvailableWakeWordsList()
+                        .map(w => ({
                         id: w.getId(),
                         phrase: w.getWakeWord(),
                         languages: w.getTrainedLanguagesList(),
-                    })),
+                    }))
+                        .filter(w => !seen.has(w.id) && !!seen.add(w.id)),
                     max: config.getMaxActiveWakeWords(),
                 };
                 const active = this.wakeWordConfig.active.join(', ') || '(none active)';
                 const available = this.wakeWordConfig.available.map(w => w.id);
                 this.opts.log.info(`ESPHome ${this.deviceName}: wake words ${active}${available.length ? ` (available: ${available.join(', ')})` : ''}`);
+                const requested = this.configChecks.shift();
+                const missing = requested?.filter(id => !this.wakeWordConfig?.active.includes(id)) ?? [];
+                if (missing.length) {
+                    // The device answers a model it cannot fetch or load with silence, not an error.
+                    this.opts.log.warn(`ESPHome ${this.deviceName}: could not activate wake word(s) ${missing.join(', ')}. ` +
+                        `For an uploaded wake word the device must reach ${this.mediaUrl('/')} and the model ` +
+                        `must be a microWakeWord .tflite.`);
+                }
                 this.opts.onWakeWords?.(this.deviceName, this.room, this.wakeWordConfig);
                 return;
             }
@@ -611,15 +641,27 @@ class EsphomeConnection {
                 room: this.room,
                 wakeWord: capture.wakeWord,
                 sttMs,
+                audioMs: Math.round(seconds * 1000),
+                vad: {
+                    peak: Math.round(capture.detector.peak),
+                    noiseFloor: Math.round(capture.detector.noiseFloor),
+                    startLevel: Math.round(capture.detector.startLevel),
+                    endLevel: Math.round(capture.detector.endLevel),
+                },
             })).trim();
-            const followUp = !!answer && this.opts.expectsFollowUp?.(answer) === true;
+            const followUp = !!answer && this.opts.expectsFollowUp?.(answer, this.deviceName) === true;
             this.event(EVENT.INTENT_END, followUp ? { continue_conversation: '1' } : undefined);
             if (!answer) {
                 this.event(EVENT.RUN_END);
                 this.status('idle');
                 return;
             }
+            const ttsStart = Date.now();
             const { pcm: ttsPcm, sampleRate } = await this.opts.tts.synthesize(answer, this.opts.language);
+            this.opts.onSpoken?.(this.deviceName, {
+                ms: Date.now() - ttsStart,
+                audioMs: (ttsPcm.length / 2 / sampleRate) * 1000,
+            });
             const url = this.publish(ttsPcm, sampleRate);
             this.status('speaking');
             this.event(EVENT.TTS_START, { text: answer });
@@ -664,8 +706,37 @@ class EsphomeConnection {
         message.setActiveWakeWordsList(valid);
         this.send(message);
         this.opts.log.info(`ESPHome ${this.deviceName}: wake words set to ${valid.join(', ') || '(none)'}`);
-        // Read back, so the reported state is the device's and not our guess.
-        this.send(new esphomeProto_1.pb.VoiceAssistantConfigurationRequest());
+        // Read back, so the reported state is the device's and not our guess. The device resolves a
+        // custom wake word (and downloads it) while handling the SetConfiguration, so this answer
+        // already tells whether that worked.
+        this.requestWakeWordConfig(valid);
+    }
+    /**
+     * Ask the device for its wake-word configuration. The request always carries the current custom
+     * wake words: the firmware replaces its list of offered models with every request, so one sent
+     * without them would make an uploaded wake word vanish from the device until the next offer.
+     *
+     * @param check ids a SetConfiguration just asked for — warned about if the answer lacks them
+     */
+    requestWakeWordConfig(check = null) {
+        const request = new esphomeProto_1.pb.VoiceAssistantConfigurationRequest();
+        const offers = this.opts.externalWakeWords?.() ?? [];
+        request.setExternalWakeWordsList(offers.map(offer => {
+            const w = new esphomeProto_1.pb.VoiceAssistantExternalWakeWord();
+            w.setId(offer.id);
+            w.setWakeWord(offer.phrase);
+            w.setTrainedLanguagesList(offer.languages);
+            w.setModelType('micro');
+            w.setModelSize(offer.size);
+            w.setModelHash(offer.sha256);
+            w.setUrl(this.mediaUrl(offer.path));
+            return w;
+        }));
+        // A device that never answers must not let this grow without bound.
+        if (this.configChecks.length < 16) {
+            this.configChecks.push(check);
+        }
+        this.send(request);
     }
     /** Drop a half-finished capture (device went away, or told us to stop). */
     abortCapture() {
@@ -705,7 +776,10 @@ class EsphomeConnection {
      * addresses, and the local end of *this* socket is by definition one it can talk to.
      */
     publish(pcm, sampleRate) {
-        const path = this.opts.media.publish((0, stt_1.pcmToWav)(pcm, sampleRate), 'audio/wav');
+        return this.mediaUrl(this.opts.media.publish((0, stt_1.pcmToWav)(pcm, sampleRate), 'audio/wav'));
+    }
+    /** Absolute URL of a path on the media server, with a host this device can reach. */
+    mediaUrl(path) {
         const local = (this.socket?.localAddress || '').replace(/^::ffff:/, '');
         const host = this.opts.mediaHost?.trim() || local || '127.0.0.1';
         // An IPv6 literal has to be bracketed in a URL.

package/build/lib/voice/esphome.js.map

@@ -1 +1 @@
-{"version":3,"file":"esphome.js","sourceRoot":"","sources":["../../../src/lib/voice/esphome.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ESPHome voice satellites — the fourth transport, next to the UDP server (`voiceServer.ts`) and the\n * Wyoming endpoint (`wyoming.ts`).\n *\n * Unlike those two, this one is a **client**: an ESPHome voice satellite is a *server* that waits on\n * TCP 6053 for the home-automation controller to connect and drive it. We therefore dial out to each\n * configured device and play the role Home Assistant normally plays. That covers the ThirdReality\n * Voice & Music Assistant (Dev Edition), the Home Assistant Voice PE and any box running\n * OHF-Voice/linux-voice-assistant.\n *\n * Flow for one utterance (verified against the firmware's `src/satellite/Satellite.cpp`):\n *\n *   device  →  VoiceAssistantRequest{start, wake_word_phrase}   wake word fired on the device\n *   we      →  VoiceAssistantResponse{port:0}                   0 = audio over the API, no UDP\n *   we      →  RUN_START, WAKE_WORD_END, STT_START, STT_VAD_START\n *   device  →  VoiceAssistantAudio …                            16 kHz mono s16le, *until told to stop*\n *   we      →  STT_VAD_END                                      ← the device has no VAD of its own\n *   we      →  STT_END{text}, INTENT_START, INTENT_END, TTS_START{text}, TTS_END{url}, RUN_END\n *   device  →  fetches the URL over HTTP, plays it, VoiceAssistantAnnounceFinished\n *\n * Two consequences shape this file: end-of-speech detection is ours (`vad.ts`), and the spoken reply\n * has to be reachable over HTTP (`mediaServer.ts`) rather than streamed down the socket.\n */\nimport * as net from 'node:net';\nimport {\n    pb,\n    encode,\n    decode,\n    type PbMessage,\n    type AuthenticationResponse,\n    type DeviceInfoResponse,\n    type HelloResponse,\n    type VoiceAssistantAnnounceFinished,\n    type VoiceAssistantAudio,\n    type VoiceAssistantConfigurationResponse,\n    type VoiceAssistantEventData,\n    type VoiceAssistantRequestMsg,\n} from './esphomeProto';\nimport { EntityRegistry, isEntityStateMessage, isListEntityMessage, type EsphomeEntity } from './esphomeEntities';\nimport { SpeechDetector, type Bytes } from './vad';\nimport { pcmToWav } from './stt';\nimport type { SttEngine } from './stt';\nimport type { TtsEngine } from './tts';\nimport type { SatelliteState } from './protocol';\n\n/** `VoiceAssistantEvent` (api.proto) — the subset we emit. */\nconst EVENT = {\n    ERROR: 0,\n    RUN_START: 1,\n    RUN_END: 2,\n    STT_START: 3,\n    STT_END: 4,\n    INTENT_START: 5,\n    INTENT_END: 6,\n    TTS_START: 7,\n    TTS_END: 8,\n    WAKE_WORD_END: 10,\n    STT_VAD_START: 11,\n    STT_VAD_END: 12,\n} as const;\n\n/** `SubscribeVoiceAssistantRequest.flags`: audio over the API socket instead of a UDP side channel. */\nconst SUBSCRIBE_API_AUDIO = 1;\n/** ESPHome voice satellites always capture at 16 kHz mono 16-bit. */\nconst MIC_SAMPLE_RATE = 16000;\n/**\n * Leading audio to keep out of the end-of-speech analysis. These devices acknowledge the wake word\n * with a chirp through their own speaker and hear it back on their own microphone, far louder than\n * the speech that follows. Without this the chirp alone satisfies the detector's speech test — so\n * `sawSpeech` stops meaning \"somebody said something\" and a false wake is billed to STT — and it\n * drags the noise floor up with it.\n *\n * Measured over four captures from a ThirdReality Voice & Music Assistant (RMS per 50 ms, remarkably\n * repeatable across all four):\n *\n *     ms    0    50   100   150   200   250   300   350   400   450   500   550   600\n *     rms  ~20 ~900 ~11k  ~19k  ~14k  ~1.3k ~990  ~780  ~610  ~370  ~330  ~165  ~180\n *\n * so the chirp is still above the gate at 500 ms and only clears it around 550–600. 600 ms is the\n * smallest value that rejects a chirp-only wake while still detecting the speech in every one of the\n * four captures, with no change to when the utterance closes. The audio itself is untouched and still\n * goes to STT in full, so a speaker who starts inside this window loses nothing but a late gate open.\n */\nconst WAKE_CHIRP_MS = 600;\n/** Default API port of an ESPHome device. */\nconst DEFAULT_PORT = 6053;\n/** Keepalive interval; two missed replies count as a dead link. */\nconst PING_INTERVAL_MS = 20_000;\n/** Wait between reconnect attempts. Devices reboot, and a Wi-Fi speaker drops off now and then. */\nconst RECONNECT_MS = 10_000;\n/** Give up on a pipeline that produced no audio at all (device wedged mid-stream). */\nconst PIPELINE_TIMEOUT_MS = 30_000;\n/** How long we wait for the device to report that it finished playing before forcing it back to idle. */\nconst PLAYBACK_TIMEOUT_MS = 60_000;\n\nexport interface EsphomeDevice {\n    /** Host name or IP of the satellite. */\n    ip: string;\n    /** API port; empty/0 → 6053. */\n    port?: number;\n    /** API password, if one is configured on the device. */\n    password?: string;\n    /** Room this satellite belongs to (drives `satellites.<room>.*` and the answer context). */\n    room?: string;\n}\n\nexport interface EsphomeSatellitesOptions {\n    devices: EsphomeDevice[];\n    /** ISO-639-1 language hint for STT/TTS ('' = auto/provider default). */\n    language: string;\n    stt: SttEngine;\n    tts: TtsEngine;\n    /** Produce the assistant reply for a transcribed utterance. */\n    answer: (\n        question: string,\n        ctx: { device: string; room: string; wakeWord: string; sttMs: number },\n    ) => Promise<string>;\n    /** Optional STT vocabulary hints (device/room names) to bias recognition; re-read per utterance. */\n    getHints?: () => string[] | Promise<string[]>;\n    /** Where spoken replies are published for the device to fetch. */\n    media: MediaHost;\n    /**\n     * Host the device should call back on. Empty → the local address of our socket to that device,\n     * which is automatically the right interface on a multi-homed host.\n     */\n    mediaHost?: string;\n    /** Silence that ends an utterance, in ms ('' / 0 → the detector default). */\n    silenceMs?: number;\n    log: ioBroker.Logger;\n    /** Notified on every satellite state transition (idle/listening/processing/speaking/offline). */\n    onStatus?: (device: string, room: string, state: SatelliteState | 'offline') => void;\n    /** Notified with the device's wake-word configuration, on connect and after every change. */\n    onWakeWords?: (device: string, room: string, config: WakeWordConfig) => void;\n    /** Notified once per connect with everything the device exposes besides the voice pipeline. */\n    onEntities?: (device: string, room: string, entities: EsphomeEntity[]) => void;\n    /** Notified whenever one of those entities changes (and once per entity right after connecting). */\n    onEntityState?: (device: string, room: string, entity: EsphomeEntity) => void;\n    /** True when the reply asks something back, so the device should re-open its mic without a wake word. */\n    expectsFollowUp?: (answer: string) => boolean;\n}\n\n/** What a device reports about its wake words. Which ones exist is fixed by the firmware. */\nexport interface WakeWordConfig {\n    /** Ids currently listening, e.g. `['okay_nabu']`. */\n    active: string[];\n    /** Everything the firmware ships, with the spoken phrase and the languages it was trained on. */\n    available: { id: string; phrase: string; languages: string[] }[];\n    /** How many may listen at once — 2 on the ThirdReality speaker, which has a sensitivity per slot. */\n    max: number;\n}\n\n/** `VoiceAssistantTimerEvent` in api.proto. */\nexport const TIMER_EVENT = { started: 0, updated: 1, cancelled: 2, finished: 3 } as const;\n\n/** One assistant timer, as the device wants to hear about it. */\nexport interface TimerEvent {\n    type: keyof typeof TIMER_EVENT;\n    id: string;\n    name: string;\n    totalSeconds: number;\n    secondsLeft: number;\n    /** False once it has finished or been cancelled — the device clears its ring on that. */\n    active: boolean;\n}\n\n/** The slice of `MediaServer` this module needs (kept narrow so tests can pass a stub). */\nexport interface MediaHost {\n    port: number;\n    publish(body: Buffer, contentType?: string, ttlMs?: number): string;\n}\n\n/**\n * All configured ESPHome satellites. Owns one connection per device and offers the same surface the\n * adapter already uses for the UDP server: `devices()` and `announce()`.\n */\nexport class EsphomeSatellites {\n    private readonly connections: EsphomeConnection[] = [];\n\n    constructor(private readonly opts: EsphomeSatellitesOptions) {}\n\n    async start(): Promise<void> {\n        for (const device of this.opts.devices) {\n            if (!device.ip?.trim()) {\n                continue;\n            }\n            const connection = new EsphomeConnection(device, this.opts);\n            this.connections.push(connection);\n            connection.start();\n        }\n        if (!this.connections.length) {\n            this.opts.log.warn('ESPHome satellites enabled, but no device addresses are configured.');\n        }\n        return Promise.resolve();\n    }\n\n    async stop(): Promise<void> {\n        await Promise.all(this.connections.map(c => c.stop()));\n        this.connections.length = 0;\n    }\n\n    /** Device names of the satellites currently connected. */\n    devices(): string[] {\n        return this.connections.filter(c => c.online).map(c => c.deviceName);\n    }\n\n    /** Wake-word configuration of one connected satellite, or null if it is unknown/offline. */\n    wakeWords(device: string): WakeWordConfig | null {\n        return this.connections.find(c => c.online && c.deviceName === device)?.wakeWordConfig ?? null;\n    }\n\n    /**\n     * Choose which wake words listen on one satellite. Ids come from {@link WakeWordConfig.available};\n     * the device stores the selection itself, so it survives a restart of the adapter.\n     */\n    setWakeWords(device: string, ids: string[]): boolean {\n        const target = this.connections.find(c => c.online && c.deviceName === device);\n        if (!target) {\n            return false;\n        }\n        target.setWakeWords(ids);\n        return true;\n    }\n\n    /** Everything one satellite exposes besides the voice pipeline (gain, noise suppression, …). */\n    entities(device: string): EsphomeEntity[] {\n        return this.connections.find(c => c.online && c.deviceName === device)?.entities.list() ?? [];\n    }\n\n    /**\n     * Write one of those entities. Returns false when the satellite is offline, the entity is unknown\n     * or read-only, or the value is not one the device accepts.\n     */\n    setEntity(device: string, objectId: string, value: unknown): boolean {\n        const target = this.connections.find(c => c.online && c.deviceName === device);\n        return target ? target.setEntity(objectId, value) : false;\n    }\n\n    /**\n     * Mirror an assistant timer onto the satellites so they can show it on their own LED ring and ring\n     * it themselves. `device` null broadcasts. Returns how many devices were told.\n     */\n    timerEvent(device: string | null, event: TimerEvent): number {\n        const targets = this.connections.filter(c => c.online && (!device || c.deviceName === device));\n        targets.forEach(c => c.sendTimerEvent(event));\n        return targets.length;\n    }\n\n    /**\n     * Play a ready PCM buffer on one satellite (by device name) or all of them. Returns how many\n     * devices it was handed to.\n     *\n     * With `startConversation` the device opens its microphone as soon as the clip has played, without\n     * a wake word — that is how a question gets its answer (see `PendingQuestions`).\n     */\n    async announce(device: string | null, pcm: Buffer, sampleRate: number, startConversation = false): Promise<number> {\n        const targets = this.connections.filter(c => c.online && (!device || c.deviceName === device));\n        if (!targets.length) {\n            return 0;\n        }\n        await Promise.all(\n            targets.map(c =>\n                c\n                    .announce(pcm, sampleRate, startConversation)\n                    .catch(e => this.opts.log.warn(`announce to ${c.deviceName} failed: ${(e as Error).message}`)),\n            ),\n        );\n        return targets.length;\n    }\n}\n\n/** State of the utterance currently being captured. */\ninterface Capture {\n    chunks: Buffer[];\n    detector: SpeechDetector;\n    conversationId: string;\n    /** Wake word that opened this capture; '' when the mic was re-opened for a follow-up/question. */\n    wakeWord: string;\n    timer: NodeJS.Timeout;\n    closed: boolean;\n}\n\n/** One satellite: socket lifecycle, handshake, and the voice pipeline. */\nclass EsphomeConnection {\n    /** Device name as reported by the device; falls back to its address until the handshake answers. */\n    deviceName: string;\n    online = false;\n    /** Last wake-word configuration the device reported; null until the handshake answers. */\n    wakeWordConfig: WakeWordConfig | null = null;\n    /** Everything else the device exposes — rebuilt from scratch on every reconnect. */\n    readonly entities = new EntityRegistry();\n\n    private readonly host: string;\n    private readonly port: number;\n    private readonly room: string;\n\n    private socket: net.Socket | null = null;\n    private rx: Bytes = Buffer.alloc(0);\n    private pingTimer: NodeJS.Timeout | null = null;\n    private reconnectTimer: NodeJS.Timeout | null = null;\n    private missedPings = 0;\n    private stopping = false;\n    private capture: Capture | null = null;\n    private playbackTimer: NodeJS.Timeout | null = null;\n    private readonly password: string;\n\n    constructor(\n        device: EsphomeDevice,\n        private readonly opts: EsphomeSatellitesOptions,\n    ) {\n        this.host = device.ip.trim();\n        this.port = device.port || DEFAULT_PORT;\n        this.room = (device.room || '').trim();\n        this.password = device.password || '';\n        this.deviceName = this.host;\n    }\n\n    // ── lifecycle ───────────────────────────────────────────────────────────────────────────────────\n\n    start(): void {\n        this.connect();\n    }\n\n    async stop(): Promise<void> {\n        this.stopping = true;\n        this.clearTimers();\n        this.abortCapture();\n        const socket = this.socket;\n        this.socket = null;\n        if (socket) {\n            try {\n                socket.write(encode(new pb.DisconnectRequest()));\n            } catch {\n                /* socket already gone — nothing to say goodbye on */\n            }\n            socket.destroy();\n        }\n        this.setOffline();\n        return Promise.resolve();\n    }\n\n    private connect(): void {\n        if (this.stopping) {\n            return;\n        }\n        this.rx = Buffer.alloc(0);\n        this.missedPings = 0;\n        // The device re-announces everything after a reconnect, and the keys are not stable across\n        // reboots, so starting from a clean slate is the only safe option.\n        this.entities.clear();\n\n        const socket = net.createConnection({ host: this.host, port: this.port }, () => {\n            this.opts.log.debug(`ESPHome ${this.host}:${this.port} connected`);\n            this.handshake();\n        });\n        this.socket = socket;\n        socket.setNoDelay(true);\n\n        socket.on('data', data => this.onData(data));\n        socket.on('error', e => {\n            // A satellite that is switched off is normal, so this is not an error-level event.\n            this.opts.log.debug(`ESPHome ${this.host}: ${e.message}`);\n        });\n        socket.on('close', () => {\n            if (this.socket === socket) {\n                this.socket = null;\n                this.onDisconnected();\n            }\n        });\n    }\n\n    private onDisconnected(): void {\n        this.clearTimers();\n        this.abortCapture();\n        if (this.online) {\n            this.opts.log.info(`ESPHome satellite offline: ${this.deviceName}`);\n        }\n        this.setOffline();\n        this.scheduleReconnect();\n    }\n\n    private scheduleReconnect(): void {\n        if (this.stopping || this.reconnectTimer) {\n            return;\n        }\n        this.reconnectTimer = setTimeout(() => {\n            this.reconnectTimer = null;\n            this.connect();\n        }, RECONNECT_MS);\n        this.reconnectTimer.unref();\n    }\n\n    private clearTimers(): void {\n        if (this.pingTimer) {\n            clearInterval(this.pingTimer);\n            this.pingTimer = null;\n        }\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = null;\n        }\n        if (this.playbackTimer) {\n            clearTimeout(this.playbackTimer);\n            this.playbackTimer = null;\n        }\n    }\n\n    private setOffline(): void {\n        if (this.online) {\n            this.online = false;\n            this.opts.onStatus?.(this.deviceName, this.room, 'offline');\n        }\n    }\n\n    private status(state: SatelliteState): void {\n        this.opts.onStatus?.(this.deviceName, this.room, state);\n    }\n\n    // ── protocol plumbing ───────────────────────────────────────────────────────────────────────────\n\n    private send(message: PbMessage): void {\n        const socket = this.socket;\n        if (!socket || socket.destroyed) {\n            return;\n        }\n        try {\n            socket.write(encode(message));\n        } catch (e) {\n            this.opts.log.debug(`ESPHome ${this.deviceName}: send failed — ${(e as Error).message}`);\n        }\n    }\n\n    private onData(data: Buffer): void {\n        this.rx = this.rx.length ? Buffer.concat([this.rx, data]) : data;\n        let frames;\n        try {\n            ({ frames, rest: this.rx } = decode(this.rx));\n        } catch (e) {\n            this.opts.log.error(`ESPHome ${this.deviceName}: ${(e as Error).message}`);\n            this.socket?.destroy();\n            return;\n        }\n        for (const frame of frames) {\n            if (frame.error) {\n                this.opts.log.debug(`ESPHome ${this.deviceName}: cannot parse ${frame.name}`);\n                continue;\n            }\n            if (!frame.name || !frame.message) {\n                continue; // unknown id — already skipped by its declared length\n            }\n            try {\n                this.onMessage(frame.name, frame.message);\n            } catch (e) {\n                this.opts.log.warn(\n                    `ESPHome ${this.deviceName}: ${frame.name} handler failed — ${(e as Error).message}`,\n                );\n            }\n        }\n    }\n\n    private handshake(): void {\n        const hello = new pb.HelloRequest();\n        hello.setClientInfo('ioBroker.assistant');\n        hello.setApiVersionMajor(1);\n        hello.setApiVersionMinor(10);\n        this.send(hello);\n\n        const auth = new pb.AuthenticationRequest();\n        auth.setPassword(this.password);\n        this.send(auth);\n\n        this.send(new pb.DeviceInfoRequest());\n        // Ask for the entity announcements *before* subscribing to their states: a state message whose\n        // entity we have not seen yet has nothing to attach to and is dropped.\n        this.send(new pb.ListEntitiesRequest());\n        this.send(new pb.SubscribeStatesRequest());\n\n        const subscribe = new pb.SubscribeVoiceAssistantRequest();\n        subscribe.setSubscribe(true);\n        subscribe.setFlags(SUBSCRIBE_API_AUDIO);\n        this.send(subscribe);\n\n        this.send(new pb.VoiceAssistantConfigurationRequest());\n\n        this.pingTimer = setInterval(() => {\n            if (++this.missedPings > 2) {\n                this.opts.log.info(`ESPHome ${this.deviceName}: no reply to keepalive — reconnecting`);\n                this.socket?.destroy();\n                return;\n            }\n            this.send(new pb.PingRequest());\n        }, PING_INTERVAL_MS);\n        this.pingTimer.unref();\n    }\n\n    private onMessage(name: string, message: unknown): void {\n        switch (name) {\n            case 'HelloResponse': {\n                const hello = message as HelloResponse;\n                this.opts.log.debug(\n                    `ESPHome ${this.host}: ${hello.getServerInfo()} (API ${hello.getApiVersionMajor()}.${hello.getApiVersionMinor()})`,\n                );\n                return;\n            }\n\n            case 'AuthenticationResponse':\n                if ((message as AuthenticationResponse).getInvalidPassword()) {\n                    this.opts.log.error(\n                        `ESPHome ${this.host}: API password rejected — check the device's password in the settings.`,\n                    );\n                    this.socket?.destroy();\n                }\n                return;\n\n            case 'DeviceInfoResponse': {\n                const info = message as DeviceInfoResponse;\n                this.deviceName = info.getName() || this.host;\n                this.online = true;\n                this.opts.log.info(\n                    `ESPHome satellite online: ${this.deviceName} (${info.getModel()}) @ ${this.host}${this.room ? `, room ${this.room}` : ''}`,\n                );\n                this.status('idle');\n                return;\n            }\n\n            case 'VoiceAssistantConfigurationResponse': {\n                const config = message as VoiceAssistantConfigurationResponse;\n                this.wakeWordConfig = {\n                    active: config.getActiveWakeWordsList(),\n                    available: config.getAvailableWakeWordsList().map(w => ({\n                        id: w.getId(),\n                        phrase: w.getWakeWord(),\n                        languages: w.getTrainedLanguagesList(),\n                    })),\n                    max: config.getMaxActiveWakeWords(),\n                };\n                const active = this.wakeWordConfig.active.join(', ') || '(none active)';\n                const available = this.wakeWordConfig.available.map(w => w.id);\n                this.opts.log.info(\n                    `ESPHome ${this.deviceName}: wake words ${active}${available.length ? ` (available: ${available.join(', ')})` : ''}`,\n                );\n                this.opts.onWakeWords?.(this.deviceName, this.room, this.wakeWordConfig);\n                return;\n            }\n\n            case 'VoiceAssistantRequest':\n                this.onPipelineRequest(message as VoiceAssistantRequestMsg);\n                return;\n\n            case 'VoiceAssistantAudio':\n                this.onAudio(message as VoiceAssistantAudio);\n                return;\n\n            case 'VoiceAssistantAnnounceFinished':\n                if (this.playbackTimer) {\n                    clearTimeout(this.playbackTimer);\n                    this.playbackTimer = null;\n                }\n                this.opts.log.debug(\n                    `ESPHome ${this.deviceName}: playback finished (success=${(message as VoiceAssistantAnnounceFinished).getSuccess()})`,\n                );\n                this.status('idle');\n                return;\n\n            case 'PingRequest':\n                this.send(new pb.PingResponse());\n                return;\n\n            case 'PingResponse':\n                this.missedPings = 0;\n                return;\n\n            case 'GetTimeRequest': {\n                // The device has no RTC and syncs its clock from us — its timer ring depends on it.\n                const time = new pb.GetTimeResponse();\n                time.setEpochSeconds(Math.floor(Date.now() / 1000));\n                this.send(time);\n                return;\n            }\n\n            case 'DisconnectRequest':\n                this.send(new pb.DisconnectResponse());\n                this.socket?.destroy();\n                return;\n\n            case 'ListEntitiesDoneResponse': {\n                const list = this.entities.list();\n                if (list.length) {\n                    this.opts.log.debug(\n                        `ESPHome ${this.deviceName}: ${list.length} entities — ${list.map(e => e.objectId).join(', ')}`,\n                    );\n                }\n                this.opts.onEntities?.(this.deviceName, this.room, list);\n                return;\n            }\n\n            default:\n                if (isListEntityMessage(name)) {\n                    this.entities.addFromAnnouncement(name, message);\n                } else if (isEntityStateMessage(name)) {\n                    const entity = this.entities.applyState(name, message);\n                    if (entity) {\n                        this.opts.onEntityState?.(this.deviceName, this.room, entity);\n                    }\n                }\n                return;\n        }\n    }\n\n    /** Write one of the device's entities. See {@link EsphomeSatellites.setEntity}. */\n    setEntity(objectId: string, value: unknown): boolean {\n        const message = this.entities.command(objectId, value);\n        if (!message) {\n            const entity = this.entities.get(objectId);\n            const known = this.entities\n                .list()\n                .map(e => e.objectId)\n                .join(', ');\n            const options = entity?.options ? ` (one of: ${entity.options.join(', ')})` : '';\n            this.opts.log.warn(\n                entity\n                    ? `ESPHome ${this.deviceName}: ${JSON.stringify(value)} is not a value \"${objectId}\" accepts${options}`\n                    : `ESPHome ${this.deviceName}: no entity \"${objectId}\" (have: ${known})`,\n            );\n            return false;\n        }\n        this.send(message);\n        this.opts.log.debug(`ESPHome ${this.deviceName}: ${objectId} := ${JSON.stringify(value)}`);\n        return true;\n    }\n\n    /** Push one assistant timer to the device so it can show and ring it itself. */\n    sendTimerEvent(event: TimerEvent): void {\n        const message = new pb.VoiceAssistantTimerEventResponse();\n        message.setEventType(TIMER_EVENT[event.type]);\n        message.setTimerId(event.id);\n        message.setName(event.name);\n        message.setTotalSeconds(Math.max(0, Math.round(event.totalSeconds)));\n        message.setSecondsLeft(Math.max(0, Math.round(event.secondsLeft)));\n        message.setIsActive(event.active);\n        this.send(message);\n    }\n\n    // ── voice pipeline ──────────────────────────────────────────────────────────────────────────────\n\n    private onPipelineRequest(request: VoiceAssistantRequestMsg): void {\n        if (!request.getStart()) {\n            this.abortCapture();\n            return;\n        }\n        if (this.capture) {\n            this.opts.log.debug(`ESPHome ${this.deviceName}: pipeline already running — ignoring wake`);\n            return;\n        }\n\n        const phrase = request.getWakeWordPhrase();\n        this.opts.log.debug(`ESPHome ${this.deviceName}: wake \"${phrase || '(follow-up)'}\"`);\n\n        const response = new pb.VoiceAssistantResponse();\n        response.setPort(0); // 0 = stream the audio over this socket\n        response.setError(false);\n        this.send(response);\n\n        const timer = setTimeout(() => {\n            this.opts.log.warn(`ESPHome ${this.deviceName}: no end of speech within ${PIPELINE_TIMEOUT_MS} ms`);\n            void this.finishCapture();\n        }, PIPELINE_TIMEOUT_MS);\n        timer.unref();\n\n        this.capture = {\n            chunks: [],\n            detector: new SpeechDetector({\n                sampleRate: MIC_SAMPLE_RATE,\n                silenceMs: this.opts.silenceMs || undefined,\n                // Microphone gain differs wildly between these devices, so fixed RMS levels do not\n                // travel: derive them from the room instead, once the wake chirp is out of the way.\n                skipMs: WAKE_CHIRP_MS,\n                adaptive: true,\n            }),\n            conversationId: request.getConversationId(),\n            wakeWord: phrase || '',\n            timer,\n            closed: false,\n        };\n\n        this.status('listening');\n        this.event(EVENT.RUN_START);\n        if (phrase) {\n            this.event(EVENT.WAKE_WORD_END, { wake_word_phrase: phrase });\n        }\n        this.event(EVENT.STT_START);\n        this.event(EVENT.STT_VAD_START);\n    }\n\n    private onAudio(audio: VoiceAssistantAudio): void {\n        const capture = this.capture;\n        if (!capture || capture.closed) {\n            return;\n        }\n        const chunk = Buffer.from(audio.getData_asU8());\n        if (chunk.length) {\n            capture.chunks.push(chunk);\n            if (capture.detector.push(chunk)) {\n                void this.finishCapture();\n                return;\n            }\n        }\n        if (audio.getEnd()) {\n            void this.finishCapture();\n        }\n    }\n\n    /** Stop the mic stream and run STT → answer → TTS for what was captured. */\n    private async finishCapture(): Promise<void> {\n        const capture = this.capture;\n        if (!capture || capture.closed) {\n            return;\n        }\n        capture.closed = true;\n        this.capture = null;\n        clearTimeout(capture.timer);\n\n        // Send this first: the device streams until it sees it.\n        this.event(EVENT.STT_VAD_END);\n\n        const pcm = Buffer.concat(capture.chunks);\n        const seconds = pcm.length / 2 / MIC_SAMPLE_RATE;\n        this.opts.log.debug(\n            `ESPHome ${this.deviceName}: captured ${seconds.toFixed(2)} s ` +\n                `(peak RMS ${Math.round(capture.detector.peak)}, noise floor ${Math.round(capture.detector.noiseFloor)}, ` +\n                `speech/silence gate ${Math.round(capture.detector.startLevel)}/${Math.round(capture.detector.endLevel)})`,\n        );\n\n        if (!pcm.length || !capture.detector.sawSpeech) {\n            this.opts.log.debug(`ESPHome ${this.deviceName}: nothing but silence — dropping the utterance`);\n            this.event(EVENT.RUN_END);\n            this.status('idle');\n            return;\n        }\n\n        this.status('processing');\n        try {\n            const hints = this.opts.getHints ? await this.opts.getHints() : undefined;\n            const sttStart = Date.now();\n            const text = (await this.opts.stt.transcribe(pcm, MIC_SAMPLE_RATE, this.opts.language, hints)).trim();\n            const sttMs = Date.now() - sttStart;\n            this.event(EVENT.STT_END, { text });\n            if (!text) {\n                this.event(EVENT.RUN_END);\n                this.status('idle');\n                return;\n            }\n\n            this.event(EVENT.INTENT_START);\n            const answer = (\n                await this.opts.answer(text, {\n                    device: this.deviceName,\n                    room: this.room,\n                    wakeWord: capture.wakeWord,\n                    sttMs,\n                })\n            ).trim();\n            const followUp = !!answer && this.opts.expectsFollowUp?.(answer) === true;\n            this.event(EVENT.INTENT_END, followUp ? { continue_conversation: '1' } : undefined);\n\n            if (!answer) {\n                this.event(EVENT.RUN_END);\n                this.status('idle');\n                return;\n            }\n\n            const { pcm: ttsPcm, sampleRate } = await this.opts.tts.synthesize(answer, this.opts.language);\n            const url = this.publish(ttsPcm, sampleRate);\n\n            this.status('speaking');\n            this.event(EVENT.TTS_START, { text: answer });\n            this.event(EVENT.TTS_END, { url });\n            this.event(EVENT.RUN_END, followUp ? { continue_conversation: '1' } : undefined);\n            this.armPlaybackTimeout();\n        } catch (e) {\n            const reason = (e as Error).message;\n            this.opts.log.error(`ESPHome ${this.deviceName}: voice pipeline failed — ${reason}`);\n            // Without this the device stays ducked and its LED keeps spinning.\n            this.event(EVENT.ERROR, { code: 'pipeline-failed', message: reason });\n            this.event(EVENT.RUN_END);\n            this.status('idle');\n        }\n    }\n\n    /**\n     * Select which wake words listen on this device. Unknown ids are dropped and the list is trimmed\n     * to what the firmware allows, because the device answers a rejected list with silence rather than\n     * an error — better to send something valid and report what we changed.\n     *\n     * The device persists the selection and echoes it back in a `VoiceAssistantConfigurationResponse`,\n     * so we ask for one instead of assuming the write took.\n     */\n    setWakeWords(ids: string[]): void {\n        const known = this.wakeWordConfig?.available.map(w => w.id) ?? [];\n        const wanted = [...new Set(ids.map(i => i.trim()).filter(Boolean))];\n        const unknown = wanted.filter(i => !known.includes(i));\n        if (unknown.length) {\n            this.opts.log.warn(\n                `ESPHome ${this.deviceName}: unknown wake word(s) ${unknown.join(', ')} — ignored. ` +\n                    `Available: ${known.join(', ') || '(none reported)'}`,\n            );\n        }\n        let valid = wanted.filter(i => known.includes(i));\n        const max = this.wakeWordConfig?.max || 0;\n        if (max > 0 && valid.length > max) {\n            this.opts.log.warn(\n                `ESPHome ${this.deviceName}: device allows ${max} active wake word(s), keeping ${valid\n                    .slice(0, max)\n                    .join(', ')}`,\n            );\n            valid = valid.slice(0, max);\n        }\n\n        const message = new pb.VoiceAssistantSetConfiguration();\n        message.setActiveWakeWordsList(valid);\n        this.send(message);\n        this.opts.log.info(`ESPHome ${this.deviceName}: wake words set to ${valid.join(', ') || '(none)'}`);\n        // Read back, so the reported state is the device's and not our guess.\n        this.send(new pb.VoiceAssistantConfigurationRequest());\n    }\n\n    /** Drop a half-finished capture (device went away, or told us to stop). */\n    private abortCapture(): void {\n        const capture = this.capture;\n        if (!capture) {\n            return;\n        }\n        this.capture = null;\n        capture.closed = true;\n        clearTimeout(capture.timer);\n    }\n\n    // ── announcements ───────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Speak a ready PCM buffer on this device (timers, alarms, `tts.text`, jingles). With\n     * `startConversation` the microphone opens once the clip has played, to catch the answer to a question.\n     */\n    announce(pcm: Buffer, sampleRate: number, startConversation = false): Promise<void> {\n        if (!this.online || !pcm.length) {\n            return Promise.resolve();\n        }\n        const request = new pb.VoiceAssistantAnnounceRequest();\n        request.setMediaId(this.publish(pcm, sampleRate));\n        request.setText('');\n        request.setPreannounceMediaId('');\n        // Needs feature flag 32 (START_CONVERSATION); on a device without it the clip still plays and\n        // only the microphone stays shut, so there is nothing to guard here.\n        request.setStartConversation(startConversation);\n        this.status('speaking');\n        this.send(request);\n        this.armPlaybackTimeout();\n        return Promise.resolve();\n    }\n\n    /**\n     * Publish PCM as a WAV on the media server and build the URL the device should fetch.\n     *\n     * The host matters: on a multi-homed ioBroker machine the device can usually only reach one of the\n     * addresses, and the local end of *this* socket is by definition one it can talk to.\n     */\n    private publish(pcm: Buffer, sampleRate: number): string {\n        const path = this.opts.media.publish(pcmToWav(pcm, sampleRate), 'audio/wav');\n        const local = (this.socket?.localAddress || '').replace(/^::ffff:/, '');\n        const host = this.opts.mediaHost?.trim() || local || '127.0.0.1';\n        // An IPv6 literal has to be bracketed in a URL.\n        const authority = host.includes(':') ? `[${host}]` : host;\n        return `http://${authority}:${this.opts.media.port}${path}`;\n    }\n\n    /** Fall back to `idle` if the device never reports that it finished playing. */\n    private armPlaybackTimeout(): void {\n        if (this.playbackTimer) {\n            clearTimeout(this.playbackTimer);\n        }\n        this.playbackTimer = setTimeout(() => {\n            this.playbackTimer = null;\n            this.status('idle');\n        }, PLAYBACK_TIMEOUT_MS);\n        this.playbackTimer.unref();\n    }\n\n    private event(type: number, data?: Record<string, string>): void {\n        const message = new pb.VoiceAssistantEventResponse();\n        message.setEventType(type);\n        const items: VoiceAssistantEventData[] = [];\n        for (const [name, value] of Object.entries(data || {})) {\n            const item = new pb.VoiceAssistantEventData();\n            item.setName(name);\n            item.setValue(value);\n            items.push(item);\n        }\n        message.setDataList(items);\n        this.send(message);\n    }\n}\n"]}
+{"version":3,"file":"esphome.js","sourceRoot":"","sources":["../../../src/lib/voice/esphome.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ESPHome voice satellites — the fourth transport, next to the UDP server (`voiceServer.ts`) and the\n * Wyoming endpoint (`wyoming.ts`).\n *\n * Unlike those two, this one is a **client**: an ESPHome voice satellite is a *server* that waits on\n * TCP 6053 for the home-automation controller to connect and drive it. We therefore dial out to each\n * configured device and play the role Home Assistant normally plays. That covers the ThirdReality\n * Voice & Music Assistant (Dev Edition), the Home Assistant Voice PE and any box running\n * OHF-Voice/linux-voice-assistant.\n *\n * Flow for one utterance (verified against the firmware's `src/satellite/Satellite.cpp`):\n *\n *   device  →  VoiceAssistantRequest{start, wake_word_phrase}   wake word fired on the device\n *   we      →  VoiceAssistantResponse{port:0}                   0 = audio over the API, no UDP\n *   we      →  RUN_START, WAKE_WORD_END, STT_START, STT_VAD_START\n *   device  →  VoiceAssistantAudio …                            16 kHz mono s16le, *until told to stop*\n *   we      →  STT_VAD_END                                      ← the device has no VAD of its own\n *   we      →  STT_END{text}, INTENT_START, INTENT_END, TTS_START{text}, TTS_END{url}, RUN_END\n *   device  →  fetches the URL over HTTP, plays it, VoiceAssistantAnnounceFinished\n *\n * Two consequences shape this file: end-of-speech detection is ours (`vad.ts`), and the spoken reply\n * has to be reachable over HTTP (`mediaServer.ts`) rather than streamed down the socket.\n */\nimport * as net from 'node:net';\nimport {\n    pb,\n    encode,\n    decode,\n    type PbMessage,\n    type AuthenticationResponse,\n    type DeviceInfoResponse,\n    type HelloResponse,\n    type VoiceAssistantAnnounceFinished,\n    type VoiceAssistantAudio,\n    type VoiceAssistantConfigurationResponse,\n    type VoiceAssistantEventData,\n    type VoiceAssistantRequestMsg,\n} from './esphomeProto';\nimport { EntityRegistry, isEntityStateMessage, isListEntityMessage, type EsphomeEntity } from './esphomeEntities';\nimport { SpeechDetector, type Bytes } from './vad';\nimport { pcmToWav } from './stt';\nimport type { SttEngine } from './stt';\nimport type { TtsEngine } from './tts';\nimport type { SatelliteState } from './protocol';\n\n/** `VoiceAssistantEvent` (api.proto) — the subset we emit. */\nconst EVENT = {\n    ERROR: 0,\n    RUN_START: 1,\n    RUN_END: 2,\n    STT_START: 3,\n    STT_END: 4,\n    INTENT_START: 5,\n    INTENT_END: 6,\n    TTS_START: 7,\n    TTS_END: 8,\n    WAKE_WORD_END: 10,\n    STT_VAD_START: 11,\n    STT_VAD_END: 12,\n} as const;\n\n/** `SubscribeVoiceAssistantRequest.flags`: audio over the API socket instead of a UDP side channel. */\nconst SUBSCRIBE_API_AUDIO = 1;\n/** ESPHome voice satellites always capture at 16 kHz mono 16-bit. */\nconst MIC_SAMPLE_RATE = 16000;\n/**\n * Leading audio to keep out of the end-of-speech analysis. These devices acknowledge the wake word\n * with a chirp through their own speaker and hear it back on their own microphone, far louder than\n * the speech that follows. Without this the chirp alone satisfies the detector's speech test — so\n * `sawSpeech` stops meaning \"somebody said something\" and a false wake is billed to STT — and it\n * drags the noise floor up with it.\n *\n * Measured over four captures from a ThirdReality Voice & Music Assistant (RMS per 50 ms, remarkably\n * repeatable across all four):\n *\n *     ms    0    50   100   150   200   250   300   350   400   450   500   550   600\n *     rms  ~20 ~900 ~11k  ~19k  ~14k  ~1.3k ~990  ~780  ~610  ~370  ~330  ~165  ~180\n *\n * so the chirp is still above the gate at 500 ms and only clears it around 550–600. 600 ms is the\n * smallest value that rejects a chirp-only wake while still detecting the speech in every one of the\n * four captures, with no change to when the utterance closes. The audio itself is untouched and still\n * goes to STT in full, so a speaker who starts inside this window loses nothing but a late gate open.\n */\nconst WAKE_CHIRP_MS = 600;\n/** Default API port of an ESPHome device. */\nconst DEFAULT_PORT = 6053;\n/** Keepalive interval; two missed replies count as a dead link. */\nconst PING_INTERVAL_MS = 20_000;\n/** Wait between reconnect attempts. Devices reboot, and a Wi-Fi speaker drops off now and then. */\nconst RECONNECT_MS = 10_000;\n/** Give up on a pipeline that produced no audio at all (device wedged mid-stream). */\nconst PIPELINE_TIMEOUT_MS = 30_000;\n/** How long we wait for the device to report that it finished playing before forcing it back to idle. */\nconst PLAYBACK_TIMEOUT_MS = 60_000;\n\nexport interface EsphomeDevice {\n    /** Host name or IP of the satellite. */\n    ip: string;\n    /** API port; empty/0 → 6053. */\n    port?: number;\n    /** API password, if one is configured on the device. */\n    password?: string;\n    /** Room this satellite belongs to (drives `satellites.<room>.*` and the answer context). */\n    room?: string;\n}\n\nexport interface EsphomeSatellitesOptions {\n    devices: EsphomeDevice[];\n    /** ISO-639-1 language hint for STT/TTS ('' = auto/provider default). */\n    language: string;\n    stt: SttEngine;\n    tts: TtsEngine;\n    /**\n     * Produce the assistant reply for a transcribed utterance. `audioMs` is the length of the recording,\n     * `vad` what the voice activity detection made of it (both for the request journal).\n     */\n    answer: (\n        question: string,\n        ctx: {\n            device: string;\n            room: string;\n            wakeWord: string;\n            sttMs: number;\n            audioMs: number;\n            vad: { peak: number; noiseFloor: number; startLevel: number; endLevel: number };\n        },\n    ) => Promise<string>;\n    /** The reply was synthesised: how long that took and how long it plays (for the request journal). */\n    onSpoken?: (device: string, info: { ms: number; audioMs: number }) => void;\n    /** Optional STT vocabulary hints (device/room names) to bias recognition; re-read per utterance. */\n    getHints?: () => string[] | Promise<string[]>;\n    /** Where spoken replies are published for the device to fetch. */\n    media: MediaHost;\n    /**\n     * Host the device should call back on. Empty → the local address of our socket to that device,\n     * which is automatically the right interface on a multi-homed host.\n     */\n    mediaHost?: string;\n    /** Silence that ends an utterance, in ms ('' / 0 → the detector default). */\n    silenceMs?: number;\n    log: ioBroker.Logger;\n    /** Notified on every satellite state transition (idle/listening/processing/speaking/offline). */\n    onStatus?: (device: string, room: string, state: SatelliteState | 'offline') => void;\n    /** Notified with the device's wake-word configuration, on connect and after every change. */\n    onWakeWords?: (device: string, room: string, config: WakeWordConfig) => void;\n    /** Notified once per connect with everything the device exposes besides the voice pipeline. */\n    onEntities?: (device: string, room: string, entities: EsphomeEntity[]) => void;\n    /** Notified whenever one of those entities changes (and once per entity right after connecting). */\n    onEntityState?: (device: string, room: string, entity: EsphomeEntity) => void;\n    /** True when the reply asks something back, so the device should re-open its mic without a wake word. */\n    expectsFollowUp?: (answer: string, device: string) => boolean;\n    /**\n     * Custom wake words to offer the devices, re-read for every configuration request. The device lists\n     * them next to its own and downloads one (from the media server) only when it is selected.\n     */\n    externalWakeWords?: () => ExternalWakeWordOffer[];\n}\n\n/** A custom wake word as offered to the devices; the files are on the media server under `path`. */\nexport interface ExternalWakeWordOffer {\n    id: string;\n    phrase: string;\n    languages: string[];\n    /** Size of the `.tflite` in bytes. */\n    size: number;\n    /** SHA-256 of the `.tflite`, lower-case hex. */\n    sha256: string;\n    /** URL path of the JSON config, e.g. `/wakeword/hey_hannah_1a2b3c4d.json`; the model sits next to it. */\n    path: string;\n}\n\n/** What a device reports about its wake words: what the firmware ships plus the custom ones we offered. */\nexport interface WakeWordConfig {\n    /** Ids currently listening, e.g. `['okay_nabu']`. */\n    active: string[];\n    /** Every wake word the device can use, with the spoken phrase and the languages it was trained on. */\n    available: { id: string; phrase: string; languages: string[] }[];\n    /** How many may listen at once — 2 on the ThirdReality speaker, which has a sensitivity per slot. */\n    max: number;\n}\n\n/** `VoiceAssistantTimerEvent` in api.proto. */\nexport const TIMER_EVENT = { started: 0, updated: 1, cancelled: 2, finished: 3 } as const;\n\n/** One assistant timer, as the device wants to hear about it. */\nexport interface TimerEvent {\n    type: keyof typeof TIMER_EVENT;\n    id: string;\n    name: string;\n    totalSeconds: number;\n    secondsLeft: number;\n    /** False once it has finished or been cancelled — the device clears its ring on that. */\n    active: boolean;\n}\n\n/** The slice of `MediaServer` this module needs (kept narrow so tests can pass a stub). */\nexport interface MediaHost {\n    port: number;\n    publish(body: Buffer, contentType?: string, ttlMs?: number): string;\n}\n\n/**\n * All configured ESPHome satellites. Owns one connection per device and offers the same surface the\n * adapter already uses for the UDP server: `devices()` and `announce()`.\n */\nexport class EsphomeSatellites {\n    private readonly connections: EsphomeConnection[] = [];\n\n    constructor(private readonly opts: EsphomeSatellitesOptions) {}\n\n    async start(): Promise<void> {\n        for (const device of this.opts.devices) {\n            if (!device.ip?.trim()) {\n                continue;\n            }\n            const connection = new EsphomeConnection(device, this.opts);\n            this.connections.push(connection);\n            connection.start();\n        }\n        if (!this.connections.length) {\n            this.opts.log.warn('ESPHome satellites enabled, but no device addresses are configured.');\n        }\n        return Promise.resolve();\n    }\n\n    async stop(): Promise<void> {\n        await Promise.all(this.connections.map(c => c.stop()));\n        this.connections.length = 0;\n    }\n\n    /** Device names of the satellites currently connected. */\n    devices(): string[] {\n        return this.connections.filter(c => c.online).map(c => c.deviceName);\n    }\n\n    /** Wake-word configuration of one connected satellite, or null if it is unknown/offline. */\n    wakeWords(device: string): WakeWordConfig | null {\n        return this.connections.find(c => c.online && c.deviceName === device)?.wakeWordConfig ?? null;\n    }\n\n    /**\n     * Choose which wake words listen on one satellite. Ids come from {@link WakeWordConfig.available};\n     * the device stores the selection itself, so it survives a restart of the adapter.\n     */\n    setWakeWords(device: string, ids: string[]): boolean {\n        const target = this.connections.find(c => c.online && c.deviceName === device);\n        if (!target) {\n            return false;\n        }\n        target.setWakeWords(ids);\n        return true;\n    }\n\n    /**\n     * Offer the current custom wake words to every connected satellite again — after one was uploaded\n     * or deleted. Each device answers with its new configuration (→ `onWakeWords`).\n     */\n    refreshWakeWords(): number {\n        const online = this.connections.filter(c => c.online);\n        online.forEach(c => c.requestWakeWordConfig());\n        return online.length;\n    }\n\n    /** Everything one satellite exposes besides the voice pipeline (gain, noise suppression, …). */\n    entities(device: string): EsphomeEntity[] {\n        return this.connections.find(c => c.online && c.deviceName === device)?.entities.list() ?? [];\n    }\n\n    /**\n     * Write one of those entities. Returns false when the satellite is offline, the entity is unknown\n     * or read-only, or the value is not one the device accepts.\n     */\n    setEntity(device: string, objectId: string, value: unknown): boolean {\n        const target = this.connections.find(c => c.online && c.deviceName === device);\n        return target ? target.setEntity(objectId, value) : false;\n    }\n\n    /**\n     * Mirror an assistant timer onto the satellites so they can show it on their own LED ring and ring\n     * it themselves. `device` null broadcasts. Returns how many devices were told.\n     */\n    timerEvent(device: string | null, event: TimerEvent): number {\n        const targets = this.connections.filter(c => c.online && (!device || c.deviceName === device));\n        targets.forEach(c => c.sendTimerEvent(event));\n        return targets.length;\n    }\n\n    /**\n     * Play a ready PCM buffer on one satellite (by device name) or all of them. Returns how many\n     * devices it was handed to.\n     *\n     * With `startConversation` the device opens its microphone as soon as the clip has played, without\n     * a wake word — that is how a question gets its answer (see `PendingQuestions`).\n     */\n    async announce(device: string | null, pcm: Buffer, sampleRate: number, startConversation = false): Promise<number> {\n        const targets = this.connections.filter(c => c.online && (!device || c.deviceName === device));\n        if (!targets.length) {\n            return 0;\n        }\n        await Promise.all(\n            targets.map(c =>\n                c\n                    .announce(pcm, sampleRate, startConversation)\n                    .catch(e => this.opts.log.warn(`announce to ${c.deviceName} failed: ${(e as Error).message}`)),\n            ),\n        );\n        return targets.length;\n    }\n}\n\n/** State of the utterance currently being captured. */\ninterface Capture {\n    chunks: Buffer[];\n    detector: SpeechDetector;\n    conversationId: string;\n    /** Wake word that opened this capture; '' when the mic was re-opened for a follow-up/question. */\n    wakeWord: string;\n    timer: NodeJS.Timeout;\n    closed: boolean;\n}\n\n/** One satellite: socket lifecycle, handshake, and the voice pipeline. */\nclass EsphomeConnection {\n    /** Device name as reported by the device; falls back to its address until the handshake answers. */\n    deviceName: string;\n    online = false;\n    /** Last wake-word configuration the device reported; null until the handshake answers. */\n    wakeWordConfig: WakeWordConfig | null = null;\n    /**\n     * One entry per configuration request in flight, in send order (the device answers each one, in\n     * order): the ids a preceding `SetConfiguration` asked for, or null. The read-back is the only\n     * failure signal the device gives.\n     */\n    private configChecks: (string[] | null)[] = [];\n    /** Everything else the device exposes — rebuilt from scratch on every reconnect. */\n    readonly entities = new EntityRegistry();\n\n    private readonly host: string;\n    private readonly port: number;\n    private readonly room: string;\n\n    private socket: net.Socket | null = null;\n    private rx: Bytes = Buffer.alloc(0);\n    private pingTimer: NodeJS.Timeout | null = null;\n    private reconnectTimer: NodeJS.Timeout | null = null;\n    private missedPings = 0;\n    private stopping = false;\n    private capture: Capture | null = null;\n    private playbackTimer: NodeJS.Timeout | null = null;\n    private readonly password: string;\n\n    constructor(\n        device: EsphomeDevice,\n        private readonly opts: EsphomeSatellitesOptions,\n    ) {\n        this.host = device.ip.trim();\n        this.port = device.port || DEFAULT_PORT;\n        this.room = (device.room || '').trim();\n        this.password = device.password || '';\n        this.deviceName = this.host;\n    }\n\n    // ── lifecycle ───────────────────────────────────────────────────────────────────────────────────\n\n    start(): void {\n        this.connect();\n    }\n\n    async stop(): Promise<void> {\n        this.stopping = true;\n        this.clearTimers();\n        this.abortCapture();\n        const socket = this.socket;\n        this.socket = null;\n        if (socket) {\n            try {\n                socket.write(encode(new pb.DisconnectRequest()));\n            } catch {\n                /* socket already gone — nothing to say goodbye on */\n            }\n            socket.destroy();\n        }\n        this.setOffline();\n        return Promise.resolve();\n    }\n\n    private connect(): void {\n        if (this.stopping) {\n            return;\n        }\n        this.rx = Buffer.alloc(0);\n        this.missedPings = 0;\n        // The device re-announces everything after a reconnect, and the keys are not stable across\n        // reboots, so starting from a clean slate is the only safe option.\n        this.entities.clear();\n        this.configChecks = [];\n\n        const socket = net.createConnection({ host: this.host, port: this.port }, () => {\n            this.opts.log.debug(`ESPHome ${this.host}:${this.port} connected`);\n            this.handshake();\n        });\n        this.socket = socket;\n        socket.setNoDelay(true);\n\n        socket.on('data', data => this.onData(data));\n        socket.on('error', e => {\n            // A satellite that is switched off is normal, so this is not an error-level event.\n            this.opts.log.debug(`ESPHome ${this.host}: ${e.message}`);\n        });\n        socket.on('close', () => {\n            if (this.socket === socket) {\n                this.socket = null;\n                this.onDisconnected();\n            }\n        });\n    }\n\n    private onDisconnected(): void {\n        this.clearTimers();\n        this.abortCapture();\n        if (this.online) {\n            this.opts.log.info(`ESPHome satellite offline: ${this.deviceName}`);\n        }\n        this.setOffline();\n        this.scheduleReconnect();\n    }\n\n    private scheduleReconnect(): void {\n        if (this.stopping || this.reconnectTimer) {\n            return;\n        }\n        this.reconnectTimer = setTimeout(() => {\n            this.reconnectTimer = null;\n            this.connect();\n        }, RECONNECT_MS);\n        this.reconnectTimer.unref();\n    }\n\n    private clearTimers(): void {\n        if (this.pingTimer) {\n            clearInterval(this.pingTimer);\n            this.pingTimer = null;\n        }\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = null;\n        }\n        if (this.playbackTimer) {\n            clearTimeout(this.playbackTimer);\n            this.playbackTimer = null;\n        }\n    }\n\n    private setOffline(): void {\n        if (this.online) {\n            this.online = false;\n            this.opts.onStatus?.(this.deviceName, this.room, 'offline');\n        }\n    }\n\n    private status(state: SatelliteState): void {\n        this.opts.onStatus?.(this.deviceName, this.room, state);\n    }\n\n    // ── protocol plumbing ───────────────────────────────────────────────────────────────────────────\n\n    private send(message: PbMessage): void {\n        const socket = this.socket;\n        if (!socket || socket.destroyed) {\n            return;\n        }\n        try {\n            socket.write(encode(message));\n        } catch (e) {\n            this.opts.log.debug(`ESPHome ${this.deviceName}: send failed — ${(e as Error).message}`);\n        }\n    }\n\n    private onData(data: Buffer): void {\n        this.rx = this.rx.length ? Buffer.concat([this.rx, data]) : data;\n        let frames;\n        try {\n            ({ frames, rest: this.rx } = decode(this.rx));\n        } catch (e) {\n            this.opts.log.error(`ESPHome ${this.deviceName}: ${(e as Error).message}`);\n            this.socket?.destroy();\n            return;\n        }\n        for (const frame of frames) {\n            if (frame.error) {\n                this.opts.log.debug(`ESPHome ${this.deviceName}: cannot parse ${frame.name}`);\n                continue;\n            }\n            if (!frame.name || !frame.message) {\n                continue; // unknown id — already skipped by its declared length\n            }\n            try {\n                this.onMessage(frame.name, frame.message);\n            } catch (e) {\n                this.opts.log.warn(\n                    `ESPHome ${this.deviceName}: ${frame.name} handler failed — ${(e as Error).message}`,\n                );\n            }\n        }\n    }\n\n    private handshake(): void {\n        const hello = new pb.HelloRequest();\n        hello.setClientInfo('ioBroker.assistant');\n        hello.setApiVersionMajor(1);\n        hello.setApiVersionMinor(10);\n        this.send(hello);\n\n        const auth = new pb.AuthenticationRequest();\n        auth.setPassword(this.password);\n        this.send(auth);\n\n        this.send(new pb.DeviceInfoRequest());\n        // Ask for the entity announcements *before* subscribing to their states: a state message whose\n        // entity we have not seen yet has nothing to attach to and is dropped.\n        this.send(new pb.ListEntitiesRequest());\n        this.send(new pb.SubscribeStatesRequest());\n\n        const subscribe = new pb.SubscribeVoiceAssistantRequest();\n        subscribe.setSubscribe(true);\n        subscribe.setFlags(SUBSCRIBE_API_AUDIO);\n        this.send(subscribe);\n\n        this.requestWakeWordConfig();\n\n        this.pingTimer = setInterval(() => {\n            if (++this.missedPings > 2) {\n                this.opts.log.info(`ESPHome ${this.deviceName}: no reply to keepalive — reconnecting`);\n                this.socket?.destroy();\n                return;\n            }\n            this.send(new pb.PingRequest());\n        }, PING_INTERVAL_MS);\n        this.pingTimer.unref();\n    }\n\n    private onMessage(name: string, message: unknown): void {\n        switch (name) {\n            case 'HelloResponse': {\n                const hello = message as HelloResponse;\n                this.opts.log.debug(\n                    `ESPHome ${this.host}: ${hello.getServerInfo()} (API ${hello.getApiVersionMajor()}.${hello.getApiVersionMinor()})`,\n                );\n                return;\n            }\n\n            case 'AuthenticationResponse':\n                if ((message as AuthenticationResponse).getInvalidPassword()) {\n                    this.opts.log.error(\n                        `ESPHome ${this.host}: API password rejected — check the device's password in the settings.`,\n                    );\n                    this.socket?.destroy();\n                }\n                return;\n\n            case 'DeviceInfoResponse': {\n                const info = message as DeviceInfoResponse;\n                this.deviceName = info.getName() || this.host;\n                this.online = true;\n                this.opts.log.info(\n                    `ESPHome satellite online: ${this.deviceName} (${info.getModel()}) @ ${this.host}${this.room ? `, room ${this.room}` : ''}`,\n                );\n                this.status('idle');\n                return;\n            }\n\n            case 'VoiceAssistantConfigurationResponse': {\n                const config = message as VoiceAssistantConfigurationResponse;\n                // A custom wake word the device already downloaded is listed twice: once from its own\n                // model folder and once from our offer.\n                const seen = new Set<string>();\n                this.wakeWordConfig = {\n                    active: config.getActiveWakeWordsList(),\n                    available: config\n                        .getAvailableWakeWordsList()\n                        .map(w => ({\n                            id: w.getId(),\n                            phrase: w.getWakeWord(),\n                            languages: w.getTrainedLanguagesList(),\n                        }))\n                        .filter(w => !seen.has(w.id) && !!seen.add(w.id)),\n                    max: config.getMaxActiveWakeWords(),\n                };\n                const active = this.wakeWordConfig.active.join(', ') || '(none active)';\n                const available = this.wakeWordConfig.available.map(w => w.id);\n                this.opts.log.info(\n                    `ESPHome ${this.deviceName}: wake words ${active}${available.length ? ` (available: ${available.join(', ')})` : ''}`,\n                );\n                const requested = this.configChecks.shift();\n                const missing = requested?.filter(id => !this.wakeWordConfig?.active.includes(id)) ?? [];\n                if (missing.length) {\n                    // The device answers a model it cannot fetch or load with silence, not an error.\n                    this.opts.log.warn(\n                        `ESPHome ${this.deviceName}: could not activate wake word(s) ${missing.join(', ')}. ` +\n                            `For an uploaded wake word the device must reach ${this.mediaUrl('/')} and the model ` +\n                            `must be a microWakeWord .tflite.`,\n                    );\n                }\n                this.opts.onWakeWords?.(this.deviceName, this.room, this.wakeWordConfig);\n                return;\n            }\n\n            case 'VoiceAssistantRequest':\n                this.onPipelineRequest(message as VoiceAssistantRequestMsg);\n                return;\n\n            case 'VoiceAssistantAudio':\n                this.onAudio(message as VoiceAssistantAudio);\n                return;\n\n            case 'VoiceAssistantAnnounceFinished':\n                if (this.playbackTimer) {\n                    clearTimeout(this.playbackTimer);\n                    this.playbackTimer = null;\n                }\n                this.opts.log.debug(\n                    `ESPHome ${this.deviceName}: playback finished (success=${(message as VoiceAssistantAnnounceFinished).getSuccess()})`,\n                );\n                this.status('idle');\n                return;\n\n            case 'PingRequest':\n                this.send(new pb.PingResponse());\n                return;\n\n            case 'PingResponse':\n                this.missedPings = 0;\n                return;\n\n            case 'GetTimeRequest': {\n                // The device has no RTC and syncs its clock from us — its timer ring depends on it.\n                const time = new pb.GetTimeResponse();\n                time.setEpochSeconds(Math.floor(Date.now() / 1000));\n                this.send(time);\n                return;\n            }\n\n            case 'DisconnectRequest':\n                this.send(new pb.DisconnectResponse());\n                this.socket?.destroy();\n                return;\n\n            case 'ListEntitiesDoneResponse': {\n                const list = this.entities.list();\n                if (list.length) {\n                    this.opts.log.debug(\n                        `ESPHome ${this.deviceName}: ${list.length} entities — ${list.map(e => e.objectId).join(', ')}`,\n                    );\n                }\n                this.opts.onEntities?.(this.deviceName, this.room, list);\n                return;\n            }\n\n            default:\n                if (isListEntityMessage(name)) {\n                    this.entities.addFromAnnouncement(name, message);\n                } else if (isEntityStateMessage(name)) {\n                    const entity = this.entities.applyState(name, message);\n                    if (entity) {\n                        this.opts.onEntityState?.(this.deviceName, this.room, entity);\n                    }\n                }\n                return;\n        }\n    }\n\n    /** Write one of the device's entities. See {@link EsphomeSatellites.setEntity}. */\n    setEntity(objectId: string, value: unknown): boolean {\n        const message = this.entities.command(objectId, value);\n        if (!message) {\n            const entity = this.entities.get(objectId);\n            const known = this.entities\n                .list()\n                .map(e => e.objectId)\n                .join(', ');\n            const options = entity?.options ? ` (one of: ${entity.options.join(', ')})` : '';\n            this.opts.log.warn(\n                entity\n                    ? `ESPHome ${this.deviceName}: ${JSON.stringify(value)} is not a value \"${objectId}\" accepts${options}`\n                    : `ESPHome ${this.deviceName}: no entity \"${objectId}\" (have: ${known})`,\n            );\n            return false;\n        }\n        this.send(message);\n        this.opts.log.debug(`ESPHome ${this.deviceName}: ${objectId} := ${JSON.stringify(value)}`);\n        return true;\n    }\n\n    /** Push one assistant timer to the device so it can show and ring it itself. */\n    sendTimerEvent(event: TimerEvent): void {\n        const message = new pb.VoiceAssistantTimerEventResponse();\n        message.setEventType(TIMER_EVENT[event.type]);\n        message.setTimerId(event.id);\n        message.setName(event.name);\n        message.setTotalSeconds(Math.max(0, Math.round(event.totalSeconds)));\n        message.setSecondsLeft(Math.max(0, Math.round(event.secondsLeft)));\n        message.setIsActive(event.active);\n        this.send(message);\n    }\n\n    // ── voice pipeline ──────────────────────────────────────────────────────────────────────────────\n\n    private onPipelineRequest(request: VoiceAssistantRequestMsg): void {\n        if (!request.getStart()) {\n            this.abortCapture();\n            return;\n        }\n        if (this.capture) {\n            this.opts.log.debug(`ESPHome ${this.deviceName}: pipeline already running — ignoring wake`);\n            return;\n        }\n\n        const phrase = request.getWakeWordPhrase();\n        this.opts.log.debug(`ESPHome ${this.deviceName}: wake \"${phrase || '(follow-up)'}\"`);\n\n        const response = new pb.VoiceAssistantResponse();\n        response.setPort(0); // 0 = stream the audio over this socket\n        response.setError(false);\n        this.send(response);\n\n        const timer = setTimeout(() => {\n            this.opts.log.warn(`ESPHome ${this.deviceName}: no end of speech within ${PIPELINE_TIMEOUT_MS} ms`);\n            void this.finishCapture();\n        }, PIPELINE_TIMEOUT_MS);\n        timer.unref();\n\n        this.capture = {\n            chunks: [],\n            detector: new SpeechDetector({\n                sampleRate: MIC_SAMPLE_RATE,\n                silenceMs: this.opts.silenceMs || undefined,\n                // Microphone gain differs wildly between these devices, so fixed RMS levels do not\n                // travel: derive them from the room instead, once the wake chirp is out of the way.\n                skipMs: WAKE_CHIRP_MS,\n                adaptive: true,\n            }),\n            conversationId: request.getConversationId(),\n            wakeWord: phrase || '',\n            timer,\n            closed: false,\n        };\n\n        this.status('listening');\n        this.event(EVENT.RUN_START);\n        if (phrase) {\n            this.event(EVENT.WAKE_WORD_END, { wake_word_phrase: phrase });\n        }\n        this.event(EVENT.STT_START);\n        this.event(EVENT.STT_VAD_START);\n    }\n\n    private onAudio(audio: VoiceAssistantAudio): void {\n        const capture = this.capture;\n        if (!capture || capture.closed) {\n            return;\n        }\n        const chunk = Buffer.from(audio.getData_asU8());\n        if (chunk.length) {\n            capture.chunks.push(chunk);\n            if (capture.detector.push(chunk)) {\n                void this.finishCapture();\n                return;\n            }\n        }\n        if (audio.getEnd()) {\n            void this.finishCapture();\n        }\n    }\n\n    /** Stop the mic stream and run STT → answer → TTS for what was captured. */\n    private async finishCapture(): Promise<void> {\n        const capture = this.capture;\n        if (!capture || capture.closed) {\n            return;\n        }\n        capture.closed = true;\n        this.capture = null;\n        clearTimeout(capture.timer);\n\n        // Send this first: the device streams until it sees it.\n        this.event(EVENT.STT_VAD_END);\n\n        const pcm = Buffer.concat(capture.chunks);\n        const seconds = pcm.length / 2 / MIC_SAMPLE_RATE;\n        this.opts.log.debug(\n            `ESPHome ${this.deviceName}: captured ${seconds.toFixed(2)} s ` +\n                `(peak RMS ${Math.round(capture.detector.peak)}, noise floor ${Math.round(capture.detector.noiseFloor)}, ` +\n                `speech/silence gate ${Math.round(capture.detector.startLevel)}/${Math.round(capture.detector.endLevel)})`,\n        );\n\n        if (!pcm.length || !capture.detector.sawSpeech) {\n            this.opts.log.debug(`ESPHome ${this.deviceName}: nothing but silence — dropping the utterance`);\n            this.event(EVENT.RUN_END);\n            this.status('idle');\n            return;\n        }\n\n        this.status('processing');\n        try {\n            const hints = this.opts.getHints ? await this.opts.getHints() : undefined;\n            const sttStart = Date.now();\n            const text = (await this.opts.stt.transcribe(pcm, MIC_SAMPLE_RATE, this.opts.language, hints)).trim();\n            const sttMs = Date.now() - sttStart;\n            this.event(EVENT.STT_END, { text });\n            if (!text) {\n                this.event(EVENT.RUN_END);\n                this.status('idle');\n                return;\n            }\n\n            this.event(EVENT.INTENT_START);\n            const answer = (\n                await this.opts.answer(text, {\n                    device: this.deviceName,\n                    room: this.room,\n                    wakeWord: capture.wakeWord,\n                    sttMs,\n                    audioMs: Math.round(seconds * 1000),\n                    vad: {\n                        peak: Math.round(capture.detector.peak),\n                        noiseFloor: Math.round(capture.detector.noiseFloor),\n                        startLevel: Math.round(capture.detector.startLevel),\n                        endLevel: Math.round(capture.detector.endLevel),\n                    },\n                })\n            ).trim();\n            const followUp = !!answer && this.opts.expectsFollowUp?.(answer, this.deviceName) === true;\n            this.event(EVENT.INTENT_END, followUp ? { continue_conversation: '1' } : undefined);\n\n            if (!answer) {\n                this.event(EVENT.RUN_END);\n                this.status('idle');\n                return;\n            }\n\n            const ttsStart = Date.now();\n            const { pcm: ttsPcm, sampleRate } = await this.opts.tts.synthesize(answer, this.opts.language);\n            this.opts.onSpoken?.(this.deviceName, {\n                ms: Date.now() - ttsStart,\n                audioMs: (ttsPcm.length / 2 / sampleRate) * 1000,\n            });\n            const url = this.publish(ttsPcm, sampleRate);\n\n            this.status('speaking');\n            this.event(EVENT.TTS_START, { text: answer });\n            this.event(EVENT.TTS_END, { url });\n            this.event(EVENT.RUN_END, followUp ? { continue_conversation: '1' } : undefined);\n            this.armPlaybackTimeout();\n        } catch (e) {\n            const reason = (e as Error).message;\n            this.opts.log.error(`ESPHome ${this.deviceName}: voice pipeline failed — ${reason}`);\n            // Without this the device stays ducked and its LED keeps spinning.\n            this.event(EVENT.ERROR, { code: 'pipeline-failed', message: reason });\n            this.event(EVENT.RUN_END);\n            this.status('idle');\n        }\n    }\n\n    /**\n     * Select which wake words listen on this device. Unknown ids are dropped and the list is trimmed\n     * to what the firmware allows, because the device answers a rejected list with silence rather than\n     * an error — better to send something valid and report what we changed.\n     *\n     * The device persists the selection and echoes it back in a `VoiceAssistantConfigurationResponse`,\n     * so we ask for one instead of assuming the write took.\n     */\n    setWakeWords(ids: string[]): void {\n        const known = this.wakeWordConfig?.available.map(w => w.id) ?? [];\n        const wanted = [...new Set(ids.map(i => i.trim()).filter(Boolean))];\n        const unknown = wanted.filter(i => !known.includes(i));\n        if (unknown.length) {\n            this.opts.log.warn(\n                `ESPHome ${this.deviceName}: unknown wake word(s) ${unknown.join(', ')} — ignored. ` +\n                    `Available: ${known.join(', ') || '(none reported)'}`,\n            );\n        }\n        let valid = wanted.filter(i => known.includes(i));\n        const max = this.wakeWordConfig?.max || 0;\n        if (max > 0 && valid.length > max) {\n            this.opts.log.warn(\n                `ESPHome ${this.deviceName}: device allows ${max} active wake word(s), keeping ${valid\n                    .slice(0, max)\n                    .join(', ')}`,\n            );\n            valid = valid.slice(0, max);\n        }\n\n        const message = new pb.VoiceAssistantSetConfiguration();\n        message.setActiveWakeWordsList(valid);\n        this.send(message);\n        this.opts.log.info(`ESPHome ${this.deviceName}: wake words set to ${valid.join(', ') || '(none)'}`);\n        // Read back, so the reported state is the device's and not our guess. The device resolves a\n        // custom wake word (and downloads it) while handling the SetConfiguration, so this answer\n        // already tells whether that worked.\n        this.requestWakeWordConfig(valid);\n    }\n\n    /**\n     * Ask the device for its wake-word configuration. The request always carries the current custom\n     * wake words: the firmware replaces its list of offered models with every request, so one sent\n     * without them would make an uploaded wake word vanish from the device until the next offer.\n     *\n     * @param check ids a SetConfiguration just asked for — warned about if the answer lacks them\n     */\n    requestWakeWordConfig(check: string[] | null = null): void {\n        const request = new pb.VoiceAssistantConfigurationRequest();\n        const offers = this.opts.externalWakeWords?.() ?? [];\n        request.setExternalWakeWordsList(\n            offers.map(offer => {\n                const w = new pb.VoiceAssistantExternalWakeWord();\n                w.setId(offer.id);\n                w.setWakeWord(offer.phrase);\n                w.setTrainedLanguagesList(offer.languages);\n                w.setModelType('micro');\n                w.setModelSize(offer.size);\n                w.setModelHash(offer.sha256);\n                w.setUrl(this.mediaUrl(offer.path));\n                return w;\n            }),\n        );\n        // A device that never answers must not let this grow without bound.\n        if (this.configChecks.length < 16) {\n            this.configChecks.push(check);\n        }\n        this.send(request);\n    }\n\n    /** Drop a half-finished capture (device went away, or told us to stop). */\n    private abortCapture(): void {\n        const capture = this.capture;\n        if (!capture) {\n            return;\n        }\n        this.capture = null;\n        capture.closed = true;\n        clearTimeout(capture.timer);\n    }\n\n    // ── announcements ───────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Speak a ready PCM buffer on this device (timers, alarms, `tts.text`, jingles). With\n     * `startConversation` the microphone opens once the clip has played, to catch the answer to a question.\n     */\n    announce(pcm: Buffer, sampleRate: number, startConversation = false): Promise<void> {\n        if (!this.online || !pcm.length) {\n            return Promise.resolve();\n        }\n        const request = new pb.VoiceAssistantAnnounceRequest();\n        request.setMediaId(this.publish(pcm, sampleRate));\n        request.setText('');\n        request.setPreannounceMediaId('');\n        // Needs feature flag 32 (START_CONVERSATION); on a device without it the clip still plays and\n        // only the microphone stays shut, so there is nothing to guard here.\n        request.setStartConversation(startConversation);\n        this.status('speaking');\n        this.send(request);\n        this.armPlaybackTimeout();\n        return Promise.resolve();\n    }\n\n    /**\n     * Publish PCM as a WAV on the media server and build the URL the device should fetch.\n     *\n     * The host matters: on a multi-homed ioBroker machine the device can usually only reach one of the\n     * addresses, and the local end of *this* socket is by definition one it can talk to.\n     */\n    private publish(pcm: Buffer, sampleRate: number): string {\n        return this.mediaUrl(this.opts.media.publish(pcmToWav(pcm, sampleRate), 'audio/wav'));\n    }\n\n    /** Absolute URL of a path on the media server, with a host this device can reach. */\n    private mediaUrl(path: string): string {\n        const local = (this.socket?.localAddress || '').replace(/^::ffff:/, '');\n        const host = this.opts.mediaHost?.trim() || local || '127.0.0.1';\n        // An IPv6 literal has to be bracketed in a URL.\n        const authority = host.includes(':') ? `[${host}]` : host;\n        return `http://${authority}:${this.opts.media.port}${path}`;\n    }\n\n    /** Fall back to `idle` if the device never reports that it finished playing. */\n    private armPlaybackTimeout(): void {\n        if (this.playbackTimer) {\n            clearTimeout(this.playbackTimer);\n        }\n        this.playbackTimer = setTimeout(() => {\n            this.playbackTimer = null;\n            this.status('idle');\n        }, PLAYBACK_TIMEOUT_MS);\n        this.playbackTimer.unref();\n    }\n\n    private event(type: number, data?: Record<string, string>): void {\n        const message = new pb.VoiceAssistantEventResponse();\n        message.setEventType(type);\n        const items: VoiceAssistantEventData[] = [];\n        for (const [name, value] of Object.entries(data || {})) {\n            const item = new pb.VoiceAssistantEventData();\n            item.setName(name);\n            item.setValue(value);\n            items.push(item);\n        }\n        message.setDataList(items);\n        this.send(message);\n    }\n}\n"]}