openclaw-event-server-plugin 1.0.0

package/dist/runtime/hook-bridge.js

@@ -0,0 +1,359 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookBridge = void 0;
+exports.createHookBridge = createHookBridge;
+const hook_bridge_actions_1 = require("./hook-bridge-actions");
+const hook_bridge_dispatch_engine_1 = require("./hook-bridge-dispatch-engine");
+const hook_bridge_tool_guard_1 = require("./hook-bridge-tool-guard");
+const hook_bridge_utils_1 = require("./hook-bridge-utils");
+const TOOL_GUARD_TRACE = process.env.EVENT_PLUGIN_TOOL_GUARD_TRACE === '1' ||
+    process.env.EVENT_PLUGIN_TOOL_GUARD_TRACE === 'true';
+class HookBridge {
+    config;
+    logger;
+    dispatchEngine;
+    parentStatusByAgent = new Map();
+    lastTriggerByRule = new Map();
+    blockedRetryStateByScope = new Map();
+    approvalCacheByScope = new Map();
+    acceptingEvents = true;
+    nextTaskId = 1;
+    trace(...args) {
+        if (!TOOL_GUARD_TRACE) {
+            return;
+        }
+        this.logger.info('[ToolGuardTrace]', ...args);
+    }
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+        this.dispatchEngine = new hook_bridge_dispatch_engine_1.HookBridgeDispatchEngine(config, logger);
+    }
+    onEvent(event) {
+        if (!this.config.enabled || !this.acceptingEvents) {
+            return;
+        }
+        this.observeAgentStatus(event);
+        for (const rule of this.config.rules) {
+            if (rule.enabled === false) {
+                continue;
+            }
+            if (!(0, hook_bridge_tool_guard_1.matchesRule)(event, rule, this.parentStatusByAgent)) {
+                continue;
+            }
+            if (!this.canTrigger(rule)) {
+                continue;
+            }
+            this.lastTriggerByRule.set(rule.id, Date.now());
+            if (this.config.dryRun) {
+                this.logger.info('[HookBridge] dry-run matched rule', rule.id, 'for event', event.type);
+                continue;
+            }
+            const action = this.config.actions[rule.action];
+            if (!action) {
+                this.logger.error('[HookBridge] Rule references unknown action', rule.id, rule.action);
+                continue;
+            }
+            this.dispatchEngine.enqueueTask({
+                taskId: `task-${this.nextTaskId++}`,
+                ruleId: rule.id,
+                actionId: rule.action,
+                action,
+                rule,
+                event,
+                enqueuedAt: Date.now(),
+                mergedCount: 0,
+            });
+        }
+    }
+    async stop() {
+        this.acceptingEvents = false;
+        await this.dispatchEngine.stop();
+    }
+    async evaluateBeforeToolCall(params) {
+        const guardConfig = this.config.toolGuard;
+        if (!guardConfig.enabled || !this.acceptingEvents) {
+            this.trace('hookBridge.evaluate.skip', {
+                reason: !guardConfig.enabled ? 'toolGuard.disabled' : 'hookBridge.notAccepting',
+                toolName: params.toolName,
+                toolCallId: params.toolCallId ?? null,
+            });
+            return undefined;
+        }
+        const toolEvent = (0, hook_bridge_tool_guard_1.buildToolGuardEvent)(params);
+        const nowMs = Date.now();
+        const scopeKey = (0, hook_bridge_tool_guard_1.buildToolGuardScopeKey)(params.toolName, params.params, guardConfig.scopeKeyBy ?? 'tool_and_params');
+        this.cleanupToolGuardState(nowMs, guardConfig.retryBackoffMs);
+        this.trace('hookBridge.evaluate.start', {
+            toolName: params.toolName,
+            toolCallId: params.toolCallId ?? null,
+            scopeKey,
+            rulesCount: guardConfig.rules.length,
+        });
+        const blockedState = this.blockedRetryStateByScope.get(scopeKey);
+        if (guardConfig.retryBackoffMs > 0 &&
+            blockedState &&
+            nowMs - blockedState.blockedAtMs < guardConfig.retryBackoffMs) {
+            const remainingMs = guardConfig.retryBackoffMs - (nowMs - blockedState.blockedAtMs);
+            const templateReason = guardConfig.retryBackoffReason ??
+                'Retry blocked. Back off briefly before retrying this tool call.';
+            return {
+                block: true,
+                blockReason: (0, hook_bridge_tool_guard_1.renderGuardTemplate)(templateReason, toolEvent).replace(/\{\{\s*retryBackoffRemainingMs\s*\}\}/g, String(remainingMs)),
+                matched: true,
+                decisionSource: 'backoff',
+            };
+        }
+        const cached = this.approvalCacheByScope.get(scopeKey);
+        if (cached && cached.expiresAtMs > nowMs) {
+            return {
+                ...(0, hook_bridge_tool_guard_1.resolveDecisionTemplates)(cached.decision, toolEvent),
+                matched: true,
+                decisionSource: 'cache',
+                matchedRuleId: cached.ruleId,
+                matchedActionId: cached.actionId,
+            };
+        }
+        const sortedRules = [...guardConfig.rules]
+            .map((rule, index) => ({ rule, index }))
+            .sort((a, b) => {
+            const priorityA = a.rule.priority ?? 0;
+            const priorityB = b.rule.priority ?? 0;
+            if (priorityA !== priorityB) {
+                return priorityB - priorityA;
+            }
+            return a.index - b.index;
+        })
+            .map((entry) => entry.rule);
+        for (const rule of sortedRules) {
+            if (rule.enabled === false) {
+                continue;
+            }
+            if (!(0, hook_bridge_tool_guard_1.matchesRule)(toolEvent, rule, this.parentStatusByAgent)) {
+                this.trace('hookBridge.rule.skip', {
+                    ruleId: rule.id,
+                    reason: 'matcher.false',
+                    toolName: params.toolName,
+                    toolCallId: params.toolCallId ?? null,
+                });
+                continue;
+            }
+            if (!this.canTrigger(rule)) {
+                this.trace('hookBridge.rule.skip', {
+                    ruleId: rule.id,
+                    reason: 'cooldown.active',
+                    toolName: params.toolName,
+                    toolCallId: params.toolCallId ?? null,
+                });
+                continue;
+            }
+            this.trace('hookBridge.rule.match', {
+                ruleId: rule.id,
+                actionId: rule.action ?? null,
+                hasDecision: Boolean(rule.decision),
+                toolName: params.toolName,
+                toolCallId: params.toolCallId ?? null,
+            });
+            const stopOnMatch = rule.stopOnMatch ?? guardConfig.stopOnMatchDefault ?? false;
+            this.lastTriggerByRule.set(rule.id, Date.now());
+            if (rule.decision) {
+                if (guardConfig.dryRun) {
+                    this.logger.info('[HookBridge] toolGuard dry-run decision', rule.id, params.toolName, JSON.stringify(rule.decision));
+                    if (stopOnMatch) {
+                        return {
+                            matched: true,
+                            matchedRuleId: rule.id,
+                        };
+                    }
+                    continue;
+                }
+                const resolvedDecision = (0, hook_bridge_tool_guard_1.resolveDecisionTemplates)(rule.decision, toolEvent);
+                const outcome = {
+                    ...resolvedDecision,
+                    matched: true,
+                    matchedRuleId: rule.id,
+                    decisionSource: 'rule',
+                };
+                this.recordToolGuardDecision(scopeKey, outcome, guardConfig, nowMs);
+                this.trace('hookBridge.rule.decision', {
+                    ruleId: rule.id,
+                    toolName: params.toolName,
+                    toolCallId: params.toolCallId ?? null,
+                    outcome,
+                });
+                return outcome;
+            }
+            const actionId = rule.action;
+            if (!actionId || actionId.trim() === '') {
+                this.logger.error('[HookBridge] Tool guard rule missing action', rule.id);
+                if (guardConfig.onError === 'block') {
+                    return { block: true, blockReason: `Tool guard action missing for rule "${rule.id}"` };
+                }
+                continue;
+            }
+            const action = this.config.actions[actionId];
+            if (!action) {
+                this.logger.error('[HookBridge] Tool guard references unknown action', rule.id, actionId);
+                if (guardConfig.onError === 'block') {
+                    return { block: true, blockReason: `Tool guard action not found: ${actionId}` };
+                }
+                continue;
+            }
+            try {
+                const decision = await (0, hook_bridge_actions_1.executeBridgeGuardAction)({ config: this.config }, action, toolEvent, rule.id, guardConfig.timeoutMs);
+                if (!decision) {
+                    this.trace('hookBridge.action.no-decision', {
+                        ruleId: rule.id,
+                        actionId,
+                        toolName: params.toolName,
+                        toolCallId: params.toolCallId ?? null,
+                        stopOnMatch,
+                    });
+                    if (stopOnMatch) {
+                        return {
+                            matched: true,
+                            matchedRuleId: rule.id,
+                            matchedActionId: actionId,
+                        };
+                    }
+                    continue;
+                }
+                if (guardConfig.dryRun) {
+                    this.logger.info('[HookBridge] toolGuard dry-run decision', rule.id, params.toolName, JSON.stringify(decision));
+                    if (stopOnMatch) {
+                        return {
+                            matched: true,
+                            matchedRuleId: rule.id,
+                            matchedActionId: actionId,
+                        };
+                    }
+                    continue;
+                }
+                const resolvedDecision = (0, hook_bridge_tool_guard_1.resolveDecisionTemplates)(decision, toolEvent);
+                const outcome = {
+                    ...resolvedDecision,
+                    matched: true,
+                    matchedRuleId: rule.id,
+                    matchedActionId: actionId,
+                    decisionSource: 'action',
+                };
+                this.recordToolGuardDecision(scopeKey, outcome, guardConfig, nowMs);
+                this.trace('hookBridge.action.decision', {
+                    ruleId: rule.id,
+                    actionId,
+                    toolName: params.toolName,
+                    toolCallId: params.toolCallId ?? null,
+                    outcome,
+                });
+                return outcome;
+            }
+            catch (error) {
+                const message = (0, hook_bridge_utils_1.toErrorMessage)(error);
+                this.logger.error('[HookBridge] Tool guard action failed', rule.id, actionId, message);
+                if (guardConfig.onError === 'block') {
+                    const outcome = {
+                        block: true,
+                        blockReason: `Tool guard failed for rule "${rule.id}": ${message}`,
+                        matched: true,
+                        matchedRuleId: rule.id,
+                        matchedActionId: actionId,
+                        decisionSource: 'action',
+                    };
+                    this.recordToolGuardDecision(scopeKey, outcome, guardConfig, nowMs);
+                    this.trace('hookBridge.action.error.block', {
+                        ruleId: rule.id,
+                        actionId,
+                        toolName: params.toolName,
+                        toolCallId: params.toolCallId ?? null,
+                        error: message,
+                        outcome,
+                    });
+                    return outcome;
+                }
+                if (stopOnMatch) {
+                    this.trace('hookBridge.action.error.stopOnMatch', {
+                        ruleId: rule.id,
+                        actionId,
+                        toolName: params.toolName,
+                        toolCallId: params.toolCallId ?? null,
+                        error: message,
+                    });
+                    return {
+                        matched: true,
+                        matchedRuleId: rule.id,
+                        matchedActionId: actionId,
+                    };
+                }
+            }
+        }
+        this.trace('hookBridge.evaluate.no-match', {
+            toolName: params.toolName,
+            toolCallId: params.toolCallId ?? null,
+        });
+        return undefined;
+    }
+    observeAgentStatus(event) {
+        if (event.type !== 'agent.status' || !event.agentId) {
+            return;
+        }
+        const status = (0, hook_bridge_utils_1.readPath)(event, 'data.status');
+        if (typeof status === 'string' && status.trim()) {
+            this.parentStatusByAgent.set(event.agentId, status);
+        }
+    }
+    canTrigger(rule) {
+        if (!rule.cooldownMs || rule.cooldownMs <= 0) {
+            return true;
+        }
+        const lastTriggeredAt = this.lastTriggerByRule.get(rule.id);
+        if (!lastTriggeredAt) {
+            return true;
+        }
+        return Date.now() - lastTriggeredAt >= rule.cooldownMs;
+    }
+    cleanupToolGuardState(nowMs, retryBackoffMs) {
+        for (const [key, cached] of this.approvalCacheByScope.entries()) {
+            if (cached.expiresAtMs <= nowMs) {
+                this.approvalCacheByScope.delete(key);
+            }
+        }
+        if (retryBackoffMs <= 0) {
+            this.blockedRetryStateByScope.clear();
+            return;
+        }
+        for (const [key, blocked] of this.blockedRetryStateByScope.entries()) {
+            if (nowMs - blocked.blockedAtMs >= retryBackoffMs) {
+                this.blockedRetryStateByScope.delete(key);
+            }
+        }
+    }
+    recordToolGuardDecision(scopeKey, outcome, guardConfig, nowMs) {
+        if (outcome.block) {
+            this.blockedRetryStateByScope.set(scopeKey, {
+                blockedAtMs: nowMs,
+                reason: outcome.blockReason,
+            });
+            return;
+        }
+        if (guardConfig.approvalCacheTtlMs <= 0) {
+            return;
+        }
+        this.approvalCacheByScope.set(scopeKey, {
+            expiresAtMs: nowMs + guardConfig.approvalCacheTtlMs,
+            decision: {
+                block: false,
+                params: outcome.params,
+            },
+            ruleId: outcome.matchedRuleId,
+            actionId: outcome.matchedActionId,
+        });
+    }
+}
+exports.HookBridge = HookBridge;
+function createHookBridge(config, logger) {
+    if (!config.hookBridge.enabled && !config.hookBridge.toolGuard.enabled) {
+        return undefined;
+    }
+    return new HookBridge(config.hookBridge, logger);
+}
+//# sourceMappingURL=hook-bridge.js.map

