openclaw-event-server-plugin 1.0.0

package/dist/config/validate.d.ts

@@ -0,0 +1,17 @@
+import { PluginConfig } from './config-types';
+/**
+ * Validate configuration
+ */
+export declare function validateConfig(config: PluginConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Resolve runtime-only config values (for example, loading HMAC secret from file).
+ */
+export declare function resolveRuntimeConfig(config: PluginConfig): PluginConfig;
+/**
+ * Check if an event should be filtered out
+ */
+export declare function shouldFilterEvent(config: PluginConfig, eventType: string, channelId?: string, toolName?: string, sessionId?: string): boolean;
+//# sourceMappingURL=validate.d.ts.map

package/dist/config/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA6HzF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAqCvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CA+BT"}

package/dist/config/validate.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+exports.resolveRuntimeConfig = resolveRuntimeConfig;
+exports.shouldFilterEvent = shouldFilterEvent;
+const event_types_1 = require("./event-types");
+const helpers_1 = require("./helpers");
+const validate_hook_bridge_1 = require("./validate-hook-bridge");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+/**
+ * Validate configuration
+ */
+function validateConfig(config) {
+    const errors = [];
+    // Validate webhooks
+    if (config.webhooks && config.webhooks.length > 0) {
+        config.webhooks.forEach((webhook, index) => {
+            if (!webhook.url || webhook.url.trim() === '') {
+                errors.push(`Webhook ${index}: URL is required`);
+            }
+            else {
+                try {
+                    const parsedUrl = new URL(webhook.url);
+                    // Only allow http and https protocols for security
+                    if (parsedUrl.protocol !== 'http:' && parsedUrl.protocol !== 'https:') {
+                        errors.push(`Webhook ${index}: Only HTTP and HTTPS protocols are allowed`);
+                    }
+                }
+                catch {
+                    errors.push(`Webhook ${index}: Invalid URL format`);
+                }
+            }
+            // Validate HTTP method if specified
+            if (webhook.method && !['POST', 'PUT', 'PATCH'].includes(webhook.method)) {
+                errors.push(`Webhook ${index}: Invalid HTTP method. Must be POST, PUT, or PATCH`);
+            }
+        });
+    }
+    // Validate retry config
+    if (config.retry.maxAttempts < 0 || config.retry.maxAttempts > 10) {
+        errors.push('Retry maxAttempts must be between 0 and 10');
+    }
+    if (config.retry.initialDelayMs < 100 || config.retry.initialDelayMs > 10000) {
+        errors.push('Retry initialDelayMs must be between 100 and 10000');
+    }
+    if (config.retry.maxDelayMs < 1000 || config.retry.maxDelayMs > 300000) {
+        errors.push('Retry maxDelayMs must be between 1000 and 300000');
+    }
+    if (config.retry.backoffMultiplier < 1 || config.retry.backoffMultiplier > 5) {
+        errors.push('Retry backoffMultiplier must be between 1 and 5');
+    }
+    // Validate queue config
+    if (config.queue.maxSize < 10 || config.queue.maxSize > 10000) {
+        errors.push('Queue maxSize must be between 10 and 10000');
+    }
+    if (config.queue.flushIntervalMs < 100 || config.queue.flushIntervalMs > 60000) {
+        errors.push('Queue flushIntervalMs must be between 100 and 60000');
+    }
+    // Validate synthetic status config
+    if (config.status.workingWindowMs < 1000 || config.status.workingWindowMs > 120000) {
+        errors.push('Status workingWindowMs must be between 1000 and 120000');
+    }
+    if (config.status.sleepingWindowMs < 10000 || config.status.sleepingWindowMs > 86400000) {
+        errors.push('Status sleepingWindowMs must be between 10000 and 86400000');
+    }
+    if (config.status.sleepingWindowMs <= config.status.workingWindowMs) {
+        errors.push('Status sleepingWindowMs must be greater than workingWindowMs');
+    }
+    if (config.status.tickIntervalMs < 1000 || config.status.tickIntervalMs > 60000) {
+        errors.push('Status tickIntervalMs must be between 1000 and 60000');
+    }
+    if (config.status.subagentIdleWindowMs < 10000 || config.status.subagentIdleWindowMs > 86400000) {
+        errors.push('Status subagentIdleWindowMs must be between 10000 and 86400000');
+    }
+    // Validate redaction config
+    if (!config.redaction.replacement || config.redaction.replacement.trim() === '') {
+        errors.push('Redaction replacement cannot be empty');
+    }
+    if (!Array.isArray(config.redaction.fields)) {
+        errors.push('Redaction fields must be an array');
+    }
+    else if (config.redaction.fields.some((field) => field.trim() === '')) {
+        errors.push('Redaction fields cannot contain empty values');
+    }
+    // Validate event log config
+    if (!config.eventLog.path || config.eventLog.path.trim() === '') {
+        errors.push('Event log path cannot be empty');
+    }
+    if (!['full-json', 'summary'].includes(config.eventLog.format)) {
+        errors.push('Event log format must be full-json or summary');
+    }
+    if (!['debug', 'info', 'warn', 'error'].includes(config.eventLog.minLevel)) {
+        errors.push('Event log minLevel must be debug, info, warn, or error');
+    }
+    if (config.eventLog.maxFileSizeMb < 1 || config.eventLog.maxFileSizeMb > 1024) {
+        errors.push('Event log maxFileSizeMb must be between 1 and 1024');
+    }
+    // Validate WS security config
+    if (!config.security.ws.bindAddress || config.security.ws.bindAddress.trim() === '') {
+        errors.push('Security ws.bindAddress cannot be empty');
+    }
+    if (config.security.ws.requireAuth && (!config.security.ws.authToken || config.security.ws.authToken.trim() === '')) {
+        errors.push('Security ws.authToken is required when ws.requireAuth is true');
+    }
+    // Validate HMAC config
+    if (config.security.hmac.enabled && (!config.security.hmac.secret || config.security.hmac.secret.trim() === '')) {
+        const secretFromFile = (0, helpers_1.loadSecretFromFile)(config.security.hmac.secretFilePath);
+        if (!secretFromFile) {
+            errors.push('Security hmac.secret or hmac.secretFilePath is required when hmac.enabled is true');
+        }
+    }
+    if (!['sha256', 'sha512'].includes(config.security.hmac.algorithm)) {
+        errors.push('Security hmac.algorithm must be sha256 or sha512');
+    }
+    // Validate timeout
+    if (config.webhookTimeoutMs < 1000 || config.webhookTimeoutMs > 60000) {
+        errors.push('Webhook timeout must be between 1000 and 60000 ms');
+    }
+    // Validate correlation ID header name
+    if (!config.correlationIdHeader || config.correlationIdHeader.trim() === '') {
+        errors.push('Correlation ID header name cannot be empty');
+    }
+    (0, validate_hook_bridge_1.validateHookBridgeConfig)(config, errors);
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Resolve runtime-only config values (for example, loading HMAC secret from file).
+ */
+function resolveRuntimeConfig(config) {
+    const resolveEventLogPath = (rawPath) => {
+        const trimmedPath = rawPath.trim();
+        if (trimmedPath === '' || (0, node_path_1.isAbsolute)(trimmedPath)) {
+            return rawPath;
+        }
+        const stateDir = process.env.OPENCLAW_STATE_DIR?.trim();
+        if (stateDir) {
+            return (0, node_path_1.resolve)(stateDir, trimmedPath);
+        }
+        const configPath = process.env.OPENCLAW_CONFIG_PATH?.trim();
+        if (configPath) {
+            return (0, node_path_1.resolve)((0, node_path_1.dirname)(configPath), trimmedPath);
+        }
+        return (0, node_path_1.resolve)((0, node_os_1.homedir)(), '.openclaw', trimmedPath);
+    };
+    const resolvedSecret = config.security.hmac.secret ?? (0, helpers_1.loadSecretFromFile)(config.security.hmac.secretFilePath);
+    return {
+        ...config,
+        eventLog: {
+            ...config.eventLog,
+            path: resolveEventLogPath(config.eventLog.path),
+        },
+        security: {
+            ...config.security,
+            hmac: {
+                ...config.security.hmac,
+                ...(resolvedSecret ? { secret: resolvedSecret } : {}),
+            },
+        },
+    };
+}
+/**
+ * Check if an event should be filtered out
+ */
+function shouldFilterEvent(config, eventType, channelId, toolName, sessionId) {
+    const { filters } = config;
+    // Check exclude types first
+    if ((0, event_types_1.isEventType)(eventType) && filters.excludeTypes?.includes(eventType)) {
+        return true;
+    }
+    // Check include types (if specified, only these are allowed)
+    if (filters.includeTypes?.length) {
+        if (!(0, event_types_1.isEventType)(eventType) || !filters.includeTypes.includes(eventType)) {
+            return true;
+        }
+    }
+    // Check channel filter
+    if (filters.channelId && filters.channelId !== channelId) {
+        return true;
+    }
+    // Check tool name filter
+    if (filters.toolName && filters.toolName !== toolName) {
+        return true;
+    }
+    // Check session filter
+    if (filters.sessionId && filters.sessionId !== sessionId) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=validate.js.map

package/dist/config/validate.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './redaction';
+export * from './signing';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./redaction"), exports);
+__exportStar(require("./signing"), exports);
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B"}

package/dist/events/redaction.d.ts

@@ -0,0 +1,5 @@
+import { RedactionConfig } from '../config/types';
+import { OpenClawEvent } from './types';
+export declare function redactPayload<T>(payload: T, config: Pick<RedactionConfig, 'enabled' | 'replacement' | 'fields'>): T;
+export declare function redactEvent(event: OpenClawEvent, config: RedactionConfig): OpenClawEvent;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/events/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/events/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAwCxC,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC,GAClE,CAAC,CAYH;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,aAAa,CAExF"}

package/dist/events/redaction.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactPayload = redactPayload;
+exports.redactEvent = redactEvent;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function normalizeFieldSet(fields) {
+    return new Set(fields.map((field) => field.trim().toLowerCase()).filter(Boolean));
+}
+function redactValue(value, sensitiveFields, replacement, seen) {
+    if (Array.isArray(value)) {
+        return value.map((item) => redactValue(item, sensitiveFields, replacement, seen));
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    if (seen.has(value)) {
+        return replacement;
+    }
+    seen.add(value);
+    const redacted = {};
+    for (const [key, nestedValue] of Object.entries(value)) {
+        if (sensitiveFields.has(key.toLowerCase())) {
+            redacted[key] = replacement;
+            continue;
+        }
+        redacted[key] = redactValue(nestedValue, sensitiveFields, replacement, seen);
+    }
+    return redacted;
+}
+function redactPayload(payload, config) {
+    if (!config.enabled) {
+        return payload;
+    }
+    const sensitiveFields = normalizeFieldSet(config.fields);
+    if (sensitiveFields.size === 0) {
+        return payload;
+    }
+    const redacted = redactValue(payload, sensitiveFields, config.replacement, new WeakSet());
+    return redacted;
+}
+function redactEvent(event, config) {
+    return redactPayload(event, config);
+}
+//# sourceMappingURL=redaction.js.map

package/dist/events/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/events/redaction.ts"],"names":[],"mappings":";;AAyCA,sCAeC;AAED,kCAEC;AAzDD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAgB;IACzC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,WAAW,CAClB,KAAc,EACd,eAA4B,EAC5B,WAAmB,EACnB,IAAqB;IAErB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEhB,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,aAAa,CAC3B,OAAU,EACV,MAAmE;IAEnE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,EAAU,CAAC,CAAC;IAClG,OAAO,QAAa,CAAC;AACvB,CAAC;AAED,SAAgB,WAAW,CAAC,KAAoB,EAAE,MAAuB;IACvE,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/events/signing.d.ts

@@ -0,0 +1,8 @@
+import { OpenClawEvent } from './types';
+export type HmacConfig = {
+    enabled: boolean;
+    secret?: string;
+    algorithm: 'sha256' | 'sha512';
+};
+export declare function signEvent(event: OpenClawEvent, config: HmacConfig): OpenClawEvent;
+//# sourceMappingURL=signing.d.ts.map

package/dist/events/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../../src/events/signing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC,CAAC;AAcF,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,CAoBjF"}

package/dist/events/signing.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signEvent = signEvent;
+const node_crypto_1 = require("node:crypto");
+function toSignablePayload(event, timestamp, nonce) {
+    const payload = {
+        ...event,
+        signature: undefined,
+    };
+    return JSON.stringify({
+        timestamp,
+        nonce,
+        payload,
+    });
+}
+function signEvent(event, config) {
+    if (!config.enabled || !config.secret) {
+        return event;
+    }
+    const timestamp = Math.floor(Date.now() / 1000);
+    const nonce = (0, node_crypto_1.randomUUID)();
+    const raw = toSignablePayload(event, timestamp, nonce);
+    const value = (0, node_crypto_1.createHmac)(config.algorithm, config.secret).update(raw).digest('hex');
+    return {
+        ...event,
+        signature: {
+            version: 'v1',
+            algorithm: config.algorithm,
+            timestamp,
+            nonce,
+            value,
+        },
+    };
+}
+//# sourceMappingURL=signing.js.map

package/dist/events/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.js","sourceRoot":"","sources":["../../src/events/signing.ts"],"names":[],"mappings":";;AAqBA,8BAoBC;AAzCD,6CAAqD;AASrD,SAAS,iBAAiB,CAAC,KAAoB,EAAE,SAAiB,EAAE,KAAa;IAC/E,MAAM,OAAO,GAAG;QACd,GAAG,KAAK;QACR,SAAS,EAAE,SAAS;KACrB,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,SAAS;QACT,KAAK;QACL,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,SAAS,CAAC,KAAoB,EAAE,MAAkB;IAChE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAA,wBAAU,GAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAA,wBAAU,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpF,OAAO;QACL,GAAG,KAAK;QACR,SAAS,EAAE;YACT,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS;YACT,KAAK;YACL,KAAK;SACN;KACF,CAAC;AACJ,CAAC"}

package/dist/events/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Canonical event type definitions for OpenClaw Event Server Plugin.
+ *
+ * The server broadcasts raw hook/plugin events with minimal transformation plus
+ * optional synthetic status/activity events.
+ */
+export type EventCategory = 'message' | 'tool' | 'command' | 'session' | 'agent' | 'gateway' | 'subagent' | 'synthetic';
+export type EventSource = 'internal-hook' | 'plugin-hook' | 'synthetic';
+export type EventType = 'message.received' | 'message.transcribed' | 'message.preprocessed' | 'message.sent' | 'message.edited' | 'message.deleted' | 'tool.called' | 'tool.guard.matched' | 'tool.guard.allowed' | 'tool.guard.blocked' | 'tool.completed' | 'tool.error' | 'tool.result_persist' | 'command.new' | 'command.reset' | 'command.stop' | 'session.start' | 'session.end' | 'subagent.spawning' | 'subagent.spawned' | 'subagent.ended' | 'subagent.idle' | 'agent.bootstrap' | 'agent.error' | 'agent.session_start' | 'agent.session_end' | 'agent.sub_agent_spawn' | 'agent.status' | 'agent.activity' | 'gateway.startup' | 'gateway.start' | 'gateway.stop' | 'session.spawned' | 'session.completed' | 'session.error';
+export type AgentSyntheticStatus = 'sleeping' | 'idle' | 'working' | 'offline' | 'error';
+export interface EventError {
+    message: string;
+    code?: string;
+    stack?: string;
+    kind?: 'tool' | 'agent' | 'gateway' | 'unknown';
+}
+export interface EventSignature {
+    version: 'v1';
+    algorithm: 'sha256' | 'sha512';
+    timestamp: number;
+    nonce: string;
+    value: string;
+}
+export interface OpenClawEvent {
+    /** Unique event ID */
+    eventId: string;
+    /** Canonical event schema version */
+    schemaVersion: string;
+    /** Legacy/primary type identifier for consumers */
+    type: EventType;
+    /** Canonical grouping for downstream filtering */
+    eventCategory?: EventCategory;
+    /** Original source event key name */
+    eventName?: string;
+    /** Where this event originated */
+    source?: EventSource;
+    /** Timestamp when event occurred */
+    timestamp: string;
+    /** Agent identifiers when known */
+    agentId?: string;
+    agentName?: string;
+    /** Session identifiers when known */
+    sessionId?: string;
+    sessionKey?: string;
+    sessionName?: string;
+    /** Run/tool correlation identifiers */
+    runId?: string;
+    toolCallId?: string;
+    correlationId?: string;
+    /** Result/error fields for completion/error events */
+    result?: unknown;
+    error?: EventError;
+    /** Plugin version that generated this event */
+    pluginVersion: string;
+    /** Optional cryptographic signature when HMAC signing is enabled */
+    signature?: EventSignature;
+    /** Raw normalized event payload */
+    data: Record<string, unknown>;
+    /** Additional metadata/debug fields */
+    metadata?: Record<string, unknown>;
+}
+export type MessageEvent = OpenClawEvent;
+export type ToolEvent = OpenClawEvent;
+export type SessionEvent = OpenClawEvent;
+export type AgentEvent = OpenClawEvent;
+export type CommandEvent = OpenClawEvent;
+export type GatewayEvent = OpenClawEvent;
+export type SubagentEvent = OpenClawEvent;
+/**
+ * Webhook configuration for broadcasting
+ */
+export interface WebhookConfig {
+    /** Webhook URL */
+    url: string;
+    /** HTTP method (default: POST) */
+    method?: 'POST' | 'PUT' | 'PATCH';
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Authentication token (optional) */
+    authToken?: string;
+    /** Whether to include full event payload */
+    includeFullPayload?: boolean;
+}
+/**
+ * Event filter configuration
+ */
+export interface EventFilter {
+    /** Event types to include (empty = all) */
+    includeTypes?: EventType[];
+    /** Event types to exclude */
+    excludeTypes?: EventType[];
+    /** Filter by channel ID */
+    channelId?: string;
+    /** Filter by tool name */
+    toolName?: string;
+    /** Filter by session ID */
+    sessionId?: string;
+}
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    /** Maximum retry attempts */
+    maxAttempts: number;
+    /** Initial delay in milliseconds */
+    initialDelayMs: number;
+    /** Maximum delay in milliseconds */
+    maxDelayMs: number;
+    /** Backoff multiplier */
+    backoffMultiplier: number;
+}
+/**
+ * Queue configuration
+ */
+export interface QueueConfig {
+    /** Maximum queue size */
+    maxSize: number;
+    /** Flush interval in milliseconds */
+    flushIntervalMs: number;
+    /** Whether to persist queue to disk */
+    persistToDisk: boolean;
+    /** Queue file path (if persisting) */
+    persistPath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

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

package/dist/events/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Canonical event type definitions for OpenClaw Event Server Plugin.
+ *
+ * The server broadcasts raw hook/plugin events with minimal transformation plus
+ * optional synthetic status/activity events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

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

package/dist/hooks/agent-hooks.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Agent event builders.
+ */
+import { AgentEvent, AgentSyntheticStatus, EventType } from '../events/types';
+export declare function createAgentStatusEvent(context: {
+    agentId: string;
+    status: AgentSyntheticStatus;
+    activity?: string;
+    activityDetail?: string;
+    sessionId?: string;
+    sessionKey?: string;
+    correlationId?: string;
+    sourceEventType?: EventType;
+    metadata?: Record<string, unknown>;
+}): AgentEvent;
+export declare function createAgentActivityEvent(context: {
+    agentId: string;
+    activity: string;
+    activityDetail?: string;
+    sessionId?: string;
+    sessionKey?: string;
+    correlationId?: string;
+    sourceEventType?: EventType;
+    toolName?: string;
+    toolStatus?: 'called' | 'completed' | 'error';
+    metadata?: Record<string, unknown>;
+}): AgentEvent;
+export declare function createAgentBootstrapEvent(context: {
+    sessionId?: string;
+    sessionKey?: string;
+    agentId?: string;
+    data?: Record<string, unknown>;
+}): AgentEvent;
+export declare function createAgentErrorEvent(context: {
+    sessionId?: string;
+    sessionKey?: string;
+    agentId?: string;
+    error: string;
+    stack?: string;
+    data?: Record<string, unknown>;
+}): AgentEvent;
+export declare function createAgentSessionEvent(context: {
+    type: 'agent.session_start' | 'agent.session_end';
+    sessionId?: string;
+    sessionKey?: string;
+    agentId?: string;
+    data?: Record<string, unknown>;
+}): AgentEvent;
+export declare function createAgentSubAgentSpawnEvent(context: {
+    parentAgentId?: string;
+    childAgentId?: string;
+    parentSessionId?: string;
+    parentSessionKey?: string;
+    childSessionKey?: string;
+    runId?: string;
+    mode?: string;
+    data?: Record<string, unknown>;
+}): AgentEvent;
+//# sourceMappingURL=agent-hooks.d.ts.map

package/dist/hooks/agent-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/agent-hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG9E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAmBb;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAoBb;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,UAAU,CAWb;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,UAAU,CAgBb;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,IAAI,EAAE,qBAAqB,GAAG,mBAAmB,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,UAAU,CAWb;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,UAAU,CAoBb"}