@yoooclaw/phone-notifications 1.12.3 → 1.12.4

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;;;;kBAqE7C,iBAAiB;;AAJjC,wBAiPE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;;;;kBAyE7C,iBAAiB;;AAJjC,wBAsRE"}

package/dist/light/sender.d.ts

@@ -1,14 +1,25 @@
 import type { LightSegment } from "../types.js";
-import type { RepeatArgument } from "./repeat.js";
+import { type RepeatArgument } from "./repeat.js";
 export interface SendLightResult {
     ok: boolean;
     bizUniqueId?: string;
     response?: unknown;
     status?: number;
     error?: string;
+    /** 本次实际走的下发链路：notification-intelligence 新入口或 message-service 旧链路 */
+    via?: "notification-intelligence" | "message-service";
 }
-export declare function sendLightEffect(apiKey: string, segments: LightSegment[], logger?: {
+export interface SendLightOptions {
+    /**
+     * 调用方幂等标识，透传给一次性亮灯入口的 bizUniqueId；
+     * 未传时由服务端生成。仅对 notification-intelligence 链路生效。
+     */
+    bizUniqueId?: string;
+}
+interface LightLogger {
     info: (msg: string) => void;
     warn: (msg: string) => void;
-}, repeatInput?: RepeatArgument, reason?: string, title?: string): Promise<SendLightResult>;
+}
+export declare function sendLightEffect(apiKey: string, segments: LightSegment[], logger?: LightLogger, repeatInput?: RepeatArgument, reason?: string, title?: string, options?: SendLightOptions): Promise<SendLightResult>;
+export {};
 //# sourceMappingURL=sender.d.ts.map

package/dist/light/sender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/light/sender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACrE,WAAW,CAAC,EAAE,cAAc,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CA4D1B"}
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/light/sender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,GAAG,CAAC,EAAE,2BAA2B,GAAG,iBAAiB,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,CAAC,EAAE,WAAW,EACpB,WAAW,CAAC,EAAE,cAAc,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAkC1B"}

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAKD,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA+ED,wBAAgB,mBAAmB,CAAC,OAAO,SAAiB,GAAG,OAAO,CAErE;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAM,GACrD,MAAM,CAgBR;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAO3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,gBAAgB,CAAuB;gBAG5B,QAAQ,EAAE,MAAM,EACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B;IAevC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMvB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMxB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,gBAAgB;CAgBzB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA8BpD;AAyND,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAgBpD"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAKD,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA+ED,wBAAgB,mBAAmB,CAAC,OAAO,SAAiB,GAAG,OAAO,CAErE;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAM,GACrD,MAAM,CAgBR;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAO3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,gBAAgB,CAAuB;gBAG5B,QAAQ,EAAE,MAAM,EACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B;IAevC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMvB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMxB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,gBAAgB;CAgBzB;AAqDD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwBpD;AAqMD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAgBpD"}

package/dist/notification/storage.d.ts

