cognitive-core 0.2.4 → 0.3.1

package/dist/experimental/team/team-playbook.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Team Playbook Types
+ *
+ * TeamPlaybook - Learned coordination patterns extracted from successful
+ * team trajectories. The team-level analog of Playbook.
+ *
+ * RolePlaybook - How to be effective in a specific team role.
+ * Distinct from individual task playbooks (about solving problems alone)
+ * and team coordination playbooks (about team composition).
+ */
+/**
+ * TeamPlaybook - Learned coordination pattern.
+ * Answers: "Given this type of task, how should a team be organized and coordinated?"
+ */
+export interface TeamPlaybook {
+    id: string;
+    name: string;
+    applicability: TeamPlaybookApplicability;
+    composition: TeamCompositionGuidance;
+    coordination: TeamCoordinationGuidance;
+    verification: TeamPlaybookVerification;
+    evolution: TeamPlaybookEvolution;
+    confidence: number;
+    complexity: 'simple' | 'moderate' | 'complex' | 'epic';
+    createdAt: Date;
+    updatedAt: Date;
+    /** Links to individual playbooks suggested for each role */
+    rolePlaybookReferences?: RolePlaybookReference[];
+}
+/**
+ * When to use this team pattern.
+ */
+export interface TeamPlaybookApplicability {
+    /** Task types this pattern works for */
+    taskTypes: string[];
+    /** Scale indicators */
+    teamSizeRange: {
+        min: number;
+        max: number;
+    };
+    /** Complexity levels this pattern handles */
+    complexityLevels: Array<'simple' | 'moderate' | 'complex' | 'epic'>;
+    /** Domains where this pattern has been proven */
+    domains: string[];
+    /** When NOT to use this pattern */
+    antiPatterns: string[];
+}
+/**
+ * How to compose the team.
+ */
+export interface TeamCompositionGuidance {
+    /** Recommended topology */
+    topology: 'hierarchical' | 'flat' | 'wave' | 'custom';
+    /** Role specifications */
+    roles: TeamRoleSpec[];
+    /** Spawn rules: which roles can spawn which */
+    spawnRules: Record<string, string[]>;
+    /** Recommended enforcement mode */
+    enforcement: 'strict' | 'permissive' | 'audit';
+}
+/**
+ * Specification for a role within the team pattern.
+ */
+export interface TeamRoleSpec {
+    /** Role name */
+    role: string;
+    /** Why this role is needed */
+    rationale: string;
+    /** Required capabilities */
+    capabilities: string[];
+    /** Whether this role is essential or optional */
+    optional: boolean;
+    /** Recommended model tier */
+    modelTier?: 'fast' | 'balanced' | 'capable';
+    /** Recommended spawn position */
+    spawnAs: 'root' | 'companion' | 'on-demand';
+}
+/**
+ * How team members should coordinate.
+ */
+export interface TeamCoordinationGuidance {
+    /** Execution model */
+    executionModel: 'sequential' | 'wave-parallel' | 'fully-parallel' | 'pipeline';
+    /** Communication channels to establish */
+    channels: TeamChannelSpec[];
+    /** Key interaction patterns */
+    interactionPatterns: InteractionPattern[];
+    /** Task delegation strategy */
+    delegationStrategy: string;
+    /** Checkpoint protocol */
+    checkpoints?: string[];
+}
+/**
+ * Specification for a communication channel.
+ */
+export interface TeamChannelSpec {
+    name: string;
+    signals: string[];
+    subscribers: string[];
+    emitters: string[];
+}
+/**
+ * A learned interaction pattern between roles.
+ */
+export interface InteractionPattern {
+    /** Short name */
+    name: string;
+    /** Description of when/how this pattern occurs */
+    description: string;
+    /** Roles involved */
+    roles: string[];
+    /** Frequency: how often this pattern should occur */
+    frequency: 'once' | 'per-task' | 'continuous';
+    /** Whether this pattern was correlated with success */
+    correlatedWithSuccess: boolean;
+}
+/**
+ * How to verify the team pattern worked.
+ */
+export interface TeamPlaybookVerification {
+    /** Metrics that indicate success */
+    successIndicators: string[];
+    /** Metrics that indicate failure */
+    failureIndicators: string[];
+    /** How to restructure if the pattern isn't working */
+    restructuringStrategy?: string;
+}
+/**
+ * Evolution tracking for team playbooks.
+ */
+export interface TeamPlaybookEvolution {
+    version: string;
+    /** Source team trajectory IDs */
+    createdFrom: string[];
+    /** Refinements from experience */
+    refinements: TeamRefinement[];
+    successCount: number;
+    failureCount: number;
+    lastUsed?: Date;
+    /** Average metrics across successful uses */
+    avgMetrics?: {
+        coordinationOverhead: number;
+        parallelismRatio: number;
+        timeToFirstOutput: number;
+    };
+}
+/**
+ * Context-specific refinement to team coordination.
+ */
+export interface TeamRefinement {
+    context: string;
+    adjustment: string;
+    source: 'failure' | 'success' | 'manual';
+    addedAt: Date;
+}
+/**
+ * Cross-reference from team playbook to individual playbooks for a role.
+ */
+export interface RolePlaybookReference {
+    role: string;
+    suggestedPlaybookIds: string[];
+}
+/**
+ * RolePlaybook - How to be effective in a specific team role.
+ * Captures teamwork behavior from a single agent's perspective.
+ */
+export interface RolePlaybook {
+    id: string;
+    name: string;
+    /** Which role this applies to */
+    role: string;
+    /** Team contexts where this guidance is relevant */
+    teamContext: RoleTeamContext;
+    guidance: RoleGuidance;
+    evolution: RolePlaybookEvolution;
+    confidence: number;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Cross-references to individual task playbooks effective for this role */
+    relatedTaskPlaybooks?: RelatedTaskPlaybook[];
+}
+/**
+ * Team context where a role playbook applies.
+ */
+export interface RoleTeamContext {
+    topologies: Array<'hierarchical' | 'flat' | 'wave' | 'custom'>;
+    teamSizeRange: {
+        min: number;
+        max: number;
+    };
+    taskTypes: string[];
+    domains: string[];
+}
+/**
+ * Guidance for a specific role.
+ */
+export interface RoleGuidance {
+    /** Core responsibilities when playing this role */
+    responsibilities: string[];
+    /** How to interact with each other role */
+    interactionGuidance: RoleInteractionGuidance[];
+    /** Decision frameworks specific to this role */
+    decisionFrameworks: RoleDecisionFramework[];
+    /** Common mistakes in this role */
+    antiPatterns: string[];
+}
+/**
+ * How to interact with a specific other role.
+ */
+export interface RoleInteractionGuidance {
+    /** Which other role */
+    withRole: string;
+    /** What type of interaction */
+    interactionType: string;
+    /** How to do it effectively */
+    guidance: string;
+    /** Concrete examples from successful executions */
+    examples: string[];
+    /** What NOT to do */
+    antiPatterns: string[];
+}
+/**
+ * Decision framework for a specific role context.
+ */
+export interface RoleDecisionFramework {
+    name: string;
+    when: string;
+    guidance: string;
+}
+/**
+ * Evolution tracking for role playbooks.
+ */
+export interface RolePlaybookEvolution {
+    version: string;
+    createdFrom: string[];
+    refinements: TeamRefinement[];
+    successCount: number;
+    failureCount: number;
+    lastUsed?: Date;
+}
+/**
+ * Cross-reference from role playbook to individual task playbooks.
+ */
+export interface RelatedTaskPlaybook {
+    playbookId: string;
+    playbookName: string;
+    applicableToTask: string;
+    rationale: string;
+}
+/**
+ * Create a new team playbook with defaults.
+ */
+export declare function createTeamPlaybook(input: Partial<TeamPlaybook> & {
+    name: string;
+    applicability: TeamPlaybookApplicability;
+    composition: TeamCompositionGuidance;
+    coordination: TeamCoordinationGuidance;
+}): TeamPlaybook;
+/**
+ * Create a new role playbook with defaults.
+ */
+export declare function createRolePlaybook(input: Partial<RolePlaybook> & {
+    name: string;
+    role: string;
+    teamContext: RoleTeamContext;
+    guidance: RoleGuidance;
+}): RolePlaybook;
+/**
+ * Get team playbook success rate.
+ */
+export declare function getTeamPlaybookSuccessRate(playbook: TeamPlaybook): number;
+/**
+ * Get role playbook success rate.
+ */
+export declare function getRolePlaybookSuccessRate(playbook: RolePlaybook): number;
+//# sourceMappingURL=team-playbook.d.ts.map

