@bundy-lmw/hive-server 1.0.1 → 1.0.3

package/dist/gateway/ws/handlers/status-handler.js

@@ -0,0 +1,136 @@
+/**
+ * StatusHandler — 服务状态域
+ *
+ * status.get / server.restart / server.getProviders / provider.list / provider.getModels
+ */
+import { WsDomainHandler } from './base.js';
+import { createSuccessResponse, createErrorResponse } from '../types.js';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { HIVE_HOME } from '../../../config.js';
+export class StatusHandler extends WsDomainHandler {
+    startTime;
+    httpServer = null;
+    constructor(ctx, startTime) {
+        super(ctx);
+        this.startTime = startTime;
+    }
+    setHttpServer(httpServer) {
+        this.httpServer = httpServer;
+    }
+    register() {
+        return new Map([
+            ['status.get', this.handleStatusGet.bind(this)],
+            ['server.restart', this.handleServerRestart.bind(this)],
+            ['server.getProviders', this.handleGetProviders.bind(this)],
+            ['provider.list', this.handleProviderList.bind(this)],
+            ['provider.getModels', this.handleProviderGetModels.bind(this)],
+        ]);
+    }
+    handleStatusGet(_params, id) {
+        const server = this.ctx.getServer();
+        const provider = server?.agent?.currentProvider;
+        const providerReady = !!provider?.apiKey && provider.apiKey.length > 0;
+        const status = {
+            server: {
+                state: 'running',
+                port: this.getPort(),
+                uptime: Math.floor((Date.now() - this.startTime) / 1000),
+                version: this.getVersion(),
+            },
+            agent: {
+                initialized: !!server,
+                providerReady,
+                currentProvider: provider?.id ?? null,
+                activePlugins: [],
+            },
+            system: {
+                memory: {
+                    rss: process.memoryUsage().rss,
+                    heapUsed: process.memoryUsage().heapUsed,
+                    heapTotal: process.memoryUsage().heapTotal,
+                },
+                nodeVersion: process.version,
+                platform: `${process.platform} ${process.arch}`,
+            },
+        };
+        return createSuccessResponse(id, status);
+    }
+    handleServerRestart(_params, id) {
+        const response = createSuccessResponse(id, { success: true });
+        this.ctx.broadcastEvent('server.shutting_down', { reason: 'restart' });
+        setTimeout(() => {
+            process.exit(0);
+        }, 300);
+        return response;
+    }
+    handleGetProviders(_params, id) {
+        const server = this.ctx.getServer();
+        if (!server) {
+            return createErrorResponse(id, 'INTERNAL', 'Server not initialized');
+        }
+        const providers = server.agent.listProviders();
+        return createSuccessResponse(id, providers);
+    }
+    async handleProviderList(_params, id) {
+        const server = this.ctx.getServer();
+        if (!server) {
+            return createErrorResponse(id, 'INTERNAL', 'Server not initialized');
+        }
+        try {
+            const providers = await server.agent.listAllProviders();
+            return createSuccessResponse(id, providers.map(p => ({
+                id: p.id,
+                name: p.name,
+                logo: p.logo,
+                type: p.type,
+                defaultModel: p.models.length > 0 ? p.models[0].id : undefined,
+                modelCount: p.models.length,
+            })));
+        }
+        catch (error) {
+            return createErrorResponse(id, 'INTERNAL', error instanceof Error ? error.message : 'Failed to list providers');
+        }
+    }
+    async handleProviderGetModels(params, id) {
+        const { providerId } = params;
+        if (!providerId) {
+            return createErrorResponse(id, 'VALIDATION', 'providerId is required');
+        }
+        const server = this.ctx.getServer();
+        if (!server) {
+            return createErrorResponse(id, 'INTERNAL', 'Server not initialized');
+        }
+        try {
+            const models = await server.agent.listProviderModels(providerId);
+            return createSuccessResponse(id, models.map(m => ({
+                id: m.id,
+                name: m.name,
+                family: m.family,
+                contextWindow: m.contextWindow,
+                maxOutputTokens: m.maxOutputTokens,
+            })));
+        }
+        catch (error) {
+            return createErrorResponse(id, 'INTERNAL', error instanceof Error ? error.message : 'Failed to get models');
+        }
+    }
+    getPort() {
+        if (this.httpServer) {
+            const addr = this.httpServer.address();
+            if (typeof addr === 'object' && addr)
+                return addr.port;
+        }
+        return 4450;
+    }
+    getVersion() {
+        try {
+            const pkg = JSON.parse(readFileSync(resolve(HIVE_HOME, 'package.json'), 'utf-8'));
+            return pkg.version ?? '0.0.0';
+        }
+        catch {
+            return '0.0.0';
+        }
+    }
+}
+//# sourceMappingURL=status-handler.js.map

