@zhin.js/agent 1.1.2 → 1.1.5

package/lib/assistant/home-facade.d.ts

@@ -0,0 +1,73 @@
+/**
+ * HomeFacade — 别名解析 + 权限 + 意图（tools 薄封装此门面）
+ */
+import type { HaHomeBackend, HaEntityState, HaServiceResult } from './domains/ha-home-backend.js';
+import type { ResolvedHomePolicyConfig } from './home-config.js';
+import { type HomePrincipal } from './home-policy.js';
+export type HomeFacadeOk<T> = {
+    ok: true;
+    value: T;
+};
+export type HomeFacadeFail = {
+    ok: false;
+    kind: 'deny' | 'needs_owner' | 'invalid';
+    message: string;
+};
+export type HomeFacadeResult<T> = HomeFacadeOk<T> | HomeFacadeFail;
+export interface HomeFacadeOptions {
+    backend: HaHomeBackend;
+    policy: ResolvedHomePolicyConfig;
+}
+export declare function mapFacadeFailToToolError(result: HomeFacadeFail): {
+    error: string;
+};
+export declare class HomeFacade {
+    private readonly options;
+    constructor(options: HomeFacadeOptions);
+    private authorize;
+    private resolve;
+    listAliases(principal: HomePrincipal): Promise<HomeFacadeResult<{
+        aliases: string[];
+        count: number;
+    } | {
+        aliases: Record<string, never>;
+        message: string;
+    }>>;
+    getState(alias: string, principal: HomePrincipal): Promise<HomeFacadeResult<HaEntityState & {
+        alias: string;
+    }>>;
+    turnOn(alias: string, principal: HomePrincipal): Promise<HomeFacadeResult<HaServiceResult & {
+        message: string;
+    }>>;
+    turnOff(alias: string, principal: HomePrincipal): Promise<HomeFacadeResult<HaServiceResult & {
+        message: string;
+    }>>;
+    setBrightness(alias: string, brightness: number, principal: HomePrincipal): Promise<HomeFacadeResult<{
+        alias: string;
+        brightness: number;
+        message: string;
+    }>>;
+    setTemperature(alias: string, temperature: number, principal: HomePrincipal): Promise<HomeFacadeResult<{
+        alias: string;
+        temperature: number;
+        message: string;
+    }>>;
+    activateScene(alias: string, principal: HomePrincipal): Promise<HomeFacadeResult<{
+        alias: string;
+        domain: string;
+        message: string;
+    }>>;
+    setCoverPosition(alias: string, position: number, principal: HomePrincipal): Promise<HomeFacadeResult<{
+        alias: string;
+        position: number;
+        message: string;
+    }>>;
+    callService(alias: string, service: string, data: Record<string, unknown> | undefined, principal: HomePrincipal): Promise<HomeFacadeResult<{
+        alias: string;
+        domain: string;
+        service: string;
+        message: string;
+    }>>;
+    private writeIntent;
+}
+//# sourceMappingURL=home-facade.d.ts.map

package/lib/assistant/home-facade.d.ts.map

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

package/lib/assistant/home-facade.js