@@ -54,13 +54,16 @@ export declare class NotificationStorage {
     private contentKeyIndexDir;
     private idCache;
     private contentKeyCache;
+    private dayEntriesCache;
     private dateWriteChains;
     private resolveDisplayName;
     constructor(dir: string, logger: Logger, resolveDisplayName?: ResolveDisplayName);
     getStorageDir(): string;
     init(): Promise<void>;
     ingest(items: RawNotification[], ingestId?: string): Promise<NotificationIngestResult>;
-    private writeNotification;
+    private writeDayNotifications;
+    /** 当日条目内存缓存：一天内的高频写入只读盘一次 */
+    private getDayEntries;
     private buildStoredNotification;
     private formatDate;
     private getIdIndexPath;
@@ -71,8 +74,6 @@ export declare class NotificationStorage {
     private getContentKeyIndexPath;
     private getContentKeySet;
     private hasNotificationContentKey;
-    private recordNotificationId;
-    private recordNotificationContentKey;
     private buildNotificationContentKey;
     private contentKeyLabels;
     private readStoredNotifications;

package/dist/notification/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/notification/storage.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,UAAU,MAAM;IACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAQD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAmCD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACpC,MAAM,CAqBR;AAED,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1E,qBAAa,mBAAmB;IAW5B,OAAO,CAAC,MAAM;IAVhB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,kBAAkB,CAAiC;gBAGzD,GAAG,EAAE,MAAM,EACH,MAAM,EAAE,MAAM,EACtB,kBAAkB,CAAC,EAAE,kBAAkB;IAQzC,aAAa,IAAI,MAAM;IAIjB,IAAI;IAOJ,MAAM,CACV,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,wBAAwB,CAAC;YAqCtB,iBAAiB;IA0C/B,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,4BAA4B;IAgBpC,OAAO,CAAC,2BAA2B;IAgBnC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,uBAAuB;YAajB,iBAAiB;IAuBzB,KAAK;CAKZ"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/notification/storage.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,UAAU,MAAM;IACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAQD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAmCD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACpC,MAAM,CAqBR;AAED,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAK1E,qBAAa,mBAAmB;IAY5B,OAAO,CAAC,MAAM;IAXhB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,kBAAkB,CAAiC;gBAGzD,GAAG,EAAE,MAAM,EACH,MAAM,EAAE,MAAM,EACtB,kBAAkB,CAAC,EAAE,kBAAkB;IAQzC,aAAa,IAAI,MAAM;IAIjB,IAAI;IAOJ,MAAM,CACV,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,wBAAwB,CAAC;YA2DtB,qBAAqB;IAsFnC,6BAA6B;IAC7B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,2BAA2B;IAgBnC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,uBAAuB;YAoBjB,iBAAiB;IAuBzB,KAAK;CAMZ"}

package/dist/plugin/auto-update.d.ts

@@ -12,6 +12,8 @@ interface AutoUpdateDeps {
     cacheBroadcast: (broadcast: BroadcastFn | undefined) => void;
     tunnelService: ReturnType<typeof createTunnelService> | null;
 }
+type AutoUpdateAgentToolDeps = Pick<AutoUpdateDeps, "api" | "config" | "logger">;
+export declare function registerAutoUpdateAgentTool({ api, config, logger, }: AutoUpdateAgentToolDeps): void;
 export declare function registerAutoUpdateLifecycle(deps: AutoUpdateDeps): ReturnType<typeof registerAutoUpdate>;
 export {};
 //# sourceMappingURL=auto-update.d.ts.map

package/dist/plugin/auto-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../../src/plugin/auto-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,cAAc;IACtB,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACzC,cAAc,EAAE,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC;IAC7D,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,GACnB,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAkDvC"}
+{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../../src/plugin/auto-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,kBAAkB,EAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,cAAc;IACtB,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACzC,cAAc,EAAE,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC;IAC7D,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED,KAAK,uBAAuB,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAkBjF,wBAAgB,2BAA2B,CAAC,EAC1C,GAAG,EACH,MAAM,EACN,MAAM,GACP,EAAE,uBAAuB,GAAG,IAAI,CAIhC;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,GACnB,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAsCvC"}

package/dist/plugin/lifecycle.d.ts

@@ -1,26 +1,19 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { Logger } from "../logger.js";
-import { NotificationStorage } from "../notification/storage.js";
-import { RecordingStorage } from "../recording/index.js";
-import { ImageStorage } from "../image/index.js";
 import { type RelayTunnelService } from "../tunnel/service.js";
 import type { PluginConfig } from "../types.js";
-interface LightRuleContext {
-    workspaceDir?: string;
-    stateDir?: string;
-}
+import type { PluginRuntime } from "./runtime.js";
 interface StorageLifecycleDeps {
     api: OpenClawPluginApi;
     logger: Logger;
-    lightRuleCtx: LightRuleContext;
-    setStorage: (storage: NotificationStorage | null) => void;
-    setRecordingStorage: (storage: RecordingStorage | null) => void;
-    setImageStorage: (storage: ImageStorage | null) => void;
+    /** 存储句柄经 runtime.markStorageReady 发布，就绪事件由 runtime 分发。 */
+    runtime: PluginRuntime;
     /**
-     * 在 storage service 完成 start 之后触发，此时 lightRuleCtx 已被回填。
-     * 用于让 LightRuleRegistry 等下游组件在拿到真实 workspaceDir 后重新加载状态。
+     * 进程级共享存储注册表的键（用 register() 阶段的 openclawDir）。路由 handler
+     * 在本次 runtime 未就绪时回落到该键读取已启动的存储句柄，规避宿主多次
+     * register() 造成的 stale runtime → 503 问题。
      */
-    onStorageReady?: () => void;
+    sharedStorageKey?: string;
 }
 export declare function registerStorageLifecycle(deps: StorageLifecycleDeps): void;
 interface RelayTunnelDeps {

package/dist/plugin/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/plugin/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,UAAU,gBAAgB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,oBAAoB;IAC5B,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,EAAE,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1D,mBAAmB,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;IAChE,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,oBAAoB,GACzB,IAAI,CAuEN;AAuGD,UAAU,eAAe;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,GACpB,kBAAkB,GAAG,IAAI,CAyD3B"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/plugin/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAc3C,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,UAAU,oBAAoB;IAC5B,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,EAAE,aAAa,CAAC;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,oBAAoB,GACzB,IAAI,CAyEN;AAuGD,UAAU,eAAe;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,GACpB,kBAAkB,GAAG,IAAI,CAwE3B"}

package/dist/plugin/light-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-control.d.ts","sourceRoot":"","sources":["../../src/plugin/light-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA4L3C,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CA8EN"}
+{"version":3,"file":"light-control.d.ts","sourceRoot":"","sources":["../../src/plugin/light-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA4L3C,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CAoFN"}

package/dist/plugin/light-rules-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-rules-tools.d.ts","sourceRoot":"","sources":["../../src/plugin/light-rules-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA8LpF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACpC,IAAI,CAuKN"}
+{"version":3,"file":"light-rules-tools.d.ts","sourceRoot":"","sources":["../../src/plugin/light-rules-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAqMpF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACpC,IAAI,CA6KN"}

package/dist/plugin/notifications.d.ts

@@ -15,6 +15,7 @@ interface NotificationInterfaceDeps {
     notifyNotificationSummaryStatus?: (event: NotificationSummaryStatusEvent) => void;
     notifyNotificationSummaryResult?: (event: NotificationSummaryResultEvent) => void;
     tunnelService?: RelayTunnelService | null;
+    agentToolsOnly?: boolean;
 }
 export declare function registerNotificationInterfaces(deps: NotificationInterfaceDeps): void;
 export {};

package/dist/plugin/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/plugin/notifications.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAEL,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAQL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACpC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AAwDrB,UAAU,yBAAyB;IACjC,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAC7C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,CAAC;IACrE,qBAAqB,EAAE,sBAAsB,CAAC;IAC9C,+BAA+B,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAClF,+BAA+B,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAClF,aAAa,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C;AAmGD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,yBAAyB,GAC9B,IAAI,CAgeN"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/plugin/notifications.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAEL,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAQL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACpC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AAwDrB,UAAU,yBAAyB;IACjC,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAC7C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,CAAC;IACrE,qBAAqB,EAAE,sBAAsB,CAAC;IAC9C,+BAA+B,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAClF,+BAA+B,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAClF,aAAa,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAmGD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,yBAAyB,GAC9B,IAAI,CAyeN"}

package/dist/plugin/register-guard.d.ts

@@ -0,0 +1,16 @@
+import type { PluginRuntime } from "./runtime.js";
+/**
+ * 认领本进程内某 openclawDir 的装配。
+ * - 已装配：返回既有 runtime，`firstAssembly=false`，调用方应跳过后台 wiring，
+ *   但仍需向当前 api collector 注册 Agent 工具。
+ * - 未装配：调用 `create()` 生成 runtime 并登记，`firstAssembly=true`。
+ */
+export declare function claimWiredRuntime(key: string | undefined, create: () => PluginRuntime): {
+    runtime: PluginRuntime;
+    firstAssembly: boolean;
+};
+/** 关停/重启时清除守卫，使下一次 register 重新完整装配。 */
+export declare function releaseWiredRuntime(key: string | undefined): void;
+/** 仅测试用：清空进程级守卫，避免用例间的模块状态串扰。 */
+export declare function resetWiredRuntimesForTest(): void;
+//# sourceMappingURL=register-guard.d.ts.map

package/dist/plugin/register-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-guard.d.ts","sourceRoot":"","sources":["../../src/plugin/register-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA+BlD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,MAAM,aAAa,GAC1B;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CASpD;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEjE;AAED,iCAAiC;AACjC,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/plugin/runtime.d.ts

@@ -0,0 +1,64 @@
+import type { ImageStorage } from "../image/index.js";
+import type { Logger } from "../logger.js";
+import type { NotificationStorage } from "../notification/storage.js";
+import type { RecordingStorage } from "../recording/index.js";
+import type { RelayTunnelService } from "../tunnel/service.js";
+import type { BroadcastFn } from "../update/types.js";
+/**
+ * 插件运行时上下文：集中持有各子系统的共享句柄与就绪状态。
+ *
+ * register() 阶段所有子系统围绕这一个对象装配：
+ * - 存储句柄在 storage service start 完成后由 markStorageReady 一次性写入，
+ *   同时回填 lightRuleCtx 的真实 workspaceDir/stateDir；
+ * - broadcast 句柄由任意 gateway 请求携带时经 cacheBroadcast 写入；
+ * - 消费方用 getter 读取当前状态，用 onStorageReady / onBroadcastChanged
+ *   订阅就绪事件。订阅时若已就绪会立即补触发一次，因此订阅注册的先后
+ *   顺序不构成隐式时序约束。
+ */
+export declare class PluginRuntime {
+    private readonly logger;
+    /**
+     * 灯效规则目录上下文。LightRuleRegistry 持有同一引用；
+     * storage 就绪后由 markStorageReady 回填 workspaceDir/stateDir。
+     */
+    readonly lightRuleCtx: {
+        workspaceDir?: string;
+        stateDir?: string;
+    };
+    /** Relay 隧道服务；register() 阶段装配一次，未启用隧道时为 null。 */
+    tunnelService: RelayTunnelService | null;
+    private storage;
+    private recordingStorage;
+    private imageStorage;
+    private broadcastFn;
+    private storageReady;
+    private readonly storageReadyListeners;
+    private readonly broadcastChangedListeners;
+    constructor(logger: Logger, stateDir?: string);
+    getStorage(): NotificationStorage | null;
+    getRecordingStorage(): RecordingStorage | null;
+    getImageStorage(): ImageStorage | null;
+    getBroadcastFn(): BroadcastFn | null;
+    /**
+     * storage service start 完成后调用：一次性发布所有存储句柄并回填
+     * lightRuleCtx，然后触发 onStorageReady 订阅者。服务重启会再次触发。
+     */
+    markStorageReady(params: {
+        storage: NotificationStorage;
+        recordingStorage: RecordingStorage;
+        imageStorage: ImageStorage;
+        workspaceDir?: string;
+        stateDir: string;
+    }): void;
+    /** storage service stop 时调用：先下线句柄，再由调用方关闭各存储。 */
+    markStorageStopped(): void;
+    /** 订阅存储就绪事件；订阅时若已就绪立即补触发一次。 */
+    onStorageReady(listener: () => void): void;
+    /** gateway 请求携带 broadcast 时缓存；句柄发生变化时通知订阅者。 */
+    cacheBroadcast(broadcast: BroadcastFn | undefined): void;
+    /** 订阅 broadcast 句柄可用/变化事件；订阅时若已可用立即补触发一次。 */
+    onBroadcastChanged(listener: () => void): void;
+    private emitAll;
+    private emitOne;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/plugin/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/plugin/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IAmBtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAlBzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEpE,iDAAiD;IACjD,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IAEhD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyB;IAC/D,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAyB;gBAGhD,MAAM,EAAE,MAAM,EAC/B,QAAQ,CAAC,EAAE,MAAM;IAKnB,UAAU,IAAI,mBAAmB,GAAG,IAAI;IAIxC,mBAAmB,IAAI,gBAAgB,GAAG,IAAI;IAI9C,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,YAAY,EAAE,YAAY,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI;IAUR,iDAAiD;IACjD,kBAAkB,IAAI,IAAI;IAO1B,+BAA+B;IAC/B,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAO1C,+CAA+C;IAC/C,cAAc,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;IAWxD,6CAA6C;IAC7C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAO9C,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,OAAO;CAShB"}

package/dist/plugin/shared-storage.d.ts

@@ -0,0 +1,31 @@
+import type { ImageStorage } from "../image/index.js";
+import type { NotificationStorage } from "../notification/storage.js";
+import type { RecordingStorage } from "../recording/index.js";
+/**
+ * 进程级共享存储句柄注册表。
+ *
+ * 背景：宿主可能对同一个插件多次调用 `register()`（例如每次 agent 运行都会
+ * 重跑一遍以解析该 agent 的工具清单）。每次 register() 都会 new 一个新的
+ * PluginRuntime，而 `notification-storage` service 的 start() 只在首个 register()
+ * 上真正跑过一次。结果是后续 register() 注册（并覆盖）的 HTTP 路由 handler
+ * 绑定到一个 storage 恒为 null 的 runtime，导致 POST /notifications 恒返回
+ * 503 Service Not Ready，且重启也无法规避（首条 agent 消息一来就复现）。
+ *
+ * 这里把「已就绪的存储句柄」提升为模块级（进程级）单例：storage service
+ * start() 成功后发布，stop() 时清除。路由 handler 在本次 runtime 未就绪时
+ * 回落到这里读取，从而复用首个 register() 启动好的同一份存储实例。
+ */
+interface SharedStorageHandles {
+    storage: NotificationStorage;
+    recordingStorage: RecordingStorage;
+    imageStorage: ImageStorage;
+}
+/** storage service start() 成功后调用，发布进程级共享句柄。 */
+export declare function publishSharedStorage(key: string | undefined, handles: SharedStorageHandles): void;
+/** storage service stop() 时调用，清除共享句柄（避免关闭中的实例被读取）。 */
+export declare function clearSharedStorage(key: string | undefined): void;
+export declare function getSharedNotificationStorage(key: string | undefined): NotificationStorage | null;
+export declare function getSharedRecordingStorage(key: string | undefined): RecordingStorage | null;
+export declare function getSharedImageStorage(key: string | undefined): ImageStorage | null;
+export {};
+//# sourceMappingURL=shared-storage.d.ts.map

package/dist/plugin/shared-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-storage.d.ts","sourceRoot":"","sources":["../../src/plugin/shared-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,UAAU,oBAAoB;IAC5B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,YAAY,EAAE,YAAY,CAAC;CAC5B;AAUD,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEhE;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,mBAAmB,GAAG,IAAI,CAE5B;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,gBAAgB,GAAG,IAAI,CAEzB;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,YAAY,GAAG,IAAI,CAErB"}

package/dist/plugin/system.d.ts

@@ -0,0 +1,17 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { Logger } from "../logger.js";
+import type { GatewayMethodRegistrar } from "./shared.js";
+interface SystemInterfaceDeps {
+    api: OpenClawPluginApi;
+    logger: Logger;
+    registerGatewayMethod: GatewayMethodRegistrar;
+}
+/**
+ * 注册系统信息接口，供客户端查询 openclaw 当前运行的操作系统。
+ *
+ * - HTTP: `GET /system/os` 返回归一化的操作系统信息（Windows 会区分是否在 WSL 中）；
+ * - Gateway: `system.os` 返回同样的数据，供 WS 通道复用。
+ */
+export declare function registerSystemInterfaces(deps: SystemInterfaceDeps): void;
+export {};
+//# sourceMappingURL=system.d.ts.map

package/dist/plugin/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/plugin/system.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,UAAU,mBAAmB;IAC3B,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,sBAAsB,CAAC;CAC/C;AAMD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAwBxE"}

package/dist/recording/storage.d.ts

@@ -16,6 +16,7 @@
  */
 import type { RecordingMetadata, RecordingTransferStatus } from "../types.js";
 import type { Logger } from "../logger.js";
+import { type TranscriptDocument } from "./transcript-document.js";
 /** 持久化到 index.json 的单条录音记录 */
 export interface RecordingIndexEntry {
     /** 录音 ID，基于文件名（如 "2026-03-23_14-32"） */
@@ -124,7 +125,7 @@ export declare class RecordingStorage {
     /**
      * 读取结构化 transcript JSON。
      */
-    readTranscriptDocument(recordingId: string): import("./transcript-document.js").TranscriptDocument | undefined;
+    readTranscriptDocument(recordingId: string): TranscriptDocument | undefined;
     findById(id: string): RecordingIndexEntry | undefined;
     listAll(): RecordingIndexEntry[];
     listByStatus(status: RecordingTransferStatus): RecordingIndexEntry[];

package/dist/recording/storage.d.ts.map

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

package/dist/system/os-info.d.ts

@@ -0,0 +1,34 @@
+/** 归一化后的操作系统类别，供客户端直接判断运行环境。 */
+export type OsKind = "windows" | "macos" | "linux" | "wsl" | "unknown";
+export interface WslInfo {
+    /** WSL 版本：1 或 2；无法确定时为 null。 */
+    version: 1 | 2 | null;
+    /** 当前 WSL 发行版名称（来自 WSL_DISTRO_NAME），未知时为 null。 */
+    distro: string | null;
+}
+export interface OsInfo {
+    /** 归一化的操作系统类别；WSL 会单独标记为 "wsl"。 */
+    os: OsKind;
+    /** 是否运行在 WSL（Windows Subsystem for Linux）中。 */
+    isWsl: boolean;
+    /** Node `os.platform()` 原始值，例如 win32 / darwin / linux。 */
+    platform: NodeJS.Platform;
+    /** CPU 架构，例如 x64 / arm64。 */
+    arch: string;
+    /** 内核/系统版本字符串（os.release()）。 */
+    release: string;
+    /** 仅在 isWsl 为 true 时存在，描述 WSL 版本与发行版。 */
+    wsl?: WslInfo;
+}
+/** 可注入的探测输入，便于在测试中模拟不同运行环境。 */
+export interface OsInfoProbe {
+    platform?: NodeJS.Platform;
+    arch?: string;
+    release?: string;
+    env?: NodeJS.ProcessEnv;
+    /** 读取 /proc/version 的内容；读取失败时返回 null。 */
+    readProcVersion?: () => string | null;
+}
+/** 探测当前进程所在的操作系统信息，包含 WSL 区分。 */
+export declare function detectOsInfo(probe?: OsInfoProbe): OsInfo;
+//# sourceMappingURL=os-info.d.ts.map

package/dist/system/os-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-info.d.ts","sourceRoot":"","sources":["../../src/system/os-info.ts"],"names":[],"mappings":"AAGA,gCAAgC;AAChC,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,OAAO;IACtB,gCAAgC;IAChC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACtB,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,MAAM;IACrB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACvC;AA6CD,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,KAAK,GAAE,WAAgB,GAAG,MAAM,CAsB5D"}

package/dist/tunnel/connect-status-reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect-status-reporter.d.ts","sourceRoot":"","sources":["../../src/tunnel/connect-status-reporter.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,cAAc,CAAC;AAEhE,UAAU,MAAM;IACd,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAgExB"}
+{"version":3,"file":"connect-status-reporter.d.ts","sourceRoot":"","sources":["../../src/tunnel/connect-status-reporter.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,cAAc,CAAC;AAEhE,UAAU,MAAM;IACd,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,KAAK,IAAI,IAAI,CAAC;CACf;AAQD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAqHxB"}

package/dist/tunnel/frame-slimmer.d.ts

@@ -5,7 +5,18 @@
  * 已知的放大点（见 2026-05-12 日志，单次命令输出曾产生两帧各 ~226KB）：
  * - agent 事件 stream="command_output" 的 data.output 带全量命令输出；
  * - agent 事件 stream="item"（kind="command"）的 data.summary 重复同一份全文；
- * - chat.history 响应里 toolResult 消息携带历史工具输出。
+ * - chat.history 响应里的工具调用消息（toolResult/tool 角色、夹带的
+ *   toolUse/toolResult 内容块）由 filterToolMessages 整条剔除，不再下发到移动端。
+ * - 实时对话流里的工具调用与推理事件（event=agent、stream=command_output、
+ *   stream=tool、stream=thinking/thought，或 stream=item 且 kind=command/tool）
+ *   由 isSuppressedAgentEventFrame 判定后整帧丢弃，
+ *   与 chat.history 保持一致，移动端只收到 assistant/lifecycle 等对话事件。
+ * - event=chat 的 state=final 帧携带完整 assistant 消息，其中内嵌的
+ *   thinking/reasoning/工具内容块由 stripToolContentFromMessage 剥离。
+ * - event=session.message 是 Gateway 在 transcript 每落盘一条消息时向会话
+ *   订阅者广播的镜像（projectChatDisplayMessage 投影，保留 thinking/toolUse/
+ *   toolResult 块），event=session.tool 是同机制的工具事件镜像。两者都不走
+ *   event=agent/event=chat 路径，由 rewriteSessionEventFrame 统一剥离或整帧丢弃。
  * - sessions.list 响应里 lastMessagePreview/lastMessage 会夹带 memory 任务长文本。
  * - cron.runs 响应里 summary/result/output 会夹带后台任务长总结。
  * - config.get 响应会携带 raw config 与完整模型配置，移动端准备会话无需全量文本。
@@ -40,8 +51,78 @@ export declare const COMMAND_SUMMARY_CAP: number;
 export declare function truncateText(text: string, cap: number): string;
 /** 列表预览用单行截断，避免把换行省略标记直接展示在会话列表里。 */
 export declare function truncatePreviewText(text: string, cap: number): string;
+/** 仅过滤非用户产生的内部子任务回传；普通用户消息保持原样。 */
+export declare function filterInternalMessages(messages: any[]): {
+    messages: any[];
+    removed: number;
+    changed: boolean;
+};
+/**
+ * 从 chat.history 的消息数组里剔除工具调用与推理块，无论帧大小都执行：
+ * - role 为 toolResult/tool 的消息整条删除；
+ * - 其余消息里夹带的工具内容块（toolUse/toolResult 等）与推理块
+ *   （thinking/redacted_thinking）清除，顶层推理字段（message.thinking 等）
+ *   删除，清理后若该消息已无可展示内容则一并删除。
+ */
+export declare function filterToolMessages(messages: any[]): {
+    messages: any[];
+    removed: number;
+    changed: boolean;
+};
+/**
+ * 清除单条消息里的工具/推理内容：content 数组里的工具与推理块，以及
+ * 顶层推理字段（message.thinking 等，见 MESSAGE_REASONING_FIELDS）。
+ * 用于 event=chat 的 state=final 帧与 event=session.message 镜像帧：
+ * 其 payload.message 由 Gateway 的 projectChatDisplayMessage 生成，
+ * thinking/reasoning 内容会原样保留（仅截断文本），若不在这里剥离，
+ * App 端会把直播收到的消息渲染出折叠的「思考完成」块。
+ * 剥离后即使 content 为空也保留消息本身——final 帧承担运行结束语义，
+ * 不能整帧丢弃；是否丢弃由调用方决定。
+ */
+export declare function stripToolContentFromMessage(message: any): {
+    message: any;
+    changed: boolean;
+};
+/** rewriteSessionEventFrame 的处理结论：透传、整帧丢弃或改写后下发。 */
+export type SessionEventRewrite = {
+    action: "keep";
+} | {
+    action: "drop";
+    reason: string;
+} | {
+    action: "rewrite";
+    frame: any;
+};
+/**
+ * 处理 Gateway 面向会话订阅者的 session.* 镜像事件：
+ * - session.tool：工具执行进度镜像（与 event=agent stream=tool 同源），整帧丢弃；
+ * - session.message：transcript 消息镜像，内嵌 projectChatDisplayMessage 投影的
+ *   完整消息。与 chat.history 的 filterToolMessages 同口径处理——
+ *   toolResult/tool 角色消息整帧丢弃，其余消息剥离 thinking/reasoning/工具块，
+ *   剥离后无可展示内容的也整帧丢弃（该帧只承担 transcript 镜像语义，
+ *   会话列表刷新另有 sessions.changed 事件，丢弃不影响状态同步）。
+ */
+export declare function rewriteSessionEventFrame(frame: any): SessionEventRewrite;
+/**
+ * 判断一个帧是否为不应下发移动端的实时 agent 事件：
+ * - stream=command_output：工具/命令输出全文；
+ * - stream=tool：工具执行进度事件（start/update/result，含 args/result）；
+ * - stream=thinking / thought：模型推理过程增量（App 渲染成 Thinking 块）；
+ * - stream=item 且 data.kind 为 command/tool：工具调用条目。
+ *
+ * 用于在实时对话流里整帧剔除，使移动端与 chat.history（filterToolMessages）
+ * 一样只保留对话内容，assistant/lifecycle 等对话事件照常下发。
+ */
+export declare function isSuppressedAgentEventFrame(frame: any): boolean;
 /** 就地瘦身已解析的帧，返回是否有修改。 */
 export declare function slimRelayFrame(frame: any): boolean;
+/**
+ * 与 slimRelayFrameText 等价，但复用调用方已解析的帧对象，
+ * 避免热路径上对大帧重复 JSON.parse。会就地修改 frame。
+ */
+export declare function slimParsedRelayFrame(text: string, frame: any, logger?: {
+    info: (msg: string) => void;
+}): string;
 /**
  * 对即将回传 Relay 的帧文本瘦身。小帧与无法解析的帧原样返回。
  */

package/dist/tunnel/frame-slimmer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frame-slimmer.d.ts","sourceRoot":"","sources":["../../src/tunnel/frame-slimmer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAE5C,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,yDAAyD;AACzD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,uCAAuC;AACvC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,6BAA6B;AAC7B,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAW,CAAC;AAwD5C,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIrE;AA4UD,yBAAyB;AACzB,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAYlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACvC,MAAM,CAiBR"}
+{"version":3,"file":"frame-slimmer.d.ts","sourceRoot":"","sources":["../../src/tunnel/frame-slimmer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAE5C,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,yDAAyD;AACzD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,uCAAuC;AACvC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,6BAA6B;AAC7B,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAW,CAAC;AAwD5C,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIrE;AA8VD,mCAAmC;AACnC,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG;IACvD,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CASA;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG;IACnD,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAkBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,GAAG,GAAG;IACzD,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB,CAYA;AAED,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAAC;AAEtC;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,mBAAmB,CAgCxE;AA8ID;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAU/D;AAED,yBAAyB;AACzB,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAYlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACvC,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACvC,MAAM,CAWR"}

package/dist/tunnel/gateway-target.d.ts

@@ -0,0 +1,17 @@
+export interface LocalGatewayBaseUrlResolution {
+    baseUrl: string;
+    source: string;
+    explicit: boolean;
+    tlsEnabled: boolean;
+    warning?: string;
+}
+export interface LocalGatewayTcpTarget {
+    host: string;
+    port: number;
+}
+export declare function resolveLocalGatewayBaseUrl(params?: {
+    config?: unknown;
+    env?: NodeJS.ProcessEnv;
+}): LocalGatewayBaseUrlResolution;
+export declare function resolveLocalGatewayTcpTarget(baseUrl: string): LocalGatewayTcpTarget | null;
+//# sourceMappingURL=gateway-target.d.ts.map

package/dist/tunnel/gateway-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-target.d.ts","sourceRoot":"","sources":["../../src/tunnel/gateway-target.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA0ED,wBAAgB,0BAA0B,CAAC,MAAM,GAAE;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACpB,GAAG,6BAA6B,CA+BrC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,qBAAqB,GAAG,IAAI,CAmB9B"}

package/dist/tunnel/http-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-proxy.d.ts","sourceRoot":"","sources":["../../src/tunnel/http-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KAC9B,CAAC;CACH;AAQD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAaD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CA4C3D;AAID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAmEf"}
+{"version":3,"file":"http-proxy.d.ts","sourceRoot":"","sources":["../../src/tunnel/http-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KAC9B,CAAC;CACH;AA6DD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAaD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CA4C3D;AAID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/tunnel/proxy.d.ts

@@ -11,6 +11,9 @@ interface ProxyOptions {
     gatewayToken?: string;
     /** Gateway 鉴权密码，代理请求到本地 gateway 时使用 */
     gatewayPassword?: string;
+    /** 本地 Gateway RPC 握手完成/断开时通知上层。 */
+    onGatewayConnected?: () => void;
+    onGatewayDisconnected?: (reason: string) => void;
     client: RelayClient;
     logger: {
         info: (msg: string) => void;
@@ -43,6 +46,13 @@ export declare class TunnelProxy {
     private recentAbortedChatRuns;
     /** Relay 断开或服务停止时要中断的 HTTP 代理请求。 */
     private httpAbortControllers;
+    private gatewayWsConnectLogLastAt;
+    private gatewayWsConnectLogSuppressed;
+    /** startGatewayConnection 启用后，即使没有待处理 RPC 也维持本地连接。 */
+    private maintainGatewayWs;
+    private gatewayWsReconnectTimer;
+    private gatewayWsReconnectAttempt;
+    private gatewayConnectionState;
     /** 设备身份，用于 Gateway connect 握手 */
     private deviceIdentity;
     private readonly stateDir;
@@ -51,8 +61,12 @@ export declare class TunnelProxy {
     constructor(opts: ProxyOptions);
     /** 处理从 Relay 收到的入站帧 */
     handleFrame(frame: InboundFrame): Promise<void>;
-    /** 清理所有代理的 WebSocket 连接 */
+    /** Relay 断开时只清理依赖 Relay 的请求，保留本地 Gateway RPC 连接。 */
+    cleanupRelayState(): void;
+    /** 插件停止时清理所有代理状态并关闭本地 Gateway RPC 连接。 */
     cleanup(): void;
+    /** 主动建立并持续维护到本地 Gateway 的 RPC WebSocket。 */
+    startGatewayConnection(): void;
     private handleRequestFrame;
     private pushGatewayPending;
     /** 将未知帧原样转发到 Gateway WS */
@@ -81,6 +95,11 @@ export declare class TunnelProxy {
     private maybeRewriteGatewayFrame;
     /** 确保到本地 Gateway 的 RPC WebSocket 已连接且握手完成 */
     private ensureGatewayWs;
+    private setGatewayConnectionState;
+    private clearGatewayReconnectTimer;
+    private scheduleGatewayReconnect;
+    private logGatewayWsConnecting;
+    private gatewayTroubleshootingHint;
     private handleConnectChallenge;
 }
 export {};