kemdicode-mcp 1.15.0

package/dist/recursive/tool-invoker.js.map

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

package/dist/recursive/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Recursive Tool Types
+ *
+ * TypeScript interfaces for recursive tool invocation system.
+ *
+ * @module recursive/types
+ */
+/** Tool invocation request */
+export interface ToolInvocationRequest {
+    invocationId: string;
+    agentId: string;
+    sessionId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    parentInvocationId?: string;
+    reason?: string;
+    timestamp: number;
+}
+/** Tool invocation result */
+export interface ToolInvocationResult {
+    invocationId: string;
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    duration: number;
+    depth: number;
+}
+/** Invocation policy */
+export interface InvocationPolicy {
+    /** Maximum nesting depth (default: 5) */
+    maxDepth: number;
+    /** Max invocations per minute per agent */
+    maxInvocationsPerMinute: number;
+    /** Tools requiring supervisor approval */
+    requiresApproval: string[];
+    /** Blocked tools (cannot be invoked recursively) */
+    blockedTools: string[];
+    /** Whether workers can invoke tools */
+    allowWorkerInvocation: boolean;
+}
+/**
+ * Default policy for recursive tool invocation
+ *
+ * @description Allows multi-level agent invocation with safety limits:
+ *   - Agent -> invoke-tool -> Tool (depth 1) ✅
+ *   - Agent -> invoke-tool -> invoke-tool -> Tool (depth 2) ✅
+ *   - Deeper recursive invoke-tool chains are blocked in tool-invoker.ts
+ *   - Overall max depth: 5 (for any tool)
+ *   - Rate limit: 30 invocations/min per agent
+ */
+export declare const DEFAULT_POLICY: InvocationPolicy;
+/** Safety check result */
+export interface SafetyCheckResult {
+    allowed: boolean;
+    reason?: string;
+    requiresSupervisorApproval?: boolean;
+    currentDepth?: number;
+    rateLimit?: {
+        current: number;
+        max: number;
+        resetIn: number;
+    };
+}
+/** Invocation context (tracks call chain) */
+export interface InvocationContext {
+    rootInvocationId: string;
+    currentDepth: number;
+    chain: string[];
+    startTime: number;
+}
+/** Rate limit entry */
+export interface RateLimitEntry {
+    count: number;
+    windowStart: number;
+}
+/** Redis key prefixes */
+export declare const RECURSIVE_KEYS: {
+    /** Invocation data - mcp:invoke:{invocationId} */
+    invocation: (id: string) => string;
+    /** Agent rate limit - mcp:invoke:rate:{agentId} */
+    rateLimit: (agentId: string) => string;
+    /** Invocation chain - mcp:invoke:chain:{rootId} */
+    chain: (rootId: string) => string;
+    /** Agent invocation log - mcp:invoke:log:{agentId} */
+    log: (agentId: string) => string;
+};
+/** Invocation TTL (1 hour) */
+export declare const INVOCATION_TTL: number;
+/** Rate limit window (1 minute) */
+export declare const RATE_LIMIT_WINDOW: number;
+/** Max log entries per agent */
+export declare const MAX_LOG_ENTRIES = 100;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recursive/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;GAMG;AAEH,8BAA8B;AAC9B,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,uBAAuB,EAAE,MAAM,CAAC;IAChC,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oDAAoD;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uCAAuC;IACvC,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,gBAM5B,CAAC;AAEF,0BAA0B;AAC1B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,yBAAyB;AACzB,eAAO,MAAM,cAAc;IACzB,kDAAkD;qBACjC,MAAM;IACvB,mDAAmD;yBAC9B,MAAM;IAC3B,mDAAmD;oBACnC,MAAM;IACtB,sDAAsD;mBACvC,MAAM;CACtB,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,cAAc,QAAU,CAAC;AAEtC,mCAAmC;AACnC,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAE3C,gCAAgC;AAChC,eAAO,MAAM,eAAe,MAAM,CAAC"}

