cognitive-core 0.2.5 → 0.3.1

package/dist/experimental/team/team-router.js

@@ -0,0 +1,312 @@
+/**
+ * Team Router
+ *
+ * Recommends team composition for a given task description.
+ * Queries team playbooks and experiences from memory, scores matches,
+ * and applies team meta-strategies to adjust recommendations.
+ *
+ * The team-level analog of TaskRouter.
+ */
+const DEFAULT_CONFIG = {
+    minPlaybookConfidence: 0.4,
+    maxCandidates: 5,
+    maxRolePlaybooksPerRole: 2,
+    includeSimilarExperiences: true,
+};
+// ============================================================
+// Default fallback composition
+// ============================================================
+function defaultComposition(input) {
+    // Simple tasks → flat 2-agent team, complex → wave with planner
+    if (input.complexity === 'simple') {
+        return {
+            topology: 'flat',
+            roles: [
+                {
+                    role: 'executor',
+                    rationale: 'Execute the task directly',
+                    capabilities: ['task execution'],
+                    optional: false,
+                    modelTier: 'balanced',
+                    spawnAs: 'root',
+                },
+            ],
+            spawnRules: {},
+            enforcement: 'permissive',
+        };
+    }
+    const roles = [
+        {
+            role: 'planner',
+            rationale: 'Decompose and plan the work',
+            capabilities: ['planning', 'decomposition'],
+            optional: false,
+            modelTier: 'capable',
+            spawnAs: 'root',
+        },
+        {
+            role: 'executor',
+            rationale: 'Execute planned tasks',
+            capabilities: ['task execution'],
+            optional: false,
+            modelTier: 'balanced',
+            spawnAs: 'companion',
+        },
+    ];
+    if (input.complexity === 'complex' || input.complexity === 'epic') {
+        roles.push({
+            role: 'reviewer',
+            rationale: 'Verify completed work',
+            capabilities: ['review', 'verification'],
+            optional: true,
+            modelTier: 'capable',
+            spawnAs: 'on-demand',
+        });
+    }
+    return {
+        topology: input.complexity === 'epic' ? 'hierarchical' : 'wave',
+        roles,
+        spawnRules: { planner: ['executor', 'reviewer'] },
+        enforcement: 'permissive',
+    };
+}
+function defaultCoordination(input) {
+    return {
+        executionModel: input.complexity === 'simple' ? 'sequential' : 'wave-parallel',
+        channels: [],
+        interactionPatterns: [],
+        delegationStrategy: 'auto',
+    };
+}
+// ============================================================
+// YAML export
+// ============================================================
+function compositionToYaml(rec) {
+    const lines = [
+        '# Team configuration generated by cognitive-core',
+        `# Confidence: ${rec.confidence.toFixed(2)}`,
+        '',
+        'team:',
+        `  topology: ${rec.composition.topology}`,
+        `  enforcement: ${rec.composition.enforcement}`,
+        '',
+        '  roles:',
+    ];
+    for (const role of rec.composition.roles) {
+        lines.push(`    - name: ${role.role}`);
+        lines.push(`      rationale: "${role.rationale}"`);
+        lines.push(`      optional: ${role.optional}`);
+        if (role.modelTier) {
+            lines.push(`      model_tier: ${role.modelTier}`);
+        }
+        lines.push(`      spawn_as: ${role.spawnAs}`);
+        if (role.capabilities.length > 0) {
+            lines.push(`      capabilities:`);
+            for (const cap of role.capabilities) {
+                lines.push(`        - ${cap}`);
+            }
+        }
+    }
+    if (Object.keys(rec.composition.spawnRules).length > 0) {
+        lines.push('');
+        lines.push('  spawn_rules:');
+        for (const [parent, children] of Object.entries(rec.composition.spawnRules)) {
+            lines.push(`    ${parent}: [${children.join(', ')}]`);
+        }
+    }
+    lines.push('');
+    lines.push('  coordination:');
+    lines.push(`    execution_model: ${rec.coordination.executionModel}`);
+    lines.push(`    delegation_strategy: ${rec.coordination.delegationStrategy}`);
+    if (rec.coordination.channels.length > 0) {
+        lines.push('    channels:');
+        for (const ch of rec.coordination.channels) {
+            lines.push(`      - name: ${ch.name}`);
+            lines.push(`        signals: [${ch.signals.join(', ')}]`);
+            lines.push(`        subscribers: [${ch.subscribers.join(', ')}]`);
+            lines.push(`        emitters: [${ch.emitters.join(', ')}]`);
+        }
+    }
+    if (rec.coordination.interactionPatterns.length > 0) {
+        lines.push('    interaction_patterns:');
+        for (const pat of rec.coordination.interactionPatterns) {
+            lines.push(`      - name: ${pat.name}`);
+            lines.push(`        roles: [${pat.roles.join(', ')}]`);
+            lines.push(`        frequency: ${pat.frequency}`);
+        }
+    }
+    if (rec.coordination.checkpoints && rec.coordination.checkpoints.length > 0) {
+        lines.push('    checkpoints:');
+        for (const cp of rec.coordination.checkpoints) {
+            lines.push(`      - ${cp}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ============================================================
+// Team Router
+// ============================================================
+export class TeamRouter {
+    memory;
+    config;
+    metaLearner;
+    constructor(memory, config, metaLearner) {
+        this.memory = memory;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Set the team meta learner (can be set after construction).
+     */
+    setMetaLearner(metaLearner) {
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Recommend a team composition for a given task.
+     */
+    async recommend(input) {
+        // 1. Find matching team playbooks
+        const playbookMatches = await this.memory.findMatchingTeamPlaybooks({
+            taskType: input.description,
+            domain: input.domain,
+            complexity: input.complexity,
+            topology: input.constraints?.preferredTopology,
+            k: this.config.maxCandidates,
+        });
+        // 2. Compute base recommendation
+        let recommendation = this.computeBaseRecommendation(input, playbookMatches);
+        // 3. Apply constraints
+        recommendation = this.applyConstraints(recommendation, input);
+        // 4. Attach role playbooks for each recommended role
+        const rolePlaybooks = await this.findRolePlaybooks(recommendation, input);
+        recommendation.rolePlaybooks = rolePlaybooks;
+        // 5. Apply meta-learning adjustments
+        if (this.metaLearner) {
+            try {
+                recommendation = await this.metaLearner.adjustRecommendation(recommendation, input);
+            }
+            catch (error) {
+                console.error('[TeamRouter] Meta-learning adjustment failed, using base recommendation:', error instanceof Error ? error.message : String(error));
+            }
+        }
+        return recommendation;
+    }
+    /**
+     * Compute base recommendation from playbook matches.
+     */
+    computeBaseRecommendation(input, playbookMatches) {
+        // Filter to playbooks above minimum confidence
+        const viable = playbookMatches.filter((m) => m.playbook.confidence >= this.config.minPlaybookConfidence);
+        if (viable.length > 0) {
+            // Use the best matching playbook
+            const best = viable[0];
+            const rec = {
+                playbook: best.playbook,
+                composition: best.playbook.composition,
+                coordination: best.playbook.coordination,
+                rolePlaybooks: [],
+                confidence: Math.min(best.score * best.playbook.confidence, 0.95),
+                reasoning: `Matched team playbook "${best.playbook.name}" (score: ${best.score.toFixed(2)}, confidence: ${best.playbook.confidence.toFixed(2)})`,
+                appliedMetaStrategies: [],
+            };
+            return { ...rec, asTeamYaml: () => compositionToYaml(rec) };
+        }
+        // No viable playbook — build a default recommendation
+        const composition = defaultComposition(input);
+        const coordination = defaultCoordination(input);
+        const rec = {
+            composition,
+            coordination,
+            rolePlaybooks: [],
+            confidence: 0.3,
+            reasoning: 'No matching team playbook found; using default composition based on complexity',
+            appliedMetaStrategies: [],
+        };
+        return { ...rec, asTeamYaml: () => compositionToYaml(rec) };
+    }
+    /**
+     * Apply user constraints to the recommendation.
+     */
+    applyConstraints(recommendation, input) {
+        const constraints = input.constraints;
+        if (!constraints)
+            return recommendation;
+        let modified = false;
+        const reasons = [];
+        // Apply max agents constraint
+        if (constraints.maxAgents && recommendation.composition.roles.length > constraints.maxAgents) {
+            // Keep only essential (non-optional) roles, then trim to fit
+            const essential = recommendation.composition.roles.filter((r) => !r.optional);
+            const optional = recommendation.composition.roles.filter((r) => r.optional);
+            let roles;
+            if (essential.length >= constraints.maxAgents) {
+                roles = essential.slice(0, constraints.maxAgents);
+            }
+            else {
+                const remaining = constraints.maxAgents - essential.length;
+                roles = [...essential, ...optional.slice(0, remaining)];
+            }
+            recommendation = {
+                ...recommendation,
+                composition: { ...recommendation.composition, roles },
+            };
+            reasons.push(`Trimmed to ${constraints.maxAgents} agents`);
+            modified = true;
+        }
+        // Apply preferred topology
+        if (constraints.preferredTopology &&
+            recommendation.composition.topology !== constraints.preferredTopology) {
+            recommendation = {
+                ...recommendation,
+                composition: {
+                    ...recommendation.composition,
+                    topology: constraints.preferredTopology,
+                },
+            };
+            reasons.push(`Topology set to ${constraints.preferredTopology}`);
+            modified = true;
+        }
+        if (modified) {
+            recommendation.reasoning += `. Constraints applied: ${reasons.join('; ')}`;
+            // Slightly lower confidence when constraints override
+            recommendation.confidence = Math.max(0.15, recommendation.confidence * 0.9);
+            // Rebuild asTeamYaml with updated data
+            const rec = recommendation;
+            recommendation.asTeamYaml = () => compositionToYaml(rec);
+        }
+        return recommendation;
+    }
+    /**
+     * Find role playbooks for each role in the recommendation.
+     */
+    async findRolePlaybooks(recommendation, input) {
+        const rolePlaybooks = [];
+        for (const roleSpec of recommendation.composition.roles) {
+            const matches = await this.memory.findMatchingRolePlaybooks({
+                role: roleSpec.role,
+                topology: recommendation.composition.topology,
+                domain: input.domain,
+                taskType: input.description,
+                k: this.config.maxRolePlaybooksPerRole,
+            });
+            for (const match of matches) {
+                rolePlaybooks.push(match.playbook);
+            }
+        }
+        return rolePlaybooks;
+    }
+    /**
+     * Update configuration.
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Create a TeamRouter instance.
+ */
+export function createTeamRouter(memory, config, metaLearner) {
+    return new TeamRouter(memory, config, metaLearner);
+}
+//# sourceMappingURL=team-router.js.map

package/dist/experimental/team/team-router.js.map

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

package/dist/experimental/team/team-skill-library.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Team Skill Library
+ *
+ * Tiered surfacing of team playbooks and role playbooks for
+ * team formation decisions and agent role guidance injection.
+ *
+ * The team-level analog of SkillLibrary.
+ *
+ * Responsibilities:
+ * - Rank team playbooks by relevance, confidence, and success rate
+ * - Rank role playbooks for each role in a recommended team
+ * - Format role guidance for injection into agent system prompts
+ * - Record team outcome feedback to update playbook evolution
+ * - Tier management: promote/demote team playbooks based on track record
+ */
+import type { TeamPlaybook, RolePlaybook } from './team-playbook.js';
+import type { TeamExperienceMemory } from './team-experience.js';
+export interface TeamSkillLibraryConfig {
+    /** Promotion criteria for core team playbooks */
+    promotion: {
+        minConfidence: number;
+        minSuccessCount: number;
+        minSuccessRate: number;
+    };
+    /** Maximum items to surface */
+    limits: {
+        maxCoreTeamPlaybooks: number;
+        maxRolePlaybooksPerRole: number;
+        maxTokensForGuidance: number;
+    };
+    /** Demotion criteria */
+    demotion: {
+        failureThreshold: number;
+        minConfidenceToRetain: number;
+    };
+}
+/**
+ * A team playbook with ranking scores.
+ */
+export interface RankedTeamPlaybook {
+    playbook: TeamPlaybook;
+    relevanceScore: number;
+    successRate: number;
+    /** Combined ranking score */
+    rankScore: number;
+}
+/**
+ * A role playbook with ranking scores.
+ */
+export interface RankedRolePlaybook {
+    playbook: RolePlaybook;
+    relevanceScore: number;
+    successRate: number;
+    rankScore: number;
+}
+/**
+ * Team outcome feedback for the evolution loop.
+ */
+export interface TeamOutcomeFeedback {
+    /** Which team playbook was used */
+    playbookId: string;
+    /** Team trajectory ID (optional) */
+    teamTrajectoryId?: string;
+    /** Whether the team succeeded */
+    success: boolean;
+    /** Quality of the outcome */
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+    /** Optional notes */
+    notes?: string;
+    /** Observed metrics */
+    metrics?: {
+        coordinationOverhead?: number;
+        parallelismRatio?: number;
+        timeToFirstOutput?: number;
+    };
+}
+/**
+ * Role outcome feedback.
+ */
+export interface RoleOutcomeFeedback {
+    /** Which role playbook was used */
+    playbookId: string;
+    /** Whether the role was effective */
+    success: boolean;
+    /** Quality assessment */
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+}
+/**
+ * Team skills organized for injection.
+ */
+export interface TeamAgentSkills {
+    /** Core team playbooks (highest confidence, always surfaced) */
+    coreTeamPlaybooks: TeamPlaybook[];
+    /** Matched team playbooks for this specific task */
+    matchedTeamPlaybooks: TeamPlaybook[];
+    /** Role playbooks organized by role */
+    rolePlaybooks: Map<string, RolePlaybook[]>;
+    /** Estimated token count */
+    totalTokenEstimate: number;
+}
+export declare class TeamSkillLibrary {
+    private memory;
+    private config;
+    private coreTeamPlaybooks;
+    private lastRefresh;
+    private consecutiveFailures;
+    constructor(memory: TeamExperienceMemory, config?: Partial<TeamSkillLibraryConfig>);
+    /**
+     * Refresh core team playbook tiers based on current state.
+     */
+    refreshTiers(): Promise<{
+        promoted: string[];
+        demoted: string[];
+        coreCount: number;
+    }>;
+    private meetsPromotionCriteria;
+    private meetsDemotionCriteria;
+    /**
+     * Find and rank team playbooks for a task.
+     */
+    findMatchingTeamPlaybooks(query: {
+        taskType?: string;
+        domain?: string;
+        topology?: string;
+        complexity?: string;
+        k?: number;
+    }): Promise<RankedTeamPlaybook[]>;
+    /**
+     * Find and rank role playbooks for a specific role.
+     */
+    findRolePlaybooks(role: string, context: {
+        topology?: string;
+        taskType?: string;
+        domain?: string;
+    }): Promise<RankedRolePlaybook[]>;
+    /**
+     * Get team skills organized for agent context.
+     */
+    getSkillsForTeam(query: {
+        description: string;
+        domain: string;
+        complexity?: string;
+        roles: string[];
+        topology?: string;
+    }): Promise<TeamAgentSkills>;
+    /**
+     * Format role guidance for injection into an agent's system prompt.
+     */
+    formatRoleGuidance(role: string, rolePlaybooks: RolePlaybook[]): string;
+    /**
+     * Format team playbook summary for team formation context.
+     */
+    formatTeamPlaybookSummary(playbooks: TeamPlaybook[]): string;
+    /**
+     * Record team playbook outcome feedback.
+     * Updates evolution stats and recalculates confidence.
+     */
+    recordTeamOutcome(feedback: TeamOutcomeFeedback): Promise<void>;
+    /**
+     * Record role playbook outcome feedback.
+     */
+    recordRoleOutcome(feedback: RoleOutcomeFeedback): Promise<void>;
+    getCoreTeamPlaybooks(): TeamPlaybook[];
+    getLastRefresh(): Date | null;
+    getStats(): {
+        coreTeamPlaybookCount: number;
+        lastRefresh: Date | null;
+        consecutiveFailures: Record<string, number>;
+    };
+    private computeRankScore;
+    private recalculateConfidence;
+    private recalculateRoleConfidence;
+    private updateAvgMetrics;
+    private estimateTokens;
+}
+/**
+ * Create a TeamSkillLibrary instance.
+ */
+export declare function createTeamSkillLibrary(memory: TeamExperienceMemory, config?: Partial<TeamSkillLibraryConfig>): TeamSkillLibrary;
+//# sourceMappingURL=team-skill-library.d.ts.map

package/dist/experimental/team/team-skill-library.d.ts.map

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