@tjamescouch/agentchat 0.25.0 → 0.26.0

package/dist/lib/moderation.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Moderation Plugin Architecture
+ *
+ * Chain-of-responsibility pattern for message moderation.
+ * Plugins are checked in order; strictest action wins.
+ * Supports per-channel configuration and admin bypass.
+ */
+/** Moderation actions in order of severity */
+export declare enum ModerationActionType {
+    ALLOW = "allow",
+    WARN = "warn",
+    THROTTLE = "throttle",
+    BLOCK = "block",// silently drop the message
+    TIMEOUT = "timeout",// disconnect temporarily
+    KICK = "kick"
+}
+/** Event passed to moderation plugins */
+export interface ModerationEvent {
+    /** Agent ID (if identified) */
+    agentId?: string;
+    /** Agent display name */
+    agentName?: string;
+    /** Connection IP */
+    ip?: string;
+    /** Channel the message targets (if channel message) */
+    channel?: string;
+    /** Message content */
+    content?: string;
+    /** Message type (MSG, JOIN, etc.) */
+    messageType: string;
+    /** Whether this agent has a verified persistent identity */
+    verified?: boolean;
+    /** Whether this agent has admin privileges */
+    isAdmin?: boolean;
+    /** Connection age in ms */
+    connectionAgeMs?: number;
+    /** Timestamp */
+    timestamp: number;
+}
+/** Action returned by a moderation plugin */
+export interface ModerationAction {
+    type: ModerationActionType;
+    /** Human-readable reason */
+    reason: string;
+    /** Plugin that generated this action */
+    plugin: string;
+    /** Additional data (throttle duration, timeout duration, etc.) */
+    metadata?: Record<string, unknown>;
+}
+/** Result from the pipeline (aggregated from all plugins) */
+export interface ModerationResult {
+    /** The final action (strictest wins) */
+    action: ModerationAction;
+    /** All actions from all plugins (for logging) */
+    allActions: ModerationAction[];
+    /** Whether an admin bypass was applied */
+    adminBypassed: boolean;
+}
+/**
+ * Interface that all moderation plugins must implement.
+ */
+export interface ModerationPlugin {
+    /** Unique plugin name */
+    readonly name: string;
+    /**
+     * What to do if this plugin throws an error.
+     * 'open' = allow message through (default, safe for non-critical plugins)
+     * 'closed' = block message (safe for security-critical plugins)
+     */
+    readonly failBehavior?: 'open' | 'closed';
+    /**
+     * Check a message event and return a moderation action.
+     * Return ALLOW to let the message through.
+     * Return anything stricter to flag/block/escalate.
+     * Async to support plugins that need external lookups (reputation, blocklists, etc.)
+     */
+    check(event: ModerationEvent): ModerationAction | Promise<ModerationAction>;
+    /**
+     * Optional: called when a connection disconnects.
+     * Useful for cleanup of per-connection state.
+     */
+    onDisconnect?(agentId: string): void;
+    /**
+     * Optional: called periodically for cleanup.
+     * Return number of stale entries cleaned up.
+     */
+    cleanup?(): number;
+}
+export interface ModerationPipelineOptions {
+    /** Enable admin bypass (default: true) */
+    adminBypass?: boolean;
+    /** Logger function */
+    logger?: (event: string, data: Record<string, unknown>) => void;
+}
+/**
+ * Moderation pipeline. Runs messages through registered plugins
+ * in order and returns the strictest action.
+ */
+export declare class ModerationPipeline {
+    /** Global plugins (apply to all channels) */
+    private globalPlugins;
+    /** Per-channel plugin overrides */
+    private channelPlugins;
+    private adminBypass;
+    private logger;
+    constructor(options?: ModerationPipelineOptions);
+    /**
+     * Register a global plugin (applies to all channels).
+     */
+    register(plugin: ModerationPlugin): void;
+    /**
+     * Register a plugin for a specific channel only.
+     */
+    registerForChannel(channel: string, plugin: ModerationPlugin): void;
+    /**
+     * Remove a global plugin by name.
+     */
+    unregister(pluginName: string): boolean;
+    /**
+     * Run an event through the moderation pipeline.
+     * Returns the strictest action from all applicable plugins.
+     * Async to support plugins that need external lookups.
+     */
+    check(event: ModerationEvent): Promise<ModerationResult>;
+    /**
+     * Notify all plugins of a disconnect.
+     */
+    onDisconnect(agentId: string): void;
+    /**
+     * Run cleanup on all plugins.
+     */
+    cleanup(): number;
+    /**
+     * List registered plugins.
+     */
+    listPlugins(): Array<{
+        name: string;
+        scope: string;
+        channel?: string;
+    }>;
+}
+//# sourceMappingURL=moderation.d.ts.map