package/dist/recursive/types.js

@@ -0,0 +1,52 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Default policy for recursive tool invocation
+ *
+ * @description Allows multi-level agent invocation with safety limits:
+ *   - Agent -> invoke-tool -> Tool (depth 1) ✅
+ *   - Agent -> invoke-tool -> invoke-tool -> Tool (depth 2) ✅
+ *   - Deeper recursive invoke-tool chains are blocked in tool-invoker.ts
+ *   - Overall max depth: 5 (for any tool)
+ *   - Rate limit: 30 invocations/min per agent
+ */
+export const DEFAULT_POLICY = {
+    maxDepth: 5,
+    maxInvocationsPerMinute: 30,
+    requiresApproval: ['shell-exec', 'file-write'],
+    blockedTools: [], // Recursive invoke-tool limited to depth 2 in tool-invoker.ts
+    allowWorkerInvocation: true,
+};
+/** Redis key prefixes */
+export const RECURSIVE_KEYS = {
+    /** Invocation data - mcp:invoke:{invocationId} */
+    invocation: (id) => `mcp:invoke:${id}`,
+    /** Agent rate limit - mcp:invoke:rate:{agentId} */
+    rateLimit: (agentId) => `mcp:invoke:rate:${agentId}`,
+    /** Invocation chain - mcp:invoke:chain:{rootId} */
+    chain: (rootId) => `mcp:invoke:chain:${rootId}`,
+    /** Agent invocation log - mcp:invoke:log:{agentId} */
+    log: (agentId) => `mcp:invoke:log:${agentId}`,
+};
+/** Invocation TTL (1 hour) */
+export const INVOCATION_TTL = 60 * 60;
+/** Rate limit window (1 minute) */
+export const RATE_LIMIT_WINDOW = 60 * 1000;
+/** Max log entries per agent */
+export const MAX_LOG_ENTRIES = 100;
+//# sourceMappingURL=types.js.map

package/dist/recursive/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recursive/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8CH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,QAAQ,EAAE,CAAC;IACX,uBAAuB,EAAE,EAAE;IAC3B,gBAAgB,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;IAC9C,YAAY,EAAE,EAAE,EAAE,8DAA8D;IAChF,qBAAqB,EAAE,IAAI;CAC5B,CAAC;AA6BF,yBAAyB;AACzB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,kDAAkD;IAClD,UAAU,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,cAAc,EAAE,EAAE;IAC9C,mDAAmD;IACnD,SAAS,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,mBAAmB,OAAO,EAAE;IAC5D,mDAAmD;IACnD,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,oBAAoB,MAAM,EAAE;IACvD,sDAAsD;IACtD,GAAG,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,kBAAkB,OAAO,EAAE;CACtD,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,CAAC;AAEtC,mCAAmC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C,gCAAgC;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC"}

package/dist/rl/dopamine.d.ts

