@zhin.js/agent 0.1.29 → 0.1.30

package/README.md

@@ -148,7 +148,7 @@ ai:
 框架已提供 **SubagentManager**：主 ZhinAgent 通过工具 `spawn_task` 把复杂/耗时任务派给**后台子 Agent** 异步执行，子 Agent 默认仅用受限工具集（文件、Shell、网络搜索等），完成后通过回调把结果发回主会话。
 
 - 主对话不阻塞，用户可继续聊天。
-- 子 Agent 由 `ZhinAgent.initSubagentManager(createTools)` 在 init 时挂好，主 Agent 在回复里提到「后台 / 子任务 / spawn」时会注入 `spawn_task` 工具。
+- 子 Agent 由 `ZhinAgent.initSubagentManager(createTools)` 在 init 时挂好；`spawn_task` 为主编排序列化常驻工具（见 `orchestratorTools` / `DEFAULT_ORCHESTRATOR_TOOLS`）。
 - 用户说「后台帮我整理这份文档」时，主 Agent 可调用 `spawn_task({ task: '...', label: '...' })`，子任务在后台跑完后再通知用户。
 
 无需额外配置即可使用；若需放宽子 Agent 的工具范围，使用 `ai.agent.subagentTools` 显式追加白名单（不会自动继承主会话全部 skill/tool）。

package/lib/agent-prompt/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/agent-prompt/resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAY/D,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,CAAC,EAAE,IAAI,CACX,QAAQ,CAAC,eAAe,CAAC,EACzB,+BAA+B,GAAG,wBAAwB,CAC3D,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0C/B;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,uBAAuB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,aAAa,EAAE,SAAS,EAAE,EAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,aAAa,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,EAAE,GAC9I,OAAO,aAAa,EAAE,SAAS,EAAE,CAOnC;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,uBAAuB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAUT"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/agent-prompt/resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAY/D,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,CAAC,EAAE,IAAI,CACX,QAAQ,CAAC,eAAe,CAAC,EACzB,+BAA+B,GAAG,wBAAwB,CAC3D,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyC/B;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,uBAAuB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,aAAa,EAAE,SAAS,EAAE,EAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,aAAa,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,aAAa,EAAE,SAAS,EAAE,GAC9I,OAAO,aAAa,EAAE,SAAS,EAAE,CAOnC;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,uBAAuB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAUT"}

package/lib/agent-prompt/resolver.js

