@zhin.js/agent 0.1.28 → 0.1.30

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

@@ -0,0 +1,36 @@
+/**
+ * Assistant Home Domain 配置（M4）
+ */
+import type { JobNotify } from './types.js';
+export interface HomePolicyConfig {
+    /** 仅 master 可调用 home_*（默认 true） */
+    requireMaster?: boolean;
+    /** 写操作需 Owner 审批的 HA domain（默认 lock、alarm_control_panel） */
+    confirmServices?: string[];
+}
+export interface AssistantHomeConfig {
+    enabled?: boolean;
+    /** HA REST 基址，如 http://homeassistant.local:8123 */
+    restUrl?: string;
+    /** HA 长期访问令牌 */
+    restToken?: string;
+    /** 可选：ai.mcpServers 中的名称（M4 以 REST 为主，MCP 后续扩展） */
+    mcpServer?: string;
+    /** 中文/友好名 → entity_id */
+    aliases?: Record<string, string>;
+    policy?: HomePolicyConfig;
+}
+export declare const DEFAULT_HOME_POLICY: Required<Pick<HomePolicyConfig, 'confirmServices'>>;
+export declare function resolveAssistantHomeConfig(raw?: AssistantHomeConfig): AssistantHomeConfig & {
+    enabled: boolean;
+    policy: HomePolicyConfig & {
+        requireMaster: boolean;
+        confirmServices: string[];
+    };
+};
+export declare function isAssistantHomeActive(home?: AssistantHomeConfig): boolean;
+/** 占位：Home notify 可指向 HA（M3 router ha 通道） */
+export type HomeJobNotify = Extract<JobNotify, {
+    channel: 'ha';
+}>;
+//# sourceMappingURL=home-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-config.d.ts","sourceRoot":"","sources":["../../src/assistant/home-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAEnF,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,GAAG,CAAC,EAAE,mBAAmB,GACxB,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,GAAG;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,CAY9H;AAED,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAGzE;AAED,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC"}

package/lib/assistant/home-config.js

@@ -0,0 +1,21 @@
+export const DEFAULT_HOME_POLICY = {
+    confirmServices: ['lock', 'alarm_control_panel'],
+};
+export function resolveAssistantHomeConfig(raw) {
+    return {
+        enabled: raw?.enabled === true,
+        restUrl: raw?.restUrl,
+        restToken: raw?.restToken,
+        mcpServer: raw?.mcpServer,
+        aliases: raw?.aliases ?? {},
+        policy: {
+            requireMaster: raw?.policy?.requireMaster !== false,
+            confirmServices: raw?.policy?.confirmServices ?? DEFAULT_HOME_POLICY.confirmServices,
+        },
+    };
+}
+export function isAssistantHomeActive(home) {
+    const cfg = resolveAssistantHomeConfig(home);
+    return cfg.enabled && Boolean(cfg.restUrl && cfg.restToken);
+}
+//# sourceMappingURL=home-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-config.js","sourceRoot":"","sources":["../../src/assistant/home-config.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,MAAM,mBAAmB,GAAwD;IACtF,eAAe,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACjD,CAAC;AAEF,MAAM,UAAU,0BAA0B,CACxC,GAAyB;IAEzB,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI;QAC9B,OAAO,EAAE,GAAG,EAAE,OAAO;QACrB,SAAS,EAAE,GAAG,EAAE,SAAS;QACzB,SAAS,EAAE,GAAG,EAAE,SAAS;QACzB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,EAAE;QAC3B,MAAM,EAAE;YACN,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,KAAK,KAAK;YACnD,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,IAAI,mBAAmB,CAAC,eAAe;SACrF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAA0B;IAC9D,MAAM,GAAG,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;AAC9D,CAAC"}

package/lib/assistant/home-mcp-bridge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Home MCP 通道校验与说明（assistant.home.mcpServer）
+ *
+ * REST 为主路径；配置 mcpServer 时与 ai.mcpServers 对齐，供 Agent binding 挂载 MCP 工具。
+ */
+import type { AIConfig } from '@zhin.js/core';
+import type { AssistantHomeConfig } from './home-config.js';
+export declare function listConfiguredMcpServerNames(ai?: AIConfig): string[];
+/** 校验 mcpServer 已在 ai.mcpServers 注册；返回警告文案（无则 null） */
+export declare function validateHomeMcpServer(home?: AssistantHomeConfig, ai?: AIConfig): string | null;
+export declare function isHomeMcpMode(home?: AssistantHomeConfig): boolean;
+//# sourceMappingURL=home-mcp-bridge.d.ts.map

