network-ai 4.15.3 → 5.1.0

package/dist/lib/agent-conversation.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * AgentConversationLog — Per-agent execution & dialogue history.
+ *
+ * Tracks every task execution, tool invocation, and token usage for each agent
+ * so operators can click an agent in the topology and inspect its full history.
+ *
+ * @module AgentConversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentConversationLog = void 0;
+// ============================================================================
+// CONVERSATION LOG
+// ============================================================================
+/**
+ * Collects per-agent execution history.
+ *
+ * @example
+ * ```ts
+ * const log = new AgentConversationLog();
+ * log.recordTurn('agent-1', {
+ *   instruction: 'Summarize the document',
+ *   success: true,
+ *   tokensUsed: 450,
+ *   executionTimeMs: 1200,
+ * });
+ * const conv = log.getConversation('agent-1');
+ * // conv.turns.length === 1
+ * // conv.stats.totalTokensUsed === 450
+ * ```
+ */
+class AgentConversationLog {
+    conversations = new Map();
+    maxTurnsPerAgent;
+    constructor(options) {
+        this.maxTurnsPerAgent = options?.maxTurnsPerAgent ?? 500;
+    }
+    /**
+     * Record a turn for an agent. Returns the assigned turn number.
+     */
+    recordTurn(agentId, turn) {
+        let record = this.conversations.get(agentId);
+        if (!record) {
+            record = { turns: [], turnCounter: 0 };
+            this.conversations.set(agentId, record);
+        }
+        const turnNumber = ++record.turnCounter;
+        const full = {
+            turnNumber,
+            timestamp: turn.timestamp ?? new Date().toISOString(),
+            instruction: turn.instruction,
+            result: turn.result,
+            success: turn.success,
+            errorCode: turn.errorCode,
+            tokensUsed: turn.tokensUsed,
+            executionTimeMs: turn.executionTimeMs,
+            retryAttempts: turn.retryAttempts,
+            adapter: turn.adapter,
+            qualityDecision: turn.qualityDecision,
+            correlationId: turn.correlationId,
+            sourceAgent: turn.sourceAgent,
+            metadata: turn.metadata,
+        };
+        record.turns.push(full);
+        // Evict oldest
+        if (record.turns.length > this.maxTurnsPerAgent) {
+            record.turns.splice(0, record.turns.length - this.maxTurnsPerAgent);
+        }
+        return turnNumber;
+    }
+    /**
+     * Get the full conversation for an agent.
+     */
+    getConversation(agentId) {
+        const record = this.conversations.get(agentId);
+        if (!record)
+            return null;
+        return {
+            agentId,
+            turns: [...record.turns],
+            stats: this.computeStats(record.turns),
+        };
+    }
+    /**
+     * Get stats for an agent without copying all turns.
+     */
+    getStats(agentId) {
+        const record = this.conversations.get(agentId);
+        if (!record)
+            return null;
+        return this.computeStats(record.turns);
+    }
+    /**
+     * Get the most recent N turns for an agent.
+     */
+    getRecentTurns(agentId, count) {
+        const record = this.conversations.get(agentId);
+        if (!record)
+            return [];
+        return record.turns.slice(-count);
+    }
+    /**
+     * List all agent IDs that have recorded turns.
+     */
+    listAgents() {
+        return [...this.conversations.keys()];
+    }
+    /**
+     * Clear the conversation history for a specific agent.
+     */
+    clearAgent(agentId) {
+        this.conversations.delete(agentId);
+    }
+    /**
+     * Clear all conversations.
+     */
+    clear() {
+        this.conversations.clear();
+    }
+    /**
+     * Total number of turns across all agents.
+     */
+    get totalTurns() {
+        let sum = 0;
+        for (const record of this.conversations.values()) {
+            sum += record.turns.length;
+        }
+        return sum;
+    }
+    computeStats(turns) {
+        let successCount = 0;
+        let failureCount = 0;
+        let totalTokensUsed = 0;
+        let totalExecutionTimeMs = 0;
+        for (const t of turns) {
+            if (t.success)
+                successCount++;
+            else
+                failureCount++;
+            totalTokensUsed += t.tokensUsed ?? 0;
+            totalExecutionTimeMs += t.executionTimeMs ?? 0;
+        }
+        return {
+            totalTurns: turns.length,
+            successCount,
+            failureCount,
+            totalTokensUsed,
+            totalExecutionTimeMs,
+            averageExecutionTimeMs: turns.length > 0 ? totalExecutionTimeMs / turns.length : 0,
+            lastActivityAt: turns.length > 0 ? turns[turns.length - 1].timestamp : null,
+        };
+    }
+}
+exports.AgentConversationLog = AgentConversationLog;
+//# sourceMappingURL=agent-conversation.js.map