package/dist/experimental/team/team-playbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-playbook.d.ts","sourceRoot":"","sources":["../../../src/experimental/team/team-playbook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IAGb,aAAa,EAAE,yBAAyB,CAAC;IAGzC,WAAW,EAAE,uBAAuB,CAAC;IAGrC,YAAY,EAAE,wBAAwB,CAAC;IAGvC,YAAY,EAAE,wBAAwB,CAAC;IAGvC,SAAS,EAAE,qBAAqB,CAAC;IAGjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAGhB,4DAA4D;IAC5D,sBAAsB,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uBAAuB;IACvB,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,6CAA6C;IAC7C,gBAAgB,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;IACpE,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2BAA2B;IAC3B,QAAQ,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtD,0BAA0B;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,mCAAmC;IACnC,WAAW,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC5C,iCAAiC;IACjC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,sBAAsB;IACtB,cAAc,EAAE,YAAY,GAAG,eAAe,GAAG,gBAAgB,GAAG,UAAU,CAAC;IAC/E,0CAA0C;IAC1C,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,+BAA+B;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC9C,uDAAuD;IACvD,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kCAAkC;IAClC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,6CAA6C;IAC7C,UAAU,CAAC,EAAE;QACX,oBAAoB,EAAE,MAAM,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAMD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IAGb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,WAAW,EAAE,eAAe,CAAC;IAG7B,QAAQ,EAAE,YAAY,CAAC;IAGvB,SAAS,EAAE,qBAAqB,CAAC;IAGjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAGhB,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,KAAK,CAAC,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/D,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,mBAAmB,EAAE,uBAAuB,EAAE,CAAC;IAC/C,gDAAgD;IAChD,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;IAC5C,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qBAAqB;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,yBAAyB,CAAC;IACzC,WAAW,EAAE,uBAAuB,CAAC;IACrC,YAAY,EAAE,wBAAwB,CAAC;CACxC,GACA,YAAY,CAyBd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,EAAE,YAAY,CAAC;CACxB,GACA,YAAY,CAoBd;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAIzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAIzE"}

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