package/lib/assistant/home-mcp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-mcp-bridge.d.ts","sourceRoot":"","sources":["../../src/assistant/home-mcp-bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,wBAAgB,4BAA4B,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CAOpE;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CACnC,IAAI,CAAC,EAAE,mBAAmB,EAC1B,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAGjE"}

package/lib/assistant/home-mcp-bridge.js

@@ -0,0 +1,26 @@
+import { resolveAssistantHomeConfig } from './home-config.js';
+export function listConfiguredMcpServerNames(ai) {
+    const names = new Set();
+    for (const entry of ai?.mcpServers ?? []) {
+        const name = entry.name?.trim();
+        if (name)
+            names.add(name);
+    }
+    return [...names];
+}
+/** 校验 mcpServer 已在 ai.mcpServers 注册；返回警告文案（无则 null） */
+export function validateHomeMcpServer(home, ai) {
+    const cfg = resolveAssistantHomeConfig(home);
+    const name = cfg.mcpServer?.trim();
+    if (!name)
+        return null;
+    const registered = listConfiguredMcpServerNames(ai);
+    if (registered.includes(name))
+        return null;
+    return `assistant.home.mcpServer="${name}" 未在 ai.mcpServers 中注册；REST 仍可用，MCP 工具需补全配置`;
+}
+export function isHomeMcpMode(home) {
+    const cfg = resolveAssistantHomeConfig(home);
+    return Boolean(cfg.mcpServer?.trim() && !cfg.restUrl);
+}
+//# sourceMappingURL=home-mcp-bridge.js.map

package/lib/assistant/home-mcp-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-mcp-bridge.js","sourceRoot":"","sources":["../../src/assistant/home-mcp-bridge.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,UAAU,4BAA4B,CAAC,EAAa;IACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,EAAE,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,qBAAqB,CACnC,IAA0B,EAC1B,EAAa;IAEb,MAAM,GAAG,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,UAAU,GAAG,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,6BAA6B,IAAI,6CAA6C,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,MAAM,GAAG,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { ToolContext } from '@zhin.js/core';
+import { type ToolRequesterRole } from '../security/owner-approve-always-store.js';
+import type { HomePolicyConfig } from './home-config.js';
+export interface HomeToolDecision {
+    allowed: boolean;
+    needsOwnerApproval?: boolean;
+    reason?: string;
+    role: ToolRequesterRole;
+}
+export declare function checkHomeToolAccess(operation: 'read' | 'write', entityId: string, context: ToolContext | undefined, policy: HomePolicyConfig & {
+    requireMaster: boolean;
+    confirmServices: string[];
+}): HomeToolDecision;
+export declare function toHomeOwnerSignal(decision: HomeToolDecision): string;
+export declare function toHomeDenyError(decision: HomeToolDecision): string;
+//# sourceMappingURL=home-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-policy.d.ts","sourceRoot":"","sources":["../../src/assistant/home-policy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,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;AAcD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,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"}

package/lib/assistant/home-policy.js

@@ -0,0 +1,46 @@
+/**
+ * Home Domain 工具权限（M4）
+ */
+import { getPlugin } from '@zhin.js/core';
+import { resolveToolRequesterRole, } from '../security/owner-approve-always-store.js';
+import { parseEntityDomain } from './domains/home-assistant.js';
+function resolveRole(context) {
+    if (!context?.platform || !context?.botId || !context?.senderId) {
+        return 'unknown';
+    }
+    try {
+        return resolveToolRequesterRole(getPlugin(), context);
+    }
+    catch {
+        if (context.roles?.includes('master'))
+            return 'master';
+        return 'other';
+    }
+}
+export function checkHomeToolAccess(operation, entityId, context, policy) {
+    const role = resolveRole(context);
+    const domain = parseEntityDomain(entityId);
+    if (policy.requireMaster && role !== 'master') {
+        return {
+            allowed: false,
+            role,
+            reason: '智能家居操作仅允许 Bot Owner（master）调用。',
+        };
+    }
+    if (operation === 'write' && policy.confirmServices.includes(domain)) {
+        return {
+            allowed: false,
+            needsOwnerApproval: true,
+            role,
+            reason: `「${domain}」类设备操作需 Owner 确认后方可执行（entity: ${entityId}）。`,
+        };
+    }
+    return { allowed: true, role };
+}
+export function toHomeOwnerSignal(decision) {
+    return `ZHIN_NEEDS_OWNER:\n${decision.reason ?? '该智能家居操作需要 Master 确认。'}`;
+}
+export function toHomeDenyError(decision) {
+    return `Error: ${decision.reason ?? '智能家居操作被拒绝。'}`;
+}
+//# sourceMappingURL=home-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-policy.js","sourceRoot":"","sources":["../../src/assistant/home-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EACL,wBAAwB,GAEzB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAShE,SAAS,WAAW,CAAC,OAAqB;IACxC,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,wBAAwB,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAA2B,EAC3B,QAAgB,EAChB,OAAgC,EAChC,MAAgF;IAEhF,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,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,gCAAgC;SACzC,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