package/dist/gateway/ws/handlers/status-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-handler.js","sourceRoot":"","sources":["../../../../src/gateway/ws/handlers/status-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAE9C,MAAM,OAAO,aAAc,SAAQ,eAAe;IACxC,SAAS,CAAQ;IACjB,UAAU,GAAsB,IAAI,CAAA;IAE5C,YAAY,GAAmB,EAAE,SAAiB;QAChD,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAED,aAAa,CAAC,UAA6B;QACzC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,GAAG,CAAwB;YACpC,CAAC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,CAAC,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvD,CAAC,qBAAqB,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC,eAAe,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrD,CAAC,oBAAoB,EAAE,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAChE,CAAC,CAAA;IACJ,CAAC;IAEO,eAAe,CAAC,OAAgB,EAAE,EAAU;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAA;QACnC,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,eAAe,CAAA;QAC/C,MAAM,aAAa,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;QAEtE,MAAM,MAAM,GAAiB;YAC3B,MAAM,EAAE;gBACN,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;gBACpB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;gBACxD,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;aAC3B;YACD,KAAK,EAAE;gBACL,WAAW,EAAE,CAAC,CAAC,MAAM;gBACrB,aAAa;gBACb,eAAe,EAAE,QAAQ,EAAE,EAAE,IAAI,IAAI;gBACrC,aAAa,EAAE,EAAE;aAClB;YACD,MAAM,EAAE;gBACN,MAAM,EAAE;oBACN,GAAG,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG;oBAC9B,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ;oBACxC,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS;iBAC3C;gBACD,WAAW,EAAE,OAAO,CAAC,OAAO;gBAC5B,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE;aAChD;SACF,CAAA;QAED,OAAO,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAEO,mBAAmB,CAAC,OAAgB,EAAE,EAAU;QACtD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAE7D,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QAEtE,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,EAAE,GAAG,CAAC,CAAA;QAEP,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,kBAAkB,CAAC,OAAgB,EAAE,EAAU;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAA;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAA;QACtE,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAA;QAC9C,OAAO,qBAAqB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7C,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,OAAgB,EAAE,EAAU;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAA;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAA;QACtE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAA;YACvD,OAAO,qBAAqB,CAAC,EAAE,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACnD,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;gBAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;aAC5B,CAAC,CAAC,CAAC,CAAA;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAA;QACjH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,uBAAuB,CAAC,MAAe,EAAE,EAAU;QAC/D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAgC,CAAA;QACvD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,wBAAwB,CAAC,CAAA;QACxE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAA;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAA;QACtE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAA;YAChE,OAAO,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChD,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,eAAe,EAAE,CAAC,CAAC,eAAe;aACnC,CAAC,CAAC,CAAC,CAAA;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAA;QAC7G,CAAC;IACH,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAA;YACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAA;QACxD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;YACjF,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAA;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAA;QAChB,CAAC;IACH,CAAC;CACF"}

package/dist/gateway/ws/log-buffer.d.ts

@@ -18,6 +18,7 @@ export declare class LogBuffer {
         query?: string;
         limit?: number;
         offset?: number;
+        sinceId?: string;
     }): LogEntry[];
     /** 获取所有日志（用于调试） */
     getAll(): LogEntry[];