package/dist/lib/agent-conversation.js.map

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

package/dist/lib/agent-debate.d.ts

@@ -0,0 +1,115 @@
+/**
+ * AgentDebate — Adversarial multi-agent debate and self-critique.
+ *
+ * A proposer agent generates a proposal, then one or more critic agents
+ * challenge it across configurable rounds. The debate continues until
+ * consensus, a round limit, or a confidence threshold is met.
+ *
+ * @module AgentDebate
+ */
+/** A single turn in a debate */
+export interface DebateTurn {
+    round: number;
+    role: 'proposer' | 'critic';
+    agentId: string;
+    content: string;
+    confidence: number;
+    timestamp: number;
+}
+/** Configuration for a debate session */
+export interface DebateConfig {
+    /** Maximum number of debate rounds (default 3) */
+    maxRounds?: number;
+    /** Confidence threshold to accept a proposal without further critique (0-100, default 85) */
+    acceptanceThreshold?: number;
+    /** Minimum confidence from all critics to reach consensus (0-100, default 70) */
+    consensusThreshold?: number;
+    /** Timeout per turn in ms (default 30000) */
+    turnTimeoutMs?: number;
+}
+/** Final outcome of a debate */
+export interface DebateOutcome {
+    /** Whether the proposal was accepted */
+    accepted: boolean;
+    /** Reason for acceptance or rejection */
+    reason: 'consensus' | 'threshold' | 'max_rounds' | 'proposer_withdrew';
+    /** The final (possibly revised) proposal */
+    finalProposal: string;
+    /** Confidence of the final proposal */
+    finalConfidence: number;
+    /** Full debate transcript */
+    transcript: DebateTurn[];
+    /** Number of rounds conducted */
+    rounds: number;
+    /** Total duration in ms */
+    durationMs: number;
+}
+/** Critique result from a critic agent */
+export interface CritiqueResult {
+    /** The critique text */
+    critique: string;
+    /** Critic's confidence in the proposal (0-100, higher = more approving) */
+    confidence: number;
+    /** Whether the critic approves the proposal as-is */
+    approves: boolean;
+}
+/** Revised proposal from the proposer after critique */
+export interface RevisionResult {
+    /** The revised proposal */
+    proposal: string;
+    /** Proposer's confidence in the revised version */
+    confidence: number;
+    /** Whether the proposer wants to withdraw (give up) */
+    withdrawn: boolean;
+}
+/**
+ * Function that a proposer calls to generate or revise a proposal.
+ * Round 0 = initial proposal. Round > 0 = revision after critique.
+ */
+export type ProposerFn = (instruction: string, previousCritiques: DebateTurn[], round: number) => Promise<RevisionResult>;
+/**
+ * Function that a critic calls to evaluate a proposal.
+ */
+export type CriticFn = (proposal: string, instruction: string, round: number) => Promise<CritiqueResult>;
+/**
+ * Orchestrate a multi-round adversarial debate.
+ *
+ * @example
+ * ```ts
+ * const debate = new AgentDebate({
+ *   proposer: { agentId: 'writer', fn: writerFn },
+ *   critics: [
+ *     { agentId: 'reviewer', fn: reviewerFn },
+ *     { agentId: 'security-checker', fn: securityFn },
+ *   ],
+ *   config: { maxRounds: 3, acceptanceThreshold: 90 },
+ * });
+ *
+ * const outcome = await debate.run('Write a secure login handler');
+ * if (outcome.accepted) {
+ *   console.log('Final proposal:', outcome.finalProposal);
+ * }
+ * ```
+ */
+export declare class AgentDebate {
+    private proposer;
+    private critics;
+    private config;
+    constructor(options: {
+        proposer: {
+            agentId: string;
+            fn: ProposerFn;
+        };
+        critics: Array<{
+            agentId: string;
+            fn: CriticFn;
+        }>;
+        config?: DebateConfig;
+    });
+    /**
+     * Run the full debate for a given instruction.
+     */
+    run(instruction: string): Promise<DebateOutcome>;
+    private withTimeout;
+}
+//# sourceMappingURL=agent-debate.d.ts.map