package/dist/lib/moderation.d.ts.map

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

package/dist/lib/moderation.js

@@ -0,0 +1,192 @@
+/**
+ * Moderation Plugin Architecture
+ *
+ * Chain-of-responsibility pattern for message moderation.
+ * Plugins are checked in order; strictest action wins.
+ * Supports per-channel configuration and admin bypass.
+ */
+// ============ Types ============
+/** Moderation actions in order of severity */
+export var ModerationActionType;
+(function (ModerationActionType) {
+    ModerationActionType["ALLOW"] = "allow";
+    ModerationActionType["WARN"] = "warn";
+    ModerationActionType["THROTTLE"] = "throttle";
+    ModerationActionType["BLOCK"] = "block";
+    ModerationActionType["TIMEOUT"] = "timeout";
+    ModerationActionType["KICK"] = "kick";
+})(ModerationActionType || (ModerationActionType = {}));
+/** Severity ordering for strictest-wins logic */
+const ACTION_SEVERITY = {
+    [ModerationActionType.ALLOW]: 0,
+    [ModerationActionType.WARN]: 1,
+    [ModerationActionType.THROTTLE]: 2,
+    [ModerationActionType.BLOCK]: 3,
+    [ModerationActionType.TIMEOUT]: 4,
+    [ModerationActionType.KICK]: 5,
+};
+/**
+ * Moderation pipeline. Runs messages through registered plugins
+ * in order and returns the strictest action.
+ */
+export class ModerationPipeline {
+    /** Global plugins (apply to all channels) */
+    globalPlugins = [];
+    /** Per-channel plugin overrides */
+    channelPlugins = new Map();
+    adminBypass;
+    logger;
+    constructor(options = {}) {
+        this.adminBypass = options.adminBypass !== false;
+        this.logger = options.logger || (() => { });
+    }
+    /**
+     * Register a global plugin (applies to all channels).
+     */
+    register(plugin) {
+        this.globalPlugins.push(plugin);
+        this.logger('moderation_plugin_registered', { name: plugin.name, scope: 'global' });
+    }
+    /**
+     * Register a plugin for a specific channel only.
+     */
+    registerForChannel(channel, plugin) {
+        if (!this.channelPlugins.has(channel)) {
+            this.channelPlugins.set(channel, []);
+        }
+        this.channelPlugins.get(channel).push(plugin);
+        this.logger('moderation_plugin_registered', { name: plugin.name, scope: 'channel', channel });
+    }
+    /**
+     * Remove a global plugin by name.
+     */
+    unregister(pluginName) {
+        const idx = this.globalPlugins.findIndex(p => p.name === pluginName);
+        if (idx >= 0) {
+            this.globalPlugins.splice(idx, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Run an event through the moderation pipeline.
+     * Returns the strictest action from all applicable plugins.
+     * Async to support plugins that need external lookups.
+     */
+    async check(event) {
+        // Admin bypass — skip all checks
+        if (this.adminBypass && event.isAdmin) {
+            return {
+                action: { type: ModerationActionType.ALLOW, reason: 'Admin bypass', plugin: 'pipeline' },
+                allActions: [],
+                adminBypassed: true,
+            };
+        }
+        const allActions = [];
+        const runPlugin = async (plugin) => {
+            try {
+                const action = await plugin.check(event);
+                allActions.push(action);
+            }
+            catch (err) {
+                const failMode = plugin.failBehavior || 'open';
+                this.logger('moderation_plugin_error', {
+                    plugin: plugin.name,
+                    error: err.message,
+                    failBehavior: failMode,
+                });
+                if (failMode === 'closed') {
+                    allActions.push({
+                        type: ModerationActionType.BLOCK,
+                        reason: `Plugin ${plugin.name} error (fail-closed)`,
+                        plugin: plugin.name,
+                    });
+                }
+                // fail-open: just skip this plugin's action (implicit ALLOW)
+            }
+        };
+        // Run global plugins
+        for (const plugin of this.globalPlugins) {
+            await runPlugin(plugin);
+        }
+        // Run channel-specific plugins (if applicable)
+        if (event.channel) {
+            const channelSpecific = this.channelPlugins.get(event.channel);
+            if (channelSpecific) {
+                for (const plugin of channelSpecific) {
+                    await runPlugin(plugin);
+                }
+            }
+        }
+        // Find the strictest action
+        let strictest = {
+            type: ModerationActionType.ALLOW,
+            reason: 'No moderation action',
+            plugin: 'pipeline',
+        };
+        for (const action of allActions) {
+            if (ACTION_SEVERITY[action.type] > ACTION_SEVERITY[strictest.type]) {
+                strictest = action;
+            }
+        }
+        // Log non-allow actions
+        if (strictest.type !== ModerationActionType.ALLOW) {
+            this.logger('moderation_action', {
+                action: strictest.type,
+                plugin: strictest.plugin,
+                reason: strictest.reason,
+                agentId: event.agentId,
+                channel: event.channel,
+            });
+        }
+        return {
+            action: strictest,
+            allActions,
+            adminBypassed: false,
+        };
+    }
+    /**
+     * Notify all plugins of a disconnect.
+     */
+    onDisconnect(agentId) {
+        for (const plugin of this.globalPlugins) {
+            plugin.onDisconnect?.(agentId);
+        }
+        for (const plugins of this.channelPlugins.values()) {
+            for (const plugin of plugins) {
+                plugin.onDisconnect?.(agentId);
+            }
+        }
+    }
+    /**
+     * Run cleanup on all plugins.
+     */
+    cleanup() {
+        let total = 0;
+        for (const plugin of this.globalPlugins) {
+            total += plugin.cleanup?.() || 0;
+        }
+        for (const plugins of this.channelPlugins.values()) {
+            for (const plugin of plugins) {
+                total += plugin.cleanup?.() || 0;
+            }
+        }
+        return total;
+    }
+    /**
+     * List registered plugins.
+     */
+    listPlugins() {
+        const result = [];
+        for (const p of this.globalPlugins) {
+            result.push({ name: p.name, scope: 'global' });
+        }
+        for (const [channel, plugins] of this.channelPlugins) {
+            for (const p of plugins) {
+                result.push({ name: p.name, scope: 'channel', channel });
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=moderation.js.map

package/dist/lib/moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.js","sourceRoot":"","sources":["../../lib/moderation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kCAAkC;AAElC,8CAA8C;AAC9C,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,uCAAe,CAAA;IACf,qCAAa,CAAA;IACb,6CAAqB,CAAA;IACrB,uCAAe,CAAA;IACf,2CAAmB,CAAA;IACnB,qCAAa,CAAA;AACf,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AAED,iDAAiD;AACjD,MAAM,eAAe,GAAyC;IAC5D,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC9B,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAClC,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;CAC/B,CAAC;AA6FF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC7B,6CAA6C;IACrC,aAAa,GAAuB,EAAE,CAAC;IAE/C,mCAAmC;IAC3B,cAAc,GAAoC,IAAI,GAAG,EAAE,CAAC;IAE5D,WAAW,CAAU;IACrB,MAAM,CAAyD;IAEvE,YAAY,UAAqC,EAAE;QACjD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,KAAK,KAAK,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAwB;QAC/B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,OAAe,EAAE,MAAwB;QAC1D,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAkB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACrE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,KAAsB;QAChC,iCAAiC;QACjC,IAAI,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACtC,OAAO;gBACL,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE;gBACxF,UAAU,EAAE,EAAE;gBACd,aAAa,EAAE,IAAI;aACpB,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAuB,EAAE,CAAC;QAE1C,MAAM,SAAS,GAAG,KAAK,EAAE,MAAwB,EAAiB,EAAE;YAClE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACzC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,yBAAyB,EAAE;oBACrC,MAAM,EAAE,MAAM,CAAC,IAAI;oBACnB,KAAK,EAAG,GAAa,CAAC,OAAO;oBAC7B,YAAY,EAAE,QAAQ;iBACvB,CAAC,CAAC;gBACH,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAC1B,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,oBAAoB,CAAC,KAAK;wBAChC,MAAM,EAAE,UAAU,MAAM,CAAC,IAAI,sBAAsB;wBACnD,MAAM,EAAE,MAAM,CAAC,IAAI;qBACpB,CAAC,CAAC;gBACL,CAAC;gBACD,6DAA6D;YAC/D,CAAC;QACH,CAAC,CAAC;QAEF,qBAAqB;QACrB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QAED,+CAA+C;QAC/C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/D,IAAI,eAAe,EAAE,CAAC;gBACpB,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;oBACrC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,SAAS,GAAqB;YAChC,IAAI,EAAE,oBAAoB,CAAC,KAAK;YAChC,MAAM,EAAE,sBAAsB;YAC9B,MAAM,EAAE,UAAU;SACnB,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnE,SAAS,GAAG,MAAM,CAAC;YACrB,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,SAAS,CAAC,IAAI,KAAK,oBAAoB,CAAC,KAAK,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE;gBAC/B,MAAM,EAAE,SAAS,CAAC,IAAI;gBACtB,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,UAAU;YACV,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAe;QAC1B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YACnD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YACnD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,WAAW;QACT,MAAM,MAAM,GAA6D,EAAE,CAAC;QAC5E,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/lib/moderation.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for Moderation Pipeline and Plugins
+ *
+ * Run with: npx tsx lib/moderation.test.ts
+ */
+export {};
+//# sourceMappingURL=moderation.test.d.ts.map

package/dist/lib/moderation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.test.d.ts","sourceRoot":"","sources":["../../lib/moderation.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/lib/moderation.test.js

@@ -0,0 +1,275 @@
+/**
+ * Tests for Moderation Pipeline and Plugins
+ *
+ * Run with: npx tsx lib/moderation.test.ts
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { ModerationPipeline, ModerationActionType } from './moderation.js';
+import { EscalationPlugin } from './moderation-plugins/escalation-plugin.js';
+import { LinkDetectorPlugin } from './moderation-plugins/link-detector-plugin.js';
+function makeEvent(overrides = {}) {
+    return {
+        messageType: 'MSG',
+        timestamp: Date.now(),
+        ...overrides,
+    };
+}
+describe('ModerationPipeline', () => {
+    it('allows messages when no plugins registered', async () => {
+        const pipeline = new ModerationPipeline();
+        const result = await pipeline.check(makeEvent());
+        assert.equal(result.action.type, ModerationActionType.ALLOW);
+    });
+    it('applies admin bypass', async () => {
+        const pipeline = new ModerationPipeline();
+        // Register a plugin that always blocks
+        const blockerPlugin = {
+            name: 'always-block',
+            check: () => ({
+                type: ModerationActionType.BLOCK,
+                reason: 'Blocked',
+                plugin: 'always-block',
+            }),
+        };
+        pipeline.register(blockerPlugin);
+        // Admin should bypass
+        const result = await pipeline.check(makeEvent({ isAdmin: true }));
+        assert.equal(result.adminBypassed, true);
+        assert.equal(result.action.type, ModerationActionType.ALLOW);
+    });
+    it('strictest action wins', async () => {
+        const pipeline = new ModerationPipeline();
+        const warnPlugin = {
+            name: 'warn-plugin',
+            check: () => ({ type: ModerationActionType.WARN, reason: 'Warning', plugin: 'warn-plugin' }),
+        };
+        const blockPlugin = {
+            name: 'block-plugin',
+            check: () => ({ type: ModerationActionType.BLOCK, reason: 'Blocked', plugin: 'block-plugin' }),
+        };
+        pipeline.register(warnPlugin);
+        pipeline.register(blockPlugin);
+        const result = await pipeline.check(makeEvent());
+        assert.equal(result.action.type, ModerationActionType.BLOCK);
+        assert.equal(result.action.plugin, 'block-plugin');
+        assert.equal(result.allActions.length, 2);
+    });
+    it('supports per-channel plugins', async () => {
+        const pipeline = new ModerationPipeline();
+        const strictPlugin = {
+            name: 'strict',
+            check: () => ({ type: ModerationActionType.BLOCK, reason: 'Strict', plugin: 'strict' }),
+        };
+        pipeline.registerForChannel('#moderated', strictPlugin);
+        // Message to #moderated gets blocked
+        const r1 = await pipeline.check(makeEvent({ channel: '#moderated' }));
+        assert.equal(r1.action.type, ModerationActionType.BLOCK);
+        // Message to #general is fine
+        const r2 = await pipeline.check(makeEvent({ channel: '#general' }));
+        assert.equal(r2.action.type, ModerationActionType.ALLOW);
+    });
+    it('combines global and channel plugins', async () => {
+        const pipeline = new ModerationPipeline();
+        const globalWarn = {
+            name: 'global-warn',
+            check: () => ({ type: ModerationActionType.WARN, reason: 'Global warning', plugin: 'global-warn' }),
+        };
+        const channelBlock = {
+            name: 'channel-block',
+            check: () => ({ type: ModerationActionType.BLOCK, reason: 'Channel blocked', plugin: 'channel-block' }),
+        };
+        pipeline.register(globalWarn);
+        pipeline.registerForChannel('#strict', channelBlock);
+        // #strict gets the stricter action
+        const r1 = await pipeline.check(makeEvent({ channel: '#strict' }));
+        assert.equal(r1.action.type, ModerationActionType.BLOCK);
+        assert.equal(r1.allActions.length, 2);
+        // Other channels only get the warn
+        const r2 = await pipeline.check(makeEvent({ channel: '#general' }));
+        assert.equal(r2.action.type, ModerationActionType.WARN);
+    });
+    it('unregisters plugins', async () => {
+        const pipeline = new ModerationPipeline();
+        const plugin = {
+            name: 'removable',
+            check: () => ({ type: ModerationActionType.BLOCK, reason: 'Block', plugin: 'removable' }),
+        };
+        pipeline.register(plugin);
+        assert.equal((await pipeline.check(makeEvent())).action.type, ModerationActionType.BLOCK);
+        pipeline.unregister('removable');
+        assert.equal((await pipeline.check(makeEvent())).action.type, ModerationActionType.ALLOW);
+    });
+    it('lists registered plugins', () => {
+        const pipeline = new ModerationPipeline();
+        const p1 = { name: 'a', check: () => ({ type: ModerationActionType.ALLOW, reason: '', plugin: 'a' }) };
+        const p2 = { name: 'b', check: () => ({ type: ModerationActionType.ALLOW, reason: '', plugin: 'b' }) };
+        pipeline.register(p1);
+        pipeline.registerForChannel('#test', p2);
+        const list = pipeline.listPlugins();
+        assert.equal(list.length, 2);
+        assert.equal(list[0].name, 'a');
+        assert.equal(list[0].scope, 'global');
+        assert.equal(list[1].name, 'b');
+        assert.equal(list[1].scope, 'channel');
+        assert.equal(list[1].channel, '#test');
+    });
+    it('calls onDisconnect on all plugins', () => {
+        const pipeline = new ModerationPipeline();
+        const disconnected = [];
+        const plugin = {
+            name: 'tracker',
+            check: () => ({ type: ModerationActionType.ALLOW, reason: '', plugin: 'tracker' }),
+            onDisconnect: (id) => disconnected.push(id),
+        };
+        pipeline.register(plugin);
+        pipeline.onDisconnect('agent123');
+        assert.equal(disconnected.length, 1);
+        assert.equal(disconnected[0], 'agent123');
+    });
+    it('supports async plugins', async () => {
+        const pipeline = new ModerationPipeline();
+        const asyncPlugin = {
+            name: 'async-blocker',
+            check: async (_event) => {
+                // Simulate async lookup
+                await new Promise(r => setTimeout(r, 10));
+                return { type: ModerationActionType.BLOCK, reason: 'Async block', plugin: 'async-blocker' };
+            },
+        };
+        pipeline.register(asyncPlugin);
+        const result = await pipeline.check(makeEvent());
+        assert.equal(result.action.type, ModerationActionType.BLOCK);
+        assert.equal(result.action.plugin, 'async-blocker');
+    });
+    it('fail-open plugin error allows message through', async () => {
+        const pipeline = new ModerationPipeline();
+        const brokenPlugin = {
+            name: 'broken-open',
+            failBehavior: 'open',
+            check: () => { throw new Error('Plugin crashed'); },
+        };
+        pipeline.register(brokenPlugin);
+        const result = await pipeline.check(makeEvent());
+        // fail-open: message goes through
+        assert.equal(result.action.type, ModerationActionType.ALLOW);
+    });
+    it('fail-closed plugin error blocks message', async () => {
+        const pipeline = new ModerationPipeline();
+        const brokenPlugin = {
+            name: 'broken-closed',
+            failBehavior: 'closed',
+            check: () => { throw new Error('Plugin crashed'); },
+        };
+        pipeline.register(brokenPlugin);
+        const result = await pipeline.check(makeEvent());
+        // fail-closed: message is blocked
+        assert.equal(result.action.type, ModerationActionType.BLOCK);
+        assert.ok(result.action.reason.includes('fail-closed'));
+    });
+    it('defaults to fail-open when failBehavior not specified', async () => {
+        const pipeline = new ModerationPipeline();
+        const brokenPlugin = {
+            name: 'broken-default',
+            // no failBehavior set
+            check: () => { throw new Error('Plugin crashed'); },
+        };
+        pipeline.register(brokenPlugin);
+        const result = await pipeline.check(makeEvent());
+        assert.equal(result.action.type, ModerationActionType.ALLOW);
+    });
+});
+describe('LinkDetectorPlugin', () => {
+    it('allows messages without URLs', () => {
+        const plugin = new LinkDetectorPlugin();
+        const action = plugin.check(makeEvent({ content: 'Hello everyone' }));
+        assert.equal(action.type, ModerationActionType.ALLOW);
+    });
+    it('warns new connections posting URLs', () => {
+        const plugin = new LinkDetectorPlugin({ minConnectionAgeMs: 300000 });
+        const action = plugin.check(makeEvent({
+            content: 'Check out https://example.com',
+            connectionAgeMs: 5000, // 5 seconds old
+        }));
+        assert.equal(action.type, ModerationActionType.WARN);
+        assert.ok(action.reason.includes('New connection'));
+    });
+    it('allows old connections to post URLs', () => {
+        const plugin = new LinkDetectorPlugin({ minConnectionAgeMs: 300000 });
+        const action = plugin.check(makeEvent({
+            content: 'Check out https://example.com',
+            connectionAgeMs: 600000, // 10 minutes old
+        }));
+        assert.equal(action.type, ModerationActionType.ALLOW);
+    });
+    it('allows verified agents to post URLs', () => {
+        const plugin = new LinkDetectorPlugin({ minConnectionAgeMs: 300000 });
+        const action = plugin.check(makeEvent({
+            content: 'Check out https://example.com',
+            connectionAgeMs: 1000, // very new
+            verified: true,
+        }));
+        assert.equal(action.type, ModerationActionType.ALLOW);
+    });
+    it('blocks URLs matching blocked patterns', () => {
+        const plugin = new LinkDetectorPlugin({
+            blockedPatterns: ['botsforpeace\\.ai'],
+        });
+        const action = plugin.check(makeEvent({
+            content: 'Join us at https://botsforpeace.ai',
+            connectionAgeMs: 600000,
+            verified: true,
+        }));
+        assert.equal(action.type, ModerationActionType.BLOCK);
+        assert.ok(action.reason.includes('Blocked URL'));
+    });
+    it('skips non-MSG events', () => {
+        const plugin = new LinkDetectorPlugin();
+        const action = plugin.check(makeEvent({
+            messageType: 'JOIN',
+            content: 'https://example.com',
+        }));
+        assert.equal(action.type, ModerationActionType.ALLOW);
+    });
+    it('configurable untrusted action', () => {
+        const plugin = new LinkDetectorPlugin({
+            untrustedAction: ModerationActionType.BLOCK,
+            minConnectionAgeMs: 300000,
+        });
+        const action = plugin.check(makeEvent({
+            content: 'https://spam.example.com',
+            connectionAgeMs: 1000,
+        }));
+        assert.equal(action.type, ModerationActionType.BLOCK);
+    });
+});
+describe('EscalationPlugin', () => {
+    it('allows by default', () => {
+        const plugin = new EscalationPlugin();
+        const action = plugin.check(makeEvent({ agentId: 'test' }));
+        assert.equal(action.type, ModerationActionType.ALLOW);
+    });
+    it('warns after repeated violations', () => {
+        const plugin = new EscalationPlugin({ warnAfterViolations: 2 });
+        plugin.recordViolation('test');
+        const action = plugin.recordViolation('test');
+        assert.equal(action.type, ModerationActionType.WARN);
+    });
+    it('reports throttle state via check()', () => {
+        const plugin = new EscalationPlugin({ warnAfterViolations: 2, throttleAfterViolations: 4 });
+        for (let i = 0; i < 4; i++)
+            plugin.recordViolation('test');
+        // Now check() should report throttled
+        const action = plugin.check(makeEvent({ agentId: 'test' }));
+        assert.equal(action.type, ModerationActionType.THROTTLE);
+    });
+    it('exposes stats', () => {
+        const plugin = new EscalationPlugin({ warnAfterViolations: 2 });
+        plugin.recordViolation('a');
+        plugin.recordViolation('a');
+        const stats = plugin.stats();
+        assert.equal(stats.tracked, 1);
+        assert.equal(stats.warned, 1);
+    });
+});
+//# sourceMappingURL=moderation.test.js.map

package/dist/lib/moderation.test.js.map

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