@zhin.js/agent 1.0.1 → 1.0.3

package/lib/event/agent-stream-hooks.js

@@ -0,0 +1,28 @@
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+/** Legacy `type:action` hook keys → Eve-aligned stream event names. */
+export const LEGACY_HOOK_STREAM_ALIASES = {
+    'message:received': AgentStreamEventType.MESSAGE_RECEIVED,
+    'message:sent': AgentStreamEventType.MESSAGE_COMPLETED,
+    'session:new': AgentStreamEventType.SESSION_STARTED,
+    'tool:call': AgentStreamEventType.ACTIONS_REQUESTED,
+    'tool:result': AgentStreamEventType.ACTION_RESULT,
+};
+export function isAgentStreamHookEventName(event) {
+    return Object.values(AgentStreamEventType).includes(event);
+}
+export function agentStreamEventToAIHookEvent(streamEvent, sessionId) {
+    const [type, action] = streamEvent.type.split('.', 2);
+    const resolvedSessionId = typeof streamEvent.data?.sessionId === 'string' ? streamEvent.data.sessionId : sessionId;
+    return {
+        type: type,
+        action: action ?? streamEvent.type,
+        sessionId: resolvedSessionId,
+        context: {
+            ...(streamEvent.data ?? {}),
+            streamType: streamEvent.type,
+        },
+        timestamp: new Date(streamEvent.timestamp ?? Date.now()),
+        messages: [],
+    };
+}
+//# sourceMappingURL=agent-stream-hooks.js.map

package/lib/event/agent-stream-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-stream-hooks.js","sourceRoot":"","sources":["../../src/event/agent-stream-hooks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAwD,MAAM,0BAA0B,CAAC;AAEtH,uEAAuE;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAuD;IAC5F,kBAAkB,EAAE,oBAAoB,CAAC,gBAAgB;IACzD,cAAc,EAAE,oBAAoB,CAAC,iBAAiB;IACtD,aAAa,EAAE,oBAAoB,CAAC,eAAe;IACnD,WAAW,EAAE,oBAAoB,CAAC,iBAAiB;IACnD,aAAa,EAAE,oBAAoB,CAAC,aAAa;CAClD,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,OAAQ,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,WAA6B,EAC7B,SAAkB;IAElB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,iBAAiB,GACrB,OAAO,WAAW,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,OAAO;QACL,IAAI,EAAE,IAAuB;QAC7B,MAAM,EAAE,MAAM,IAAI,WAAW,CAAC,IAAI;QAClC,SAAS,EAAE,iBAAiB;QAC5B,OAAO,EAAE;YACP,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;YAC3B,UAAU,EAAE,WAAW,CAAC,IAAI;SAC7B;QACD,SAAS,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACxD,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC"}

package/lib/event/contracts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Event System — 模块契约（与实现同步）。
+ *
+ * 实现：`EventSystem.on` / `emit` + `LoggingMiddleware` + `FilteringMiddleware`。
+ *
+ * 分工：与 `ZhinAgentEventEmitter`、Kernel RunEvent、plugin `before.*` 分离，见 CONTEXT.md。
+ */
+export interface EventSystemAgentEvent {
+    type: string;
+    payload: unknown;
+    timestamp: number;
+    source?: string;
+}
+export type EventHandler = (event: EventSystemAgentEvent) => void | Promise<void>;
+export interface EventMiddleware {
+    name: string;
+    process(event: EventSystemAgentEvent): Promise<EventSystemAgentEvent | null>;
+}
+export interface EventSystemConfig {
+    source?: string;
+    /** 非空时仅放行列出的 event.type */
+    allowedEventTypes?: string[];
+    /** 丢弃列出的 event.type（优先于 allow） */
+    deniedEventTypes?: string[];
+}
+//# sourceMappingURL=contracts.d.ts.map

package/lib/event/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/event/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B"}

package/lib/event/contracts.js

