@phuetz/code-buddy 0.1.0

package/dist/channels/peer-routing.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Agent Peer Routing
+ *
+ * OpenClaw-inspired message routing system that binds inbound messages
+ * to specific agent configurations by (channel, accountId, peer).
+ *
+ * Peer matches always take priority over channel-wide rules.
+ *
+ * Usage:
+ * ```typescript
+ * const router = getPeerRouter();
+ *
+ * // Route a specific user's WhatsApp messages to Claude Opus
+ * router.addRoute({
+ *   channelType: 'whatsapp',
+ *   peerId: 'user-123',
+ *   agent: { model: 'claude-3-opus', systemPrompt: 'Be helpful' }
+ * });
+ *
+ * // Route all Discord messages to Grok
+ * router.addRoute({
+ *   channelType: 'discord',
+ *   agent: { model: 'grok-3' }
+ * });
+ *
+ * // Resolve route for a message
+ * const route = router.resolve(message);
+ * ```
+ */
+import { EventEmitter } from 'events';
+import type { ChannelType, InboundMessage } from './index.js';
+/**
+ * Agent configuration for a route
+ */
+export interface RouteAgentConfig {
+    /** Agent ID (for multi-agent setups) */
+    agentId?: string;
+    /** Model to use */
+    model?: string;
+    /** System prompt override */
+    systemPrompt?: string;
+    /** Max tool rounds */
+    maxToolRounds?: number;
+    /** Temperature */
+    temperature?: number;
+    /** Tools allowlist */
+    allowedTools?: string[];
+    /** Tools denylist */
+    deniedTools?: string[];
+    /** Custom agent metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A routing rule
+ */
+export interface PeerRoute {
+    /** Unique route ID */
+    id: string;
+    /** Route name/label */
+    name: string;
+    /** Route description */
+    description?: string;
+    /** Channel type to match (undefined = all channels) */
+    channelType?: ChannelType;
+    /** Account ID to match (for multi-account setups) */
+    accountId?: string;
+    /** Peer ID to match (undefined = all peers on channel) */
+    peerId?: string;
+    /** Channel ID to match (for specific groups/DMs) */
+    channelId?: string;
+    /** Agent configuration for this route */
+    agent: RouteAgentConfig;
+    /** Priority (higher = checked first) */
+    priority: number;
+    /** Whether this route is active */
+    enabled: boolean;
+    /** Conditions for matching */
+    conditions?: RouteCondition[];
+    /** Creation timestamp */
+    createdAt: Date;
+}
+/**
+ * Additional conditions for route matching
+ */
+export interface RouteCondition {
+    /** Condition type */
+    type: 'time-range' | 'message-pattern' | 'content-type' | 'is-dm' | 'is-group';
+    /** Condition value */
+    value: string | boolean;
+}
+/**
+ * Result of route resolution
+ */
+export interface ResolvedRoute {
+    /** Matched route */
+    route: PeerRoute;
+    /** Match type (how the route was matched) */
+    matchType: 'peer' | 'channel-id' | 'channel-type' | 'account' | 'default';
+    /** Match specificity (higher = more specific) */
+    specificity: number;
+    /** Agent config from the route */
+    agent: RouteAgentConfig;
+}
+/**
+ * Peer router configuration
+ */
+export interface PeerRouterConfig {
+    /** Default agent config when no route matches */
+    defaultAgent: RouteAgentConfig;
+    /** Enable logging of routing decisions */
+    logDecisions: boolean;
+}
+export declare class PeerRouter extends EventEmitter {
+    private config;
+    private routes;
+    private routeCounter;
+    private routingHistory;
+    constructor(config?: Partial<PeerRouterConfig>);
+    /**
+     * Add a routing rule
+     */
+    addRoute(route: Omit<PeerRoute, 'id' | 'createdAt'> & {
+        id?: string;
+    }): PeerRoute;
+    /**
+     * Remove a routing rule
+     */
+    removeRoute(routeId: string): boolean;
+    /**
+     * Update a routing rule
+     */
+    updateRoute(routeId: string, updates: Partial<PeerRoute>): PeerRoute | null;
+    /**
+     * Enable/disable a route
+     */
+    toggleRoute(routeId: string, enabled: boolean): boolean;
+    /**
+     * Get a route by ID
+     */
+    getRoute(routeId: string): PeerRoute | undefined;
+    /**
+     * List all routes (sorted by priority descending)
+     */
+    listRoutes(): PeerRoute[];
+    /**
+     * Resolve the best route for an inbound message.
+     * Peer matches take priority over channel-wide rules.
+     *
+     * Resolution order (highest to lowest priority):
+     * 1. Exact peer match (channel + accountId + peer)
+     * 2. Channel ID match (specific group/DM)
+     * 3. Channel type + account match
+     * 4. Channel type match (all peers on channel)
+     * 5. Default agent config
+     */
+    resolve(message: InboundMessage, accountId?: string): ResolvedRoute | null;
+    /**
+     * Get effective agent config for a message (resolves route + applies defaults)
+     */
+    getAgentConfig(message: InboundMessage, accountId?: string): RouteAgentConfig;
+    /**
+     * Check if a route matches a message
+     */
+    private matchRoute;
+    /**
+     * Check a single route condition
+     */
+    private checkCondition;
+    getStats(): {
+        totalRoutes: number;
+        activeRoutes: number;
+        routesByChannel: Record<string, number>;
+        routingDecisions: number;
+        matchRate: number;
+    };
+    dispose(): void;
+}
+export declare function getPeerRouter(config?: Partial<PeerRouterConfig>): PeerRouter;
+export declare function resetPeerRouter(): void;

package/dist/channels/peer-routing.js

@@ -0,0 +1,300 @@
+/**
+ * Agent Peer Routing
+ *
+ * OpenClaw-inspired message routing system that binds inbound messages
+ * to specific agent configurations by (channel, accountId, peer).
+ *
+ * Peer matches always take priority over channel-wide rules.
+ *
+ * Usage:
+ * ```typescript
+ * const router = getPeerRouter();
+ *
+ * // Route a specific user's WhatsApp messages to Claude Opus
+ * router.addRoute({
+ *   channelType: 'whatsapp',
+ *   peerId: 'user-123',
+ *   agent: { model: 'claude-3-opus', systemPrompt: 'Be helpful' }
+ * });
+ *
+ * // Route all Discord messages to Grok
+ * router.addRoute({
+ *   channelType: 'discord',
+ *   agent: { model: 'grok-3' }
+ * });
+ *
+ * // Resolve route for a message
+ * const route = router.resolve(message);
+ * ```
+ */
+import { EventEmitter } from 'events';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_ROUTER_CONFIG = {
+    defaultAgent: {},
+    logDecisions: false,
+};
+// ============================================================================
+// Peer Router
+// ============================================================================
+export class PeerRouter extends EventEmitter {
+    config;
+    routes = new Map();
+    routeCounter = 0;
+    routingHistory = [];
+    constructor(config = {}) {
+        super();
+        this.config = { ...DEFAULT_ROUTER_CONFIG, ...config };
+    }
+    // ==========================================================================
+    // Route Management
+    // ==========================================================================
+    /**
+     * Add a routing rule
+     */
+    addRoute(route) {
+        const fullRoute = {
+            ...route,
+            id: route.id || `route-${++this.routeCounter}`,
+            createdAt: new Date(),
+        };
+        this.routes.set(fullRoute.id, fullRoute);
+        this.emit('route:added', fullRoute);
+        return fullRoute;
+    }
+    /**
+     * Remove a routing rule
+     */
+    removeRoute(routeId) {
+        const route = this.routes.get(routeId);
+        if (route) {
+            this.routes.delete(routeId);
+            this.emit('route:removed', route);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Update a routing rule
+     */
+    updateRoute(routeId, updates) {
+        const route = this.routes.get(routeId);
+        if (!route)
+            return null;
+        const updated = { ...route, ...updates, id: route.id, createdAt: route.createdAt };
+        this.routes.set(routeId, updated);
+        this.emit('route:updated', updated);
+        return updated;
+    }
+    /**
+     * Enable/disable a route
+     */
+    toggleRoute(routeId, enabled) {
+        const route = this.routes.get(routeId);
+        if (!route)
+            return false;
+        route.enabled = enabled;
+        this.emit('route:toggled', route, enabled);
+        return true;
+    }
+    /**
+     * Get a route by ID
+     */
+    getRoute(routeId) {
+        return this.routes.get(routeId);
+    }
+    /**
+     * List all routes (sorted by priority descending)
+     */
+    listRoutes() {
+        return Array.from(this.routes.values())
+            .sort((a, b) => b.priority - a.priority);
+    }
+    // ==========================================================================
+    // Route Resolution
+    // ==========================================================================
+    /**
+     * Resolve the best route for an inbound message.
+     * Peer matches take priority over channel-wide rules.
+     *
+     * Resolution order (highest to lowest priority):
+     * 1. Exact peer match (channel + accountId + peer)
+     * 2. Channel ID match (specific group/DM)
+     * 3. Channel type + account match
+     * 4. Channel type match (all peers on channel)
+     * 5. Default agent config
+     */
+    resolve(message, accountId) {
+        const candidates = [];
+        for (const route of this.routes.values()) {
+            if (!route.enabled)
+                continue;
+            const match = this.matchRoute(route, message, accountId);
+            if (match) {
+                candidates.push(match);
+            }
+        }
+        // Sort by specificity (highest first), then by priority
+        candidates.sort((a, b) => {
+            if (a.specificity !== b.specificity)
+                return b.specificity - a.specificity;
+            return b.route.priority - a.route.priority;
+        });
+        const result = candidates[0] || null;
+        // Track routing history
+        this.routingHistory.push({
+            messageId: message.id,
+            timestamp: new Date(),
+            route: result,
+        });
+        // Keep only last 1000 routing decisions
+        if (this.routingHistory.length > 1000) {
+            this.routingHistory = this.routingHistory.slice(-500);
+        }
+        if (result) {
+            this.emit('route:matched', result, message);
+        }
+        else {
+            this.emit('route:unmatched', message);
+        }
+        return result;
+    }
+    /**
+     * Get effective agent config for a message (resolves route + applies defaults)
+     */
+    getAgentConfig(message, accountId) {
+        const resolved = this.resolve(message, accountId);
+        if (resolved) {
+            return { ...this.config.defaultAgent, ...resolved.agent };
+        }
+        return { ...this.config.defaultAgent };
+    }
+    // ==========================================================================
+    // Matching Logic
+    // ==========================================================================
+    /**
+     * Check if a route matches a message
+     */
+    matchRoute(route, message, accountId) {
+        let specificity = 0;
+        let matchType = 'default';
+        // Check channel type
+        if (route.channelType) {
+            if (route.channelType !== message.channel.type)
+                return null;
+            specificity += 10;
+            matchType = 'channel-type';
+        }
+        // Check account ID
+        if (route.accountId) {
+            if (route.accountId !== accountId)
+                return null;
+            specificity += 20;
+            matchType = 'account';
+        }
+        // Check channel ID (specific group/DM)
+        if (route.channelId) {
+            if (route.channelId !== message.channel.id)
+                return null;
+            specificity += 30;
+            matchType = 'channel-id';
+        }
+        // Check peer ID (most specific)
+        if (route.peerId) {
+            if (route.peerId !== message.sender.id)
+                return null;
+            specificity += 50;
+            matchType = 'peer';
+        }
+        // Check additional conditions
+        if (route.conditions) {
+            for (const condition of route.conditions) {
+                if (!this.checkCondition(condition, message))
+                    return null;
+            }
+            specificity += route.conditions.length * 5;
+        }
+        // If no criteria specified, it's a catch-all (lowest specificity)
+        if (specificity === 0) {
+            specificity = 1;
+        }
+        return {
+            route,
+            matchType,
+            specificity,
+            agent: route.agent,
+        };
+    }
+    /**
+     * Check a single route condition
+     */
+    checkCondition(condition, message) {
+        switch (condition.type) {
+            case 'is-dm':
+                return message.channel.isDM === condition.value;
+            case 'is-group':
+                return message.channel.isGroup === condition.value;
+            case 'content-type':
+                return message.contentType === condition.value;
+            case 'message-pattern': {
+                const pattern = new RegExp(condition.value, 'i');
+                return pattern.test(message.content);
+            }
+            case 'time-range': {
+                const [start, end] = condition.value.split('-').map(Number);
+                const hour = new Date().getHours();
+                return hour >= start && hour <= end;
+            }
+            default:
+                return true;
+        }
+    }
+    // ==========================================================================
+    // Statistics
+    // ==========================================================================
+    getStats() {
+        const routesByChannel = {};
+        let activeRoutes = 0;
+        for (const route of this.routes.values()) {
+            if (route.enabled)
+                activeRoutes++;
+            const channel = route.channelType || 'any';
+            routesByChannel[channel] = (routesByChannel[channel] || 0) + 1;
+        }
+        const matched = this.routingHistory.filter(h => h.route !== null).length;
+        const total = this.routingHistory.length;
+        return {
+            totalRoutes: this.routes.size,
+            activeRoutes,
+            routesByChannel,
+            routingDecisions: total,
+            matchRate: total > 0 ? matched / total : 0,
+        };
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    dispose() {
+        this.routes.clear();
+        this.routingHistory = [];
+        this.removeAllListeners();
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let routerInstance = null;
+export function getPeerRouter(config) {
+    if (!routerInstance) {
+        routerInstance = new PeerRouter(config);
+    }
+    return routerInstance;
+}
+export function resetPeerRouter() {
+    if (routerInstance) {
+        routerInstance.dispose();
+    }
+    routerInstance = null;
+}
+//# sourceMappingURL=peer-routing.js.map

package/dist/channels/peer-routing.js.map

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

package/dist/channels/session-isolation.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Session Isolation
+ *
+ * OpenClaw-inspired session scoping for multi-channel DM handling.
+ *
+ * Session scopes:
+ * - per-channel-peer: Separate session per (channel, peer) pair
+ *   Prevents cross-user context leakage
+ * - per-account-channel-peer: Per (account, channel, peer) triple
+ *   For multiple bot accounts on the same channel
+ * - global: Single session for all peers (default for CLI)
+ *
+ * Usage:
+ * ```typescript
+ * const isolator = getSessionIsolator();
+ *
+ * // Get session key for a message
+ * const sessionKey = isolator.getSessionKey(message);
+ *
+ * // Check if sessions are isolated
+ * isolator.areIsolated(sessionKey1, sessionKey2); // true if different scopes
+ * ```
+ */
+import { EventEmitter } from 'events';
+import type { InboundMessage, ChannelType } from './index.js';
+import type { IdentityLinker } from './identity-links.js';
+/**
+ * Session scope determines how sessions are partitioned
+ */
+export type SessionScope = 'global' | 'per-channel' | 'per-channel-peer' | 'per-account-channel-peer';
+/**
+ * Session key components
+ */
+export interface SessionKeyComponents {
+    /** Bot account ID (for multi-account setups) */
+    accountId?: string;
+    /** Channel type (telegram, discord, etc.) */
+    channelType: ChannelType;
+    /** Channel ID */
+    channelId: string;
+    /** Peer/user ID */
+    peerId: string;
+}
+/**
+ * Session isolation configuration
+ */
+export interface SessionIsolationConfig {
+    /** Default session scope */
+    defaultScope: SessionScope;
+    /** Per-channel scope overrides */
+    channelScopes?: Partial<Record<ChannelType, SessionScope>>;
+    /** Maximum sessions per scope */
+    maxSessions: number;
+    /** Session TTL in milliseconds (0 = no expiry) */
+    sessionTtlMs: number;
+    /** Enable session activity tracking */
+    trackActivity: boolean;
+    /** Optional identity linker for cross-channel identity unification */
+    identityLinker?: IdentityLinker;
+}
+/**
+ * Session metadata
+ */
+export interface SessionInfo {
+    /** Computed session key */
+    key: string;
+    /** Key components */
+    components: SessionKeyComponents;
+    /** Session scope used */
+    scope: SessionScope;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last activity timestamp */
+    lastActivityAt: Date;
+    /** Message count */
+    messageCount: number;
+}
+export declare const DEFAULT_SESSION_ISOLATION_CONFIG: SessionIsolationConfig;
+export declare class SessionIsolator extends EventEmitter {
+    private config;
+    private sessions;
+    private cleanupTimer;
+    constructor(config?: Partial<SessionIsolationConfig>);
+    /**
+     * Set or replace the identity linker used for canonical identity resolution
+     */
+    setIdentityLinker(linker: IdentityLinker | undefined): void;
+    /**
+     * Generate session key for an inbound message.
+     *
+     * If an identity linker is configured, the sender's peer ID is resolved
+     * to its canonical identity ID before computing the session key. This
+     * allows the same person on different channels to share a session when
+     * their identities are linked.
+     */
+    getSessionKey(message: InboundMessage, accountId?: string): string;
+    /**
+     * Generate session key from explicit components
+     */
+    computeSessionKey(components: SessionKeyComponents): string;
+    /**
+     * Get the scope for a given channel type
+     */
+    getScopeForChannel(channelType: ChannelType): SessionScope;
+    /**
+     * Check if two session keys are isolated from each other
+     */
+    areIsolated(key1: string, key2: string): boolean;
+    /**
+     * Get session info
+     */
+    getSession(key: string): SessionInfo | undefined;
+    /**
+     * List all active sessions
+     */
+    listSessions(): SessionInfo[];
+    /**
+     * List sessions for a specific channel
+     */
+    listSessionsForChannel(channelType: ChannelType): SessionInfo[];
+    /**
+     * List sessions for a specific peer across all channels
+     */
+    listSessionsForPeer(peerId: string): SessionInfo[];
+    /**
+     * Remove a session
+     */
+    removeSession(key: string): boolean;
+    /**
+     * Set scope for a specific channel
+     */
+    setChannelScope(channelType: ChannelType, scope: SessionScope): void;
+    /**
+     * Clean up expired sessions
+     */
+    private cleanupExpiredSessions;
+    /**
+     * Evict the oldest session when at capacity
+     */
+    private evictOldestSession;
+    /**
+     * Get isolation statistics
+     */
+    getStats(): {
+        totalSessions: number;
+        sessionsByScope: Record<SessionScope, number>;
+        sessionsByChannel: Record<string, number>;
+        oldestSession: Date | null;
+        newestSession: Date | null;
+    };
+    /**
+     * Dispose the isolator
+     */
+    dispose(): void;
+}
+export declare function getSessionIsolator(config?: Partial<SessionIsolationConfig>): SessionIsolator;
+export declare function resetSessionIsolator(): void;