package/dist/runtime/hook-bridge.js.map

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

package/dist/runtime/internal-handlers.d.ts

@@ -0,0 +1,20 @@
+import { PluginState } from './types';
+import { RuntimeEventOps } from './runtime-events';
+interface InternalHandlersDeps {
+    state: PluginState;
+    ops: RuntimeEventOps;
+}
+export declare function createInternalHandlers(deps: InternalHandlersDeps): {
+    handleMessageReceived: (hookEvent: unknown) => Promise<void>;
+    handleMessageTranscribed: (hookEvent: unknown) => Promise<void>;
+    handleMessagePreprocessed: (hookEvent: unknown) => Promise<void>;
+    handleMessageSent: (hookEvent: unknown) => Promise<void>;
+    handleCommand: (action: "new" | "reset" | "stop", hookEvent: unknown) => Promise<void>;
+    handleAgentBootstrap: (hookEvent: unknown) => Promise<void>;
+    handleAgentError: (hookEvent: unknown) => Promise<void>;
+    handleAgentSessionEvent: (type: "agent.session_start" | "agent.session_end", hookEvent: unknown) => Promise<void>;
+    handleGatewayStartup: (hookEvent: unknown) => Promise<void>;
+};
+export type InternalHandlers = ReturnType<typeof createInternalHandlers>;
+export {};
+//# sourceMappingURL=internal-handlers.d.ts.map