@@ -0,0 +1,9 @@
+/**
+ * Event System — 模块契约（与实现同步）。
+ *
+ * 实现：`EventSystem.on` / `emit` + `LoggingMiddleware` + `FilteringMiddleware`。
+ *
+ * 分工：与 `ZhinAgentEventEmitter`、Kernel RunEvent、plugin `before.*` 分离，见 CONTEXT.md。
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/event/contracts.js.map

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

package/lib/event/event-emitter.d.ts

@@ -0,0 +1,17 @@
+import type { Message, Plugin } from '@zhin.js/core';
+import { EventSystem } from './event-system.js';
+import type { EventHandler } from './contracts.js';
+export declare class ZhinAgentEventEmitter {
+    private hostPlugin;
+    private readonly eventSystem;
+    constructor(hostPlugin?: Plugin | null);
+    /** Agent turn 域事件订阅（EventSystem）；plugin lifecycle 仍走 dispatch/emit。 */
+    on(eventType: string, handler: EventHandler): () => void;
+    getEventSystem(): EventSystem;
+    setHostPlugin(plugin: Plugin): void;
+    getHostPlugin(): Plugin | null;
+    createPayload(sessionId: string, commMessage: Message, mode: Plugin.AIEventPayload['mode'], extra?: Partial<Plugin.AIEventPayload>): Plugin.AIEventPayload;
+    dispatch(name: keyof Plugin.Lifecycle, payload: Plugin.AIEventPayload): Promise<void>;
+    emit(name: keyof Plugin.Lifecycle, payload: Plugin.AIEventPayload): void;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/lib/event/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../src/event/event-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAEtB,UAAU,GAAE,MAAM,GAAG,IAAW;IAIpD,uEAAuE;IACvE,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAIxD,cAAc,IAAI,WAAW;IAI7B,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EACnC,KAAK,GAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAM,GACzC,MAAM,CAAC,cAAc;IA2BlB,QAAQ,CACZ,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,EAC5B,OAAO,EAAE,MAAM,CAAC,cAAc,GAC7B,OAAO,CAAC,IAAI,CAAC;IAMhB,IAAI,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI;CASzE"}

package/lib/event/event-emitter.js