@@ -0,0 +1,85 @@
+/**
+ * Team Playbook Types
+ *
+ * TeamPlaybook - Learned coordination patterns extracted from successful
+ * team trajectories. The team-level analog of Playbook.
+ *
+ * RolePlaybook - How to be effective in a specific team role.
+ * Distinct from individual task playbooks (about solving problems alone)
+ * and team coordination playbooks (about team composition).
+ */
+// ============================================================
+// Factory functions
+// ============================================================
+/**
+ * Create a new team playbook with defaults.
+ */
+export function createTeamPlaybook(input) {
+    const now = new Date();
+    return {
+        id: input.id ?? `team-playbook-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        name: input.name,
+        applicability: input.applicability,
+        composition: input.composition,
+        coordination: input.coordination,
+        verification: input.verification ?? {
+            successIndicators: [],
+            failureIndicators: [],
+        },
+        evolution: input.evolution ?? {
+            version: '1.0.0',
+            createdFrom: [],
+            refinements: [],
+            successCount: 0,
+            failureCount: 0,
+        },
+        confidence: input.confidence ?? 0.3,
+        complexity: input.complexity ?? 'moderate',
+        createdAt: input.createdAt ?? now,
+        updatedAt: input.updatedAt ?? now,
+        rolePlaybookReferences: input.rolePlaybookReferences,
+    };
+}
+/**
+ * Create a new role playbook with defaults.
+ */
+export function createRolePlaybook(input) {
+    const now = new Date();
+    return {
+        id: input.id ?? `role-playbook-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        name: input.name,
+        role: input.role,
+        teamContext: input.teamContext,
+        guidance: input.guidance,
+        evolution: input.evolution ?? {
+            version: '1.0.0',
+            createdFrom: [],
+            refinements: [],
+            successCount: 0,
+            failureCount: 0,
+        },
+        confidence: input.confidence ?? 0.3,
+        createdAt: input.createdAt ?? now,
+        updatedAt: input.updatedAt ?? now,
+        relatedTaskPlaybooks: input.relatedTaskPlaybooks,
+    };
+}
+/**
+ * Get team playbook success rate.
+ */
+export function getTeamPlaybookSuccessRate(playbook) {
+    const total = playbook.evolution.successCount + playbook.evolution.failureCount;
+    if (total === 0)
+        return 0;
+    return playbook.evolution.successCount / total;
+}
+/**
+ * Get role playbook success rate.
+ */
+export function getRolePlaybookSuccessRate(playbook) {
+    const total = playbook.evolution.successCount + playbook.evolution.failureCount;
+    if (total === 0)
+        return 0;
+    return playbook.evolution.successCount / total;
+}
+//# sourceMappingURL=team-playbook.js.map

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

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