@@ -0,0 +1,144 @@
+import { parseEntityDomain } from './domains/home-entity.js';
+import { checkHomeToolAccess, toHomeDenyError, toHomeOwnerSignal, } from './home-policy.js';
+function fail(kind, message) {
+    return { ok: false, kind, message };
+}
+function fromAccess(decision) {
+    if (decision.allowed)
+        return null;
+    if (decision.needsOwnerApproval) {
+        return fail('needs_owner', toHomeOwnerSignal(decision));
+    }
+    return fail('deny', toHomeDenyError(decision));
+}
+export function mapFacadeFailToToolError(result) {
+    return { error: result.message };
+}
+export class HomeFacade {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    authorize(operation, entityId, principal) {
+        return fromAccess(checkHomeToolAccess(operation, entityId, principal, this.options.policy));
+    }
+    resolve(alias) {
+        try {
+            return { entityId: this.options.backend.resolveAlias(alias) };
+        }
+        catch (e) {
+            return fail('invalid', e.message);
+        }
+    }
+    async listAliases(principal) {
+        const gate = this.authorize('read', 'light.__list__', principal);
+        if (gate)
+            return gate;
+        const names = Object.keys(this.options.backend.listAliases());
+        if (names.length === 0) {
+            return { ok: true, value: { aliases: {}, message: '未配置任何设备别名' } };
+        }
+        return { ok: true, value: { aliases: names, count: names.length } };
+    }
+    async getState(alias, principal) {
+        const resolved = this.resolve(alias);
+        if ('ok' in resolved && resolved.ok === false)
+            return resolved;
+        const { entityId } = resolved;
+        const gate = this.authorize('read', entityId, principal);
+        if (gate)
+            return gate;
+        try {
+            const state = await this.options.backend.getState(alias);
+            return { ok: true, value: { ...state, alias } };
+        }
+        catch (e) {
+            return fail('invalid', e.message);
+        }
+    }
+    async turnOn(alias, principal) {
+        return this.writeIntent(alias, principal, async () => {
+            const result = await this.options.backend.turnOn(alias);
+            return { ...result, message: `已执行 ${result.service}` };
+        });
+    }
+    async turnOff(alias, principal) {
+        return this.writeIntent(alias, principal, async () => {
+            const result = await this.options.backend.turnOff(alias);
+            return { ...result, message: `已执行 ${result.service}` };
+        });
+    }
+    async setBrightness(alias, brightness, principal) {
+        if (isNaN(brightness) || brightness < 0 || brightness > 255) {
+            return fail('invalid', 'brightness 须为 0–255');
+        }
+        return this.writeIntent(alias, principal, async () => {
+            await this.options.backend.callService(alias, 'turn_on', { brightness });
+            return { alias, brightness, message: `已设置亮度 ${brightness}` };
+        });
+    }
+    async setTemperature(alias, temperature, principal) {
+        if (isNaN(temperature))
+            return fail('invalid', 'temperature 须为数字');
+        return this.writeIntent(alias, principal, async () => {
+            await this.options.backend.callService(alias, 'set_temperature', { temperature });
+            return { alias, temperature, message: `已设置温度 ${temperature}°C` };
+        });
+    }
+    async activateScene(alias, principal) {
+        const resolved = this.resolve(alias);
+        if ('ok' in resolved && resolved.ok === false)
+            return resolved;
+        const { entityId } = resolved;
+        const domain = parseEntityDomain(entityId);
+        if (domain !== 'scene' && domain !== 'script') {
+            return fail('invalid', `别名 "${alias}" 对应 ${domain}，不是 scene 或 script`);
+        }
+        return this.writeIntent(alias, principal, async () => {
+            await this.options.backend.callService(alias, 'turn_on');
+            return { alias, domain, message: `已触发 ${domain} "${alias}"` };
+        });
+    }
+    async setCoverPosition(alias, position, principal) {
+        if (isNaN(position) || position < 0 || position > 100) {
+            return fail('invalid', 'position 须为 0–100');
+        }
+        return this.writeIntent(alias, principal, async () => {
+            await this.options.backend.callService(alias, 'set_cover_position', { position });
+            return { alias, position, message: `已设置窗帘位置 ${position}%` };
+        });
+    }
+    async callService(alias, service, data, principal) {
+        if (!service.trim())
+            return fail('invalid', 'service 必填');
+        const resolved = this.resolve(alias);
+        if ('ok' in resolved && resolved.ok === false)
+            return resolved;
+        const { entityId } = resolved;
+        const domain = parseEntityDomain(entityId);
+        const allowed = this.options.policy.allowedServiceDomains;
+        if (!allowed.includes(domain)) {
+            return fail('deny', `domain "${domain}" 不在允许的白名单中（允许: ${allowed.join(', ')}）`);
+        }
+        return this.writeIntent(alias, principal, async () => {
+            await this.options.backend.callService(alias, service, data);
+            return { alias, domain, service, message: `已执行 ${domain}.${service}` };
+        });
+    }
+    async writeIntent(alias, principal, run) {
+        const resolved = this.resolve(alias);
+        if ('ok' in resolved && resolved.ok === false)
+            return resolved;
+        const { entityId } = resolved;
+        const gate = this.authorize('write', entityId, principal);
+        if (gate)
+            return gate;
+        try {
+            return { ok: true, value: await run() };
+        }
+        catch (e) {
+            return fail('invalid', e.message);
+        }
+    }
+}
+//# sourceMappingURL=home-facade.js.map