package/dist/gateway/ws/log-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-buffer.d.ts","sourceRoot":"","sources":["../../../src/gateway/ws/log-buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEzD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,OAAO,CAAI;gBAEP,OAAO,SAAS;IAI5B,WAAW;IACX,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ;IAiB/D,aAAa;IACb,KAAK,CAAC,OAAO,CAAC,EAAE;QACd,KAAK,CAAC,EAAE,QAAQ,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,QAAQ,EAAE;IAoBd,mBAAmB;IACnB,MAAM,IAAI,QAAQ,EAAE;IAIpB,YAAY;IACZ,KAAK,IAAI,IAAI;IAIb,aAAa;IACb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"log-buffer.d.ts","sourceRoot":"","sources":["../../../src/gateway/ws/log-buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEzD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,OAAO,CAAI;gBAEP,OAAO,SAAS;IAI5B,WAAW;IACX,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ;IAiB/D,aAAa;IACb,KAAK,CAAC,OAAO,CAAC,EAAE;QACd,KAAK,CAAC,EAAE,QAAQ,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,GAAG,QAAQ,EAAE;IA6Bd,mBAAmB;IACnB,MAAM,IAAI,QAAQ,EAAE;IAIpB,YAAY;IACZ,KAAK,IAAI,IAAI;IAIb,aAAa;IACb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/gateway/ws/log-buffer.js

@@ -28,6 +28,14 @@ export class LogBuffer {
     /** 查询历史日志 */
     query(options) {
         let result = this.buffer;
+        // sinceId: 返回该 ID 之后的所有日志（用于轮询增量拉取）
+        if (options?.sinceId) {
+            const idx = this.buffer.findIndex(e => e.id === options.sinceId);
+            if (idx >= 0) {
+                result = result.slice(idx + 1);
+            }
+            // sinceId 不存在时返回全部（可能是 counter 重置）
+        }
         if (options?.level) {
             result = result.filter(e => e.level === options.level);
         }

package/dist/gateway/ws/log-buffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-buffer.js","sourceRoot":"","sources":["../../../src/gateway/ws/log-buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,SAAS;IACZ,MAAM,GAAe,EAAE,CAAA;IACd,OAAO,CAAQ;IACxB,OAAO,GAAG,CAAC,CAAA;IAEnB,YAAY,OAAO,GAAG,MAAM;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,WAAW;IACX,GAAG,CAAC,KAAe,EAAE,MAAc,EAAE,OAAe;QAClD,MAAM,KAAK,GAAa;YACtB,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC;YAC1B,KAAK;YACL,MAAM;YACN,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAA;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,aAAa;IACb,KAAK,CAAC,OAML;QACC,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAExB,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QAC1D,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;YACrC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QAClE,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAA;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,GAAG,EAAE,IAAI,CAAC,CAAA;QAEnD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED,mBAAmB;IACnB,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;IAED,YAAY;IACZ,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;IAClB,CAAC;IAED,aAAa;IACb,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;IAC3B,CAAC;CACF"}
+{"version":3,"file":"log-buffer.js","sourceRoot":"","sources":["../../../src/gateway/ws/log-buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,SAAS;IACZ,MAAM,GAAe,EAAE,CAAA;IACd,OAAO,CAAQ;IACxB,OAAO,GAAG,CAAC,CAAA;IAEnB,YAAY,OAAO,GAAG,MAAM;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,WAAW;IACX,GAAG,CAAC,KAAe,EAAE,MAAc,EAAE,OAAe;QAClD,MAAM,KAAK,GAAa;YACtB,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC;YAC1B,KAAK;YACL,MAAM;YACN,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAA;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,aAAa;IACb,KAAK,CAAC,OAOL;QACC,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAExB,oCAAoC;QACpC,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;YAChE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBACb,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;YAChC,CAAC;YACD,mCAAmC;QACrC,CAAC;QAED,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QAC1D,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;YACrC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QAClE,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAA;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,GAAG,EAAE,IAAI,CAAC,CAAA;QAEnD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED,mBAAmB;IACnB,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;IAED,YAAY;IACZ,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;IAClB,CAAC;IAED,aAAa;IACb,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;IAC3B,CAAC;CACF"}

package/dist/gateway/ws/types.d.ts

@@ -43,7 +43,7 @@ export interface WsError {
     message: string;
 }
 export type WsResponse = WsSuccessResponse | WsErrorResponse;
-export type ErrorCode = 'NOT_FOUND' | 'VALIDATION' | 'INTERNAL' | 'TIMEOUT' | 'UNAUTHORIZED';
+export type ErrorCode = 'NOT_FOUND' | 'VALIDATION' | 'INTERNAL' | 'TIMEOUT' | 'UNAUTHORIZED' | 'AGENT_NOT_READY';
 export interface WsEvent extends WsMessage {
     type: 'event';
     /** 事件名 */

package/dist/gateway/ws/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/gateway/ws/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW;IACX,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAA;IAC7B,YAAY;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAMD,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,IAAI,EAAE,KAAK,CAAA;IACX,YAAY;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW;IACX,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAMD,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,KAAK,CAAA;IACX,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,IAAI,CAAA;IACb,WAAW;IACX,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,KAAK,CAAA;IACX,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,OAAO;IACtB,UAAU;IACV,IAAI,EAAE,SAAS,CAAA;IACf,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,eAAe,CAAA;AAE5D,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,YAAY,GACZ,UAAU,GACV,SAAS,GACT,cAAc,CAAA;AAMlB,MAAM,WAAW,OAAQ,SAAQ,SAAS;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,IAAI,EAAE,OAAO,CAAA;CACd;AAED,iBAAiB;AACjB,MAAM,MAAM,eAAe,GACvB,sBAAsB,GACtB,KAAK,GACL,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,CAAA;AAMpB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;AAM3D,aAAa;AACb,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAQzE;AAED,aAAa;AACb,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAQ3F;AAED,aAAa;AACb,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAQxG;AAED,aAAa;AACb,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAQjE;AAED,eAAe;AACf,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAW/D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/gateway/ws/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW;IACX,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAA;IAC7B,YAAY;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAMD,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,IAAI,EAAE,KAAK,CAAA;IACX,YAAY;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW;IACX,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAMD,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,KAAK,CAAA;IACX,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,IAAI,CAAA;IACb,WAAW;IACX,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,KAAK,CAAA;IACX,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,OAAO;IACtB,UAAU;IACV,IAAI,EAAE,SAAS,CAAA;IACf,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,eAAe,CAAA;AAE5D,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,YAAY,GACZ,UAAU,GACV,SAAS,GACT,cAAc,GACd,iBAAiB,CAAA;AAMrB,MAAM,WAAW,OAAQ,SAAQ,SAAS;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,UAAU;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,IAAI,EAAE,OAAO,CAAA;CACd;AAED,iBAAiB;AACjB,MAAM,MAAM,eAAe,GACvB,sBAAsB,GACtB,KAAK,GACL,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,CAAA;AAMpB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;AAM3D,aAAa;AACb,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAQzE;AAED,aAAa;AACb,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAQ3F;AAED,aAAa;AACb,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAQxG;AAED,aAAa;AACb,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAQjE;AAED,eAAe;AACf,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAW/D"}

package/dist/gateway/ws/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/gateway/ws/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0FH,+CAA+C;AAC/C,OAAO;AACP,+CAA+C;AAE/C,aAAa;AACb,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAgB;IAC5D,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,KAAK;QACX,MAAM;QACN,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,aAAa;AACb,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,MAAe;IACtE,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,IAAI;QACb,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,aAAa;AACb,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,IAAe,EAAE,OAAe;IACrF,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,aAAa;AACb,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAa;IACtD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,OAAO;QACb,KAAK;QACL,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,eAAe;AACf,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QAChD,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QACrC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAC5D,OAAO,GAAmB,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AAEH,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/gateway/ws/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2FH,+CAA+C;AAC/C,OAAO;AACP,+CAA+C;AAE/C,aAAa;AACb,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAgB;IAC5D,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,KAAK;QACX,MAAM;QACN,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,aAAa;AACb,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,MAAe;IACtE,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,IAAI;QACb,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,aAAa;AACb,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,IAAe,EAAE,OAAe;IACrF,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,aAAa;AACb,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAa;IACtD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,OAAO;QACb,KAAK;QACL,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAA;AACH,CAAC;AAED,eAAe;AACf,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QAChD,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QACrC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAC5D,OAAO,GAAmB,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AAEH,CAAC"}

package/dist/graceful-shutdown.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Graceful Shutdown
+ *
+ * Registers process signal handlers for clean shutdown in sidecar mode.
+ * Works with Tauri's watch_server() which detects process exit and auto-restarts.
+ */
+export interface GracefulShutdownOptions {
+    close: () => Promise<void>;
+    forceExitTimeout?: number;
+    memoryThresholdBytes?: number;
+}
+export declare function registerGracefulShutdown(options: GracefulShutdownOptions): () => void;
+//# sourceMappingURL=graceful-shutdown.d.ts.map

package/dist/graceful-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../src/graceful-shutdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAqErF"}

package/dist/graceful-shutdown.js

@@ -0,0 +1,65 @@
+/**
+ * Graceful Shutdown
+ *
+ * Registers process signal handlers for clean shutdown in sidecar mode.
+ * Works with Tauri's watch_server() which detects process exit and auto-restarts.
+ */
+export function registerGracefulShutdown(options) {
+    const { close, forceExitTimeout = 10_000, memoryThresholdBytes = 512 * 1024 * 1024, } = options;
+    let shuttingDown = false;
+    async function shutdown(reason, exitCode) {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log(`[shutdown] Triggered by: ${reason}`);
+        // Force-exit timer — ensures we don't hang forever
+        const timer = setTimeout(() => {
+            console.error(`[shutdown] Force exit after ${forceExitTimeout}ms timeout`);
+            process.exit(exitCode || 1);
+        }, forceExitTimeout);
+        timer.unref(); // Don't block process exit
+        try {
+            await close();
+            console.log('[shutdown] Graceful shutdown complete');
+        }
+        catch (err) {
+            console.error('[shutdown] Error during shutdown:', err);
+        }
+        process.exit(exitCode);
+    }
+    // Named function references for proper process.off() removal
+    function handleSigterm() { shutdown('SIGTERM', 0); }
+    function handleSigint() { shutdown('SIGINT', 0); }
+    function handleUncaughtException(err) {
+        console.error('[shutdown] Uncaught exception:', err);
+        shutdown('uncaughtException', 1);
+    }
+    function handleUnhandledRejection(reason) {
+        console.error('[shutdown] Unhandled rejection:', reason);
+        // Log only — don't crash the process
+    }
+    // Register handlers
+    process.on('SIGTERM', handleSigterm);
+    process.on('SIGINT', handleSigint);
+    process.on('uncaughtException', handleUncaughtException);
+    process.on('unhandledRejection', handleUnhandledRejection);
+    // Memory watchdog
+    const watcher = setInterval(() => {
+        const rss = process.memoryUsage().rss;
+        if (rss > memoryThresholdBytes) {
+            const mb = Math.round(rss / 1024 / 1024);
+            const threshold = Math.round(memoryThresholdBytes / 1024 / 1024);
+            console.warn(`[watchdog] Memory usage ${mb}MB exceeds threshold ${threshold}MB`);
+        }
+    }, 30_000);
+    watcher.unref();
+    // Return deregister function
+    return () => {
+        process.off('SIGTERM', handleSigterm);
+        process.off('SIGINT', handleSigint);
+        process.off('uncaughtException', handleUncaughtException);
+        process.off('unhandledRejection', handleUnhandledRejection);
+        clearInterval(watcher);
+    };
+}
+//# sourceMappingURL=graceful-shutdown.js.map

package/dist/graceful-shutdown.js.map

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

package/dist/logging/file-logger.d.ts

@@ -0,0 +1,43 @@
+/**
+ * FileLogger — 日志文件持久化
+ *
+ * 按天切割日志文件，支持文件大小限制切割和过期清理。
+ */
+import type { LogEntry } from '../gateway/ws/data-types.js';
+export interface FileLoggerOptions {
+    /** 日志目录路径（默认: ./logs） */
+    dir?: string;
+    /** 日志保留天数（默认: 7） */
+    retentionDays?: number;
+    /** 单文件最大字节数（默认: 50MB） */
+    maxFileSize?: number;
+}
+export declare class FileLogger {
+    private dir;
+    private retentionDays;
+    private maxFileSize;
+    private currentStream;
+    private currentDate;
+    private fileIndex;
+    private currentFilePath;
+    constructor(options?: FileLoggerOptions);
+    /** 写入一条日志 */
+    addLog(entry: LogEntry): void;
+    /** 关闭文件流（异步，确保数据刷新到磁盘） */
+    dispose(): Promise<void>;
+    private ensureDir;
+    /** 检查日期是否切换，必要时轮转 */
+    private ensureDate;
+    private getToday;
+    /** 格式化日志行 */
+    private formatLine;
+    /** 切换到新的日志文件 */
+    private rotateStream;
+    /** 生成文件路径 */
+    private getFilePath;
+    /** 检查当前文件大小，超过限制时切割 */
+    private checkFileSize;
+    /** 清理过期日志文件 */
+    private cleanupExpired;
+}
+//# sourceMappingURL=file-logger.d.ts.map

package/dist/logging/file-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-logger.d.ts","sourceRoot":"","sources":["../../src/logging/file-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAAoD;IACzE,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,eAAe,CAAK;gBAEhB,OAAO,GAAE,iBAAsB;IAU3C,aAAa;IACb,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAO7B,0BAA0B;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B,OAAO,CAAC,SAAS;IAMjB,qBAAqB;IACrB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,QAAQ;IAIhB,aAAa;IACb,OAAO,CAAC,UAAU;IAMlB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAcpB,aAAa;IACb,OAAO,CAAC,WAAW;IAOnB,uBAAuB;IACvB,OAAO,CAAC,aAAa;IAkBrB,eAAe;IACf,OAAO,CAAC,cAAc;CAuBvB"}

package/dist/logging/file-logger.js

@@ -0,0 +1,134 @@
+/**
+ * FileLogger — 日志文件持久化
+ *
+ * 按天切割日志文件，支持文件大小限制切割和过期清理。
+ */
+import { createWriteStream, existsSync, mkdirSync, readdirSync, statSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_DIR = 'logs';
+const DEFAULT_RETENTION_DAYS = 7;
+const MAX_FILE_SIZE = 50 * 1024 * 1024; // 50MB
+export class FileLogger {
+    dir;
+    retentionDays;
+    maxFileSize;
+    currentStream = null;
+    currentDate = '';
+    fileIndex = 0;
+    currentFilePath = '';
+    constructor(options = {}) {
+        this.dir = options.dir ?? DEFAULT_DIR;
+        this.retentionDays = options.retentionDays ?? DEFAULT_RETENTION_DAYS;
+        this.maxFileSize = options.maxFileSize ?? MAX_FILE_SIZE;
+        this.ensureDir();
+        this.cleanupExpired();
+        this.rotateStream();
+    }
+    /** 写入一条日志 */
+    addLog(entry) {
+        this.ensureDate();
+        this.checkFileSize();
+        const line = this.formatLine(entry);
+        this.currentStream?.write(line + '\n');
+    }
+    /** 关闭文件流（异步，确保数据刷新到磁盘） */
+    async dispose() {
+        if (this.currentStream) {
+            await new Promise((resolve) => {
+                this.currentStream.end(() => resolve());
+            });
+            this.currentStream = null;
+        }
+    }
+    // ============================================
+    // 私有方法
+    // ============================================
+    ensureDir() {
+        if (!existsSync(this.dir)) {
+            mkdirSync(this.dir, { recursive: true });
+        }
+    }
+    /** 检查日期是否切换，必要时轮转 */
+    ensureDate() {
+        const today = this.getToday();
+        if (today !== this.currentDate) {
+            this.rotateStream();
+        }
+    }
+    getToday() {
+        return new Date().toISOString().slice(0, 10);
+    }
+    /** 格式化日志行 */
+    formatLine(entry) {
+        const ts = new Date(entry.timestamp).toISOString().replace('T', ' ').slice(0, 23);
+        const level = entry.level.toUpperCase().padEnd(5);
+        return `${ts} [${level}] [${entry.source}] ${entry.message}`;
+    }
+    /** 切换到新的日志文件 */
+    rotateStream() {
+        if (this.currentStream) {
+            this.currentStream.end();
+        }
+        this.currentDate = this.getToday();
+        this.fileIndex = 0;
+        this.currentFilePath = this.getFilePath();
+        this.currentStream = createWriteStream(this.currentFilePath, { flags: 'a' });
+        this.currentStream.on('error', () => {
+            // 防止 uncaught exception（如文件被删除后异步写入报错）
+        });
+    }
+    /** 生成文件路径 */
+    getFilePath() {
+        if (this.fileIndex === 0) {
+            return join(this.dir, `hive-${this.currentDate}.log`);
+        }
+        return join(this.dir, `hive-${this.currentDate}.${this.fileIndex}.log`);
+    }
+    /** 检查当前文件大小，超过限制时切割 */
+    checkFileSize() {
+        if (!this.currentFilePath)
+            return;
+        try {
+            const stat = statSync(this.currentFilePath);
+            if (stat.size >= this.maxFileSize) {
+                this.fileIndex++;
+                this.currentStream?.end();
+                this.currentFilePath = this.getFilePath();
+                this.currentStream = createWriteStream(this.currentFilePath, { flags: 'a' });
+                this.currentStream.on('error', () => {
+                    // 防止 uncaught exception
+                });
+            }
+        }
+        catch {
+            // 文件可能尚未写入磁盘，忽略
+        }
+    }
+    /** 清理过期日志文件 */
+    cleanupExpired() {
+        if (!existsSync(this.dir))
+            return;
+        try {
+            const files = readdirSync(this.dir);
+            const cutoff = Date.now() - this.retentionDays * 24 * 60 * 60 * 1000;
+            for (const file of files) {
+                if (!file.endsWith('.log'))
+                    continue;
+                try {
+                    const filePath = join(this.dir, file);
+                    const stat = statSync(filePath);
+                    if (stat.mtimeMs < cutoff) {
+                        unlinkSync(filePath);
+                    }
+                }
+                catch {
+                    // 忽略单个文件错误
+                }
+            }
+        }
+        catch {
+            // 忽略目录读取错误
+        }
+    }
+}
+//# sourceMappingURL=file-logger.js.map

package/dist/logging/file-logger.js.map

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

package/dist/logging/hive-logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Hive Logger — pino 封装
+ *
+ * 统一日志入口：
+ * - console 输出（带颜色 + 时间戳）
+ * - logBuffer 内存缓冲（供 log.tail API 使用）
+ * - 文件持久化（日切割 + 大小切割 + 过期清理）
+ */
+import pino from 'pino';
+import type { LogEntry } from '../gateway/ws/data-types.js';
+import type { LogBuffer } from '../gateway/ws/log-buffer.js';
+export interface HiveLoggerOptions {
+    dir: string;
+    retentionDays?: number;
+    maxFileSize?: number;
+    logLevel?: string;
+}
+export interface HiveLogger {
+    logger: pino.Logger;
+    overrideConsole(): () => void;
+    dispose(): Promise<void>;
+    listLogDates(): string[];
+    getLogsByDate(date: string, limit?: number, offset?: number): LogEntry[];
+}
+export declare function createHiveLogger(logBuffer: LogBuffer, broadcastLog: (entry: LogEntry) => void, options: HiveLoggerOptions): HiveLogger;
+//# sourceMappingURL=hive-logger.d.ts.map

package/dist/logging/hive-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hive-logger.d.ts","sourceRoot":"","sources":["../../src/logging/hive-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,6BAA6B,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAM5D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;IACnB,eAAe,IAAI,MAAM,IAAI,CAAA;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,YAAY,IAAI,MAAM,EAAE,CAAA;IACxB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAA;CACzE;AA6BD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,EACvC,OAAO,EAAE,iBAAiB,GACzB,UAAU,CA4OZ"}