openclaw-event-server-plugin 1.0.0

package/dist/runtime/register-gateway-hooks.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGatewayTypedHooks = registerGatewayTypedHooks;
+const gateway_hooks_1 = require("../hooks/gateway-hooks");
+const utils_1 = require("./utils");
+function registerGatewayTypedHooks(api, deps) {
+    const { state, logger, ops } = deps;
+    (0, utils_1.registerTypedHook)(logger, api, 'gateway_start', { name: 'event-plugin.gateway-start', description: 'Broadcast gateway.start events' }, async (rawEvent) => {
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : {};
+        const event = (0, gateway_hooks_1.createGatewayPluginStartEvent)({
+            port: (0, utils_1.readNumber)(raw.port),
+            data: raw,
+        });
+        await ops.broadcastEvent(event);
+    });
+    (0, utils_1.registerTypedHook)(logger, api, 'gateway_stop', { name: 'event-plugin.gateway-stop', description: 'Broadcast gateway.stop events' }, async (rawEvent) => {
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : {};
+        const event = (0, gateway_hooks_1.createGatewayPluginStopEvent)({
+            reason: (0, utils_1.readString)(raw.reason),
+            data: raw,
+        });
+        await ops.broadcastEvent(event);
+        state.statusReducer.markAllOffline();
+        await ops.emitAgentStatusTransitions('gateway.stop');
+    });
+}
+//# sourceMappingURL=register-gateway-hooks.js.map

package/dist/runtime/register-gateway-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-gateway-hooks.js","sourceRoot":"","sources":["../../src/runtime/register-gateway-hooks.ts"],"names":[],"mappings":";;AAKA,8DAkCC;AAvCD,0DAAqG;AAGrG,mCAA8E;AAE9E,SAAgB,yBAAyB,CAAC,GAAsB,EAAE,IAAmB;IACnF,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEpC,IAAA,yBAAiB,EACf,MAAM,EACN,GAAG,EACH,eAAe,EACf,EAAE,IAAI,EAAE,4BAA4B,EAAE,WAAW,EAAE,gCAAgC,EAAE,EACrF,KAAK,EAAE,QAAQ,EAAE,EAAE;QACjB,MAAM,GAAG,GAAG,IAAA,gBAAQ,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAA,6CAA6B,EAAC;YAC1C,IAAI,EAAE,IAAA,kBAAU,EAAC,GAAG,CAAC,IAAI,CAAC;YAC1B,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CACF,CAAC;IAEF,IAAA,yBAAiB,EACf,MAAM,EACN,GAAG,EACH,cAAc,EACd,EAAE,IAAI,EAAE,2BAA2B,EAAE,WAAW,EAAE,+BAA+B,EAAE,EACnF,KAAK,EAAE,QAAQ,EAAE,EAAE;QACjB,MAAM,GAAG,GAAG,IAAA,gBAAQ,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAA,4CAA4B,EAAC;YACzC,MAAM,EAAE,IAAA,kBAAU,EAAC,GAAG,CAAC,MAAM,CAAC;YAC9B,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC;QACrC,MAAM,GAAG,CAAC,0BAA0B,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/runtime/register-session-hooks.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSessionHooks = registerSessionHooks;
+const session_hooks_1 = require("../hooks/session-hooks");
+const utils_1 = require("./utils");
+function registerSessionHooks(api, deps) {
+    const { state, logger, ops } = deps;
+    (0, utils_1.registerTypedHook)(logger, api, 'session_start', { name: 'event-plugin.session-start', description: 'Broadcast session.start events' }, async (rawEvent, rawCtx) => {
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : {};
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const sessionId = (0, utils_1.readString)(raw.sessionId) ?? (0, utils_1.readString)(ctx?.sessionId);
+        if (!sessionId) {
+            return;
+        }
+        const sessionKey = (0, utils_1.readString)(raw.sessionKey) ?? (0, utils_1.readString)(ctx?.sessionKey);
+        const agentId = (0, utils_1.resolveAgentId)({
+            sessionTracker: state.sessionTracker,
+            hookEvent: raw,
+            ctx,
+            sessionRefs: { sessionId, sessionKey },
+        });
+        state.sessionTracker.startSession({
+            sessionId,
+            sessionKey,
+            agentId,
+        });
+        const event = (0, session_hooks_1.createSessionStartEvent)({
+            sessionId,
+            sessionKey,
+            agentId,
+            resumedFrom: (0, utils_1.readString)(raw.resumedFrom),
+        });
+        await ops.broadcastEvent(event);
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId,
+            sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'session.start',
+            activity: 'Session Started',
+            activityDetail: 'Agent session lifecycle started',
+        });
+    });
+    (0, utils_1.registerTypedHook)(logger, api, 'session_end', { name: 'event-plugin.session-end', description: 'Broadcast session.end events' }, async (rawEvent, rawCtx) => {
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : {};
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const sessionId = (0, utils_1.readString)(raw.sessionId) ?? (0, utils_1.readString)(ctx?.sessionId);
+        if (!sessionId) {
+            return;
+        }
+        const sessionKey = (0, utils_1.readString)(raw.sessionKey) ?? (0, utils_1.readString)(ctx?.sessionKey);
+        const ended = state.sessionTracker.endSession(sessionId) ??
+            state.sessionTracker.endSession(sessionKey ?? '');
+        const agentId = ended?.agentId ??
+            (0, utils_1.resolveAgentId)({
+                sessionTracker: state.sessionTracker,
+                hookEvent: raw,
+                ctx,
+                sessionRefs: { sessionId, sessionKey },
+            });
+        if (agentId) {
+            state.statusReducer.removeSession(agentId, (0, utils_1.resolveSessionRefForStatus)(sessionId, sessionKey));
+        }
+        const event = (0, session_hooks_1.createSessionEndEvent)({
+            sessionId,
+            sessionKey,
+            agentId,
+            messageCount: (0, utils_1.readNumber)(raw.messageCount),
+            durationMs: (0, utils_1.readNumber)(raw.durationMs) ?? ended?.durationMs,
+        });
+        await ops.broadcastEvent(event);
+        if (agentId) {
+            await ops.emitAgentActivity({
+                agentId,
+                sessionId,
+                sessionKey,
+                correlationId: event.correlationId,
+                sourceEventType: 'session.end',
+                activity: 'Session Ended',
+                activityDetail: 'Agent session lifecycle ended',
+            });
+        }
+        else {
+            await ops.emitAgentStatusTransitions('session.end');
+        }
+    });
+}
+//# sourceMappingURL=register-session-hooks.js.map