package/dist/experimental/team/team-router.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 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.
+ */
+import type { TeamPlaybook, RolePlaybook, TeamCompositionGuidance, TeamCoordinationGuidance } from './team-playbook.js';
+import type { TeamExperienceMemory } from './team-experience.js';
+/**
+ * The slice of TeamMetaLearner the router needs. Structural (instead of
+ * importing the class type) to avoid a team-router ↔ team-meta-learner
+ * import cycle — the meta-learner imports TeamRecommendation* from here.
+ */
+export interface TeamRecommendationAdjuster {
+    adjustRecommendation(recommendation: TeamRecommendation, input: TeamRecommendationInput): Promise<TeamRecommendation>;
+}
+export interface TeamRouterConfig {
+    /** Minimum playbook confidence to use directly */
+    minPlaybookConfidence: number;
+    /** How many playbook candidates to retrieve */
+    maxCandidates: number;
+    /** How many role playbooks to include per role */
+    maxRolePlaybooksPerRole: number;
+    /** Whether to include similar experiences in reasoning */
+    includeSimilarExperiences: boolean;
+}
+/**
+ * Result from team recommendation.
+ */
+export interface TeamRecommendation {
+    /** Matched team playbook (if any) */
+    playbook?: TeamPlaybook;
+    /** Recommended composition */
+    composition: TeamCompositionGuidance;
+    /** Recommended coordination */
+    coordination: TeamCoordinationGuidance;
+    /** Role playbooks for each recommended role */
+    rolePlaybooks: RolePlaybook[];
+    /** Confidence in this recommendation (0-1) */
+    confidence: number;
+    /** Reasoning for this recommendation */
+    reasoning: string;
+    /** Meta-strategies that were applied */
+    appliedMetaStrategies: string[];
+    /** Export as OpenTeams team.yaml format */
+    asTeamYaml(): string;
+}
+/**
+ * Task input for team recommendation.
+ */
+export interface TeamRecommendationInput {
+    description: string;
+    domain: string;
+    complexity: 'simple' | 'moderate' | 'complex' | 'epic';
+    constraints?: {
+        maxAgents?: number;
+        maxTokenBudget?: number;
+        preferredTopology?: string;
+    };
+}
+export declare class TeamRouter {
+    private memory;
+    private config;
+    private metaLearner?;
+    constructor(memory: TeamExperienceMemory, config?: Partial<TeamRouterConfig>, metaLearner?: TeamRecommendationAdjuster);
+    /**
+     * Set the team meta learner (can be set after construction).
+     */
+    setMetaLearner(metaLearner: TeamRecommendationAdjuster): void;
+    /**
+     * Recommend a team composition for a given task.
+     */
+    recommend(input: TeamRecommendationInput): Promise<TeamRecommendation>;
+    /**
+     * Compute base recommendation from playbook matches.
+     */
+    private computeBaseRecommendation;
+    /**
+     * Apply user constraints to the recommendation.
+     */
+    private applyConstraints;
+    /**
+     * Find role playbooks for each role in the recommendation.
+     */
+    private findRolePlaybooks;
+    /**
+     * Update configuration.
+     */
+    updateConfig(config: Partial<TeamRouterConfig>): void;
+}
+/**
+ * Create a TeamRouter instance.
+ */
+export declare function createTeamRouter(memory: TeamExperienceMemory, config?: Partial<TeamRouterConfig>, metaLearner?: TeamRecommendationAdjuster): TeamRouter;
+//# sourceMappingURL=team-router.d.ts.map

package/dist/experimental/team/team-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-router.d.ts","sourceRoot":"","sources":["../../../src/experimental/team/team-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,oBAAoB,CAClB,cAAc,EAAE,kBAAkB,EAClC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,uBAAuB,EAAE,MAAM,CAAC;IAChC,0DAA0D;IAC1D,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAaD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,8BAA8B;IAC9B,WAAW,EAAE,uBAAuB,CAAC;IACrC,+BAA+B;IAC/B,YAAY,EAAE,wBAAwB,CAAC;IACvC,+CAA+C;IAC/C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,2CAA2C;IAC3C,UAAU,IAAI,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD,WAAW,CAAC,EAAE;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAwJD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAC,CAA6B;gBAG/C,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,WAAW,CAAC,EAAE,0BAA0B;IAO1C;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,0BAA0B,GAAG,IAAI;IAI7D;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmC5E;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyCjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6DxB;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAGtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,WAAW,CAAC,EAAE,0BAA0B,GACvC,UAAU,CAEZ"}