package/lib/assistant/home-facade.js.map

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

package/lib/assistant/home-policy.d.ts

@@ -1,7 +1,7 @@
 /**
  * Home Domain 工具权限（M4）
  */
-import { type Message } from '@zhin.js/core';
+import type { ToolInvocationContext } from '@zhin.js/tool';
 import { type ToolRequesterRole } from '../security/owner-approve-always-store.js';
 import type { HomePolicyConfig } from './home-config.js';
 export interface HomeToolDecision {
@@ -10,7 +10,8 @@ export interface HomeToolDecision {
     reason?: string;
     role: ToolRequesterRole;
 }
-export declare function checkHomeToolAccess(operation: 'read' | 'write', entityId: string, commMessage: Message | undefined, policy: HomePolicyConfig & {
+export type HomePrincipal = ToolInvocationContext['principal'];
+export declare function checkHomeToolAccess(operation: 'read' | 'write', entityId: string, principal: HomePrincipal, policy: HomePolicyConfig & {
     requireMaster: boolean;
     confirmServices: string[];
 }): HomeToolDecision;

package/lib/assistant/home-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"home-policy.d.ts","sourceRoot":"","sources":["../../src/assistant/home-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAsG,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACjJ,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AA+BD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,MAAM,EAAE,gBAAgB,GAAG;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/E,gBAAgB,CAsBlB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAElE"}
+{"version":3,"file":"home-policy.d.ts","sourceRoot":"","sources":["../../src/assistant/home-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;AAQ/D,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,gBAAgB,GAAG;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/E,gBAAgB,CAsBlB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAElE"}

package/lib/assistant/home-policy.js

@@ -1,41 +1,13 @@
-/**
- * Home Domain 工具权限（M4）
- */
-import { getHostRootPlugin, hasSenderRole, mergeAITriggerConfig, resolveSenderRoles, senderRolesFromMessage } from '@zhin.js/core';
-import { resolveToolRequesterRole, } from '../security/owner-approve-always-store.js';
-import { parseEntityDomain } from './domains/home-assistant.js';
-function resolveRole(commMessage) {
-    if (!commMessage?.$adapter || !commMessage?.$endpoint || !commMessage?.$sender?.id) {
-        return 'unknown';
-    }
-    if (commMessage.$adapter === 'process')
+import { parseEntityDomain } from './domains/home-entity.js';
+function resolveRole(principal) {
+    if (principal.roles.includes('master'))
         return 'master';
-    const host = getHostRootPlugin();
-    if (host) {
-        return resolveToolRequesterRole(host, commMessage);
-    }
-    if (commMessage.$sender.isMaster !== undefined || commMessage.$sender.isTrusted !== undefined) {
-        const roles = senderRolesFromMessage(commMessage);
-        if (hasSenderRole(roles, 'master'))
-            return 'master';
-        if (hasSenderRole(roles, 'trusted'))
-            return 'trusted';
-        return 'other';
-    }
-    try {
-        const { roles } = resolveSenderRoles(commMessage, mergeAITriggerConfig({}), undefined);
-        if (hasSenderRole(roles, 'master'))
-            return 'master';
-        if (hasSenderRole(roles, 'trusted'))
-            return 'trusted';
-        return 'other';
-    }
-    catch {
-        return 'other';
-    }
+    if (principal.roles.includes('trusted'))
+        return 'trusted';
+    return 'other';
 }
-export function checkHomeToolAccess(operation, entityId, commMessage, policy) {
-    const role = resolveRole(commMessage);
+export function checkHomeToolAccess(operation, entityId, principal, policy) {
+    const role = resolveRole(principal);
     const domain = parseEntityDomain(entityId);
     if (policy.requireMaster && role !== 'master') {
         return {

package/lib/assistant/home-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"home-policy.js","sourceRoot":"","sources":["../../src/assistant/home-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,sBAAsB,EAAgB,MAAM,eAAe,CAAC;AACjJ,OAAO,EACL,wBAAwB,GAEzB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAQhE,SAAS,WAAW,CAAC,WAAqB;IACxC,IAAI,CAAC,WAAW,EAAE,QAAQ,IAAI,CAAC,WAAW,EAAE,SAAS,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACnF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACxD,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,wBAAwB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC9F,MAAM,KAAK,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QACpD,IAAI,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAClC,WAAW,EACX,oBAAoB,CAAC,EAAE,CAAC,EACxB,SAAS,CACV,CAAC;QACF,IAAI,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QACpD,IAAI,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAA2B,EAC3B,QAAgB,EAChB,WAAgC,EAChC,MAAgF;IAEhF,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI;YACJ,MAAM,EAAE,qCAAqC;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,OAAO,IAAI,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,kBAAkB,EAAE,IAAI;YACxB,IAAI;YACJ,MAAM,EAAE,IAAI,MAAM,iCAAiC,QAAQ,IAAI;SAChE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAA0B;IAC1D,OAAO,sBAAsB,QAAQ,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA0B;IACxD,OAAO,UAAU,QAAQ,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;AACrD,CAAC"}
+{"version":3,"file":"home-policy.js","sourceRoot":"","sources":["../../src/assistant/home-policy.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAU7D,SAAS,WAAW,CAAC,SAAwB;IAC3C,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxD,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAA2B,EAC3B,QAAgB,EAChB,SAAwB,EACxB,MAAgF;IAEhF,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI;YACJ,MAAM,EAAE,qCAAqC;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,OAAO,IAAI,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,kBAAkB,EAAE,IAAI;YACxB,IAAI;YACJ,MAAM,EAAE,IAAI,MAAM,iCAAiC,QAAQ,IAAI;SAChE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAA0B;IAC1D,OAAO,sBAAsB,QAAQ,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA0B;IACxD,OAAO,UAAU,QAAQ,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;AACrD,CAAC"}

package/lib/assistant/home-tools.d.ts

@@ -1,15 +1,12 @@
-/**
- * home_* 工具 — 薄封装 HomeAssistantService（M4）
- */
-import { ZhinTool } from '@zhin.js/core';
-import type { HomeAssistantService } from './domains/home-assistant.js';
-import type { HomePolicyConfig } from './home-config.js';
+/** Canonical home_* Tool definitions. No IM Message compatibility surface. */
+import { type AgentToolDefinition } from '@zhin.js/tool';
+import { HomeFacade } from './home-facade.js';
 export interface HomeToolsOptions {
-    service: HomeAssistantService;
-    policy: HomePolicyConfig & {
-        requireMaster: boolean;
-        confirmServices: string[];
-    };
+    facade: HomeFacade;
 }
-export declare function createHomeTools(options: HomeToolsOptions): ZhinTool[];
+export interface HomeToolRegistration {
+    readonly name: string;
+    readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, unknown>>;
+}
+export declare function createHomeTools(options: HomeToolsOptions): readonly HomeToolRegistration[];
 //# sourceMappingURL=home-tools.d.ts.map

package/lib/assistant/home-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"home-tools.d.ts","sourceRoot":"","sources":["../../src/assistant/home-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAmC,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQzD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,gBAAgB,GAAG;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAClF;AAwCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CA8FrE"}
+{"version":3,"file":"home-tools.d.ts","sourceRoot":"","sources":["../../src/assistant/home-tools.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EAGX,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;CACtF;AA8BD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,oBAAoB,EAAE,CAmH1F"}

package/lib/assistant/home-tools.js

@@ -1,143 +1,102 @@
-/**
- * home_* 工具 — 薄封装 HomeAssistantService（M4）
- */
-import { ZhinTool, getHostRootPlugin } from '@zhin.js/core';
-import { checkHomeToolAccess, toHomeDenyError, toHomeOwnerSignal, } from './home-policy.js';
-import { resolveToolRequesterRole } from '../security/owner-approve-always-store.js';
-function guard(operation, entityId, commMessage, policy) {
-    const decision = checkHomeToolAccess(operation, entityId, commMessage, policy);
-    return formatGuardResult(decision);
+/** Canonical home_* Tool definitions. No IM Message compatibility surface. */
+import { defineAgentTool, } from '@zhin.js/tool';
+import { mapFacadeFailToToolError, } from './home-facade.js';
+function toToolResult(result) {
+    if (!result.ok)
+        return mapFacadeFailToToolError(result);
+    return result.value;
 }
-function guardMasterOnly(commMessage, policy) {
-    if (!policy.requireMaster || !commMessage?.$adapter || !commMessage?.$endpoint || !commMessage?.$sender?.id) {
-        return null;
-    }
-    try {
-        const host = getHostRootPlugin();
-        if (!host)
-            return null;
-        const role = resolveToolRequesterRole(host, commMessage);
-        if (role === 'master')
-            return null;
-        return toHomeDenyError({
-            allowed: false,
-            role,
-            reason: '智能家居操作仅允许 Endpoint Owner（master）调用。',
-        });
-    }
-    catch {
-        return null;
-    }
+function schema(properties = {}, required = []) {
+    return Object.freeze({ type: 'object', properties: Object.freeze(properties), required: Object.freeze([...required]) });
 }
-function formatGuardResult(decision) {
-    if (decision.allowed)
-        return null;
-    if (decision.needsOwnerApproval)
-        return toHomeOwnerSignal(decision);
-    return toHomeDenyError(decision);
+function registration(name, description, inputSchema, execute) {
+    return Object.freeze({
+        name,
+        definition: defineAgentTool({
+            description,
+            inputSchema,
+            execute,
+        }),
+    });
 }
 export function createHomeTools(options) {
-    const { service, policy } = options;
-    const listAliases = new ZhinTool('home_list_aliases')
-        .desc('列出已配置的智能家居设备别名（不暴露原始 entity_id 给用户层）')
-        .keyword('智能家居', '设备列表', 'home list', '别名')
-        .tag('home', 'assistant')
-        .execute(async (_args, commMessage) => {
-        const aliases = service.listAliases();
-        const names = Object.keys(aliases);
-        if (names.length === 0)
-            return { aliases: {}, message: '未配置任何设备别名' };
-        const listErr = guardMasterOnly(commMessage, policy);
-        if (listErr)
-            return { error: listErr };
-        return { aliases: names, count: names.length };
-    });
-    const getState = new ZhinTool('home_get_state')
-        .desc('读取智能家居设备状态（使用配置别名，如「客厅灯」）')
-        .keyword('设备状态', '灯状态', 'home state', '查询')
-        .tag('home', 'assistant')
-        .param('alias', { type: 'string', description: '设备别名（zhin.config.yml assistant.home.aliases 中配置）' }, true)
-        .execute(async (args, commMessage) => {
-        const alias = String(args.alias ?? '').trim();
-        if (!alias)
-            return { error: 'alias 必填' };
-        let entityId;
-        try {
-            entityId = service.resolveAlias(alias);
-        }
-        catch (e) {
-            return { error: e.message };
-        }
-        const err = guard('read', entityId, commMessage, policy);
-        if (err)
-            return { error: err };
-        try {
-            const state = await service.getState(alias);
+    const { facade } = options;
+    const aliasProperty = { type: 'string', description: '设备别名' };
+    return Object.freeze([
+        registration('home_list_aliases', '列出已配置的智能家居设备别名（不暴露原始 entity_id 给用户层）', schema(), async (_input, context) => toToolResult(await facade.listAliases(context.principal))),
+        registration('home_get_state', '读取智能家居设备状态（使用配置别名，如「客厅灯」）', schema({ alias: aliasProperty }, ['alias']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            const result = await facade.getState(alias, context.principal);
+            if (!result.ok)
+                return mapFacadeFailToToolError(result);
             return {
-                alias,
-                state: state.state,
-                attributes: state.attributes,
-                lastUpdated: state.lastUpdated,
+                alias: result.value.alias,
+                state: result.value.state,
+                attributes: result.value.attributes,
+                lastUpdated: result.value.lastUpdated,
             };
-        }
-        catch (e) {
-            return { error: e.message };
-        }
-    });
-    const turnOn = new ZhinTool('home_turn_on')
-        .desc('打开/开启智能家居设备（别名，如「客厅灯」）')
-        .keyword('开灯', '打开', 'home on', 'turn on')
-        .tag('home', 'assistant')
-        .param('alias', { type: 'string', description: '设备别名' }, true)
-        .execute(async (args, commMessage) => {
-        const alias = String(args.alias ?? '').trim();
-        if (!alias)
-            return { error: 'alias 必填' };
-        let entityId;
-        try {
-            entityId = service.resolveAlias(alias);
-        }
-        catch (e) {
-            return { error: e.message };
-        }
-        const err = guard('write', entityId, commMessage, policy);
-        if (err)
-            return { error: err };
-        try {
-            const result = await service.turnOn(alias);
-            return { success: true, ...result, message: `已执行 ${result.service}` };
-        }
-        catch (e) {
-            return { error: e.message };
-        }
-    });
-    const turnOff = new ZhinTool('home_turn_off')
-        .desc('关闭智能家居设备（别名，如「客厅灯」）')
-        .keyword('关灯', '关闭', 'home off', 'turn off')
-        .tag('home', 'assistant')
-        .param('alias', { type: 'string', description: '设备别名' }, true)
-        .execute(async (args, commMessage) => {
-        const alias = String(args.alias ?? '').trim();
-        if (!alias)
-            return { error: 'alias 必填' };
-        let entityId;
-        try {
-            entityId = service.resolveAlias(alias);
-        }
-        catch (e) {
-            return { error: e.message };
-        }
-        const err = guard('write', entityId, commMessage, policy);
-        if (err)
-            return { error: err };
-        try {
-            const result = await service.turnOff(alias);
-            return { success: true, ...result, message: `已执行 ${result.service}` };
-        }
-        catch (e) {
-            return { error: e.message };
-        }
-    });
-    return [listAliases, getState, turnOn, turnOff];
+        }),
+        registration('home_turn_on', '打开/开启智能家居设备（别名，如「客厅灯」）', schema({ alias: aliasProperty }, ['alias']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            const result = await facade.turnOn(alias, context.principal);
+            return result.ok ? { success: true, ...result.value } : mapFacadeFailToToolError(result);
+        }),
+        registration('home_turn_off', '关闭智能家居设备（别名，如「客厅灯」）', schema({ alias: aliasProperty }, ['alias']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            const result = await facade.turnOff(alias, context.principal);
+            return result.ok ? { success: true, ...result.value } : mapFacadeFailToToolError(result);
+        }),
+        registration('home_set_brightness', '设置灯光亮度（0–255，使用配置别名）', schema({ alias: aliasProperty, brightness: { type: 'number', description: '亮度值 0–255' } }, ['alias', 'brightness']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            const result = await facade.setBrightness(alias, Number(input.brightness), context.principal);
+            return result.ok ? { success: true, ...result.value } : mapFacadeFailToToolError(result);
+        }),
+        registration('home_set_temperature', '设置温控目标温度（使用配置别名）', schema({ alias: aliasProperty, temperature: { type: 'number', description: '目标温度（摄氏度）' } }, ['alias', 'temperature']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            const result = await facade.setTemperature(alias, Number(input.temperature), context.principal);
+            return result.ok ? { success: true, ...result.value } : mapFacadeFailToToolError(result);
+        }),
+        registration('home_activate_scene', '触发 HA 场景或脚本（使用配置别名）', schema({ alias: { type: 'string', description: '场景/脚本别名' } }, ['alias']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            const result = await facade.activateScene(alias, context.principal);
+            return result.ok ? { success: true, ...result.value } : mapFacadeFailToToolError(result);
+        }),
+        registration('home_set_cover_position', '设置窗帘位置（0=关闭 100=全开，使用配置别名）', schema({ alias: aliasProperty, position: { type: 'number', description: '位置 0–100' } }, ['alias', 'position']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            const result = await facade.setCoverPosition(alias, Number(input.position), context.principal);
+            return result.ok ? { success: true, ...result.value } : mapFacadeFailToToolError(result);
+        }),
+        registration('home_call_service', '通用 HA 服务调用（受 domain 白名单约束，仅接受别名）', schema({
+            alias: aliasProperty,
+            service: { type: 'string', description: 'HA 服务名（如 turn_on, set_temperature）' },
+            data: { type: 'object', description: '服务参数（可选）' },
+        }, ['alias', 'service']), async (input, context) => {
+            const alias = String(input.alias ?? '').trim();
+            const service = String(input.service ?? '').trim();
+            if (!alias)
+                return { error: 'alias 必填' };
+            if (!service)
+                return { error: 'service 必填' };
+            const data = input.data && typeof input.data === 'object'
+                ? input.data
+                : undefined;
+            const result = await facade.callService(alias, service, data, context.principal);
+            return result.ok ? { success: true, ...result.value } : mapFacadeFailToToolError(result);
+        }),
+    ]);
 }
 //# sourceMappingURL=home-tools.js.map