@@ -0,0 +1,73 @@
+import { Logger, formatCompact } from '@zhin.js/logger';
+import { EventSystem } from './event-system.js';
+import { getScheduleTurnContext, getActivityFeedbackEligible } from '../internal/turn-context.js';
+const logger = new Logger(null, 'ZhinAgent');
+export class ZhinAgentEventEmitter {
+    hostPlugin;
+    eventSystem;
+    constructor(hostPlugin = null) {
+        this.hostPlugin = hostPlugin;
+        this.eventSystem = new EventSystem({ source: 'zhin-agent' });
+    }
+    /** Agent turn 域事件订阅（EventSystem）；plugin lifecycle 仍走 dispatch/emit。 */
+    on(eventType, handler) {
+        return this.eventSystem.on(eventType, handler);
+    }
+    getEventSystem() {
+        return this.eventSystem;
+    }
+    setHostPlugin(plugin) {
+        this.hostPlugin = plugin.root ?? plugin;
+    }
+    getHostPlugin() {
+        return this.hostPlugin;
+    }
+    createPayload(sessionId, commMessage, mode, extra = {}) {
+        const { source = 'zhin-agent', hookContext: extraHookContext, ...rest } = extra;
+        const scheduleCtx = getScheduleTurnContext();
+        const hookContext = {
+            ...(extraHookContext && typeof extraHookContext === 'object' ? extraHookContext : {}),
+        };
+        if (scheduleCtx?.createdBy)
+            hookContext.scheduleCreatedBy = scheduleCtx.createdBy;
+        if (scheduleCtx?.jobId)
+            hookContext.scheduleJobId = scheduleCtx.jobId;
+        if (scheduleCtx?.preview === true)
+            hookContext.schedulePreview = true;
+        if (scheduleCtx?.activityFeedback === true)
+            hookContext.scheduleActivityFeedback = true;
+        if (scheduleCtx?.executionPlan)
+            hookContext.scheduleExecutionPlan = scheduleCtx.executionPlan;
+        if (getActivityFeedbackEligible())
+            hookContext.activityFeedbackEligible = true;
+        return {
+            sessionId,
+            source,
+            mode,
+            userId: commMessage.$sender.id,
+            platform: String(commMessage.$adapter),
+            endpointId: commMessage.$endpoint,
+            sceneId: commMessage.$channel?.id ?? commMessage.$sender.id,
+            messageId: commMessage.$id,
+            scope: commMessage.$channel?.type ?? 'private',
+            ...(Object.keys(hookContext).length > 0 ? { hookContext } : {}),
+            ...rest,
+        };
+    }
+    async dispatch(name, payload) {
+        const root = this.hostPlugin?.root ?? this.hostPlugin;
+        if (!root)
+            return;
+        await root.dispatch(name, payload);
+    }
+    emit(name, payload) {
+        this.eventSystem.emitFireAndForget(String(name), payload);
+        this.dispatch(name, payload).catch((error) => {
+            logger.warn(formatCompact({
+                ai_event: String(name),
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        });
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/lib/event/event-emitter.js.map

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

package/lib/event/event-system.d.ts

@@ -0,0 +1,13 @@
+import type { EventHandler, EventMiddleware, EventSystemConfig } from './contracts.js';
+export declare class EventSystem {
+    private readonly config;
+    private readonly listeners;
+    private readonly middleware;
+    constructor(config?: EventSystemConfig);
+    on(eventType: string, handler: EventHandler): () => void;
+    addMiddleware(middleware: EventMiddleware): void;
+    emit(eventType: string, payload: unknown): Promise<void>;
+    emitFireAndForget(eventType: string, payload: unknown): void;
+}
+export declare function createEventSystem(config?: EventSystemConfig): EventSystem;
+//# sourceMappingURL=event-system.d.ts.map

package/lib/event/event-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-system.d.ts","sourceRoot":"","sources":["../../src/event/event-system.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAEf,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAMxB,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;gBAEvB,MAAM,GAAE,iBAAsB;IAE3D,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAQxD,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAI1C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;CAQ7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,iBAA4C,GAAG,WAAW,CAQnG"}

package/lib/event/event-system.js

@@ -0,0 +1,56 @@
+import { formatCompact, Logger } from '@zhin.js/logger';
+import { LoggingMiddleware } from './logging-middleware.js';
+import { FilteringMiddleware } from './filtering-middleware.js';
+const logger = new Logger(null, 'EventSystem');
+export class EventSystem {
+    config;
+    listeners = new Map();
+    middleware = [];
+    constructor(config = {}) {
+        this.config = config;
+    }
+    on(eventType, handler) {
+        if (!this.listeners.has(eventType)) {
+            this.listeners.set(eventType, new Set());
+        }
+        this.listeners.get(eventType).add(handler);
+        return () => this.listeners.get(eventType)?.delete(handler);
+    }
+    addMiddleware(middleware) {
+        this.middleware.push(middleware);
+    }
+    async emit(eventType, payload) {
+        const event = {
+            type: eventType,
+            payload,
+            timestamp: Date.now(),
+            source: this.config.source,
+        };
+        let processedEvent = event;
+        for (const mw of this.middleware) {
+            processedEvent = await mw.process(processedEvent);
+            if (!processedEvent)
+                return;
+        }
+        const listeners = this.listeners.get(eventType) ?? new Set();
+        await Promise.all(Array.from(listeners).map((h) => h(processedEvent)));
+    }
+    emitFireAndForget(eventType, payload) {
+        this.emit(eventType, payload).catch((error) => {
+            logger.warn(formatCompact({
+                event: eventType,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        });
+    }
+}
+export function createEventSystem(config = { source: 'zhin-agent' }) {
+    const system = new EventSystem(config);
+    system.addMiddleware(new LoggingMiddleware());
+    system.addMiddleware(new FilteringMiddleware({
+        allowedEventTypes: config.allowedEventTypes,
+        deniedEventTypes: config.deniedEventTypes,
+    }));
+    return system;
+}
+//# sourceMappingURL=event-system.js.map

package/lib/event/event-system.js.map

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

package/lib/event/filtering-middleware.d.ts

@@ -0,0 +1,13 @@
+import type { EventMiddleware, EventSystemAgentEvent } from './contracts.js';
+export interface FilteringMiddlewareOptions {
+    allowedEventTypes?: string[];
+    deniedEventTypes?: string[];
+}
+export declare class FilteringMiddleware implements EventMiddleware {
+    name: string;
+    private readonly allowed;
+    private readonly denied;
+    constructor(options?: FilteringMiddlewareOptions);
+    process(event: EventSystemAgentEvent): Promise<EventSystemAgentEvent | null>;
+}
+//# sourceMappingURL=filtering-middleware.d.ts.map

package/lib/event/filtering-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering-middleware.d.ts","sourceRoot":"","sources":["../../src/event/filtering-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACzD,IAAI,SAAe;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,OAAO,GAAE,0BAA+B;IAO9C,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAKnF"}

package/lib/event/filtering-middleware.js

@@ -0,0 +1,19 @@
+export class FilteringMiddleware {
+    name = 'filtering';
+    allowed;
+    denied;
+    constructor(options = {}) {
+        this.allowed = options.allowedEventTypes?.length
+            ? new Set(options.allowedEventTypes)
+            : null;
+        this.denied = new Set(options.deniedEventTypes ?? []);
+    }
+    async process(event) {
+        if (this.denied.has(event.type))
+            return null;
+        if (this.allowed && !this.allowed.has(event.type))
+            return null;
+        return event;
+    }
+}
+//# sourceMappingURL=filtering-middleware.js.map

package/lib/event/filtering-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering-middleware.js","sourceRoot":"","sources":["../../src/event/filtering-middleware.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,mBAAmB;IAC9B,IAAI,GAAG,WAAW,CAAC;IAEF,OAAO,CAAqB;IAC5B,MAAM,CAAc;IAErC,YAAY,UAAsC,EAAE;QAClD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,MAAM;YAC9C,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA4B;QACxC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/lib/event/hook-stream-sink.d.ts

@@ -0,0 +1,7 @@
+/**
+ * HookRegistry adapter — AgentStreamBus sink (ADR 0041).
+ */
+import type { AgentStreamSink } from './agent-stream-bus.js';
+import type { HookRegistry } from '../orchestrator/hook-registry.js';
+export declare function createHookStreamSink(hooks: HookRegistry): AgentStreamSink;
+//# sourceMappingURL=hook-stream-sink.d.ts.map

package/lib/event/hook-stream-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-stream-sink.d.ts","sourceRoot":"","sources":["../../src/event/hook-stream-sink.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAOzE"}

package/lib/event/hook-stream-sink.js

@@ -0,0 +1,9 @@
+export function createHookStreamSink(hooks) {
+    return {
+        name: 'hook',
+        async handle(event, ctx) {
+            await hooks.triggerStream(event, ctx.agentId, ctx.sessionId, { skipBus: true, fromBus: true });
+        },
+    };
+}
+//# sourceMappingURL=hook-stream-sink.js.map

package/lib/event/hook-stream-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-stream-sink.js","sourceRoot":"","sources":["../../src/event/hook-stream-sink.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG;YACrB,MAAM,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjG,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/event/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Event System — Agent turn 域事件 + ZhinAgentEventEmitter 适配。
+ */
+export type { EventSystemAgentEvent, EventHandler, EventMiddleware, EventSystemConfig, } from './contracts.js';
+export { EventSystem, createEventSystem } from './event-system.js';
+export { FilteringMiddleware } from './filtering-middleware.js';
+export type { FilteringMiddlewareOptions } from './filtering-middleware.js';
+export { ZhinAgentEventEmitter } from './event-emitter.js';
+export { emitSessionNewEvent, emitSessionCompactEvent } from './session-events.js';
+export type { TurnEvent, TurnUsage, TurnStartEvent, ChunkEvent, ToolCallEvent, ToolResultEvent, ThinkingEvent, TurnEndEvent, TurnErrorEvent, SubagentStartEvent, SubagentProgressEvent, SubagentEndEvent, McpConnectEvent, McpToolCallEvent, } from './turn-event.js';
+export { mapTurnEventToAgentStreamEvents, } from './turn-to-agent-stream.js';
+export type { TurnToStreamContext } from './turn-to-agent-stream.js';
+export { createAgentStreamBus, DefaultAgentStreamBus, } from './agent-stream-bus.js';
+export type { AgentStreamBus, AgentStreamSink, AgentStreamPublishContext, } from './agent-stream-bus.js';
+export { createHookStreamSink } from './hook-stream-sink.js';
+export { publishAgentStream, publishTurnStreamEvents } from './publish-agent-stream.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,YAAY,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,cAAc,EACd,eAAe,EACf,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/lib/event/index.js

@@ -0,0 +1,12 @@
+/**
+ * Event System — Agent turn 域事件 + ZhinAgentEventEmitter 适配。
+ */
+export { EventSystem, createEventSystem } from './event-system.js';
+export { FilteringMiddleware } from './filtering-middleware.js';
+export { ZhinAgentEventEmitter } from './event-emitter.js';
+export { emitSessionNewEvent, emitSessionCompactEvent } from './session-events.js';
+export { mapTurnEventToAgentStreamEvents, } from './turn-to-agent-stream.js';
+export { createAgentStreamBus, DefaultAgentStreamBus, } from './agent-stream-bus.js';
+export { createHookStreamSink } from './hook-stream-sink.js';
+export { publishAgentStream, publishTurnStreamEvents } from './publish-agent-stream.js';
+//# sourceMappingURL=index.js.map

package/lib/event/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/event/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAmBnF,OAAO,EACL,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/lib/event/logging-middleware.d.ts

@@ -0,0 +1,6 @@
+import type { EventMiddleware, EventSystemAgentEvent } from './contracts.js';
+export declare class LoggingMiddleware implements EventMiddleware {
+    name: string;
+    process(event: EventSystemAgentEvent): Promise<EventSystemAgentEvent>;
+}
+//# sourceMappingURL=logging-middleware.d.ts.map

package/lib/event/logging-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-middleware.d.ts","sourceRoot":"","sources":["../../src/event/logging-middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAI7E,qBAAa,iBAAkB,YAAW,eAAe;IACvD,IAAI,SAAa;IAEX,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAS5E"}

package/lib/event/logging-middleware.js

@@ -0,0 +1,16 @@
+import { formatCompact, Logger } from '@zhin.js/logger';
+const logger = new Logger(null, 'EventSystem:Logging');
+export class LoggingMiddleware {
+    name = 'logging';
+    async process(event) {
+        if (process.env.NODE_ENV === 'test')
+            return event;
+        logger.debug(formatCompact({
+            event: event.type,
+            source: event.source,
+            ts: event.timestamp,
+        }));
+        return event;
+    }
+}
+//# sourceMappingURL=logging-middleware.js.map

package/lib/event/logging-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-middleware.js","sourceRoot":"","sources":["../../src/event/logging-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGxD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AAEvD,MAAM,OAAO,iBAAiB;IAC5B,IAAI,GAAG,SAAS,CAAC;IAEjB,KAAK,CAAC,OAAO,CAAC,KAA4B;QACxC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;YACzB,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,EAAE,EAAE,KAAK,CAAC,SAAS;SACpB,CAAC,CAAC,CAAC;QACJ,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/lib/event/publish-agent-stream.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Publish AgentStreamEvent via per-orchestrator bus.
+ */
+import type { AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { AgentStreamPublishContext } from './agent-stream-bus.js';
+import { type TurnToStreamContext } from './turn-to-agent-stream.js';
+import type { TurnEvent } from './turn-event.js';
+export declare function publishAgentStream(host: Pick<ZhinAgentPrivate, 'orchestrator'>, event: AgentStreamEvent, ctx?: AgentStreamPublishContext): void;
+export declare function publishTurnStreamEvents(host: Pick<ZhinAgentPrivate, 'orchestrator'>, turnEvent: TurnEvent, ctx: TurnToStreamContext & AgentStreamPublishContext): void;
+//# sourceMappingURL=publish-agent-stream.d.ts.map

package/lib/event/publish-agent-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-agent-stream.d.ts","sourceRoot":"","sources":["../../src/event/publish-agent-stream.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAmC,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,EAC5C,KAAK,EAAE,gBAAgB,EACvB,GAAG,GAAE,yBAA8B,GAClC,IAAI,CAIN;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,EAC5C,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,mBAAmB,GAAG,yBAAyB,GACnD,IAAI,CAKN"}

package/lib/event/publish-agent-stream.js

@@ -0,0 +1,14 @@
+import { mapTurnEventToAgentStreamEvents } from './turn-to-agent-stream.js';
+export function publishAgentStream(host, event, ctx = {}) {
+    const bus = host.orchestrator?.agentStreamBus;
+    if (!bus)
+        return;
+    void bus.publish(event, ctx);
+}
+export function publishTurnStreamEvents(host, turnEvent, ctx) {
+    const { sessionId, turnId, httpSessionId, agentId } = ctx;
+    for (const streamEvent of mapTurnEventToAgentStreamEvents(turnEvent, { sessionId, turnId })) {
+        publishAgentStream(host, streamEvent, { sessionId, turnId, httpSessionId, agentId });
+    }
+}
+//# sourceMappingURL=publish-agent-stream.js.map

package/lib/event/publish-agent-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-agent-stream.js","sourceRoot":"","sources":["../../src/event/publish-agent-stream.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,+BAA+B,EAA4B,MAAM,2BAA2B,CAAC;AAGtG,MAAM,UAAU,kBAAkB,CAChC,IAA4C,EAC5C,KAAuB,EACvB,MAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAA4C,EAC5C,SAAoB,EACpB,GAAoD;IAEpD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAC1D,KAAK,MAAM,WAAW,IAAI,+BAA+B,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC5F,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;AACH,CAAC"}

package/lib/event/session-events.d.ts

@@ -0,0 +1,10 @@
+import type { Message } from '../orchestrator/types.js';
+import type { ZhinAgentEventEmitter } from '../event/event-emitter.js';
+export declare function emitSessionNewEvent(emitter: ZhinAgentEventEmitter, sessionId: string, commMessage: Message, mode: 'text' | 'multimodal', content: string, reply: string): void;
+export declare function emitSessionCompactEvent(emitter: ZhinAgentEventEmitter, sessionId: string, commMessage: Message, mode: 'text' | 'multimodal', info: {
+    microSavedTokens: number;
+    autoSavedTokens: number;
+    totalTokensBefore: number;
+    totalTokensAfter: number;
+}): void;
+//# sourceMappingURL=session-events.d.ts.map

package/lib/event/session-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-events.d.ts","sourceRoot":"","sources":["../../src/event/session-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,MAAM,GAAG,YAAY,EAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,IAAI,CAMN;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,MAAM,GAAG,YAAY,EAC3B,IAAI,EAAE;IACJ,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACA,IAAI,CASN"}

package/lib/event/session-events.js

@@ -0,0 +1,18 @@
+export function emitSessionNewEvent(emitter, sessionId, commMessage, mode, content, reply) {
+    emitter.emit('ai.session.new', emitter.createPayload(sessionId, commMessage, mode, {
+        reason: 'first_message',
+        content,
+        reply,
+    }));
+}
+export function emitSessionCompactEvent(emitter, sessionId, commMessage, mode, info) {
+    emitter.emit('ai.session.compact', emitter.createPayload(sessionId, commMessage, mode, {
+        path: 'agent',
+        compactedCount: 1,
+        savedTokens: info.microSavedTokens + info.autoSavedTokens,
+        totalTokensBefore: info.totalTokensBefore,
+        totalTokensAfter: info.totalTokensAfter,
+        result: info,
+    }));
+}
+//# sourceMappingURL=session-events.js.map

package/lib/event/session-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-events.js","sourceRoot":"","sources":["../../src/event/session-events.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CACjC,OAA8B,EAC9B,SAAiB,EACjB,WAAoB,EACpB,IAA2B,EAC3B,OAAe,EACf,KAAa;IAEb,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE;QACjF,MAAM,EAAE,eAAe;QACvB,OAAO;QACP,KAAK;KACN,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAA8B,EAC9B,SAAiB,EACjB,WAAoB,EACpB,IAA2B,EAC3B,IAKC;IAED,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE;QACrF,IAAI,EAAE,OAAO;QACb,cAAc,EAAE,CAAC;QACjB,WAAW,EAAE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,eAAe;QACzD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,MAAM,EAAE,IAAI;KACb,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/event/turn-event.d.ts

@@ -0,0 +1,77 @@
+/**
+ * TurnEvent — structured event union for the AsyncGenerator streaming API.
+ *
+ * Consumed by processMessageStream() callers; produced by the turn pipeline.
+ */
+import type { OutputElement } from '@zhin.js/ai';
+export interface TurnUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+export type TurnEvent = TurnStartEvent | ChunkEvent | ToolCallEvent | ToolResultEvent | ThinkingEvent | TurnEndEvent | TurnErrorEvent | SubagentStartEvent | SubagentProgressEvent | SubagentEndEvent | McpConnectEvent | McpToolCallEvent;
+export interface TurnStartEvent {
+    type: 'turn_start';
+    sessionId: string;
+    turnId: string;
+}
+export interface ChunkEvent {
+    type: 'chunk';
+    text: string;
+    accumulated: string;
+}
+export interface ToolCallEvent {
+    type: 'tool_call';
+    toolName: string;
+    args: Record<string, unknown>;
+    toolUseId: string;
+}
+export interface ToolResultEvent {
+    type: 'tool_result';
+    toolName: string;
+    output: unknown;
+    durationMs: number;
+    toolUseId: string;
+}
+export interface ThinkingEvent {
+    type: 'thinking';
+    text: string;
+}
+export interface TurnEndEvent {
+    type: 'turn_end';
+    output: OutputElement[];
+    usage: TurnUsage;
+}
+export interface TurnErrorEvent {
+    type: 'error';
+    error: Error;
+    recoverable: boolean;
+}
+export interface SubagentStartEvent {
+    type: 'subagent_start';
+    taskId: string;
+    agentName?: string;
+    description: string;
+}
+export interface SubagentProgressEvent {
+    type: 'subagent_progress';
+    taskId: string;
+    summary: string;
+}
+export interface SubagentEndEvent {
+    type: 'subagent_end';
+    taskId: string;
+    status: 'ok' | 'error';
+    result?: string;
+}
+export interface McpConnectEvent {
+    type: 'mcp_connect';
+    serverName: string;
+    status: 'connecting' | 'connected' | 'error';
+}
+export interface McpToolCallEvent {
+    type: 'mcp_tool_call';
+    serverName: string;
+    toolName: string;
+}
+//# sourceMappingURL=turn-event.d.ts.map

package/lib/event/turn-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-event.d.ts","sourceRoot":"","sources":["../../src/event/turn-event.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,UAAU,GACV,aAAa,GACb,eAAe,GACf,aAAa,GACb,YAAY,GACZ,cAAc,GACd,kBAAkB,GAClB,qBAAqB,GACrB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/lib/event/turn-event.js

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

package/lib/event/turn-event.js.map

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

package/lib/event/turn-to-agent-stream.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Maps internal TurnEvent to Eve-aligned AgentStreamEvent (ADR 0039 P0).
+ */
+import { type AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+import type { TurnEvent } from './turn-event.js';
+export interface TurnToStreamContext {
+    sessionId: string;
+    turnId: string;
+}
+/** Map one TurnEvent to zero or more wire events. */
+export declare function mapTurnEventToAgentStreamEvents(event: TurnEvent, ctx: TurnToStreamContext): AgentStreamEvent[];
+//# sourceMappingURL=turn-to-agent-stream.d.ts.map

package/lib/event/turn-to-agent-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-to-agent-stream.d.ts","sourceRoot":"","sources":["../../src/event/turn-to-agent-stream.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD,qDAAqD;AACrD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,mBAAmB,GACvB,gBAAgB,EAAE,CAyGpB"}