cognitive-core 0.1.0 → 0.2.0

package/dist/learning/reflexion-generator.js

@@ -0,0 +1,194 @@
+/**
+ * ReflexionGenerator — Generates structured self-reflection from completed trajectories.
+ *
+ * Two modes:
+ * - **heuristic** (default, no LLM): Extracts patterns, tool names, file paths,
+ *   error messages, and strategy assessments from trajectory data.
+ * - **agentic** (optional): Uses LLM via ComputeProvider for deeper analysis.
+ *   Falls back to heuristic if LLM is unavailable.
+ */
+import { classifyErrorType } from '../utils/error-classifier.js';
+import { detectRepeatedActions, extractToolNames } from '../utils/trajectory-helpers.js';
+/**
+ * ReflexionGenerator — creates ReflexionEpisode from trajectory + matched playbooks
+ */
+export class ReflexionGenerator {
+    config;
+    constructor(config) {
+        this.config = {
+            mode: config?.mode ?? 'heuristic',
+            maxSummaryLength: config?.maxSummaryLength ?? 200,
+            maxInsights: config?.maxInsights ?? 5,
+        };
+    }
+    /**
+     * Generate a reflexion episode from a completed trajectory.
+     */
+    async generate(trajectory, matchedPlaybooks) {
+        // Currently only heuristic mode is implemented
+        return this.generateHeuristic(trajectory, matchedPlaybooks ?? []);
+    }
+    /**
+     * Heuristic mode — no LLM calls, pure pattern extraction.
+     */
+    generateHeuristic(trajectory, matchedPlaybooks) {
+        const outcome = this.mapOutcome(trajectory);
+        const taskSummary = trajectory.task.description.slice(0, this.config.maxSummaryLength);
+        const selfCritique = this.extractSelfCritique(trajectory);
+        const keyInsights = this.extractKeyInsights(trajectory);
+        const strategyAssessment = this.assessStrategy(trajectory, matchedPlaybooks);
+        const suggestedPlaybookUpdates = this.suggestPlaybookUpdates(trajectory, matchedPlaybooks);
+        return {
+            id: crypto.randomUUID(),
+            trajectoryId: trajectory.id,
+            taskSummary,
+            outcome,
+            selfCritique,
+            keyInsights,
+            strategyAssessment,
+            suggestedPlaybookUpdates,
+            domain: trajectory.task.domain ?? 'general',
+            createdAt: new Date(),
+        };
+    }
+    /**
+     * Map trajectory outcome to reflexion outcome label.
+     */
+    mapOutcome(trajectory) {
+        if (trajectory.outcome.success)
+            return 'success';
+        if (trajectory.outcome.partialScore !== undefined &&
+            trajectory.outcome.partialScore > 0) {
+            return 'partial';
+        }
+        return 'failure';
+    }
+    /**
+     * Extract self-critique from the trajectory.
+     * Looks at failed steps, error messages, and wasted actions.
+     */
+    extractSelfCritique(trajectory) {
+        const parts = [];
+        if (!trajectory.outcome.success) {
+            // Summarize what went wrong
+            if (trajectory.outcome.errorInfo) {
+                parts.push(`Failed with: ${trajectory.outcome.errorInfo.slice(0, 150)}`);
+            }
+            // Count steps with low attribution scores (wasted effort)
+            const lowAttributionSteps = trajectory.steps.filter((s) => s.attributionScore !== undefined && s.attributionScore < 0.2);
+            if (lowAttributionSteps.length > 0) {
+                parts.push(`${lowAttributionSteps.length} of ${trajectory.steps.length} steps had low attribution (wasted effort)`);
+            }
+        }
+        else {
+            // Successful — note efficiency
+            const stepCount = trajectory.steps.length;
+            if (stepCount > 10) {
+                parts.push(`Succeeded but took ${stepCount} steps — may be overcomplicating`);
+            }
+            else {
+                parts.push(`Completed efficiently in ${stepCount} steps`);
+            }
+        }
+        // Look for repeated actions (potential thrashing)
+        const repeated = detectRepeatedActions(trajectory.steps, 3);
+        if (repeated.length > 0) {
+            parts.push(`Repeated actions detected: ${repeated.map(({ action, count }) => `"${action.slice(0, 30)}..." (${count}x)`).join(', ')}`);
+        }
+        return parts.join('. ') || 'No specific critique identified';
+    }
+    /**
+     * Extract key insights from the trajectory.
+     * Pulls tool names, file paths, and notable observations.
+     */
+    extractKeyInsights(trajectory) {
+        const insights = [];
+        // Extract tool names from steps
+        const toolNames = extractToolNames(trajectory.steps);
+        if (toolNames.size > 0) {
+            insights.push(`Tools used: ${[...toolNames].join(', ')}`);
+        }
+        // Extract file paths from observations
+        const filePaths = new Set();
+        for (const step of trajectory.steps) {
+            const pathMatches = step.observation?.match(/(?:\/[\w.-]+)+(?:\.[\w]+)/g);
+            if (pathMatches) {
+                for (const p of pathMatches.slice(0, 5)) {
+                    filePaths.add(p);
+                }
+            }
+        }
+        if (filePaths.size > 0) {
+            insights.push(`Key files: ${[...filePaths].slice(0, 5).join(', ')}`);
+        }
+        // Note error patterns for failed trajectories
+        if (!trajectory.outcome.success && trajectory.outcome.errorInfo) {
+            const errorType = classifyErrorType(trajectory.outcome.errorInfo);
+            if (errorType) {
+                insights.push(`Error pattern: ${errorType}`);
+            }
+        }
+        // Note step count and efficiency
+        const highAttributionSteps = trajectory.steps.filter((s) => s.attributionScore !== undefined && s.attributionScore > 0.7);
+        if (highAttributionSteps.length > 0) {
+            insights.push(`${highAttributionSteps.length} high-impact steps identified`);
+        }
+        return insights.slice(0, this.config.maxInsights);
+    }
+    /**
+     * Assess the strategy by comparing matched playbooks against the outcome.
+     */
+    assessStrategy(trajectory, matchedPlaybooks) {
+        if (matchedPlaybooks.length === 0) {
+            if (trajectory.outcome.success) {
+                return 'Succeeded without playbook guidance — potential new playbook candidate';
+            }
+            return 'Failed without playbook guidance — no applicable playbooks found';
+        }
+        const topMatch = matchedPlaybooks[0];
+        const matchScore = Math.round(topMatch.score * 100);
+        if (trajectory.outcome.success) {
+            return `Succeeded with playbook "${topMatch.playbook.name}" (${matchScore}% match). Strategy confirmed.`;
+        }
+        // Failure with a matched playbook
+        return `Failed despite playbook "${topMatch.playbook.name}" (${matchScore}% match). Playbook may need refinement for this context.`;
+    }
+    /**
+     * Suggest playbook updates based on the trajectory outcome.
+     */
+    suggestPlaybookUpdates(trajectory, matchedPlaybooks) {
+        const suggestions = [];
+        if (trajectory.outcome.success && matchedPlaybooks.length === 0) {
+            // Successful without playbooks — suggest creating one
+            suggestions.push(`Create new playbook for: ${trajectory.task.description.slice(0, 100)}`);
+        }
+        if (!trajectory.outcome.success) {
+            // Failed — suggest updates to matched playbooks
+            for (const match of matchedPlaybooks) {
+                if (trajectory.outcome.errorInfo) {
+                    suggestions.push(`Add anti-pattern to "${match.playbook.name}": ${trajectory.outcome.errorInfo.slice(0, 80)}`);
+                }
+                // Suggest refinement based on error context
+                const domain = trajectory.task.domain;
+                if (domain) {
+                    suggestions.push(`Add refinement to "${match.playbook.name}" for domain "${domain}"`);
+                }
+            }
+            // If no playbooks matched a failure, suggest broader coverage
+            if (matchedPlaybooks.length === 0 && trajectory.outcome.errorInfo) {
+                const errorType = classifyErrorType(trajectory.outcome.errorInfo);
+                if (errorType) {
+                    suggestions.push(`Create error-handling playbook for pattern: ${errorType}`);
+                }
+            }
+        }
+        return suggestions;
+    }
+}
+/**
+ * Create a ReflexionGenerator instance
+ */
+export function createReflexionGenerator(config) {
+    return new ReflexionGenerator(config);
+}
+//# sourceMappingURL=reflexion-generator.js.map