package/dist/lib/agent-debate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-debate.d.ts","sourceRoot":"","sources":["../../lib/agent-debate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,mBAAmB,CAAC;IACvE,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,cAAc,CAAC,CAAC;AAM7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,MAAM,CAAyB;gBAE3B,OAAO,EAAE;QACnB,QAAQ,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,UAAU,CAAA;SAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,QAAQ,CAAA;SAAE,CAAC,CAAC;QAClD,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB;IAWD;;OAEG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YA2GxC,WAAW;CAM1B"}

package/dist/lib/agent-debate.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * AgentDebate — Adversarial multi-agent debate and self-critique.
+ *
+ * A proposer agent generates a proposal, then one or more critic agents
+ * challenge it across configurable rounds. The debate continues until
+ * consensus, a round limit, or a confidence threshold is met.
+ *
+ * @module AgentDebate
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentDebate = void 0;
+// ============================================================================
+// AGENT DEBATE
+// ============================================================================
+/**
+ * Orchestrate a multi-round adversarial debate.
+ *
+ * @example
+ * ```ts
+ * const debate = new AgentDebate({
+ *   proposer: { agentId: 'writer', fn: writerFn },
+ *   critics: [
+ *     { agentId: 'reviewer', fn: reviewerFn },
+ *     { agentId: 'security-checker', fn: securityFn },
+ *   ],
+ *   config: { maxRounds: 3, acceptanceThreshold: 90 },
+ * });
+ *
+ * const outcome = await debate.run('Write a secure login handler');
+ * if (outcome.accepted) {
+ *   console.log('Final proposal:', outcome.finalProposal);
+ * }
+ * ```
+ */
+class AgentDebate {
+    proposer;
+    critics;
+    config;
+    constructor(options) {
+        this.proposer = options.proposer;
+        this.critics = options.critics;
+        this.config = {
+            maxRounds: options.config?.maxRounds ?? 3,
+            acceptanceThreshold: options.config?.acceptanceThreshold ?? 85,
+            consensusThreshold: options.config?.consensusThreshold ?? 70,
+            turnTimeoutMs: options.config?.turnTimeoutMs ?? 30_000,
+        };
+    }
+    /**
+     * Run the full debate for a given instruction.
+     */
+    async run(instruction) {
+        const startMs = Date.now();
+        const transcript = [];
+        let currentProposal = '';
+        let proposalConfidence = 0;
+        for (let round = 0; round < this.config.maxRounds; round++) {
+            // --- Proposer turn ---
+            const previousCritiques = transcript.filter(t => t.role === 'critic');
+            const revision = await this.withTimeout(this.proposer.fn(instruction, previousCritiques, round), this.config.turnTimeoutMs, { proposal: currentProposal || '(timeout)', confidence: 0, withdrawn: true });
+            if (revision.withdrawn) {
+                return {
+                    accepted: false,
+                    reason: 'proposer_withdrew',
+                    finalProposal: currentProposal,
+                    finalConfidence: proposalConfidence,
+                    transcript,
+                    rounds: round + 1,
+                    durationMs: Date.now() - startMs,
+                };
+            }
+            currentProposal = revision.proposal;
+            proposalConfidence = revision.confidence;
+            transcript.push({
+                round,
+                role: 'proposer',
+                agentId: this.proposer.agentId,
+                content: currentProposal,
+                confidence: proposalConfidence,
+                timestamp: Date.now(),
+            });
+            // Early accept if proposer confidence exceeds threshold
+            if (proposalConfidence >= this.config.acceptanceThreshold) {
+                return {
+                    accepted: true,
+                    reason: 'threshold',
+                    finalProposal: currentProposal,
+                    finalConfidence: proposalConfidence,
+                    transcript,
+                    rounds: round + 1,
+                    durationMs: Date.now() - startMs,
+                };
+            }
+            // --- Critic turns ---
+            const critiqueResults = [];
+            for (const critic of this.critics) {
+                const critique = await this.withTimeout(critic.fn(currentProposal, instruction, round), this.config.turnTimeoutMs, { critique: '(timeout)', confidence: 0, approves: false });
+                critiqueResults.push(critique);
+                transcript.push({
+                    round,
+                    role: 'critic',
+                    agentId: critic.agentId,
+                    content: critique.critique,
+                    confidence: critique.confidence,
+                    timestamp: Date.now(),
+                });
+            }
+            // Check consensus — all critics approve with sufficient confidence
+            const allApprove = critiqueResults.every(c => c.approves);
+            const minCriticConfidence = critiqueResults.length > 0
+                ? Math.min(...critiqueResults.map(c => c.confidence))
+                : 0;
+            if (allApprove && minCriticConfidence >= this.config.consensusThreshold) {
+                return {
+                    accepted: true,
+                    reason: 'consensus',
+                    finalProposal: currentProposal,
+                    finalConfidence: Math.min(proposalConfidence, minCriticConfidence),
+                    transcript,
+                    rounds: round + 1,
+                    durationMs: Date.now() - startMs,
+                };
+            }
+        }
+        // Max rounds reached — return the latest proposal
+        return {
+            accepted: false,
+            reason: 'max_rounds',
+            finalProposal: currentProposal,
+            finalConfidence: proposalConfidence,
+            transcript,
+            rounds: this.config.maxRounds,
+            durationMs: Date.now() - startMs,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // INTERNAL
+    // --------------------------------------------------------------------------
+    async withTimeout(promise, timeoutMs, fallback) {
+        const timer = new Promise((resolve) => setTimeout(() => resolve(fallback), timeoutMs));
+        return Promise.race([promise, timer]);
+    }
+}
+exports.AgentDebate = AgentDebate;
+//# sourceMappingURL=agent-debate.js.map

package/dist/lib/agent-debate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-debate.js","sourceRoot":"","sources":["../../lib/agent-debate.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAqFH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,WAAW;IACd,QAAQ,CAAsC;IAC9C,OAAO,CAA2C;IAClD,MAAM,CAAyB;IAEvC,YAAY,OAIX;QACC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC;YACzC,mBAAmB,EAAE,OAAO,CAAC,MAAM,EAAE,mBAAmB,IAAI,EAAE;YAC9D,kBAAkB,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,IAAI,EAAE;YAC5D,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,aAAa,IAAI,MAAM;SACvD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,WAAmB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAiB,EAAE,CAAC;QACpC,IAAI,eAAe,GAAG,EAAE,CAAC;QACzB,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAE3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3D,wBAAwB;YACxB,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YACtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,CAAC,EACvD,IAAI,CAAC,MAAM,CAAC,aAAa,EACzB,EAAE,QAAQ,EAAE,eAAe,IAAI,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAC7E,CAAC;YAEF,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACvB,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,mBAAmB;oBAC3B,aAAa,EAAE,eAAe;oBAC9B,eAAe,EAAE,kBAAkB;oBACnC,UAAU;oBACV,MAAM,EAAE,KAAK,GAAG,CAAC;oBACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC;YACJ,CAAC;YAED,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC;YACpC,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC;YAEzC,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK;gBACL,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAC9B,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE,kBAAkB;gBAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;YAEH,wDAAwD;YACxD,IAAI,kBAAkB,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;gBAC1D,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,WAAW;oBACnB,aAAa,EAAE,eAAe;oBAC9B,eAAe,EAAE,kBAAkB;oBACnC,UAAU;oBACV,MAAM,EAAE,KAAK,GAAG,CAAC;oBACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC;YACJ,CAAC;YAED,uBAAuB;YACvB,MAAM,eAAe,GAAqB,EAAE,CAAC;YAC7C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CACrC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,KAAK,CAAC,EAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EACzB,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAC1D,CAAC;gBAEF,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/B,UAAU,CAAC,IAAI,CAAC;oBACd,KAAK;oBACL,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,QAAQ,CAAC,QAAQ;oBAC1B,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;YAED,mEAAmE;YACnE,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC1D,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC;gBACpD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBACrD,CAAC,CAAC,CAAC,CAAC;YAEN,IAAI,UAAU,IAAI,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACxE,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,WAAW;oBACnB,aAAa,EAAE,eAAe;oBAC9B,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;oBAClE,UAAU;oBACV,MAAM,EAAE,KAAK,GAAG,CAAC;oBACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,YAAY;YACpB,aAAa,EAAE,eAAe;YAC9B,eAAe,EAAE,kBAAkB;YACnC,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAC7B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SACjC,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,WAAW;IACX,6EAA6E;IAErE,KAAK,CAAC,WAAW,CAAI,OAAmB,EAAE,SAAiB,EAAE,QAAW;QAC9E,MAAM,KAAK,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,EAAE,CACvC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAC/C,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;CACF;AAxID,kCAwIC"}

package/dist/lib/agent-memory.d.ts

@@ -0,0 +1,157 @@
+/**
+ * AgentMemory — Multi-layer memory system for agents.
+ *
+ * Three memory layers:
+ * - **Episodic**: per-run short-term memory with time-based decay
+ * - **Procedural**: persistent skill/chain patterns (e.g. SkillComposer recipes)
+ * - **Shared long-term**: cross-agent knowledge base with relevance scoring
+ *
+ * @module AgentMemory
+ */
+/** A single memory entry */
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    tags: string[];
+    createdAt: number;
+    lastAccessed: number;
+    accessCount: number;
+    score: number;
+    metadata: Record<string, unknown>;
+}
+/** Episodic memory entry — decays over time */
+export interface EpisodicEntry extends MemoryEntry {
+    /** Decay half-life in milliseconds */
+    halfLifeMs: number;
+}
+/** Procedural memory entry — persistent skill/pattern */
+export interface ProceduralEntry extends MemoryEntry {
+    /** The pattern type (chain, batch, loop, etc.) */
+    patternType: string;
+    /** Number of times this pattern succeeded */
+    successCount: number;
+    /** Number of times this pattern failed */
+    failureCount: number;
+}
+/** Shared long-term entry — cross-agent knowledge */
+export interface SharedEntry extends MemoryEntry {
+    /** Agent that contributed this knowledge */
+    sourceAgent: string;
+    /** Agents that have accessed this entry */
+    accessedBy: Set<string>;
+}
+/** Query options for memory recall */
+export interface RecallOptions {
+    tags?: string[];
+    maxResults?: number;
+    minScore?: number;
+    /** Only entries newer than this timestamp */
+    since?: number;
+}
+/**
+ * Short-term, per-run memory with exponential time decay.
+ * Entries lose relevance over time; stale entries are pruned.
+ */
+export declare class EpisodicMemory {
+    private entries;
+    private maxEntries;
+    private defaultHalfLifeMs;
+    constructor(options?: {
+        maxEntries?: number;
+        defaultHalfLifeMs?: number;
+    });
+    /** Store a new episodic memory */
+    store(content: string, tags?: string[], metadata?: Record<string, unknown>, halfLifeMs?: number): string;
+    /** Recall entries matching criteria, scored by recency and decay */
+    recall(options?: RecallOptions): EpisodicEntry[];
+    /** Remove a specific entry */
+    remove(id: string): boolean;
+    /** Clear all entries */
+    clear(): void;
+    /** Number of stored entries */
+    size(): number;
+    /** Prune entries below a score threshold */
+    prune(minScore?: number): number;
+    private evict;
+}
+/**
+ * Persistent memory for successful skill/chain patterns.
+ * Agents learn which patterns work and prefer them in future.
+ */
+export declare class ProceduralMemory {
+    private entries;
+    private maxEntries;
+    constructor(options?: {
+        maxEntries?: number;
+    });
+    /** Register a pattern (chain/batch/loop/verify) */
+    register(id: string, content: string, patternType: string, tags?: string[], metadata?: Record<string, unknown>): ProceduralEntry;
+    /** Record success for a pattern — increases its score */
+    recordSuccess(id: string): void;
+    /** Record failure for a pattern — decreases its score */
+    recordFailure(id: string): void;
+    /** Recall top-scoring patterns matching criteria */
+    recall(options?: RecallOptions & {
+        patternType?: string;
+    }): ProceduralEntry[];
+    /** Get a specific pattern by ID */
+    get(id: string): ProceduralEntry | undefined;
+    /** Number of stored patterns */
+    size(): number;
+    /** Clear all patterns */
+    clear(): void;
+    private evict;
+}
+/**
+ * Cross-agent shared knowledge base.
+ * Any agent can contribute; all agents can query.
+ * Relevance scored by tag overlap and access frequency.
+ */
+export declare class SharedLongTermMemory {
+    private entries;
+    private maxEntries;
+    constructor(options?: {
+        maxEntries?: number;
+    });
+    /** Contribute knowledge to the shared store */
+    contribute(sourceAgent: string, content: string, tags?: string[], metadata?: Record<string, unknown>): string;
+    /** Query shared memory, scored by tag overlap and recency */
+    query(agentId: string, options?: RecallOptions): SharedEntry[];
+    /** Get all entries contributed by a specific agent */
+    getByAgent(sourceAgent: string): SharedEntry[];
+    /** Number of stored entries */
+    size(): number;
+    /** Clear all entries */
+    clear(): void;
+    private evict;
+}
+/**
+ * Unified memory system combining all three layers.
+ * Instantiate per-agent for episodic, share ProceduralMemory and
+ * SharedLongTermMemory across agents.
+ *
+ * @example
+ * ```ts
+ * const procedural = new ProceduralMemory();
+ * const shared = new SharedLongTermMemory();
+ *
+ * const agentMemory = new AgentMemory('agent-1', { procedural, shared });
+ * agentMemory.episodic.store('Completed code review', ['review', 'code']);
+ * agentMemory.procedural.recordSuccess('chain-review-fix');
+ * agentMemory.shared.contribute('agent-1', 'Auth service uses JWT', ['auth']);
+ * ```
+ */
+export declare class AgentMemory {
+    readonly agentId: string;
+    readonly episodic: EpisodicMemory;
+    readonly procedural: ProceduralMemory;
+    readonly shared: SharedLongTermMemory;
+    constructor(agentId: string, options?: {
+        episodic?: EpisodicMemory;
+        procedural?: ProceduralMemory;
+        shared?: SharedLongTermMemory;
+    });
+    /** Recall across all layers, merged and ranked by score */
+    recallAll(options?: RecallOptions): MemoryEntry[];
+}
+//# sourceMappingURL=agent-memory.d.ts.map

package/dist/lib/agent-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-memory.d.ts","sourceRoot":"","sources":["../../lib/agent-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO;IAK7E,kCAAkC;IAClC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAkBhH,oEAAoE;IACpE,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,aAAa,EAAE;IA0BpD,8BAA8B;IAC9B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAIb,+BAA+B;IAC/B,IAAI,IAAI,MAAM;IAId,4CAA4C;IAC5C,KAAK,CAAC,QAAQ,SAAO,GAAG,MAAM;IAc9B,OAAO,CAAC,KAAK;CAOd;AAMD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAIjD,mDAAmD;IACnD,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,MAAM,EAAO,EACnB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,eAAe;IA0BlB,yDAAyD;IACzD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ/B,yDAAyD;IACzD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ/B,oDAAoD;IACpD,MAAM,CAAC,OAAO,GAAE,aAAa,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe,EAAE;IAiBjF,mCAAmC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,gCAAgC;IAChC,IAAI,IAAI,MAAM;IAId,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,KAAK;CAMd;AAMD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAIjD,+CAA+C;IAC/C,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM;IAmBT,6DAA6D;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,WAAW,EAAE;IAiClE,sDAAsD;IACtD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE;IAI9C,+BAA+B;IAC/B,IAAI,IAAI,MAAM;IAId,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,KAAK;CAMd;AAMD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,SAAgB,UAAU,EAAE,gBAAgB,CAAC;IAC7C,SAAgB,MAAM,EAAE,oBAAoB,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,MAAM,CAAC,EAAE,oBAAoB,CAAC;KAC1B;IAQR,2DAA2D;IAC3D,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,WAAW,EAAE;CAStD"}