@@ -0,0 +1,96 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * RL Dopamine Module
+ *
+ * Provides immediate "dopamine hit" feedback signals for agent actions.
+ * These signals are separate from shaped rewards and provide instant feedback.
+ */
+import { RedisBackedService } from '../infrastructure/redis/redis-backed-service.js';
+import type { DopamineSignal, DopamineTrigger, DopamineStats } from './types.js';
+/**
+ * Dopamine Emitter configuration
+ */
+export interface DopamineEmitterConfig {
+    /** Maximum signals to keep per agent */
+    maxSignals?: number;
+    /** Signal TTL in seconds */
+    signalTtl?: number;
+}
+/**
+ * Dopamine Emitter
+ */
+export declare class DopamineEmitter extends RedisBackedService {
+    protected get serviceName(): string;
+    private config;
+    constructor(config?: DopamineEmitterConfig);
+    /**
+     * Emit a dopamine signal
+     */
+    emit(agentId: string, trigger: DopamineTrigger, options?: {
+        intensityMultiplier?: number;
+        action?: string;
+        customMessage?: string;
+        duration?: number;
+    }): Promise<DopamineSignal | null>;
+    /**
+     * Emit tool success signal
+     */
+    toolSuccess(agentId: string, toolName: string, durationMs?: number): Promise<DopamineSignal | null>;
+    /**
+     * Emit tool failure signal
+     */
+    toolFailure(agentId: string, toolName: string): Promise<DopamineSignal | null>;
+    /**
+     * Emit task completed signal
+     */
+    taskCompleted(agentId: string, taskName?: string): Promise<DopamineSignal | null>;
+    /**
+     * Emit pattern discovered signal
+     */
+    patternDiscovered(agentId: string, patternName?: string): Promise<DopamineSignal | null>;
+    /**
+     * Emit repeated error signal
+     */
+    repeatedError(agentId: string, errorType?: string): Promise<DopamineSignal | null>;
+    /**
+     * Emit collaboration success signal
+     */
+    collaborationSuccess(agentId: string, peerId?: string): Promise<DopamineSignal | null>;
+    /**
+     * Get recent signals for an agent
+     */
+    getRecentSignals(agentId: string, limit?: number): Promise<DopamineSignal[]>;
+    /**
+     * Get dopamine statistics
+     */
+    getStats(agentId: string): Promise<DopamineStats | null>;
+    /**
+     * Clear all signals for an agent
+     */
+    clearSignals(agentId: string): Promise<boolean>;
+}
+/**
+ * Get the global dopamine emitter
+ */
+export declare function getDopamineEmitter(): DopamineEmitter;
+/**
+ * Reset the global dopamine emitter (for testing)
+ */
+export declare function resetDopamineEmitter(): void;
+//# sourceMappingURL=dopamine.d.ts.map

package/dist/rl/dopamine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dopamine.d.ts","sourceRoot":"","sources":["../../src/rl/dopamine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,aAAa,EAEd,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACrD,SAAS,KAAK,WAAW,WAAgC;IACzD,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,GAAE,qBAA0B;IAQ9C;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE;QACP,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd,GACL,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAuCjC;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAQjC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIpF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAOvF;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAM9F;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAMxF;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAQ5F;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsBtF;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsD9D;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAatD;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/rl/dopamine.js