@@ -31,7 +31,6 @@ export async function resolveAgentPromptSections(options) {
     const hookEvent = createAIHookEvent('agent', 'prompt', sessionId, {
         slot: ctx.slot,
         toolContext: ctx.toolContext,
-        toolSearch: ctx.toolSearch,
         userMessagePreview: ctx.userMessagePreview,
         deferred: ctx.deferred,
         sections,

package/lib/agent-prompt/resolver.js.map

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

package/lib/assistant/config.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Assistant Runtime 配置（应用级，zhin.config.yml 顶层 assistant 块）
+ */
+import type { AssistantHomeConfig } from './home-config.js';
+import type { JobNotify } from './types.js';
+export interface AssistantDefaultsConfig {
+    /** 未显式指定 notify 时的默认投递目标（M3） */
+    notify?: JobNotify;
+    /** Job 失败时是否通知（默认 false） */
+    notifyOnFailure?: boolean;
+}
+export interface AssistantEventsConfig {
+    /** 启用 POST /api/assistant/events（需 assistant.enabled） */
+    enabled?: boolean;
+    /**
+     * 可选专用 Bearer；未设时复用 http.token（路由仍在 /api 下受全局鉴权保护）。
+     */
+    token?: string;
+    /** 允许的来源白名单；空数组表示不限制 */
+    allowedSources?: string[];
+    /** 每来源每分钟最大请求数（默认 60） */
+    rateLimitPerMinute?: number;
+}
+export interface AssistantQueueConfig {
+    /** 启用 TaskQueue 执行 Job（默认 assistant.enabled 时为 true） */
+    enabled?: boolean;
+    maxConcurrency?: number;
+    maxRetries?: number;
+    defaultTimeoutMs?: number;
+}
+export interface AssistantConfig {
+    /** 启用统一 JobStore（默认 false，Stable 行为不变） */
+    enabled?: boolean;
+    /** JobWorker → TaskQueue（重试 / 并发 / 死信） */
+    queue?: AssistantQueueConfig;
+    /**
+     * 写入 assistant-jobs.json 后是否双写 legacy cron-jobs.json（默认 false）。
+     * 迁移期可设 true 便于旧 CLI 只读 cron-jobs.json。
+     */
+    legacyDualWrite?: boolean;
+    /** 自定义 JobStore 文件名（默认 assistant-jobs.json） */
+    jobsFile?: string;
+    defaults?: AssistantDefaultsConfig;
+    profile?: import('./profile-types.js').AssistantProfileConfig;
+    home?: AssistantHomeConfig;
+    events?: AssistantEventsConfig;
+}
+export declare const DEFAULT_ASSISTANT_CONFIG: Required<Pick<AssistantConfig, 'legacyDualWrite'>>;
+export declare const DEFAULT_EVENTS_CONFIG: Required<Pick<AssistantEventsConfig, 'rateLimitPerMinute'>>;
+export declare function resolveAssistantQueueConfig(raw?: AssistantQueueConfig, assistantEnabled?: boolean): AssistantQueueConfig & {
+    enabled: boolean;
+    maxConcurrency: number;
+    maxRetries: number;
+    defaultTimeoutMs: number;
+};
+export declare function resolveAssistantConfig(raw?: AssistantConfig): AssistantConfig & {
+    enabled: boolean;
+};
+export declare function resolveAssistantDefaultsConfig(raw?: AssistantDefaultsConfig): AssistantDefaultsConfig & {
+    notifyOnFailure: boolean;
+};
+export declare function resolveAssistantEventsConfig(raw?: AssistantEventsConfig): AssistantEventsConfig & {
+    enabled: boolean;
+    rateLimitPerMinute: number;
+};
+export declare function isAssistantEventsActive(assistant?: AssistantConfig): boolean;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/assistant/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4BAA4B;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,oBAAoB,EAAE,sBAAsB,CAAC;IAC9D,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAEvF,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAE7F,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,GAAG,CAAC,EAAE,oBAAoB,EAC1B,gBAAgB,UAAQ,GACvB,oBAAoB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAQnH;AAED,wBAAgB,sBAAsB,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAWpG;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,CAAC,EAAE,uBAAuB,GAC5B,uBAAuB,GAAG;IAAE,eAAe,EAAE,OAAO,CAAA;CAAE,CAKxD;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,CAAC,EAAE,qBAAqB,GAC1B,qBAAqB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAO1E;AAED,wBAAgB,uBAAuB,CACrC,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAIT"}

package/lib/assistant/config.js

@@ -0,0 +1,47 @@
+export const DEFAULT_ASSISTANT_CONFIG = {
+    legacyDualWrite: false,
+};
+export const DEFAULT_EVENTS_CONFIG = {
+    rateLimitPerMinute: 60,
+};
+export function resolveAssistantQueueConfig(raw, assistantEnabled = false) {
+    const enabled = raw?.enabled ?? assistantEnabled;
+    return {
+        enabled,
+        maxConcurrency: raw?.maxConcurrency ?? 3,
+        maxRetries: raw?.maxRetries ?? 2,
+        defaultTimeoutMs: raw?.defaultTimeoutMs ?? 120_000,
+    };
+}
+export function resolveAssistantConfig(raw) {
+    return {
+        enabled: raw?.enabled === true,
+        legacyDualWrite: raw?.legacyDualWrite ?? DEFAULT_ASSISTANT_CONFIG.legacyDualWrite,
+        jobsFile: raw?.jobsFile,
+        queue: raw?.queue,
+        defaults: raw?.defaults,
+        profile: raw?.profile,
+        home: raw?.home,
+        events: raw?.events,
+    };
+}
+export function resolveAssistantDefaultsConfig(raw) {
+    return {
+        notify: raw?.notify,
+        notifyOnFailure: raw?.notifyOnFailure === true,
+    };
+}
+export function resolveAssistantEventsConfig(raw) {
+    return {
+        enabled: raw?.enabled === true,
+        token: raw?.token,
+        allowedSources: raw?.allowedSources,
+        rateLimitPerMinute: raw?.rateLimitPerMinute ?? DEFAULT_EVENTS_CONFIG.rateLimitPerMinute,
+    };
+}
+export function isAssistantEventsActive(assistant) {
+    const base = resolveAssistantConfig(assistant);
+    const events = resolveAssistantEventsConfig(base.events);
+    return base.enabled && events.enabled;
+}
+//# sourceMappingURL=config.js.map

package/lib/assistant/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/assistant/config.ts"],"names":[],"mappings":"AAoDA,MAAM,CAAC,MAAM,wBAAwB,GAAuD;IAC1F,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgE;IAChG,kBAAkB,EAAE,EAAE;CACvB,CAAC;AAEF,MAAM,UAAU,2BAA2B,CACzC,GAA0B,EAC1B,gBAAgB,GAAG,KAAK;IAExB,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,IAAI,gBAAgB,CAAC;IACjD,OAAO;QACL,OAAO;QACP,cAAc,EAAE,GAAG,EAAE,cAAc,IAAI,CAAC;QACxC,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,CAAC;QAChC,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,IAAI,OAAO;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI;QAC9B,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,wBAAwB,CAAC,eAAe;QACjF,QAAQ,EAAE,GAAG,EAAE,QAAQ;QACvB,KAAK,EAAE,GAAG,EAAE,KAAK;QACjB,QAAQ,EAAE,GAAG,EAAE,QAAQ;QACvB,OAAO,EAAE,GAAG,EAAE,OAAO;QACrB,IAAI,EAAE,GAAG,EAAE,IAAI;QACf,MAAM,EAAE,GAAG,EAAE,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,GAA6B;IAE7B,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,MAAM;QACnB,eAAe,EAAE,GAAG,EAAE,eAAe,KAAK,IAAI;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,GAA2B;IAE3B,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI;QAC9B,KAAK,EAAE,GAAG,EAAE,KAAK;QACjB,cAAc,EAAE,GAAG,EAAE,cAAc;QACnC,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,IAAI,qBAAqB,CAAC,kBAAkB;KACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAA2B;IAE3B,MAAM,IAAI,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { AssistantHomeConfig } from '../home-config.js';
+export type HaFetch = (url: string, init?: RequestInit) => Promise<Response>;
+export interface HaEntityState {
+    entityId: string;
+    state: string;
+    attributes: Record<string, unknown>;
+    lastChanged?: string;
+    lastUpdated?: string;
+}
+export declare function parseEntityDomain(entityId: string): string;
+export declare class HomeAssistantService {
+    private cfg;
+    private fetchFn;
+    constructor(homeConfig: AssistantHomeConfig, fetchFn?: HaFetch);
+    listAliases(): Record<string, string>;
+    resolveAlias(alias: string): string;
+    private baseUrl;
+    private token;
+    private haRequest;
+    getState(alias: string): Promise<HaEntityState>;
+    resolveServiceForToggle(entityId: string, on: boolean): {
+        domain: string;
+        service: string;
+    };
+    callService(alias: string, service: string, data?: Record<string, unknown>): Promise<void>;
+    turnOn(alias: string): Promise<{
+        alias: string;
+        entityId: string;
+        service: string;
+    }>;
+    turnOff(alias: string): Promise<{
+        alias: string;
+        entityId: string;
+        service: string;
+    }>;
+}
+//# sourceMappingURL=home-assistant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home-assistant.d.ts","sourceRoot":"","sources":["../../../src/assistant/domains/home-assistant.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAK7D,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,GAAG,CAAgD;IAC3D,OAAO,CAAC,OAAO,CAAU;gBAEb,UAAU,EAAE,mBAAmB,EAAE,OAAO,GAAE,OAA2C;IAKjG,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIrC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IASnC,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,KAAK;YAKC,SAAS;IAoBjB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAYrD,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAUrF,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAUV,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOpF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAM5F"}

package/lib/assistant/domains/home-assistant.js

@@ -0,0 +1,113 @@
+/**
+ * HomeAssistantService — 别名解析 + HA REST（M4）
+ */
+import { Logger } from '@zhin.js/core';
+import { formatCompact } from '@zhin.js/logger';
+import { resolveAssistantHomeConfig } from '../home-config.js';
+const logger = new Logger(null, 'home-assistant');
+const DOMAIN_SERVICE_MAP = {
+    light: { on: 'turn_on', off: 'turn_off' },
+    switch: { on: 'turn_on', off: 'turn_off' },
+    fan: { on: 'turn_on', off: 'turn_off' },
+    cover: { on: 'open_cover', off: 'close_cover' },
+    lock: { on: 'unlock', off: 'lock' },
+    climate: { on: 'turn_on', off: 'turn_off' },
+    media_player: { on: 'turn_on', off: 'turn_off' },
+};
+export function parseEntityDomain(entityId) {
+    const dot = entityId.indexOf('.');
+    return dot > 0 ? entityId.slice(0, dot) : entityId;
+}
+export class HomeAssistantService {
+    cfg;
+    fetchFn;
+    constructor(homeConfig, fetchFn = globalThis.fetch.bind(globalThis)) {
+        this.cfg = resolveAssistantHomeConfig(homeConfig);
+        this.fetchFn = fetchFn;
+    }
+    listAliases() {
+        return { ...this.cfg.aliases };
+    }
+    resolveAlias(alias) {
+        const key = alias.trim();
+        const entity = this.cfg.aliases?.[key];
+        if (!entity) {
+            throw new Error(`未知设备别名: ${alias}（可用: ${Object.keys(this.cfg.aliases ?? {}).join('、') || '无'}）`);
+        }
+        return entity;
+    }
+    baseUrl() {
+        const url = this.cfg.restUrl?.replace(/\/$/, '');
+        if (!url)
+            throw new Error('assistant.home.restUrl 未配置');
+        return url;
+    }
+    token() {
+        if (!this.cfg.restToken)
+            throw new Error('assistant.home.restToken 未配置');
+        return this.cfg.restToken;
+    }
+    async haRequest(path, init) {
+        const url = `${this.baseUrl()}${path}`;
+        const res = await this.fetchFn(url, {
+            ...init,
+            headers: {
+                Authorization: `Bearer ${this.token()}`,
+                'Content-Type': 'application/json',
+                ...(init?.headers ?? {}),
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`HA API ${res.status}: ${body.slice(0, 200) || res.statusText}`);
+        }
+        if (res.status === 204)
+            return null;
+        const text = await res.text();
+        if (!text)
+            return null;
+        return JSON.parse(text);
+    }
+    async getState(alias) {
+        const entityId = this.resolveAlias(alias);
+        const raw = await this.haRequest(`/api/states/${encodeURIComponent(entityId)}`);
+        return {
+            entityId,
+            state: String(raw.state ?? 'unknown'),
+            attributes: raw.attributes ?? {},
+            lastChanged: raw.last_changed,
+            lastUpdated: raw.last_updated,
+        };
+    }
+    resolveServiceForToggle(entityId, on) {
+        const domain = parseEntityDomain(entityId);
+        const mapped = DOMAIN_SERVICE_MAP[domain];
+        const service = on ? mapped?.on : mapped?.off;
+        if (!service) {
+            throw new Error(`不支持的控制类型: ${domain}（entity: ${entityId}）`);
+        }
+        return { domain, service };
+    }
+    async callService(alias, service, data) {
+        const entityId = this.resolveAlias(alias);
+        const domain = parseEntityDomain(entityId);
+        await this.haRequest(`/api/services/${domain}/${service}`, {
+            method: 'POST',
+            body: JSON.stringify({ entity_id: entityId, ...data }),
+        });
+        logger.debug(formatCompact({ op: 'ha_service', alias, entityId, domain, service }));
+    }
+    async turnOn(alias) {
+        const entityId = this.resolveAlias(alias);
+        const { domain, service } = this.resolveServiceForToggle(entityId, true);
+        await this.callService(alias, service);
+        return { alias, entityId, service: `${domain}.${service}` };
+    }
+    async turnOff(alias) {
+        const entityId = this.resolveAlias(alias);
+        const { domain, service } = this.resolveServiceForToggle(entityId, false);
+        await this.callService(alias, service);
+        return { alias, entityId, service: `${domain}.${service}` };
+    }
+}
+//# sourceMappingURL=home-assistant.js.map

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

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

package/lib/assistant/event-ingress.d.ts

@@ -0,0 +1,28 @@
+import type { AssistantEventsConfig } from './config.js';
+import type { AssistantEventRequest, AssistantEventResult } from './event-types.js';
+import type { AssistantJobEngine } from './job-engine.js';
+import type { AssistantJobStore } from './job-store.js';
+export interface AssistantEventIngressOptions {
+    store: AssistantJobStore;
+    engine: AssistantJobEngine;
+    eventsConfig?: AssistantEventsConfig;
+}
+export declare class AssistantEventIngress {
+    private store;
+    private engine;
+    private eventsCfg;
+    private rateBuckets;
+    constructor(options: AssistantEventIngressOptions);
+    isEnabled(): boolean;
+    checkRateLimit(source: string): boolean;
+    validateSource(source: string): string | null;
+    validateRequest(body: unknown): {
+        ok: true;
+        data: AssistantEventRequest;
+    } | {
+        ok: false;
+        error: string;
+    };
+    handle(body: unknown): Promise<AssistantEventResult>;
+}
+//# sourceMappingURL=event-ingress.d.ts.map

package/lib/assistant/event-ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-ingress.d.ts","sourceRoot":"","sources":["../../src/assistant/event-ingress.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAOD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,WAAW,CAAiC;gBAExC,OAAO,EAAE,4BAA4B;IAMjD,SAAS,IAAI,OAAO;IAIpB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAcvC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAS7C,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,qBAAqB,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAmClG,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2D3D"}

package/lib/assistant/event-ingress.js

@@ -0,0 +1,132 @@
+/**
+ * Assistant Event Ingress — 外部事件入队并触发 Job 执行（M2）
+ */
+import { Logger } from '@zhin.js/core';
+import { formatCompact } from '@zhin.js/logger';
+import { resolveAssistantEventsConfig } from './config.js';
+const logger = new Logger(null, 'assistant-event-ingress');
+export class AssistantEventIngress {
+    store;
+    engine;
+    eventsCfg;
+    rateBuckets = new Map();
+    constructor(options) {
+        this.store = options.store;
+        this.engine = options.engine;
+        this.eventsCfg = resolveAssistantEventsConfig(options.eventsConfig);
+    }
+    isEnabled() {
+        return this.eventsCfg.enabled;
+    }
+    checkRateLimit(source) {
+        const limit = this.eventsCfg.rateLimitPerMinute;
+        if (limit <= 0)
+            return true;
+        const now = Date.now();
+        const bucket = this.rateBuckets.get(source);
+        if (!bucket || now - bucket.windowStart >= 60_000) {
+            this.rateBuckets.set(source, { windowStart: now, count: 1 });
+            return true;
+        }
+        if (bucket.count >= limit)
+            return false;
+        bucket.count += 1;
+        return true;
+    }
+    validateSource(source) {
+        const allowed = this.eventsCfg.allowedSources;
+        if (!allowed || allowed.length === 0)
+            return null;
+        if (!allowed.includes(source)) {
+            return `source "${source}" not in allowedSources`;
+        }
+        return null;
+    }
+    validateRequest(body) {
+        if (!body || typeof body !== 'object') {
+            return { ok: false, error: 'body must be a JSON object' };
+        }
+        const raw = body;
+        const source = typeof raw.source === 'string' ? raw.source.trim() : '';
+        if (!source)
+            return { ok: false, error: 'source is required' };
+        const jobId = typeof raw.jobId === 'string' ? raw.jobId.trim() : undefined;
+        const action = raw.action;
+        const hasAction = action && typeof action === 'object' && action.kind === 'agent'
+            && typeof action.prompt === 'string' && action.prompt.trim().length > 0;
+        if (!jobId && !hasAction) {
+            return { ok: false, error: 'jobId or action.kind=agent with prompt is required' };
+        }
+        if (jobId && hasAction) {
+            return { ok: false, error: 'jobId and action are mutually exclusive' };
+        }
+        return {
+            ok: true,
+            data: {
+                eventId: typeof raw.eventId === 'string' ? raw.eventId.trim() : undefined,
+                source,
+                type: typeof raw.type === 'string' ? raw.type : undefined,
+                payload: raw.payload,
+                jobId,
+                action: hasAction ? action : undefined,
+                notify: raw.notify,
+                label: typeof raw.label === 'string' ? raw.label : undefined,
+            },
+        };
+    }
+    async handle(body) {
+        if (!this.isEnabled()) {
+            return { ok: false, status: 'error', error: 'assistant.events is disabled' };
+        }
+        const parsed = this.validateRequest(body);
+        if (!parsed.ok) {
+            return { ok: false, status: 'error', error: parsed.error };
+        }
+        const req = parsed.data;
+        const sourceErr = this.validateSource(req.source);
+        if (sourceErr) {
+            return { ok: false, status: 'error', error: sourceErr };
+        }
+        if (!this.checkRateLimit(req.source)) {
+            return { ok: false, status: 'error', error: 'rate limit exceeded' };
+        }
+        if (req.eventId) {
+            const existing = await this.store.findEventJobByEventId(req.eventId);
+            if (existing) {
+                logger.debug(formatCompact({ op: 'event_deduped', eventId: req.eventId, jobId: existing.id }));
+                return { ok: true, jobId: existing.id, status: 'deduped', deduped: true };
+            }
+        }
+        try {
+            if (req.jobId) {
+                const job = await this.store.getJob(req.jobId);
+                if (!job) {
+                    return { ok: false, status: 'error', error: `job not found: ${req.jobId}` };
+                }
+                void this.engine.runJobNow(req.jobId);
+                logger.info(formatCompact({ op: 'event_trigger', jobId: req.jobId, source: req.source }));
+                return { ok: true, jobId: req.jobId, status: 'queued' };
+            }
+            const jobId = `event_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+            await this.store.createEventJob({
+                id: jobId,
+                label: req.label || `event:${req.source}`,
+                action: req.action,
+                notify: req.notify,
+                source: req.source,
+                eventType: req.type,
+                eventId: req.eventId,
+                payload: req.payload,
+            });
+            void this.engine.runJobNow(jobId);
+            logger.info(formatCompact({ op: 'event_enqueue', jobId, source: req.source, type: req.type }));
+            return { ok: true, jobId, status: 'queued' };
+        }
+        catch (e) {
+            const error = e?.message || String(e);
+            logger.warn(formatCompact({ op: 'event_error', error }));
+            return { ok: false, status: 'error', error };
+        }
+    }
+}
+//# sourceMappingURL=event-ingress.js.map

package/lib/assistant/event-ingress.js.map

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

package/lib/assistant/event-types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Assistant Event Ingress — 请求/响应类型（M2）
+ */
+import type { JobAction, JobNotify } from './types.js';
+export interface AssistantEventRequest {
+    /** 幂等键；同 eventId 已存在则跳过重复执行 */
+    eventId?: string;
+    /** 事件来源，如 homeassistant / script */
+    source: string;
+    /** 事件类型，如 state_changed */
+    type?: string;
+    payload?: unknown;
+    /** 触发已注册的 Job（cron / event 等） */
+    jobId?: string;
+    /** 一次性内联 Agent 任务（与 jobId 二选一） */
+    action?: JobAction;
+    notify?: JobNotify;
+    label?: string;
+}
+export type AssistantEventStatus = 'queued' | 'running' | 'deduped' | 'error';
+export interface AssistantEventResult {
+    ok: boolean;
+    jobId?: string;
+    status: AssistantEventStatus;
+    deduped?: boolean;
+    error?: string;
+}
+//# sourceMappingURL=event-types.d.ts.map

package/lib/assistant/event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../src/assistant/event-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/lib/assistant/event-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-types.js.map

package/lib/assistant/event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.js","sourceRoot":"","sources":["../../src/assistant/event-types.ts"],"names":[],"mappings":""}

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