cognitive-core 0.1.0 → 0.1.2

package/dist/learning/team-ingester.js

@@ -0,0 +1,333 @@
+/**
+ * Team Trajectory Ingester
+ *
+ * Computational pre-processing of team trajectories before agentic analysis.
+ * Builds interaction graphs, computes structural metrics, compresses
+ * per-agent trajectories, and scores critical steps/interactions.
+ *
+ * No LLM calls — purely structural/heuristic processing.
+ */
+const DEFAULT_COMPRESSION_CONFIG = {
+    maxTokensPerAgent: 5000,
+    preserveInteractionBoundaries: true,
+    foldThreshold: 5,
+    maxCriticalRatio: 0.25,
+    criticalStepThreshold: 0.3,
+    criticalInteractionThreshold: 0.3,
+};
+// ============================================================
+// Ingester
+// ============================================================
+export class TeamTrajectoryIngester {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_COMPRESSION_CONFIG, ...config };
+    }
+    /**
+     * Ingest a team trajectory: compute metrics, score steps/interactions,
+     * identify critical moments.
+     *
+     * Uses graph data (members[], interactions[]) for content-based scoring.
+     */
+    ingest(trajectory) {
+        // 1. Compute structural metrics from graph data
+        const structuralMetrics = this.computeStructuralMetrics(trajectory);
+        // 2. Score and identify critical steps from member trajectories
+        const scoredSteps = this.scoreGraphSteps(trajectory.members, trajectory);
+        const criticalSteps = this.selectCritical(scoredSteps, this.config.criticalStepThreshold, this.config.maxCriticalRatio);
+        // 3. Score and identify critical interactions
+        const scoredInteractions = this.scoreGraphInteractions(trajectory.interactions, trajectory.members, trajectory);
+        const criticalInteractions = this.selectCriticalInteractions(scoredInteractions, this.config.criticalInteractionThreshold);
+        const totalItems = trajectory.members.reduce((s, m) => s + m.trajectory.steps.length, 0);
+        return {
+            teamTrajectory: trajectory,
+            structuralMetrics,
+            criticalSteps,
+            criticalInteractions,
+            compressionStats: {
+                originalEventCount: totalItems,
+                criticalEventCount: criticalSteps.length,
+                criticalRatio: totalItems > 0 ? criticalSteps.length / totalItems : 0,
+            },
+            graphMetrics: trajectory.graphMetrics,
+        };
+    }
+    /**
+     * Compute structural metrics from graph data.
+     */
+    computeStructuralMetrics(trajectory) {
+        const gm = trajectory.graphMetrics;
+        return {
+            teamSize: gm.teamSize,
+            totalEvents: gm.totalSteps,
+            totalInteractions: gm.totalInteractions,
+            interactionDensity: gm.interactionDensity,
+            maxInDegree: { role: gm.maxInDegree.agentId, count: gm.maxInDegree.count },
+            maxOutDegree: { role: gm.maxOutDegree.agentId, count: gm.maxOutDegree.count },
+            parallelismRatio: gm.parallelismRatio,
+            totalWallTimeSeconds: gm.totalWallTimeSeconds,
+            totalTokens: gm.totalTokens,
+        };
+    }
+    /**
+     * Select critical steps above threshold, respecting max ratio.
+     */
+    selectCritical(scored, threshold, maxRatio) {
+        const aboveThreshold = scored
+            .filter((s) => s.scores.total >= threshold)
+            .sort((a, b) => b.scores.total - a.scores.total);
+        const maxCount = Math.max(1, Math.ceil(scored.length * maxRatio));
+        return aboveThreshold.slice(0, maxCount);
+    }
+    /**
+     * Select critical interactions above threshold.
+     */
+    selectCriticalInteractions(scored, threshold) {
+        return scored
+            .filter((i) => i.scores.total >= threshold)
+            .sort((a, b) => b.scores.total - a.scores.total);
+    }
+    // ============================================================
+    // Graph-Aware Scoring (when members[] / interactions[] available)
+    // ============================================================
+    /**
+     * Score actual trajectory steps from member trajectories.
+     * Uses content-based heuristics (thought/action/observation text)
+     * in addition to position and interaction scoring.
+     */
+    scoreGraphSteps(members, trajectory) {
+        const interactionSteps = new Set();
+        if (trajectory.interactions) {
+            for (const interaction of trajectory.interactions) {
+                interactionSteps.add(`${interaction.from.agentId}:${interaction.from.stepIndex}`);
+                interactionSteps.add(`${interaction.to.agentId}:${interaction.to.stepIndex}`);
+            }
+        }
+        const allScored = [];
+        for (const member of members) {
+            const steps = member.trajectory.steps;
+            const totalSteps = steps.length;
+            if (totalSteps === 0)
+                continue;
+            for (let i = 0; i < totalSteps; i++) {
+                const step = steps[i];
+                // Position score: early and late steps are more important
+                const normalizedPos = totalSteps > 1 ? i / (totalSteps - 1) : 0.5;
+                const positionScore = 1 - 4 * Math.pow(normalizedPos - 0.5, 2);
+                // Action type score based on step content
+                const actionScore = this.scoreStepAction(step);
+                // Interaction bonus: is this step involved in an agent interaction?
+                const isInteractionStep = interactionSteps.has(`${member.agentId}:${i}`);
+                const interactionBonus = isInteractionStep ? 0.3 : 0;
+                // Content-based score: look at thought/action/observation text
+                const contentScore = this.scoreStepContent(step);
+                // Weighted total (content replaces some of the action weight)
+                const total = positionScore * 0.2 +
+                    actionScore * 0.25 +
+                    interactionBonus * 0.25 +
+                    contentScore * 0.3;
+                // Create a synthetic TeamEvent for backward compatibility
+                const syntheticEvent = {
+                    timestamp: step.timestamp ?? new Date(),
+                    type: this.stepActionToEventType(step),
+                    agentId: member.agentId,
+                    role: member.role,
+                    payload: { action: step.action, observation: step.observation },
+                };
+                allScored.push({
+                    agentId: member.agentId,
+                    role: member.role,
+                    eventIndex: i, // maps to step index within the flattened event list
+                    event: syntheticEvent,
+                    scores: {
+                        position: positionScore,
+                        actionType: actionScore,
+                        interactionBonus,
+                        total,
+                    },
+                    // Graph-enriched fields
+                    stepIndex: i,
+                    stepContent: {
+                        thought: step.thought,
+                        action: step.action,
+                        observation: step.observation,
+                    },
+                    contentScore,
+                });
+            }
+        }
+        return allScored;
+    }
+    /**
+     * Score a step's action text for importance.
+     */
+    scoreStepAction(step) {
+        const action = step.action.toLowerCase();
+        if (action.includes('delegate') || action.includes('assign'))
+            return 0.7;
+        if (action.includes('error') || action.includes('fail'))
+            return 0.8;
+        if (action.includes('complete') || action.includes('finish'))
+            return 0.7;
+        if (action.includes('decide') || action.includes('choose'))
+            return 0.6;
+        if (action.includes('plan') || action.includes('design'))
+            return 0.5;
+        if (action.includes('signal') || action.includes('emit'))
+            return 0.4;
+        if (action.includes('read') || action.includes('search'))
+            return 0.2;
+        return 0.3;
+    }
+    /**
+     * Content-based scoring: analyze thought/action/observation text
+     * for indicators of importance.
+     */
+    scoreStepContent(step) {
+        let score = 0;
+        const text = [step.thought ?? '', step.action, step.observation].join(' ').toLowerCase();
+        // Error/failure indicators are highly important
+        if (text.includes('error') || text.includes('exception') || text.includes('failed')) {
+            score += 0.3;
+        }
+        // Decision points
+        if (text.includes('decided') || text.includes('choosing') || text.includes('selected')) {
+            score += 0.2;
+        }
+        // Coordination events
+        if (text.includes('delegat') || text.includes('coordin') || text.includes('handoff')) {
+            score += 0.2;
+        }
+        // Success/completion
+        if (text.includes('success') || text.includes('completed') || text.includes('resolved')) {
+            score += 0.2;
+        }
+        // Thought present (reasoning visible)
+        if (step.thought && step.thought.length > 50) {
+            score += 0.1;
+        }
+        return Math.min(score, 1.0);
+    }
+    /**
+     * Map step action text to TeamEventType.
+     */
+    stepActionToEventType(step) {
+        const action = step.action.toLowerCase();
+        if (action.includes('delegate'))
+            return 'task_delegated';
+        if (action.includes('signal') || action.includes('emit'))
+            return 'signal_emitted';
+        if (action.includes('message') || action.includes('send'))
+            return 'message_sent';
+        if (action.includes('plan'))
+            return 'plan_proposed';
+        if (action.includes('escalat'))
+            return 'escalation';
+        return 'task_completed';
+    }
+    /**
+     * Score step-level AgentInteraction objects.
+     * Richer than flat InteractionEdge scoring: uses content, latency,
+     * wasExpected flag, and downstream success analysis.
+     */
+    scoreGraphInteractions(interactions, members, trajectory) {
+        if (interactions.length === 0)
+            return [];
+        // Build a map of member trajectories for downstream analysis
+        const memberMap = new Map();
+        for (const m of members) {
+            memberMap.set(m.agentId, m);
+        }
+        // Also build flat edge map for backward-compatible CriticalInteraction.edge
+        const edgeMap = new Map();
+        for (const edge of trajectory.interactionGraph) {
+            edgeMap.set(`${edge.from}->${edge.to}`, edge);
+        }
+        return interactions.map((interaction) => {
+            // Volume score: normalize by total interactions
+            const volume = 1 / interactions.length;
+            // Type diversity bonus: certain types are more critical
+            const typeBonuses = {
+                delegation: 0.3,
+                result_return: 0.25,
+                escalation: 0.35,
+                signal: 0.15,
+                message: 0.1,
+                spawn: 0.2,
+            };
+            const typeBonus = typeBonuses[interaction.type] ?? 0.1;
+            // Latency penalty
+            const latencyPenalty = interaction.latencyMs
+                ? Math.min(interaction.latencyMs / 10000, 0.3)
+                : 0;
+            // Expected pattern bonus: unexpected interactions are more noteworthy
+            const unexpectedBonus = interaction.wasExpected ? 0 : 0.15;
+            // Downstream success: check if the target agent succeeded after this interaction
+            const downstreamSuccessScore = this.computeDownstreamSuccess(interaction, memberMap);
+            const total = Math.max(0, volume * 0.2 +
+                typeBonus * 0.25 +
+                unexpectedBonus * 0.15 +
+                downstreamSuccessScore * 0.2 -
+                latencyPenalty * 0.2);
+            // Find the matching flat edge for backward compatibility
+            const edgeKey = `${interaction.from.role}->${interaction.to.role}`;
+            const edge = edgeMap.get(edgeKey) ?? {
+                from: interaction.from.role,
+                to: interaction.to.role,
+                count: 1,
+                types: [],
+            };
+            return {
+                edge,
+                scores: {
+                    volume,
+                    diversityBonus: typeBonus + unexpectedBonus,
+                    latencyPenalty,
+                    total,
+                },
+                // Graph-enriched fields
+                interaction,
+                downstreamSuccessScore,
+            };
+        });
+    }
+    /**
+     * Check downstream success: did the target agent complete steps
+     * successfully after receiving this interaction?
+     */
+    computeDownstreamSuccess(interaction, memberMap) {
+        const targetMember = memberMap.get(interaction.to.agentId);
+        if (!targetMember)
+            return 0.5;
+        const steps = targetMember.trajectory.steps;
+        const startIdx = interaction.to.stepIndex;
+        // Look at up to 5 steps after the interaction
+        const downstreamSteps = steps.slice(startIdx, startIdx + 5);
+        if (downstreamSteps.length === 0)
+            return 0.5;
+        let successIndicators = 0;
+        let failureIndicators = 0;
+        for (const step of downstreamSteps) {
+            const text = [step.action, step.observation].join(' ').toLowerCase();
+            if (text.includes('success') || text.includes('completed') || text.includes('pass')) {
+                successIndicators++;
+            }
+            if (text.includes('error') || text.includes('fail') || text.includes('exception')) {
+                failureIndicators++;
+            }
+        }
+        if (successIndicators > failureIndicators)
+            return 0.8;
+        if (failureIndicators > successIndicators)
+            return 0.2;
+        // Also consider overall trajectory outcome
+        return targetMember.trajectory.outcome?.success ? 0.6 : 0.4;
+    }
+}
+/**
+ * Create a TeamTrajectoryIngester instance.
+ */
+export function createTeamTrajectoryIngester(config) {
+    return new TeamTrajectoryIngester(config);
+}
+//# sourceMappingURL=team-ingester.js.map

