@zhin.js/agent 1.0.3 → 1.0.4

package/lib/plugin-ai-hook-bus.js

@@ -1,13 +1,32 @@
 import { getHostRootPlugin } from '@zhin.js/core';
 import { createAIHookBusPayload } from './ai-event-bus.js';
+import { aiHookRuntimeBus } from './ai-hook-runtime-bus.js';
+import { runModuleAIHookHandlers } from './ai-hook-handlers.js';
 function resolveRootPlugin() {
     return getHostRootPlugin();
 }
+/**
+ * Emit AI hook / session lifecycle events onto:
+ * 1. Module Runtime bus (`aiHookRuntimeBus`) — Plugin Runtime without host Plugin
+ * 2. Legacy `registerAIHook` handlers
+ * 3. Root Plugin event bus when a classic host Plugin exists (`onAIHook` / `plugin.on`)
+ *
+ * HookRegistry and AgentStreamBus remain internal orchestration.
+ */
 export function emitAIHookBusEvent(event, source, agentId) {
+    const payload = createAIHookBusPayload(event, source, agentId);
+    aiHookRuntimeBus.emit('ai.hook', payload);
+    if (event.type === 'session' && event.action === 'new') {
+        aiHookRuntimeBus.emit('ai.session.new', payload);
+    }
+    if (event.type === 'session' && event.action === 'compact') {
+        aiHookRuntimeBus.emit('ai.session.compact', payload);
+    }
+    // Fire-and-forget: registerAIHook handlers must not block the turn pipeline.
+    void runModuleAIHookHandlers(event);
     const root = resolveRootPlugin();
     if (!root || typeof root.dispatch !== 'function')
         return;
-    const payload = createAIHookBusPayload(event, source, agentId);
     root.dispatch('ai.hook', payload);
     if (event.type === 'session' && event.action === 'new') {
         root.dispatch('ai.session.new', payload);

package/lib/plugin-ai-hook-bus.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-ai-hook-bus.js","sourceRoot":"","sources":["../src/plugin-ai-hook-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAe,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,SAAS,iBAAiB;IACxB,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAkB,EAClB,MAAuC,EACvC,OAAgB;IAEhB,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU;QAAE,OAAO;IACzD,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}
+{"version":3,"file":"plugin-ai-hook-bus.js","sourceRoot":"","sources":["../src/plugin-ai-hook-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAe,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,SAAS,iBAAiB;IACxB,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAkB,EAClB,MAAuC,EACvC,OAAgB;IAEhB,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACvD,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3D,gBAAgB,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,6EAA6E;IAC7E,KAAK,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU;QAAE,OAAO;IACzD,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/lib/plugin-runtime/agent-host-port.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stable Host boundary for protocols that expose Agent capabilities externally.
+ * Consumers must not reach into CLI installer state or the legacy Plugin graph.
+ */
+export interface AgentHostPort {
+    /** Concrete Agent classes stay private to the composing package. */
+    readonly service: unknown;
+    readonly agent: unknown;
+}
+export declare const agentHostToken: import("@zhin.js/plugin-runtime").Token<AgentHostPort>;
+//# sourceMappingURL=agent-host-port.d.ts.map

package/lib/plugin-runtime/agent-host-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host-port.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/agent-host-port.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,cAAc,wDAG1B,CAAC"}

package/lib/plugin-runtime/agent-host-port.js

@@ -0,0 +1,3 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+export const agentHostToken = createToken('zhin.host.agent', 'Active AIService and ZhinAgent owned by the Root generation');
+//# sourceMappingURL=agent-host-port.js.map

package/lib/plugin-runtime/agent-host-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host-port.js","sourceRoot":"","sources":["../../src/plugin-runtime/agent-host-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAYtD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CACvC,iBAAiB,EACjB,6DAA6D,CAC9D,CAAC"}

package/lib/plugin-runtime/agent-runtime.d.ts

@@ -0,0 +1,11 @@
+import type { PluginId, SnapshotStore } from '@zhin.js/plugin-runtime';
+import type { Message } from '@zhin.js/core';
+import { type AgentCapabilities } from './capability-ingress.js';
+export declare class AgentRuntime {
+    #private;
+    attach(snapshots: SnapshotStore): void;
+    runTurn<TResult>(owner: PluginId, operation: (capabilities: AgentCapabilities) => TResult | Promise<TResult>, options?: {
+        readonly message?: Message;
+    }): Promise<TResult>;
+}
+//# sourceMappingURL=agent-runtime.d.ts.map

package/lib/plugin-runtime/agent-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,YAAY;;IAIvB,MAAM,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAOhC,OAAO,CAAC,OAAO,EACnB,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,CAAC,YAAY,EAAE,iBAAiB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC1E,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACvC,OAAO,CAAC,OAAO,CAAC;CAgBpB"}

package/lib/plugin-runtime/agent-runtime.js

@@ -0,0 +1,25 @@
+import { CapabilityIngress, } from './capability-ingress.js';
+export class AgentRuntime {
+    #ingress = new CapabilityIngress();
+    #snapshots;
+    attach(snapshots) {
+        if (this.#snapshots && this.#snapshots !== snapshots) {
+            throw new Error('AgentRuntime is already attached to another Root');
+        }
+        this.#snapshots = snapshots;
+    }
+    async runTurn(owner, operation, options) {
+        if (!this.#snapshots)
+            throw new Error('AgentRuntime is not attached to a Root');
+        const lease = this.#snapshots.acquire();
+        let active = true;
+        try {
+            return await operation(this.#ingress.read(lease.value, owner, () => active, options?.message));
+        }
+        finally {
+            active = false;
+            lease.release();
+        }
+    }
+}
+//# sourceMappingURL=agent-runtime.js.map

package/lib/plugin-runtime/agent-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.js","sourceRoot":"","sources":["../../src/plugin-runtime/agent-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,OAAO,YAAY;IACd,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC5C,UAAU,CAAiB;IAE3B,MAAM,CAAC,SAAwB;QAC7B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAe,EACf,SAA0E,EAC1E,OAAwC;QAExC,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxC,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CACvC,KAAK,CAAC,KAAK,EACX,KAAK,EACL,GAAG,EAAE,CAAC,MAAM,EACZ,OAAO,EAAE,OAAO,CACjB,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,GAAG,KAAK,CAAC;YACf,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}

package/lib/plugin-runtime/capability-ingress.d.ts

@@ -0,0 +1,25 @@
+import type { PluginId, RuntimeSnapshot } from '@zhin.js/plugin-runtime';
+import { type Message } from '@zhin.js/core';
+import { type AgentDescriptor } from '@zhin.js/agent-feature';
+import { type McpDescriptor, type McpToolDescriptor } from '@zhin.js/mcp-feature';
+import { type SkillDescriptor } from '@zhin.js/skill';
+import { type ToolDescriptor } from '@zhin.js/tool';
+export interface ToolCapability extends ToolDescriptor {
+    execute<TInput = unknown, TResult = unknown>(input: TInput): Promise<TResult>;
+}
+export interface McpCapability extends McpDescriptor {
+    listTools(): Promise<readonly McpToolDescriptor[]>;
+    callTool<TResult = unknown>(tool: string, input: unknown): Promise<TResult>;
+}
+export interface AgentCapabilities {
+    readonly generation: number;
+    readonly owner: PluginId;
+    readonly tools: readonly ToolCapability[];
+    readonly skills: readonly SkillDescriptor[];
+    readonly agents: readonly AgentDescriptor[];
+    readonly mcp: readonly McpCapability[];
+}
+export declare class CapabilityIngress {
+    read(snapshot: RuntimeSnapshot, owner: PluginId, isActive?: () => boolean, message?: Message): AgentCapabilities;
+}
+//# sourceMappingURL=capability-ingress.d.ts.map

package/lib/plugin-runtime/capability-ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-ingress.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/capability-ingress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAiB,KAAK,OAAO,EAAyB,MAAM,eAAe,CAAC;AACnF,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,OAAO,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,SAAS,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,SAAS,aAAa,EAAE,CAAC;CACxC;AAED,qBAAa,iBAAiB;IAC5B,IAAI,CACF,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,MAAM,OAAoB,EACpC,OAAO,CAAC,EAAE,OAAO,GAChB,iBAAiB;CAiBrB"}

package/lib/plugin-runtime/capability-ingress.js

@@ -0,0 +1,77 @@
+import { canAccessTool } from '@zhin.js/core';
+import { AgentIndex, agentFeatureId, } from '@zhin.js/agent-feature';
+import { McpIndex, mcpFeatureId, } from '@zhin.js/mcp-feature';
+import { SkillIndex, skillFeatureId, } from '@zhin.js/skill';
+import { ToolIndex, toolFeatureId, } from '@zhin.js/tool';
+export class CapabilityIngress {
+    read(snapshot, owner, isActive = () => true, message) {
+        if (!snapshot.tree.has(owner))
+            throw new Error(`Unknown Agent capability owner: ${owner}`);
+        const tools = projection(snapshot, toolFeatureId, ToolIndex);
+        const mcp = projection(snapshot, mcpFeatureId, McpIndex);
+        return Object.freeze({
+            generation: snapshot.generation,
+            owner,
+            tools: bindTools(tools, owner, isActive, message),
+            skills: Object.freeze([
+                ...(projection(snapshot, skillFeatureId, SkillIndex)?.visible(owner) ?? []),
+            ]),
+            agents: Object.freeze([
+                ...(projection(snapshot, agentFeatureId, AgentIndex)?.visible(owner) ?? []),
+            ]),
+            mcp: bindMcp(mcp, owner, isActive),
+        });
+    }
+}
+function bindTools(index, owner, isActive, message) {
+    if (!index)
+        return Object.freeze([]);
+    return Object.freeze(index.visible(owner)
+        .filter((descriptor) => !descriptor.hidden && canAccessDescriptor(descriptor, message))
+        .map((descriptor) => Object.freeze({
+        ...descriptor,
+        execute: (input) => {
+            assertActive(isActive);
+            return index.execute(owner, descriptor.name, input);
+        },
+    })));
+}
+function canAccessDescriptor(descriptor, message) {
+    return canAccessTool({
+        name: descriptor.name,
+        description: descriptor.description,
+        parameters: { type: 'object', properties: {} },
+        execute: () => undefined,
+        platforms: descriptor.platforms ? [...descriptor.platforms] : undefined,
+        scopes: descriptor.scopes ? [...descriptor.scopes] : undefined,
+        permissions: descriptor.permissions ? [...descriptor.permissions] : undefined,
+    }, message);
+}
+function bindMcp(index, owner, isActive) {
+    if (!index)
+        return Object.freeze([]);
+    return Object.freeze(index.visible(owner).map((descriptor) => Object.freeze({
+        ...descriptor,
+        listTools: () => {
+            assertActive(isActive);
+            return index.listTools(owner, descriptor.name);
+        },
+        callTool: (tool, input) => {
+            assertActive(isActive);
+            return index.callTool(owner, descriptor.name, tool, input);
+        },
+    })));
+}
+function assertActive(isActive) {
+    if (!isActive())
+        throw new Error('Agent capability turn scope has ended');
+}
+function projection(snapshot, id, constructor) {
+    const value = snapshot.projections.get(id);
+    return value
+        && typeof value === 'object'
+        && Object.prototype.isPrototypeOf.call(constructor.prototype, value)
+        ? value
+        : undefined;
+}
+//# sourceMappingURL=capability-ingress.js.map

package/lib/plugin-runtime/capability-ingress.js.map

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

package/lib/plugin-runtime/index.d.ts

@@ -0,0 +1,4 @@
+export * from './agent-runtime.js';
+export * from './agent-host-port.js';
+export * from './capability-ingress.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugin-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/lib/plugin-runtime/index.js

@@ -0,0 +1,4 @@
+export * from './agent-runtime.js';
+export * from './agent-host-port.js';
+export * from './capability-ingress.js';
+//# sourceMappingURL=index.js.map

package/lib/plugin-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/lib/schedule-manager.d.ts

@@ -22,6 +22,8 @@ export interface ScheduleManager {
     previewTask?: (options: TaskExecutionOptions) => Promise<TaskExecutionResult>;
 }
 export declare function setScheduleManager(m: ScheduleManager | null): void;
+/** Generation-safe registration; disposing an older owner cannot clear a newer manager. */
+export declare function registerScheduleManager(manager: ScheduleManager): () => void;
 export declare function getScheduleManager(): ScheduleManager | null;
 export { generateScheduleJobId };
 export declare function createScheduleTools(): ZhinTool[];

package/lib/schedule-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedule-manager.d.ts","sourceRoot":"","sources":["../src/schedule-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAU,MAAM,eAAe,CAAC;AAEjD,OAAO,EAEL,qBAAqB,EAEtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIpF,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE;QACf,SAAS,IAAI,KAAK,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,OAAO,CAAC;YACjB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;KACJ,CAAC;IACF,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,sBAAsB;IACtB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC/E;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAElE;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,wBAAgB,mBAAmB,IAAI,QAAQ,EAAE,CA4IhD"}
+{"version":3,"file":"schedule-manager.d.ts","sourceRoot":"","sources":["../src/schedule-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAa,MAAM,eAAe,CAAC;AAEpD,OAAO,EAEL,qBAAqB,EAEtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIpF,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE;QACf,SAAS,IAAI,KAAK,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,OAAO,CAAC;YACjB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;KACJ,CAAC;IACF,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,sBAAsB;IACtB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC/E;AAKD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAElE;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI,CAM5E;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAG3D;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,wBAAgB,mBAAmB,IAAI,QAAQ,EAAE,CA4IhD"}

package/lib/schedule-manager.js

@@ -1,17 +1,28 @@
 /**
  * 持久化调度任务 + AI 工具
  */
-import { ZhinTool, Logger } from '@zhin.js/core';
+import { ZhinTool, getLogger } from '@zhin.js/core';
 import { captureScheduleJobCreator } from './assistant/job-creator.js';
 import { addScheduleJob, generateScheduleJobId, parseScheduleAddFromToolArgs, } from './assistant/schedule-job-service.js';
-const logger = new Logger(null, 'schedule-manager');
+const logger = getLogger('schedule-manager');
 export const SCHEDULE_JOBS_FILENAME = 'schedule-jobs.json';
 let scheduleManager = null;
+const scheduleManagerRegistrations = [];
 export function setScheduleManager(m) {
     scheduleManager = m;
 }
+/** Generation-safe registration; disposing an older owner cannot clear a newer manager. */
+export function registerScheduleManager(manager) {
+    scheduleManagerRegistrations.push(manager);
+    return () => {
+        const index = scheduleManagerRegistrations.lastIndexOf(manager);
+        if (index >= 0)
+            scheduleManagerRegistrations.splice(index, 1);
+    };
+}
 export function getScheduleManager() {
-    return scheduleManager;
+    return scheduleManagerRegistrations[scheduleManagerRegistrations.length - 1]
+        ?? scheduleManager;
 }
 export { generateScheduleJobId };
 export function createScheduleTools() {

package/lib/schedule-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"schedule-manager.js","sourceRoot":"","sources":["../src/schedule-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schedule-manager.js","sourceRoot":"","sources":["../src/schedule-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AAI7C,MAAM,MAAM,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAE7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAkB3D,IAAI,eAAe,GAA2B,IAAI,CAAC;AACnD,MAAM,4BAA4B,GAAsB,EAAE,CAAC;AAE3D,MAAM,UAAU,kBAAkB,CAAC,CAAyB;IAC1D,eAAe,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,GAAG,EAAE;QACV,MAAM,KAAK,GAAG,4BAA4B,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,KAAK,IAAI,CAAC;YAAE,4BAA4B,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,4BAA4B,CAAC,4BAA4B,CAAC,MAAM,GAAG,CAAC,CAAC;WACvE,eAAe,CAAC;AACvB,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,eAAe,CAAC;SAC3C,IAAI,CAAC,sCAAsC,CAAC;SAC5C,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC;SACnC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,CAAC,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM;YACzB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,IAAI,EAAE,YAAqB;gBAC3B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAC/D,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC;YACL,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEL,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAC,cAAc,CAAC;SACzC,IAAI,CACH,+DAA+D;UAC7D,iCAAiC;UACjC,uDAAuD;UACvD,sBAAsB,CACzB;SACA,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC;SACrB,KAAK,CAAC,eAAe,EAAE;QACtB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gDAAgD;KAC9D,CAAC;SACD,KAAK,CAAC,MAAM,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4DAA4D;KAC1E,CAAC;SACD,KAAK,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;SACpE,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC;SACnE,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SACrD,KAAK,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;SAC7E,KAAK,CAAC,mBAAmB,EAAE;QAC1B,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yCAAyC;KACvD,CAAC;SACD,KAAK,CAAC,gBAAgB,EAAE;QACvB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wCAAwC;KACtD,CAAC;SACD,KAAK,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;SAC/E,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;SACjE,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;SAClE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;QACnC,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,EAAE,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAE/C,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAI,OAAO,IAAI,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAEpD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE;YACzC,GAAG,KAAK;YACR,EAAE,EAAE,qBAAqB,EAAE;SAC5B,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACvF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,OAAO,KAAK,EAAE,CAAC;QAC7E,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEL,MAAM,UAAU,GAAG,IAAI,QAAQ,CAAC,iBAAiB,CAAC;SAC/C,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC;SAC3D,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,EAAE,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YAClD,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;YACnB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEL,MAAM,SAAS,GAAG,IAAI,QAAQ,CAAC,gBAAgB,CAAC;SAC7C,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC;SAC3D,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,EAAE,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEL,MAAM,UAAU,GAAG,IAAI,QAAQ,CAAC,iBAAiB,CAAC;SAC/C,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC;SAC3D,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,EAAE,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEL,MAAM,WAAW,GAAG,IAAI,QAAQ,CAAC,kBAAkB,CAAC;SACjD,IAAI,CACH,uDAAuD;UACrD,+CAA+C,CAClD;SACA,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC;SAC3B,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC;SACnE,KAAK,CAAC,mBAAmB,EAAE;QAC1B,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,kCAAkC;KAChD,CAAC;SACD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;QACnC,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,EAAE,WAAW;YAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QACjD,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,CAAC;YACjC,MAAM;YACN,OAAO,EAAE,IAAI;YACb,kBAAkB,EAAE,WAAW;YAC/B,SAAS,EAAE,yBAAyB,CAAC,WAAW,CAAC;YACjD,gBAAgB,EAAE,IAAI,CAAC,iBAAiB,KAAK,IAAI;YACjD,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM,CAAC,YAAY;YAC5B,cAAc,EAAE,MAAM,CAAC,aAAa;YACpC,OAAO,EAAE,sDAAsD;SAChE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC7E,CAAC"}

package/lib/security/audit-logger.d.ts

@@ -59,6 +59,11 @@ export declare class AuditLogger {
     private eventCount;
     private sessionEvents;
     private static readonly MAX_SESSION_EVENTS;
+    /** 背压：write() 返回 false 时事件先进有界队列，'drain' 后泄放 */
+    private pendingLines;
+    private paused;
+    private droppedCount;
+    private static readonly MAX_PENDING_LINES;
     constructor(config?: Partial<AuditLoggerConfig>);
     private initLogFile;
     /**
@@ -74,9 +79,17 @@ export declare class AuditLogger {
      */
     log(event: Omit<AuditEvent, 'id' | 'timestamp'>): void;
     /**
-     * 写入日志文件
+     * 写入日志文件（含背压处理）
+     *
+     * write() 返回 false 表示内部缓冲已满：暂停直入、事件行进入有界队列，
+     * 'drain' 后泄放；队列超上限（MAX_PENDING_LINES）丢弃并计数，
+     * 计数定期以 warn 审计事件落盘。
      */
     private writeToFile;
+    private enqueueLine;
+    /** 首次丢弃及每 1000 条丢弃落一条 warn 审计事件 */
+    private maybeLogDropWarn;
+    private onDrain;
     /**
      * 控制台输出
      */
@@ -132,6 +145,7 @@ export declare class AuditLogger {
         totalEvents: number;
         sessionEvents: number;
         blockedEvents: number;
+        droppedEvents: number;
         byType: Record<AuditEventType, number>;
         bySeverity: Record<AuditEventSeverity, number>;
     };
@@ -140,9 +154,9 @@ export declare class AuditLogger {
      */
     clearSessionEvents(): void;
     /**
-     * 关闭日志流
+     * 关闭日志流：先泄放队列，再等待 'finish'（或 error）确保全部落盘。
      */
-    close(): void;
+    close(): Promise<void>;
 }
 /**
  * 获取全局审计日志实例
@@ -153,7 +167,7 @@ export declare function getAuditLogger(): AuditLogger;
  */
 export declare function initAuditLogger(config: Partial<AuditLoggerConfig>): AuditLogger;
 /**
- * 关闭审计日志
+ * 关闭审计日志（等待全部缓冲事件落盘）
  */
-export declare function closeAuditLogger(): void;
+export declare function closeAuditLogger(): Promise<void>;
 //# sourceMappingURL=audit-logger.d.ts.map

package/lib/security/audit-logger.d.ts.map

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

package/lib/security/audit-logger.js

@@ -172,6 +172,11 @@ export class AuditLogger {
     eventCount = 0;
     sessionEvents = [];
     static MAX_SESSION_EVENTS = 5000;
+    /** 背压：write() 返回 false 时事件先进有界队列，'drain' 后泄放 */
+    pendingLines = [];
+    paused = false;
+    droppedCount = 0;
+    static MAX_PENDING_LINES = 10000;
     constructor(config = {}) {
         this.config = { ...DEFAULT_CONFIG, ...config };
         this.initLogFile();
@@ -250,19 +255,67 @@ export class AuditLogger {
         }
     }
     /**
-     * 写入日志文件
+     * 写入日志文件（含背压处理）
+     *
+     * write() 返回 false 表示内部缓冲已满：暂停直入、事件行进入有界队列，
+     * 'drain' 后泄放；队列超上限（MAX_PENDING_LINES）丢弃并计数，
+     * 计数定期以 warn 审计事件落盘。
      */
     writeToFile(event) {
         if (!this.logStream)
             return;
         try {
             const logLine = JSON.stringify(event) + '\n';
-            this.logStream.write(logLine);
+            if (this.paused) {
+                this.enqueueLine(logLine);
+                return;
+            }
+            const ok = this.logStream.write(logLine);
+            if (!ok) {
+                this.paused = true;
+                this.logStream.once('drain', () => this.onDrain());
+            }
         }
         catch (err) {
             console.error('[AuditLogger] 写入日志失败:', err);
         }
     }
+    enqueueLine(logLine) {
+        if (this.pendingLines.length >= AuditLogger.MAX_PENDING_LINES) {
+            this.droppedCount++;
+            this.maybeLogDropWarn();
+            return;
+        }
+        this.pendingLines.push(logLine);
+    }
+    /** 首次丢弃及每 1000 条丢弃落一条 warn 审计事件 */
+    maybeLogDropWarn() {
+        if (this.droppedCount === 1 || this.droppedCount % 1000 === 0) {
+            this.log({
+                type: 'security.violation',
+                severity: 'warn',
+                message: `审计事件写入队列超限，已丢弃 ${this.droppedCount} 条事件`,
+                blocked: true,
+                details: { droppedEvents: this.droppedCount },
+            });
+        }
+    }
+    onDrain() {
+        this.paused = false;
+        const stream = this.logStream;
+        if (!stream) {
+            this.pendingLines.length = 0;
+            return;
+        }
+        while (this.pendingLines.length > 0) {
+            const ok = stream.write(this.pendingLines.shift());
+            if (!ok) {
+                this.paused = true;
+                stream.once('drain', () => this.onDrain());
+                return;
+            }
+        }
+    }
     /**
      * 控制台输出
      */
@@ -435,6 +488,7 @@ export class AuditLogger {
             totalEvents: this.eventCount,
             sessionEvents: this.sessionEvents.length,
             blockedEvents,
+            droppedEvents: this.droppedCount,
             byType,
             bySeverity,
         };
@@ -446,13 +500,35 @@ export class AuditLogger {
         this.sessionEvents = [];
     }
     /**
-     * 关闭日志流
+     * 关闭日志流：先泄放队列，再等待 'finish'（或 error）确保全部落盘。
      */
-    close() {
-        if (this.logStream) {
-            this.logStream.end();
-            this.logStream = null;
+    async close() {
+        const stream = this.logStream;
+        if (!stream)
+            return;
+        this.logStream = null;
+        this.paused = false;
+        // 泄放背压队列中剩余事件
+        while (this.pendingLines.length > 0) {
+            try {
+                stream.write(this.pendingLines.shift());
+            }
+            catch {
+                // 流已损坏，丢弃剩余队列
+                this.pendingLines.length = 0;
+                break;
+            }
         }
+        await new Promise((resolve) => {
+            const done = () => resolve();
+            stream.once('error', done);
+            try {
+                stream.end(done);
+            }
+            catch {
+                done();
+            }
+        });
     }
 }
 // ── 全局审计日志实例 ──────────────────────────────────────────────────
@@ -478,17 +554,17 @@ export function getAuditLogger() {
  */
 export function initAuditLogger(config) {
     if (globalAuditLogger) {
-        globalAuditLogger.close();
+        void globalAuditLogger.close().catch(() => { });
     }
     globalAuditLogger = new AuditLogger(config);
     return globalAuditLogger;
 }
 /**
- * 关闭审计日志
+ * 关闭审计日志（等待全部缓冲事件落盘）
  */
-export function closeAuditLogger() {
+export async function closeAuditLogger() {
     if (globalAuditLogger) {
-        globalAuditLogger.close();
+        await globalAuditLogger.close();
         globalAuditLogger = null;
     }
 }