@@ -0,0 +1,242 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * RL Dopamine Module
+ *
+ * Provides immediate "dopamine hit" feedback signals for agent actions.
+ * These signals are separate from shaped rewards and provide instant feedback.
+ */
+import { RedisBackedService } from '../infrastructure/redis/redis-backed-service.js';
+import { DOPAMINE_TRIGGERS, RL_KEYS } from './types.js';
+import { randomBytes } from 'crypto';
+/**
+ * Dopamine Emitter
+ */
+export class DopamineEmitter extends RedisBackedService {
+    get serviceName() { return 'DopamineEmitter'; }
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            maxSignals: config.maxSignals || 500,
+            signalTtl: config.signalTtl || 3600, // 1 hour
+        };
+    }
+    /**
+     * Emit a dopamine signal
+     */
+    async emit(agentId, trigger, options = {}) {
+        if (!this.isConnected() || !this.redis)
+            return null;
+        try {
+            const config = DOPAMINE_TRIGGERS[trigger];
+            const intensity = config.baseIntensity * (options.intensityMultiplier || 1.0);
+            const signal = {
+                id: `dopa_${Date.now()}_${randomBytes(4).toString('hex')}`,
+                agentId,
+                type: config.signalType,
+                intensity: Math.max(-1, Math.min(1, intensity)), // Clamp to [-1, 1]
+                trigger,
+                timestamp: Date.now(),
+                duration: options.duration,
+                action: options.action,
+                message: options.customMessage || config.message,
+            };
+            // Store signal
+            const key = RL_KEYS.dopamine(agentId);
+            await this.redis.zadd(key, signal.timestamp, JSON.stringify(signal));
+            // Trim to max size
+            const count = await this.redis.zcard(key);
+            if (count > this.config.maxSignals) {
+                await this.redis.zremrangebyrank(key, 0, count - this.config.maxSignals - 1);
+            }
+            // Set TTL
+            await this.redis.expire(key, this.config.signalTtl);
+            return signal;
+        }
+        catch (error) {
+            console.error('[DopamineEmitter] Error emitting signal:', error);
+            return null;
+        }
+    }
+    /**
+     * Emit tool success signal
+     */
+    async toolSuccess(agentId, toolName, durationMs) {
+        // Fast success (< 1 second) gets a bigger hit
+        if (durationMs !== undefined && durationMs < 1000) {
+            return this.emit(agentId, 'tool_fast_success', { action: toolName });
+        }
+        return this.emit(agentId, 'tool_success', { action: toolName });
+    }
+    /**
+     * Emit tool failure signal
+     */
+    async toolFailure(agentId, toolName) {
+        return this.emit(agentId, 'tool_failure', { action: toolName });
+    }
+    /**
+     * Emit task completed signal
+     */
+    async taskCompleted(agentId, taskName) {
+        return this.emit(agentId, 'task_completed', {
+            action: taskName,
+            customMessage: taskName ? `Task completed: ${taskName}` : 'Task completed!',
+        });
+    }
+    /**
+     * Emit pattern discovered signal
+     */
+    async patternDiscovered(agentId, patternName) {
+        return this.emit(agentId, 'pattern_discovered', {
+            customMessage: patternName ? `Pattern discovered: ${patternName}` : 'New pattern identified!',
+        });
+    }
+    /**
+     * Emit repeated error signal
+     */
+    async repeatedError(agentId, errorType) {
+        return this.emit(agentId, 'repeated_error', {
+            customMessage: errorType ? `Repeated error: ${errorType}` : 'Repeated error detected',
+        });
+    }
+    /**
+     * Emit collaboration success signal
+     */
+    async collaborationSuccess(agentId, peerId) {
+        return this.emit(agentId, 'collaboration_success', {
+            customMessage: peerId
+                ? `Successful collaboration with ${peerId}`
+                : 'Successful collaboration',
+        });
+    }
+    /**
+     * Get recent signals for an agent
+     */
+    async getRecentSignals(agentId, limit = 20) {
+        if (!this.isConnected() || !this.redis)
+            return [];
+        try {
+            const key = RL_KEYS.dopamine(agentId);
+            const entries = await this.redis.zrevrange(key, 0, limit - 1);
+            return entries
+                .map((entry) => {
+                try {
+                    return JSON.parse(entry);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((s) => s !== null);
+        }
+        catch (error) {
+            console.error('[DopamineEmitter] Error getting signals:', error);
+            return [];
+        }
+    }
+    /**
+     * Get dopamine statistics
+     */
+    async getStats(agentId) {
+        if (!this.isConnected() || !this.redis)
+            return null;
+        try {
+            const key = RL_KEYS.dopamine(agentId);
+            const allSignals = await this.redis.zrange(key, 0, -1);
+            if (allSignals.length === 0) {
+                return null;
+            }
+            const signals = allSignals
+                .map((s) => {
+                try {
+                    return JSON.parse(s);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((s) => s !== null);
+            // Count by type
+            const byType = {
+                spike: 0,
+                dip: 0,
+                sustained: 0,
+                baseline: 0,
+            };
+            const byTrigger = {};
+            let totalIntensity = 0;
+            for (const signal of signals) {
+                byType[signal.type]++;
+                byTrigger[signal.trigger] = (byTrigger[signal.trigger] || 0) + 1;
+                totalIntensity += signal.intensity;
+            }
+            // Get recent signals
+            const recentSignals = signals.slice(-20).reverse();
+            return {
+                agentId,
+                totalSignals: signals.length,
+                byType,
+                byTrigger: byTrigger,
+                averageIntensity: signals.length > 0 ? totalIntensity / signals.length : 0,
+                recentSignals,
+            };
+        }
+        catch (error) {
+            console.error('[DopamineEmitter] Error getting stats:', error);
+            return null;
+        }
+    }
+    /**
+     * Clear all signals for an agent
+     */
+    async clearSignals(agentId) {
+        if (!this.isConnected() || !this.redis)
+            return false;
+        try {
+            const key = RL_KEYS.dopamine(agentId);
+            await this.redis.del(key);
+            return true;
+        }
+        catch (error) {
+            console.error('[DopamineEmitter] Error clearing signals:', error);
+            return false;
+        }
+    }
+}
+// Singleton instance
+let dopamineEmitter = null;
+/**
+ * Get the global dopamine emitter
+ */
+export function getDopamineEmitter() {
+    if (!dopamineEmitter) {
+        dopamineEmitter = new DopamineEmitter();
+    }
+    return dopamineEmitter;
+}
+/**
+ * Reset the global dopamine emitter (for testing)
+ */
+export function resetDopamineEmitter() {
+    if (dopamineEmitter) {
+        dopamineEmitter.disconnect().catch(console.error);
+    }
+    dopamineEmitter = null;
+}
+//# sourceMappingURL=dopamine.js.map

package/dist/rl/dopamine.js.map

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

package/dist/rl/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * RL (Reinforcement Learning) Module
+ *
+ * Provides potential-based reward shaping with dopamine signals
+ * to guide agent behavior through intrinsic motivation.
+ */
+export type { AgentState, PotentialWeights, IntrinsicRewards, ShapedReward, DopamineSignal, DopamineSignalType, DopamineTrigger, DopamineTriggerConfig, RewardHistoryEntry, RewardStats, DopamineStats, WeightLearningConfig, } from './types.js';
+export { DEFAULT_POTENTIAL_WEIGHTS, DEFAULT_INTRINSIC_REWARDS, DOPAMINE_TRIGGERS, RL_KEYS, GAMMA, DEFAULT_WEIGHT_LEARNING_CONFIG, } from './types.js';
+export { StateTracker, getStateTracker, resetStateTracker, type StateTrackerConfig, type StateUpdate, } from './state-tracker.js';
+export { calculatePotential, potentialDifference, calculateShapedReward, normalizeWeights, analyzePotential, suggestOptimalAction, } from './potential.js';
+export { getIntrinsicReward, shapeReward, RewardTracker, getRewardTracker, resetRewardTracker, type RewardTrackerConfig, } from './rewards.js';
+export { DopamineEmitter, getDopamineEmitter, resetDopamineEmitter, type DopamineEmitterConfig, } from './dopamine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AAGH,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,iBAAiB,EACjB,OAAO,EACP,KAAK,EACL,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC"}

package/dist/rl/index.js

@@ -0,0 +1,27 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+export { DEFAULT_POTENTIAL_WEIGHTS, DEFAULT_INTRINSIC_REWARDS, DOPAMINE_TRIGGERS, RL_KEYS, GAMMA, DEFAULT_WEIGHT_LEARNING_CONFIG, } from './types.js';
+// State tracking
+export { StateTracker, getStateTracker, resetStateTracker, } from './state-tracker.js';
+// Potential function
+export { calculatePotential, potentialDifference, calculateShapedReward, normalizeWeights, analyzePotential, suggestOptimalAction, } from './potential.js';
+// Rewards
+export { getIntrinsicReward, shapeReward, RewardTracker, getRewardTracker, resetRewardTracker, } from './rewards.js';
+// Dopamine
+export { DopamineEmitter, getDopamineEmitter, resetDopamineEmitter, } from './dopamine.js';
+//# sourceMappingURL=index.js.map

package/dist/rl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyBH,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,iBAAiB,EACjB,OAAO,EACP,KAAK,EACL,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAGlB,MAAM,oBAAoB,CAAC;AAE5B,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,UAAU;AACV,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,cAAc,CAAC;AAEtB,WAAW;AACX,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,eAAe,CAAC"}