package/dist/runtime/register-session-hooks.js.map

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

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

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

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

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

package/dist/runtime/register-subagent-hooks.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSubagentHooks = registerSubagentHooks;
+const agent_hooks_1 = require("../hooks/agent-hooks");
+const subagent_hooks_1 = require("../hooks/subagent-hooks");
+const utils_1 = require("./utils");
+function registerSubagentHooks(api, deps) {
+    const { state, logger, ops } = deps;
+    (0, utils_1.registerTypedHook)(logger, api, 'subagent_spawning', { name: 'event-plugin.subagent-spawning', description: 'Broadcast subagent.spawning events' }, async (rawEvent, rawCtx) => {
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : {};
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw, ctx);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, ctx, sessionRefs }) ??
+            (0, utils_1.readString)(raw.agentId);
+        const event = (0, subagent_hooks_1.createSubagentSpawningEvent)({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            runId: (0, utils_1.readString)(raw.runId) ?? (0, utils_1.readString)(ctx?.runId),
+            childSessionKey: (0, utils_1.readString)(raw.childSessionKey),
+            data: {
+                ...raw,
+                parentAgentId: agentId,
+                parentSessionId: sessionRefs.sessionId,
+                parentSessionKey: sessionRefs.sessionKey,
+                childAgentId: (0, utils_1.readString)(raw.agentId),
+                childSessionKey: (0, utils_1.readString)(raw.childSessionKey),
+            },
+        });
+        await ops.broadcastEvent(event);
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'subagent.spawning',
+            activity: 'Spawning Subagent',
+            activityDetail: 'Subagent spawn requested',
+        });
+    });
+    (0, utils_1.registerTypedHook)(logger, api, 'subagent_spawned', { name: 'event-plugin.subagent-spawned', description: 'Broadcast subagent.spawned events' }, async (rawEvent, rawCtx) => {
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : {};
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw, ctx);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, ctx, sessionRefs }) ??
+            (0, utils_1.readString)(raw.agentId);
+        const runId = (0, utils_1.readString)(raw.runId) ?? (0, utils_1.readString)(ctx?.runId);
+        const childSessionKey = (0, utils_1.readString)(raw.childSessionKey);
+        const event = (0, subagent_hooks_1.createSubagentSpawnedEvent)({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            runId,
+            childSessionKey,
+            data: {
+                ...raw,
+                parentAgentId: agentId,
+                parentSessionId: sessionRefs.sessionId,
+                parentSessionKey: sessionRefs.sessionKey,
+                childAgentId: (0, utils_1.readString)(raw.agentId),
+                childSessionKey,
+            },
+        });
+        await ops.broadcastEvent(event);
+        const synthetic = (0, agent_hooks_1.createAgentSubAgentSpawnEvent)({
+            parentAgentId: agentId,
+            parentSessionId: sessionRefs.sessionId,
+            parentSessionKey: sessionRefs.sessionKey,
+            childAgentId: (0, utils_1.readString)(raw.agentId),
+            childSessionKey,
+            runId,
+            mode: (0, utils_1.readString)(raw.mode),
+            data: raw,
+        });
+        await ops.broadcastEvent(synthetic);
+        if (childSessionKey) {
+            state.subagentTracker.registerSpawn({
+                childSessionKey,
+                parentAgentId: agentId,
+                parentSessionId: sessionRefs.sessionId,
+                parentSessionKey: sessionRefs.sessionKey,
+                childAgentId: (0, utils_1.readString)(raw.agentId),
+                runId,
+                mode: (0, utils_1.readString)(raw.mode),
+            });
+            state.sessionTracker.touchSession({
+                sessionKey: childSessionKey,
+                agentId: (0, utils_1.readString)(raw.agentId),
+            });
+        }
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'subagent.spawned',
+            activity: 'Subagent Spawned',
+            activityDetail: 'Subagent successfully spawned',
+        });
+    });
+    (0, utils_1.registerTypedHook)(logger, api, 'subagent_ended', { name: 'event-plugin.subagent-ended', description: 'Broadcast subagent.ended events' }, async (rawEvent, rawCtx) => {
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : {};
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw, ctx);
+        const agentId = (0, utils_1.resolveAgentId)({ sessionTracker: state.sessionTracker, hookEvent: raw, ctx, sessionRefs }) ??
+            (0, utils_1.readString)(raw.agentId);
+        const childSessionKey = (0, utils_1.readString)(raw.targetSessionKey) ?? (0, utils_1.readString)(raw.childSessionKey);
+        const event = (0, subagent_hooks_1.createSubagentEndedEvent)({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            runId: (0, utils_1.readString)(raw.runId) ?? (0, utils_1.readString)(ctx?.runId),
+            childSessionKey,
+            data: {
+                ...raw,
+                parentAgentId: agentId,
+                parentSessionId: sessionRefs.sessionId,
+                parentSessionKey: sessionRefs.sessionKey,
+                childAgentId: (0, utils_1.readString)(raw.agentId),
+                childSessionKey,
+            },
+        });
+        await ops.broadcastEvent(event);
+        if (childSessionKey) {
+            state.subagentTracker.markEnded(childSessionKey);
+            const childAgent = state.sessionTracker.getAgentIdBySession({ sessionKey: childSessionKey });
+            if (childAgent) {
+                state.statusReducer.removeSession(childAgent, childSessionKey);
+            }
+            state.sessionTracker.endSession(childSessionKey);
+        }
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: event.correlationId,
+            sourceEventType: 'subagent.ended',
+            activity: 'Subagent Ended',
+            activityDetail: 'Subagent lifecycle ended',
+        });
+    });
+}
+//# sourceMappingURL=register-subagent-hooks.js.map