package/dist/learning/team-ingester.js.map

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

package/dist/learning/team-meta-learner.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Team Meta-Learner
+ *
+ * Learns about team formation and coordination decisions.
+ * Analyzes TeamMetaObservations to generate TeamMetaStrategies.
+ * Adjusts team recommendations based on learned patterns.
+ *
+ * The team-level analog of MetaLearner.
+ */
+import type { TeamMetaObservation, TeamMetaStrategy, TeamTrajectory } from '../types/index.js';
+import type { TeamExperienceMemory } from '../memory/team-experience.js';
+import type { TeamRecommendation, TeamRecommendationInput } from '../search/team-router.js';
+export interface TeamMetaLearnerConfig {
+    /** Minimum observations before generating strategies */
+    minObservationsForStrategies: number;
+    /** How often to run strategy generation (in observations) */
+    strategyGenerationInterval: number;
+    /** Minimum success rate for a topology to generate a prefer-strategy */
+    preferTopologyThreshold: number;
+    /** Maximum coordination overhead before flagging */
+    highOverheadThreshold: number;
+}
+export declare class TeamMetaLearner {
+    private memory;
+    private config;
+    private observationCount;
+    constructor(memory: TeamExperienceMemory, config?: Partial<TeamMetaLearnerConfig>);
+    /**
+     * Generate a meta-observation from a completed team trajectory and
+     * the recommendation that was used to form the team (if any).
+     */
+    generateReflection(trajectory: TeamTrajectory, recommendation?: TeamRecommendation): Promise<TeamMetaObservation>;
+    /**
+     * Analyze accumulated observations and generate team meta-strategies.
+     */
+    learn(): Promise<TeamMetaStrategy[]>;
+    /**
+     * Adjust a team recommendation based on learned meta-strategies.
+     */
+    adjustRecommendation(recommendation: TeamRecommendation, input: TeamRecommendationInput): Promise<TeamRecommendation>;
+    private extractTaskCharacteristics;
+    private analyzeTopologyEffectiveness;
+    private analyzeTeamSizePatterns;
+    private analyzeOverheadPatterns;
+}
+/**
+ * Create a TeamMetaLearner instance.
+ */
+export declare function createTeamMetaLearner(memory: TeamExperienceMemory, config?: Partial<TeamMetaLearnerConfig>): TeamMetaLearner;
+//# sourceMappingURL=team-meta-learner.d.ts.map

package/dist/learning/team-meta-learner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-meta-learner.d.ts","sourceRoot":"","sources":["../../src/learning/team-meta-learner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAMlC,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,4BAA4B,EAAE,MAAM,CAAC;IACrC,6DAA6D;IAC7D,0BAA0B,EAAE,MAAM,CAAC;IACnC,wEAAwE;IACxE,uBAAuB,EAAE,MAAM,CAAC;IAChC,oDAAoD;IACpD,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAaD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAKjF;;;OAGG;IACG,kBAAkB,CACtB,UAAU,EAAE,cAAc,EAC1B,cAAc,CAAC,EAAE,kBAAkB,GAClC,OAAO,CAAC,mBAAmB,CAAC;IA2J/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAiF1C;;OAEG;IACG,oBAAoB,CACxB,cAAc,EAAE,kBAAkB,EAClC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IA+F9B,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,4BAA4B;IA0CpC,OAAO,CAAC,uBAAuB;IAmD/B,OAAO,CAAC,uBAAuB;CA8BhC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,eAAe,CAEjB"}