package/dist/runtime/internal-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-handlers.d.ts","sourceRoot":"","sources":["../../src/runtime/internal-handlers.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAWnD,UAAU,oBAAoB;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,eAAe,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB;uCAGf,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;0CAqBpB,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;2CAqBtB,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;mCAqB/B,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;4BAqB9B,KAAK,GAAG,OAAO,GAAG,MAAM,aAAa,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;sCAqClD,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;kCA4B3B,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;oCAkC1D,qBAAqB,GAAG,mBAAmB,aACtC,OAAO,KACjB,OAAO,CAAC,IAAI,CAAC;sCAiC+B,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;EAsBvE;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/runtime/internal-handlers.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInternalHandlers = createInternalHandlers;
+const message_hooks_1 = require("../hooks/message-hooks");
+const command_hooks_1 = require("../hooks/command-hooks");
+const agent_hooks_1 = require("../hooks/agent-hooks");
+const gateway_hooks_1 = require("../hooks/gateway-hooks");
+const utils_1 = require("./utils");
+function createInternalHandlers(deps) {
+    const { state, ops } = deps;
+    async function handleMessageReceived(hookEvent) {
+        const event = (0, message_hooks_1.fromOpenClawMessageReceived)(hookEvent);
+        if (!event) {
+            return;
+        }
+        await ops.broadcastEvent(event);
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : undefined;
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: event.sessionId ?? sessionRefs.sessionId,
+            sessionKey: event.sessionKey ?? sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'message.received',
+            activity: 'Message Received',
+            activityDetail: 'Inbound message accepted by agent pipeline',
+        });
+    }
+    async function handleMessageTranscribed(hookEvent) {
+        const event = (0, message_hooks_1.fromOpenClawMessageTranscribed)(hookEvent);
+        if (!event) {
+            return;
+        }
+        await ops.broadcastEvent(event);
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : undefined;
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: event.sessionId ?? sessionRefs.sessionId,
+            sessionKey: event.sessionKey ?? sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'message.transcribed',
+            activity: 'Transcribing Message',
+            activityDetail: 'Inbound message transcription completed',
+        });
+    }
+    async function handleMessagePreprocessed(hookEvent) {
+        const event = (0, message_hooks_1.fromOpenClawMessagePreprocessed)(hookEvent);
+        if (!event) {
+            return;
+        }
+        await ops.broadcastEvent(event);
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : undefined;
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: event.sessionId ?? sessionRefs.sessionId,
+            sessionKey: event.sessionKey ?? sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'message.preprocessed',
+            activity: 'Processing Message',
+            activityDetail: 'Inbound message preprocessing complete',
+        });
+    }
+    async function handleMessageSent(hookEvent) {
+        const event = (0, message_hooks_1.fromOpenClawMessageSent)(hookEvent);
+        if (!event) {
+            return;
+        }
+        await ops.broadcastEvent(event);
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : undefined;
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: event.sessionId ?? sessionRefs.sessionId,
+            sessionKey: event.sessionKey ?? sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'message.sent',
+            activity: 'Response Sent',
+            activityDetail: 'Outbound message delivered',
+        });
+    }
+    async function handleCommand(action, hookEvent) {
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : {};
+        const context = (0, utils_1.readObject)(raw.context) ?? {};
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        const typeMap = {
+            new: 'command.new',
+            reset: 'command.reset',
+            stop: 'command.stop',
+        };
+        const commandEvent = (0, command_hooks_1.createCommandEvent)({
+            type: typeMap[action],
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            agentId,
+            commandSource: (0, utils_1.readString)(context.commandSource),
+            senderId: (0, utils_1.readString)(context.senderId),
+            data: context,
+        });
+        await ops.broadcastEvent(commandEvent);
+        if (!agentId) {
+            return;
+        }
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: commandEvent.correlationId,
+            sourceEventType: typeMap[action],
+            activity: `Command ${action.toUpperCase()}`,
+            activityDetail: `Processed /${action} command`,
+        });
+    }
+    async function handleAgentBootstrap(hookEvent) {
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : {};
+        const context = (0, utils_1.readObject)(raw.context) ?? {};
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        const bootstrapEvent = (0, agent_hooks_1.createAgentBootstrapEvent)({
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            agentId,
+            data: context,
+        });
+        await ops.broadcastEvent(bootstrapEvent);
+        if (!agentId) {
+            return;
+        }
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: bootstrapEvent.correlationId,
+            sourceEventType: 'agent.bootstrap',
+            activity: 'Bootstrapping',
+            activityDetail: 'Agent bootstrap hook executed',
+        });
+    }
+    async function handleAgentError(hookEvent) {
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : {};
+        const context = (0, utils_1.readObject)(raw.context) ?? {};
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        const message = (0, utils_1.readString)(context.error) ??
+            (0, utils_1.readString)(raw.error) ??
+            (0, utils_1.readString)(context.message) ??
+            'Agent error';
+        const errorEvent = (0, agent_hooks_1.createAgentErrorEvent)({
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            agentId,
+            error: message,
+            stack: (0, utils_1.readString)(context.stack) ?? (0, utils_1.readString)(raw.stack),
+            data: context,
+        });
+        await ops.broadcastEvent(errorEvent);
+        if (!agentId) {
+            return;
+        }
+        const classification = (0, utils_1.classifyAgentError)(message);
+        if (classification === 'offline') {
+            state.statusReducer.markAgentOffline(agentId, true);
+        }
+        else {
+            state.statusReducer.markAgentError(agentId, true);
+        }
+        await ops.emitAgentStatusTransitions('agent.error');
+    }
+    async function handleAgentSessionEvent(type, hookEvent) {
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : {};
+        const context = (0, utils_1.readObject)(raw.context) ?? {};
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, sessionRefs });
+        const event = (0, agent_hooks_1.createAgentSessionEvent)({
+            type,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            agentId,
+            data: context,
+        });
+        await ops.broadcastEvent(event);
+        if (!agentId) {
+            return;
+        }
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: type,
+            activity: type === 'agent.session_start' ? 'Agent Session Start' : 'Agent Session End',
+            activityDetail: type === 'agent.session_start'
+                ? 'Agent session lifecycle started'
+                : 'Agent session lifecycle ended',
+        });
+    }
+    async function handleGatewayStartup(hookEvent) {
+        const raw = (0, utils_1.isRecord)(hookEvent) ? hookEvent : {};
+        const context = (0, utils_1.readObject)(raw.context) ?? {};
+        const event = (0, gateway_hooks_1.createGatewayStartupEvent)({
+            port: (0, utils_1.readNumber)(context.port),
+            data: context,
+        });
+        await ops.broadcastEvent(event);
+        ops.maybeInitializeQueue();
+    }
+    return {
+        handleMessageReceived,
+        handleMessageTranscribed,
+        handleMessagePreprocessed,
+        handleMessageSent,
+        handleCommand,
+        handleAgentBootstrap,
+        handleAgentError,
+        handleAgentSessionEvent,
+        handleGatewayStartup,
+    };
+}
+//# sourceMappingURL=internal-handlers.js.map

package/dist/runtime/internal-handlers.js.map

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

package/dist/runtime/register-gateway-hooks.d.ts

@@ -0,0 +1,4 @@
+import type { OpenClawPluginApi } from './types';
+import type { TypedHookDeps } from './typed-hooks';
+export declare function registerGatewayTypedHooks(api: OpenClawPluginApi, deps: TypedHookDeps): void;
+//# sourceMappingURL=register-gateway-hooks.d.ts.map

package/dist/runtime/register-gateway-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-gateway-hooks.d.ts","sourceRoot":"","sources":["../../src/runtime/register-gateway-hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAkC3F"}