package/dist/runtime/register-subagent-hooks.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-tool-hooks.d.ts","sourceRoot":"","sources":["../../src/runtime/register-tool-hooks.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAiCnD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CA4XnF"}

package/dist/runtime/register-tool-hooks.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerToolHooks = registerToolHooks;
+const tool_hooks_1 = require("../hooks/tool-hooks");
+const redaction_1 = require("../events/redaction");
+const utils_1 = require("./utils");
+const TOOL_GUARD_TRACE = process.env.EVENT_PLUGIN_TOOL_GUARD_TRACE === '1' ||
+    process.env.EVENT_PLUGIN_TOOL_GUARD_TRACE === 'true';
+function traceToolGuard(logger, ...args) {
+    if (!TOOL_GUARD_TRACE) {
+        return;
+    }
+    logger.info('[ToolGuardTrace]', ...args);
+}
+function buildBlockedParamsPatch(params) {
+    const patch = { __toolGuardBlocked: true };
+    for (const key of Object.keys(params)) {
+        patch[key] = null;
+    }
+    return patch;
+}
+function registerToolHooks(api, deps) {
+    const { state, logger, ops } = deps;
+    (0, utils_1.registerTypedHookWithResult)(logger, api, 'before_tool_call', {
+        name: 'event-plugin.before-tool-call',
+        description: 'Broadcast tool.called events and optionally apply hookBridge tool guard',
+        // Run late so block/params decisions are not overridden by other hooks.
+        priority: -10000,
+    }, async (rawEvent, rawCtx) => {
+        const event = (0, utils_1.toToolHookEvent)(rawEvent);
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : undefined;
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw, ctx);
+        const agentId = (0, utils_1.resolveAgentId)({
+            sessionTracker: state.sessionTracker,
+            hookEvent: raw,
+            ctx,
+            sessionRefs,
+        });
+        const toolName = (0, utils_1.readString)(event.toolName) ?? (0, utils_1.readString)(ctx?.toolName) ?? 'unknown';
+        const params = (0, utils_1.readObject)(event.params) ?? {};
+        const redactedGuardParams = (0, redaction_1.redactPayload)(params, state.config.hookBridge.toolGuard.redaction);
+        const runId = (0, utils_1.readString)(event.runId) ?? (0, utils_1.readString)(ctx?.runId);
+        const toolCallId = (0, utils_1.readString)(event.toolCallId) ?? (0, utils_1.readString)(ctx?.toolCallId);
+        const subagent = state.subagentTracker.getByChildSessionKey(sessionRefs.sessionKey);
+        traceToolGuard(logger, 'before_tool_call.in', {
+            toolName,
+            toolCallId: toolCallId ?? null,
+            runId: runId ?? null,
+            agentId: agentId ?? null,
+            sessionId: sessionRefs.sessionId ?? null,
+            sessionKey: sessionRefs.sessionKey ?? null,
+        });
+        const guardDecision = await state.hookBridge?.evaluateBeforeToolCall({
+            toolName,
+            params,
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            runId,
+            toolCallId,
+        });
+        traceToolGuard(logger, 'before_tool_call.guardDecision', {
+            toolName,
+            toolCallId: toolCallId ?? null,
+            decision: guardDecision ?? null,
+        });
+        if (agentId !== undefined ||
+            sessionRefs.sessionId !== undefined ||
+            sessionRefs.sessionKey !== undefined) {
+            state.sessionTracker.touchSession({
+                sessionId: sessionRefs.sessionId,
+                sessionKey: sessionRefs.sessionKey,
+                agentId,
+            });
+        }
+        const calledEvent = (0, tool_hooks_1.createToolCalledEvent)({
+            toolName,
+            params,
+            agentId,
+            parentAgentId: subagent?.parentAgentId,
+            subagentKey: subagent?.subagentKey,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            parentSessionId: subagent?.parentSessionId,
+            parentSessionKey: subagent?.parentSessionKey,
+            runId,
+            toolCallId,
+        });
+        await ops.broadcastEvent(calledEvent);
+        const callId = state.toolTracker.startCall(toolName, params, {
+            runId,
+            toolCallId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            agentId,
+            correlationId: calledEvent.correlationId,
+        });
+        const pending = {
+            callId,
+            correlationId: calledEvent.correlationId,
+            agentId,
+        };
+        if (toolCallId) {
+            state.pendingToolCalls.set(toolCallId, pending);
+        }
+        if (ctx) {
+            state.pendingToolCallsByContext.set(ctx, pending);
+        }
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: calledEvent.correlationId,
+            sourceEventType: 'tool.called',
+            activity: 'Using Tool',
+            activityDetail: `Calling tool: ${toolName}`,
+            toolName,
+            toolStatus: 'called',
+        });
+        if (guardDecision?.matched) {
+            await ops.broadcastEvent((0, tool_hooks_1.createToolGuardEvent)({
+                type: 'tool.guard.matched',
+                toolName,
+                params: redactedGuardParams,
+                blockReason: guardDecision.blockReason,
+                matchedRuleId: guardDecision.matchedRuleId,
+                matchedActionId: guardDecision.matchedActionId,
+                decisionSource: guardDecision.decisionSource,
+                agentId,
+                parentAgentId: subagent?.parentAgentId,
+                subagentKey: subagent?.subagentKey,
+                sessionId: sessionRefs.sessionId,
+                sessionKey: sessionRefs.sessionKey,
+                parentSessionId: subagent?.parentSessionId,
+                parentSessionKey: subagent?.parentSessionKey,
+                runId,
+                toolCallId,
+                correlationId: calledEvent.correlationId,
+            }));
+        }
+        if (guardDecision?.block) {
+            const blockedParamsPatch = buildBlockedParamsPatch(params);
+            traceToolGuard(logger, 'before_tool_call.return.block', {
+                toolName,
+                toolCallId: toolCallId ?? null,
+                blockReason: guardDecision.blockReason ?? null,
+                matchedRuleId: guardDecision.matchedRuleId ?? null,
+                matchedActionId: guardDecision.matchedActionId ?? null,
+                decisionSource: guardDecision.decisionSource ?? null,
+            });
+            await ops.broadcastEvent((0, tool_hooks_1.createToolGuardEvent)({
+                type: 'tool.guard.blocked',
+                toolName,
+                params: (0, redaction_1.redactPayload)({
+                    ...params,
+                    ...blockedParamsPatch,
+                }, state.config.hookBridge.toolGuard.redaction),
+                blockReason: guardDecision.blockReason,
+                matchedRuleId: guardDecision.matchedRuleId,
+                matchedActionId: guardDecision.matchedActionId,
+                decisionSource: guardDecision.decisionSource,
+                agentId,
+                parentAgentId: subagent?.parentAgentId,
+                subagentKey: subagent?.subagentKey,
+                sessionId: sessionRefs.sessionId,
+                sessionKey: sessionRefs.sessionKey,
+                parentSessionId: subagent?.parentSessionId,
+                parentSessionKey: subagent?.parentSessionKey,
+                runId,
+                toolCallId,
+                correlationId: calledEvent.correlationId,
+            }));
+            return {
+                block: true,
+                blockReason: guardDecision.blockReason,
+                // Defense in depth: if another hook later overwrites block=false in this runtime,
+                // this param patch still causes tool argument validation/execution to fail closed.
+                params: blockedParamsPatch,
+            };
+        }
+        if (guardDecision?.params) {
+            traceToolGuard(logger, 'before_tool_call.return.params', {
+                toolName,
+                toolCallId: toolCallId ?? null,
+                matchedRuleId: guardDecision.matchedRuleId ?? null,
+                matchedActionId: guardDecision.matchedActionId ?? null,
+                decisionSource: guardDecision.decisionSource ?? null,
+            });
+            await ops.broadcastEvent((0, tool_hooks_1.createToolGuardEvent)({
+                type: 'tool.guard.allowed',
+                toolName,
+                params: (0, redaction_1.redactPayload)(guardDecision.params, state.config.hookBridge.toolGuard.redaction),
+                matchedRuleId: guardDecision.matchedRuleId,
+                matchedActionId: guardDecision.matchedActionId,
+                decisionSource: guardDecision.decisionSource,
+                agentId,
+                parentAgentId: subagent?.parentAgentId,
+                subagentKey: subagent?.subagentKey,
+                sessionId: sessionRefs.sessionId,
+                sessionKey: sessionRefs.sessionKey,
+                parentSessionId: subagent?.parentSessionId,
+                parentSessionKey: subagent?.parentSessionKey,
+                runId,
+                toolCallId,
+                correlationId: calledEvent.correlationId,
+            }));
+            return {
+                params: guardDecision.params,
+            };
+        }
+        if (guardDecision?.matched) {
+            await ops.broadcastEvent((0, tool_hooks_1.createToolGuardEvent)({
+                type: 'tool.guard.allowed',
+                toolName,
+                params: redactedGuardParams,
+                matchedRuleId: guardDecision.matchedRuleId,
+                matchedActionId: guardDecision.matchedActionId,
+                decisionSource: guardDecision.decisionSource,
+                agentId,
+                parentAgentId: subagent?.parentAgentId,
+                subagentKey: subagent?.subagentKey,
+                sessionId: sessionRefs.sessionId,
+                sessionKey: sessionRefs.sessionKey,
+                parentSessionId: subagent?.parentSessionId,
+                parentSessionKey: subagent?.parentSessionKey,
+                runId,
+                toolCallId,
+                correlationId: calledEvent.correlationId,
+            }));
+        }
+        traceToolGuard(logger, 'before_tool_call.return.none', {
+            toolName,
+            toolCallId: toolCallId ?? null,
+        });
+        return undefined;
+    });
+    (0, utils_1.registerTypedHook)(logger, api, 'after_tool_call', { name: 'event-plugin.after-tool-call', description: 'Broadcast tool.completed/tool.error events' }, async (rawEvent, rawCtx) => {
+        const event = (0, utils_1.toToolHookEvent)(rawEvent);
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : undefined;
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw, ctx);
+        const toolCallId = (0, utils_1.readString)(event.toolCallId) ?? (0, utils_1.readString)(ctx?.toolCallId);
+        const pendingById = toolCallId ? state.pendingToolCalls.get(toolCallId) : undefined;
+        const pendingByContext = ctx ? state.pendingToolCallsByContext.get(ctx) : undefined;
+        const pending = pendingById ?? pendingByContext;
+        const callInfo = pending ? state.toolTracker.endCall(pending.callId) : null;
+        if (toolCallId) {
+            state.pendingToolCalls.delete(toolCallId);
+        }
+        if (ctx) {
+            state.pendingToolCallsByContext.delete(ctx);
+        }
+        const agentId = pending?.agentId ??
+            (0, utils_1.resolveAgentId)({
+                sessionTracker: state.sessionTracker,
+                hookEvent: raw,
+                ctx,
+                sessionRefs,
+            });
+        const toolName = callInfo?.toolName ?? (0, utils_1.readString)(event.toolName) ?? (0, utils_1.readString)(ctx?.toolName) ?? 'unknown';
+        const runId = callInfo?.runId ?? (0, utils_1.readString)(event.runId) ?? (0, utils_1.readString)(ctx?.runId);
+        const correlationId = pending?.correlationId ?? callInfo?.correlationId;
+        const subagent = state.subagentTracker.getByChildSessionKey(callInfo?.sessionKey ?? sessionRefs.sessionKey);
+        const normalizedError = event.error !== undefined && event.error !== null ? (0, utils_1.normalizeError)(event.error) : undefined;
+        const toolEvent = normalizedError
+            ? (0, tool_hooks_1.createToolErrorEvent)({
+                toolName,
+                error: normalizedError.message,
+                stackTrace: normalizedError.stack,
+                params: callInfo?.params,
+                agentId,
+                parentAgentId: subagent?.parentAgentId,
+                subagentKey: subagent?.subagentKey,
+                sessionId: callInfo?.sessionId ?? sessionRefs.sessionId,
+                sessionKey: callInfo?.sessionKey ?? sessionRefs.sessionKey,
+                parentSessionId: subagent?.parentSessionId,
+                parentSessionKey: subagent?.parentSessionKey,
+                runId,
+                toolCallId: callInfo?.toolCallId ?? toolCallId,
+                correlationId,
+            })
+            : (0, tool_hooks_1.createToolCompletedEvent)({
+                toolName,
+                result: event.result,
+                durationMs: callInfo?.durationMs,
+                agentId,
+                parentAgentId: subagent?.parentAgentId,
+                subagentKey: subagent?.subagentKey,
+                sessionId: callInfo?.sessionId ?? sessionRefs.sessionId,
+                sessionKey: callInfo?.sessionKey ?? sessionRefs.sessionKey,
+                parentSessionId: subagent?.parentSessionId,
+                parentSessionKey: subagent?.parentSessionKey,
+                runId,
+                toolCallId: callInfo?.toolCallId ?? toolCallId,
+                correlationId,
+            });
+        await ops.broadcastEvent(toolEvent);
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: toolEvent.sessionId,
+            sessionKey: toolEvent.sessionKey,
+            correlationId: toolEvent.correlationId,
+            sourceEventType: toolEvent.type,
+            activity: toolEvent.type === 'tool.error' ? 'Tool Error' : 'Tool Completed',
+            activityDetail: toolEvent.type === 'tool.error' ? `Tool failed: ${toolName}` : `Tool completed: ${toolName}`,
+            toolName,
+            toolStatus: toolEvent.type === 'tool.error' ? 'error' : 'completed',
+        });
+    });
+    (0, utils_1.registerTypedHook)(logger, api, 'tool_result_persist', { name: 'event-plugin.tool-result-persist', description: 'Broadcast tool.result_persist events' }, async (rawEvent, rawCtx) => {
+        const event = (0, utils_1.toToolHookEvent)(rawEvent);
+        const ctx = (0, utils_1.toContext)(rawCtx);
+        const raw = (0, utils_1.isRecord)(rawEvent) ? rawEvent : undefined;
+        const sessionRefs = (0, utils_1.resolveSessionRefs)(raw, ctx);
+        const agentId = (0, utils_1.resolveAgentId)({
+            sessionTracker: state.sessionTracker,
+            hookEvent: raw,
+            ctx,
+            sessionRefs,
+        });
+        const subagent = state.subagentTracker.getByChildSessionKey(sessionRefs.sessionKey);
+        const persistEvent = (0, tool_hooks_1.createToolResultPersistEvent)({
+            toolName: (0, utils_1.readString)(event.toolName) ?? (0, utils_1.readString)(ctx?.toolName),
+            toolCallId: (0, utils_1.readString)(event.toolCallId) ?? (0, utils_1.readString)(ctx?.toolCallId),
+            message: event.message,
+            isSynthetic: typeof event.isSynthetic === 'boolean' ? event.isSynthetic : undefined,
+            agentId,
+            parentAgentId: subagent?.parentAgentId,
+            subagentKey: subagent?.subagentKey,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            parentSessionId: subagent?.parentSessionId,
+            parentSessionKey: subagent?.parentSessionKey,
+        });
+        await ops.broadcastEvent(persistEvent);
+        await ops.emitAgentActivity({
+            agentId,
+            sessionId: sessionRefs.sessionId,
+            sessionKey: sessionRefs.sessionKey,
+            correlationId: persistEvent.correlationId,
+            sourceEventType: 'tool.result_persist',
+            activity: 'Persisting Tool Result',
+            activityDetail: 'Tool result appended to transcript',
+        });
+    });
+}
+//# sourceMappingURL=register-tool-hooks.js.map