package/dist/learning/reflexion-generator.js.map

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

package/dist/learning/team-ingester.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 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.
+ */
+import type { TeamTrajectory, TeamEvent, InteractionEdge, AgentInteraction, GraphStructuralMetrics } from '../types/index.js';
+export interface CompressionConfig {
+    /** Max tokens per agent trajectory after compression */
+    maxTokensPerAgent: number;
+    /** Always preserve steps at interaction boundaries */
+    preserveInteractionBoundaries: boolean;
+    /** Max consecutive non-interaction steps before folding */
+    foldThreshold: number;
+    /** Fraction of steps to mark as critical */
+    maxCriticalRatio: number;
+    /** Minimum score threshold for critical steps */
+    criticalStepThreshold: number;
+    /** Minimum score threshold for critical interactions */
+    criticalInteractionThreshold: number;
+}
+export interface CriticalStep {
+    agentId: string;
+    role: string;
+    eventIndex: number;
+    event: TeamEvent;
+    scores: {
+        position: number;
+        actionType: number;
+        interactionBonus: number;
+        total: number;
+    };
+    /** Index within the member's trajectory.steps */
+    stepIndex?: number;
+    /** Actual step content from the agent's trajectory */
+    stepContent?: {
+        thought?: string;
+        action: string;
+        observation: string;
+    };
+    /** Content-based scoring bonus (e.g. error mentions, key decisions) */
+    contentScore?: number;
+}
+export interface CriticalInteraction {
+    edge: InteractionEdge;
+    scores: {
+        volume: number;
+        diversityBonus: number;
+        latencyPenalty: number;
+        total: number;
+    };
+    /** The step-level AgentInteraction this corresponds to */
+    interaction?: AgentInteraction;
+    /** Whether downstream steps after this interaction led to success */
+    downstreamSuccessScore?: number;
+}
+export interface StructuralMetrics {
+    teamSize: number;
+    totalEvents: number;
+    totalInteractions: number;
+    interactionDensity: number;
+    maxInDegree: {
+        role: string;
+        count: number;
+    };
+    maxOutDegree: {
+        role: string;
+        count: number;
+    };
+    parallelismRatio: number;
+    totalWallTimeSeconds: number;
+    totalTokens: number;
+}
+export interface IngestionResult {
+    /** The team trajectory (passed through) */
+    teamTrajectory: TeamTrajectory;
+    /** Structural metrics computed from events and interactions */
+    structuralMetrics: StructuralMetrics;
+    /** Critical steps identified by scoring */
+    criticalSteps: CriticalStep[];
+    /** Critical interactions identified by scoring */
+    criticalInteractions: CriticalInteraction[];
+    /** Compression statistics */
+    compressionStats: {
+        originalEventCount: number;
+        criticalEventCount: number;
+        criticalRatio: number;
+    };
+    /** Graph-level structural metrics */
+    graphMetrics: GraphStructuralMetrics;
+}
+export declare class TeamTrajectoryIngester {
+    private config;
+    constructor(config?: Partial<CompressionConfig>);
+    /**
+     * Ingest a team trajectory: compute metrics, score steps/interactions,
+     * identify critical moments.
+     *
+     * Uses graph data (members[], interactions[]) for content-based scoring.
+     */
+    ingest(trajectory: TeamTrajectory): IngestionResult;
+    /**
+     * Compute structural metrics from graph data.
+     */
+    private computeStructuralMetrics;
+    /**
+     * Select critical steps above threshold, respecting max ratio.
+     */
+    private selectCritical;
+    /**
+     * Select critical interactions above threshold.
+     */
+    private selectCriticalInteractions;
+    /**
+     * Score actual trajectory steps from member trajectories.
+     * Uses content-based heuristics (thought/action/observation text)
+     * in addition to position and interaction scoring.
+     */
+    private scoreGraphSteps;
+    /**
+     * Score a step's action text for importance.
+     */
+    private scoreStepAction;
+    /**
+     * Content-based scoring: analyze thought/action/observation text
+     * for indicators of importance.
+     */
+    private scoreStepContent;
+    /**
+     * Map step action text to TeamEventType.
+     */
+    private stepActionToEventType;
+    /**
+     * Score step-level AgentInteraction objects.
+     * Richer than flat InteractionEdge scoring: uses content, latency,
+     * wasExpected flag, and downstream success analysis.
+     */
+    private scoreGraphInteractions;
+    /**
+     * Check downstream success: did the target agent complete steps
+     * successfully after receiving this interaction?
+     */
+    private computeDownstreamSuccess;
+}
+/**
+ * Create a TeamTrajectoryIngester instance.
+ */
+export declare function createTeamTrajectoryIngester(config?: Partial<CompressionConfig>): TeamTrajectoryIngester;
+//# sourceMappingURL=team-ingester.d.ts.map

package/dist/learning/team-ingester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-ingester.d.ts","sourceRoot":"","sources":["../../src/learning/team-ingester.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EAET,eAAe,EAEf,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAO3B,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,6BAA6B,EAAE,OAAO,CAAC;IACvC,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,4BAA4B,EAAE,MAAM,CAAC;CACtC;AAeD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,0DAA0D;IAC1D,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,cAAc,EAAE,cAAc,CAAC;IAC/B,+DAA+D;IAC/D,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,2CAA2C;IAC3C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,kDAAkD;IAClD,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,6BAA6B;IAC7B,gBAAgB,EAAE;QAChB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,qCAAqC;IACrC,YAAY,EAAE,sBAAsB,CAAC;CACtC;AAMD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAI/C;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,eAAe;IAuCnD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAehC;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAalC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA8EvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAiF9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;CA+BjC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,sBAAsB,CAExB"}