@@ -0,0 +1,15 @@
+/**
+ * home_* 工具 — 薄封装 HomeAssistantService（M4）
+ */
+import { ZhinTool } from '@zhin.js/core';
+import type { HomeAssistantService } from './domains/home-assistant.js';
+import type { HomePolicyConfig } from './home-config.js';
+export interface HomeToolsOptions {
+    service: HomeAssistantService;
+    policy: HomePolicyConfig & {
+        requireMaster: boolean;
+        confirmServices: string[];
+    };
+}
+export declare function createHomeTools(options: HomeToolsOptions): ZhinTool[];
+//# sourceMappingURL=home-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-tools.d.ts","sourceRoot":"","sources":["../../src/assistant/home-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAUzD,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;AAsCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CA8FrE"}

package/lib/assistant/home-tools.js

@@ -0,0 +1,141 @@
+/**
+ * home_* 工具 — 薄封装 HomeAssistantService（M4）
+ */
+import { ZhinTool } from '@zhin.js/core';
+import { checkHomeToolAccess, toHomeDenyError, toHomeOwnerSignal, } from './home-policy.js';
+import { getPlugin } from '@zhin.js/core';
+import { resolveToolRequesterRole } from '../security/owner-approve-always-store.js';
+function guard(operation, entityId, context, policy) {
+    const decision = checkHomeToolAccess(operation, entityId, context, policy);
+    return formatGuardResult(decision);
+}
+function guardMasterOnly(context, policy) {
+    if (!policy.requireMaster || !context?.platform || !context.botId || !context.senderId) {
+        return null;
+    }
+    try {
+        const role = resolveToolRequesterRole(getPlugin(), context);
+        if (role === 'master')
+            return null;
+        return toHomeDenyError({
+            allowed: false,
+            role,
+            reason: '智能家居操作仅允许 Bot Owner（master）调用。',
+        });
+    }
+    catch {
+        return null;
+    }
+}
+function formatGuardResult(decision) {
+    if (decision.allowed)
+        return null;
+    if (decision.needsOwnerApproval)
+        return toHomeOwnerSignal(decision);
+    return toHomeDenyError(decision);
+}
+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, context) => {
+        const aliases = service.listAliases();
+        const names = Object.keys(aliases);
+        if (names.length === 0)
+            return { aliases: {}, message: '未配置任何设备别名' };
+        const listErr = guardMasterOnly(context, 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, context) => {
+        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, context, policy);
+        if (err)
+            return { error: err };
+        try {
+            const state = await service.getState(alias);
+            return {
+                alias,
+                state: state.state,
+                attributes: state.attributes,
+                lastUpdated: state.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, context) => {
+        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, context, 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, context) => {
+        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, context, 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];
+}
+//# sourceMappingURL=home-tools.js.map

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

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

package/lib/assistant/index.d.ts

@@ -0,0 +1,31 @@
+export type { AssistantConfig, AssistantDefaultsConfig, AssistantEventsConfig, AssistantQueueConfig } from './config.js';
+export type { AssistantHomeConfig, HomePolicyConfig } from './home-config.js';
+export { resolveAssistantHomeConfig, isAssistantHomeActive, DEFAULT_HOME_POLICY, } from './home-config.js';
+export { HomeAssistantService, parseEntityDomain } from './domains/home-assistant.js';
+export type { HaEntityState, HaFetch } from './domains/home-assistant.js';
+export { createHomeTools } from './home-tools.js';
+export type { AssistantProfileConfig, AssistantProfile } from './profile-types.js';
+export { ASSISTANT_PROFILE_VERSION, DEFAULT_PROFILE_FILENAME, DEFAULT_HEARTBEAT_PROMPT, PROFILE_HEARTBEAT_JOB_ID, PROFILE_MORNING_BRIEF_JOB_ID, PROFILE_BEDTIME_CHECK_JOB_ID, } from './profile-types.js';
+export { loadAssistantProfileFile, loadBootstrapWithProfile, syncProfileHeartbeatToStore, syncProfileCronRoutinesToStore, mergeProfileDeviceAliases, validateAssistantProfile, resolveAssistantProfileConfig, buildHeartbeatJobFromRoutine, buildCronJobFromRoutine, } from './profile-loader.js';
+export { registerJobSchedule, isRuntimeSchedulable } from './job-scheduler.js';
+export { validateHomeMcpServer, listConfiguredMcpServerNames, isHomeMcpMode } from './home-mcp-bridge.js';
+export type { ScheduleDispose } from './job-scheduler.js';
+export { checkHomeToolAccess, toHomeOwnerSignal, toHomeDenyError } from './home-policy.js';
+export { DEFAULT_ASSISTANT_CONFIG, DEFAULT_EVENTS_CONFIG, resolveAssistantConfig, resolveAssistantDefaultsConfig, resolveAssistantEventsConfig, resolveAssistantQueueConfig, isAssistantEventsActive, } from './config.js';
+export type { AssistantEventRequest, AssistantEventResult, AssistantEventStatus } from './event-types.js';
+export { AssistantEventIngress } from './event-ingress.js';
+export type { AssistantEventIngressOptions } from './event-ingress.js';
+export { setAssistantRuntime, getAssistantRuntime, isAssistantEventsEndpointActive, getAssistantEventsTokenFallback, } from './runtime-registry.js';
+export type { AssistantRuntimeHandle } from './runtime-registry.js';
+export type { AssistantJob, AssistantJobFile, AssistantJobState, JobAction, JobNotify, JobSchedule, } from './types.js';
+export { ASSISTANT_JOBS_FILENAME, ASSISTANT_JOBS_VERSION } from './types.js';
+export { assistantCronJobs, assistantToCronRecord, cronRecordToAssistant, schedulerRecordToAssistant, toolContextToImNotify, isCronSchedulable, jobPrompt, } from './legacy-convert.js';
+export { AssistantJobStore, createAssistantJobStore, getAssistantJobsPath, } from './job-store.js';
+export type { AssistantJobStoreOptions, MigrationResult } from './job-store.js';
+export { JobWorker } from './job-worker.js';
+export type { JobWorkerOptions } from './job-worker.js';
+export { AssistantJobEngine } from './job-engine.js';
+export type { AssistantJobEngineOptions } from './job-engine.js';
+export { createNotificationRouter, resolveEffectiveNotify, notifyToSendOptions, mergeImNotify, } from './notification-router.js';
+export type { NotificationRouter, NotificationRouterDeps, DeliverParams, DeliverResult, ImJobNotify, } from './notification-router.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/assistant/index.d.ts.map

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

package/lib/assistant/index.js

@@ -0,0 +1,18 @@
+export { resolveAssistantHomeConfig, isAssistantHomeActive, DEFAULT_HOME_POLICY, } from './home-config.js';
+export { HomeAssistantService, parseEntityDomain } from './domains/home-assistant.js';
+export { createHomeTools } from './home-tools.js';
+export { ASSISTANT_PROFILE_VERSION, DEFAULT_PROFILE_FILENAME, DEFAULT_HEARTBEAT_PROMPT, PROFILE_HEARTBEAT_JOB_ID, PROFILE_MORNING_BRIEF_JOB_ID, PROFILE_BEDTIME_CHECK_JOB_ID, } from './profile-types.js';
+export { loadAssistantProfileFile, loadBootstrapWithProfile, syncProfileHeartbeatToStore, syncProfileCronRoutinesToStore, mergeProfileDeviceAliases, validateAssistantProfile, resolveAssistantProfileConfig, buildHeartbeatJobFromRoutine, buildCronJobFromRoutine, } from './profile-loader.js';
+export { registerJobSchedule, isRuntimeSchedulable } from './job-scheduler.js';
+export { validateHomeMcpServer, listConfiguredMcpServerNames, isHomeMcpMode } from './home-mcp-bridge.js';
+export { checkHomeToolAccess, toHomeOwnerSignal, toHomeDenyError } from './home-policy.js';
+export { DEFAULT_ASSISTANT_CONFIG, DEFAULT_EVENTS_CONFIG, resolveAssistantConfig, resolveAssistantDefaultsConfig, resolveAssistantEventsConfig, resolveAssistantQueueConfig, isAssistantEventsActive, } from './config.js';
+export { AssistantEventIngress } from './event-ingress.js';
+export { setAssistantRuntime, getAssistantRuntime, isAssistantEventsEndpointActive, getAssistantEventsTokenFallback, } from './runtime-registry.js';
+export { ASSISTANT_JOBS_FILENAME, ASSISTANT_JOBS_VERSION } from './types.js';
+export { assistantCronJobs, assistantToCronRecord, cronRecordToAssistant, schedulerRecordToAssistant, toolContextToImNotify, isCronSchedulable, jobPrompt, } from './legacy-convert.js';
+export { AssistantJobStore, createAssistantJobStore, getAssistantJobsPath, } from './job-store.js';
+export { JobWorker } from './job-worker.js';
+export { AssistantJobEngine } from './job-engine.js';
+export { createNotificationRouter, resolveEffectiveNotify, notifyToSendOptions, mergeImNotify, } from './notification-router.js';
+//# sourceMappingURL=index.js.map

package/lib/assistant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assistant/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1G,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE3F,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,SAAS,GACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,GACd,MAAM,0BAA0B,CAAC"}

package/lib/assistant/job-engine.d.ts

@@ -0,0 +1,40 @@
+import type { AddCronFn, CronJobRecord } from '../cron-engine.js';
+import type { AssistantJobStore } from './job-store.js';
+import type { JobWorker } from './job-worker.js';
+import type { AssistantJob } from './types.js';
+import type { NotificationRouter } from './notification-router.js';
+export interface AssistantJobEngineOptions {
+    store: AssistantJobStore;
+    addCron: AddCronFn;
+    worker: JobWorker;
+    notifyOnFailure?: boolean;
+    router?: NotificationRouter;
+    defaultNotify?: import('./types.js').JobNotify;
+}
+export declare class AssistantJobEngine {
+    private store;
+    private addCron;
+    private worker;
+    private disposes;
+    private notifyOnFailure;
+    private router?;
+    private defaultNotify?;
+    constructor(options: AssistantJobEngineOptions);
+    getDataDir(): string;
+    load(): void;
+    registerOne(job: AssistantJob): void;
+    runJobNow(jobId: string): Promise<void>;
+    private runJob;
+    listJobs(): Promise<CronJobRecord[]>;
+    listAssistantJobs(): Promise<AssistantJob[]>;
+    addJob(record: Omit<CronJobRecord, 'createdAt'> & {
+        createdAt?: number;
+    }): Promise<CronJobRecord>;
+    removeJob(id: string): Promise<boolean>;
+    pauseJob(id: string): Promise<boolean>;
+    resumeJob(id: string): Promise<boolean>;
+    unload(): void;
+    updateJobStatus(id: string, status: 'ok' | 'error', error?: string): Promise<void>;
+}
+export type { AddCronFn } from '../cron-engine.js';
+//# sourceMappingURL=job-engine.d.ts.map

package/lib/assistant/job-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-engine.d.ts","sourceRoot":"","sources":["../../src/assistant/job-engine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACd,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAKnE,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,YAAY,EAAE,SAAS,CAAC;CAChD;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,MAAM,CAAC,CAAqB;IACpC,OAAO,CAAC,aAAa,CAAC,CAAiC;gBAE3C,OAAO,EAAE,yBAAyB;IAS9C,UAAU,IAAI,MAAM;IAIpB,IAAI,IAAI,IAAI;IAgBZ,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAO9B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAI/B,MAAM;IA6Bd,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAIpC,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI5C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBjG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAatC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW7C,MAAM,IAAI,IAAI;IAWR,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOzF;AAED,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/assistant/job-engine.js

@@ -0,0 +1,155 @@
+/**
+ * AssistantJobEngine — 基于 JobStore 的持久化调度（API 兼容 PersistentCronEngine）
+ */
+import { Logger } from '@zhin.js/core';
+import { formatCompact } from '@zhin.js/logger';
+import { assistantToCronRecord, cronRecordToAssistant, jobPrompt, } from './legacy-convert.js';
+import { registerJobSchedule, isRuntimeSchedulable } from './job-scheduler.js';
+import { resolveEffectiveNotify } from './notification-router.js';
+const logger = new Logger(null, 'assistant-job-engine');
+export class AssistantJobEngine {
+    store;
+    addCron;
+    worker;
+    disposes = new Map();
+    notifyOnFailure;
+    router;
+    defaultNotify;
+    constructor(options) {
+        this.store = options.store;
+        this.addCron = options.addCron;
+        this.worker = options.worker;
+        this.notifyOnFailure = options.notifyOnFailure === true;
+        this.router = options.router;
+        this.defaultNotify = options.defaultNotify;
+    }
+    getDataDir() {
+        return this.store.getDataDir();
+    }
+    load() {
+        this.store.migrateLegacyIfNeeded().then(() => this.store.listJobs()).then((jobs) => {
+            for (const job of jobs) {
+                if (isRuntimeSchedulable(job)) {
+                    this.registerOne(job);
+                }
+            }
+            const count = jobs.filter((j) => isRuntimeSchedulable(j)).length;
+            if (count > 0) {
+                logger.debug(formatCompact({ assistant_jobs: count }));
+            }
+        }).catch((e) => {
+            logger.warn('加载 Assistant Job 失败: ' + (e?.message || String(e)));
+        });
+    }
+    registerOne(job) {
+        const dispose = registerJobSchedule(job, this.addCron, (jobId) => this.runJob(jobId));
+        if (dispose) {
+            this.disposes.set(job.id, dispose);
+        }
+    }
+    async runJobNow(jobId) {
+        await this.runJob(jobId);
+    }
+    async runJob(jobId) {
+        const job = await this.store.getJob(jobId);
+        if (!job || !job.enabled)
+            return;
+        if (job.action.kind !== 'agent' && job.action.kind !== 'heartbeat')
+            return;
+        const result = await this.worker.run(jobId, jobPrompt(job), {
+            notify: job.notify,
+            label: job.label || jobId,
+        });
+        await this.store.updateJobState(jobId, {
+            lastExecutedAt: Date.now(),
+            lastStatus: result.success ? 'ok' : 'error',
+            lastError: result.success ? undefined : result.error,
+        });
+        if (!result.success && this.router && (job.notifyOnFailure ?? this.notifyOnFailure)) {
+            const notify = resolveEffectiveNotify(job.notify, this.defaultNotify);
+            if (notify.channel !== 'silent' && notify.channel !== 'log') {
+                const msg = `[任务失败] ${job.label || jobId}: ${result.error || 'unknown error'}`;
+                await this.router.deliver({ notify, content: msg, jobId, label: job.label }).catch(() => { });
+            }
+        }
+        if (result.success && job.schedule.kind === 'at' && job.schedule.deleteAfterRun) {
+            await this.removeJob(jobId);
+        }
+    }
+    async listJobs() {
+        return this.store.listCronCompatible();
+    }
+    async listAssistantJobs() {
+        return this.store.listJobs();
+    }
+    async addJob(record) {
+        const assistant = cronRecordToAssistant({
+            ...record,
+            createdAt: record.createdAt ?? Date.now(),
+            enabled: record.enabled ?? true,
+        });
+        assistant.source = 'manual';
+        await this.store.upsertJob(assistant);
+        if (isRuntimeSchedulable(assistant)) {
+            this.registerOne(assistant);
+        }
+        const out = assistantToCronRecord(assistant);
+        if (!out)
+            throw new Error('Failed to convert assistant job to cron record');
+        return out;
+    }
+    async removeJob(id) {
+        const ok = await this.store.removeJob(id);
+        if (!ok)
+            return false;
+        const dispose = this.disposes.get(id);
+        if (dispose) {
+            dispose();
+            this.disposes.delete(id);
+        }
+        return true;
+    }
+    async pauseJob(id) {
+        const job = await this.store.getJob(id);
+        if (!job)
+            return false;
+        job.enabled = false;
+        await this.store.upsertJob(job);
+        const dispose = this.disposes.get(id);
+        if (dispose) {
+            dispose();
+            this.disposes.delete(id);
+        }
+        return true;
+    }
+    async resumeJob(id) {
+        const job = await this.store.getJob(id);
+        if (!job)
+            return false;
+        job.enabled = true;
+        await this.store.upsertJob(job);
+        if (isRuntimeSchedulable(job)) {
+            this.registerOne(job);
+        }
+        return true;
+    }
+    unload() {
+        for (const [id, dispose] of this.disposes) {
+            try {
+                dispose();
+            }
+            catch (e) {
+                logger.warn(`Assistant schedule dispose failed for ${id}:`, e);
+            }
+        }
+        this.disposes.clear();
+    }
+    async updateJobStatus(id, status, error) {
+        await this.store.updateJobState(id, {
+            lastExecutedAt: Date.now(),
+            lastStatus: status,
+            lastError: status === 'error' ? error : undefined,
+        });
+    }
+}
+//# sourceMappingURL=job-engine.js.map