cognitive-core 0.1.0 → 0.1.2

package/dist/types/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/types/team-playbook.d.ts.map

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

package/dist/types/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/types/team-playbook.js.map

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

package/dist/types/team-trajectory.d.ts

@@ -0,0 +1,305 @@
+/**
+ * Team Trajectory Types
+ *
+ * TeamTrajectory - Complete record of a team's collective execution.
+ * The team-level analog of Trajectory. Where an individual trajectory
+ * records thought → action → observation, a team trajectory records
+ * events across all members with an interaction graph overlay.
+ */
+import type { Trajectory } from './trajectory.js';
+/**
+ * Fine-grained interaction type between agents.
+ * Used in InteractionTag and RoleInteractionGuidance.
+ */
+export type InteractionType = 'delegation' | 'result_return' | 'message' | 'signal' | 'spawn' | 'escalation';
+/**
+ * Runtime step metadata tag linking agent interactions.
+ * Attached to individual trajectory steps to build the interaction graph.
+ */
+export interface InteractionTag {
+    /** Unique ID grouping source + target steps of one interaction */
+    interactionId: string;
+    /** Type of interaction */
+    interactionType: InteractionType;
+    /** The other agent involved */
+    counterpartAgentId: string;
+    /** Whether this step is the source or target of the interaction */
+    stepRole: 'source' | 'target';
+    /** Communication channel used, if any */
+    channel?: string;
+    /** Signal name, if any */
+    signal?: string;
+}
+/**
+ * Expected interaction pattern from team.yaml for comparison.
+ */
+export interface ExpectedInteractionPattern {
+    /** Pattern name */
+    name: string;
+    /** From role */
+    fromRole: string;
+    /** To role */
+    toRole: string;
+    /** Expected interaction type */
+    type: InteractionType;
+    /** Frequency expectation */
+    frequency: 'once' | 'per-task' | 'continuous';
+}
+/**
+ * TeamTrajectoryInput - Entry point for the team learning pipeline.
+ * Contains individual agent trajectories that get converted to a
+ * TeamTrajectory with interaction graph.
+ */
+export interface TeamTrajectoryInput {
+    objective: string;
+    domain: string;
+    complexity: 'simple' | 'moderate' | 'complex' | 'epic';
+    teamName: string;
+    templateName: string;
+    topologyType: 'hierarchical' | 'flat' | 'wave' | 'custom';
+    enforcement: 'strict' | 'permissive' | 'audit';
+    /** Individual agent trajectories */
+    memberTrajectories: MemberTrajectoryInput[];
+    /** Expected coordination patterns from team.yaml */
+    expectedPatterns?: ExpectedInteractionPattern[];
+    /** Collective team outcome */
+    outcome: TeamOutcome;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Individual member's trajectory within the team input.
+ */
+export interface MemberTrajectoryInput {
+    agentId: string;
+    role: string;
+    trajectory: Trajectory;
+}
+/**
+ * MemberTrajectory - A node in the team trajectory graph.
+ * Wraps an individual agent's full trajectory with team identity.
+ */
+export interface MemberTrajectory {
+    agentId: string;
+    role: string;
+    trajectory: Trajectory;
+}
+/**
+ * AgentInteraction - An edge in the team trajectory graph.
+ * Links a specific step in one agent's trajectory to a step in another's.
+ */
+export interface AgentInteraction {
+    id: string;
+    type: InteractionType;
+    from: {
+        agentId: string;
+        role: string;
+        stepIndex: number;
+    };
+    to: {
+        agentId: string;
+        role: string;
+        stepIndex: number;
+    };
+    content: string;
+    channel?: string;
+    signal?: string;
+    timestamp: Date;
+    latencyMs?: number;
+    /** Whether this interaction matches an expected pattern from team.yaml */
+    wasExpected: boolean;
+}
+/**
+ * StructuralMetrics computed from the graph model.
+ * Richer than CoordinationMetrics — computed from per-agent steps + interactions.
+ */
+export interface GraphStructuralMetrics {
+    teamSize: number;
+    totalSteps: number;
+    totalInteractions: number;
+    interactionDensity: number;
+    maxInDegree: {
+        agentId: string;
+        count: number;
+    };
+    maxOutDegree: {
+        agentId: string;
+        count: number;
+    };
+    parallelismRatio: number;
+    totalWallTimeSeconds: number;
+    totalTokens: number;
+}
+/**
+ * A single event in a team's execution history.
+ * These are the "steps" of team-level learning.
+ */
+export interface TeamEvent {
+    /** When this event occurred */
+    timestamp: Date;
+    /** Which event type */
+    type: TeamEventType;
+    /** Which agent produced this event */
+    agentId: string;
+    /** Role of the agent at event time */
+    role: string;
+    /** Event-specific payload */
+    payload: Record<string, unknown>;
+}
+export type TeamEventType = 'agent_spawned' | 'agent_shutdown' | 'task_delegated' | 'task_completed' | 'task_failed' | 'signal_emitted' | 'message_sent' | 'message_broadcast' | 'plan_proposed' | 'plan_approved' | 'plan_rejected' | 'checkpoint_reached' | 'role_changed' | 'escalation';
+/**
+ * Interaction edge in the team communication graph.
+ * Built from events during analysis.
+ */
+export interface InteractionEdge {
+    /** Sender role */
+    from: string;
+    /** Receiver role */
+    to: string;
+    /** Number of interactions */
+    count: number;
+    /** Types of interactions */
+    types: TeamEventType[];
+    /** Average latency between send and response (ms) */
+    avgResponseLatencyMs?: number;
+}
+/**
+ * Coordination metrics computed from team events.
+ */
+export interface CoordinationMetrics {
+    /** Total wall time for the team execution */
+    totalWallTimeSeconds: number;
+    /** Time from team creation to first task completion */
+    timeToFirstOutputSeconds: number;
+    /** Fraction of total tokens spent on coordination vs. production */
+    coordinationOverheadRatio: number;
+    /** Agent with most inbound messages (potential bottleneck) */
+    bottleneckAgent?: string;
+    /** Number of communication cycles (back-and-forth exchanges) */
+    communicationCycles: number;
+    /** Maximum task dependency chain length executed */
+    maxDependencyDepth: number;
+    /** Number of tasks that were re-delegated after failure */
+    reDelegationCount: number;
+    /** Parallelism efficiency: tasks completed concurrently / total tasks */
+    parallelismRatio: number;
+}
+/**
+ * Per-member outcome within the team trajectory.
+ */
+export interface MemberOutcome {
+    agentId: string;
+    role: string;
+    tasksAssigned: number;
+    tasksCompleted: number;
+    tasksFailed: number;
+    llmCalls: number;
+    totalTokens: number;
+    /** Link to individual trajectory if available */
+    trajectoryId?: string;
+}
+/**
+ * Collective team outcome.
+ */
+export interface TeamOutcome {
+    success: boolean;
+    /** 0-1 score for partial success */
+    partialScore: number;
+    /** Quality assessment */
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+    /** Total LLM calls across all members */
+    totalLlmCalls: number;
+    /** Total tokens across all members */
+    totalTokens: number;
+    /** Total wall time */
+    totalWallTimeSeconds: number;
+    /** Optional error information */
+    errorInfo?: string;
+}
+/**
+ * TeamTrajectory - Complete record of a team's collective execution.
+ * The team-level analog of Trajectory.
+ */
+export interface TeamTrajectory {
+    id: string;
+    /** Team name (from OpenTeams) */
+    teamName: string;
+    /** Template that defined this team */
+    templateName: string;
+    /** Topology type used */
+    topologyType: 'hierarchical' | 'flat' | 'wave' | 'custom';
+    /** Roles that participated */
+    roles: string[];
+    /** Number of agents */
+    teamSize: number;
+    /** Communication enforcement mode */
+    enforcement: 'strict' | 'permissive' | 'audit';
+    /** High-level description of what the team was trying to accomplish */
+    objective: string;
+    /** Domain of the work */
+    domain: string;
+    /** Task complexity estimate */
+    complexity: 'simple' | 'moderate' | 'complex' | 'epic';
+    events: TeamEvent[];
+    /** Communication graph (built from events) */
+    interactionGraph: InteractionEdge[];
+    /** Coordination metrics (computed from events) */
+    metrics: CoordinationMetrics;
+    /** Per-member outcomes */
+    memberOutcomes: MemberOutcome[];
+    /** Collective outcome */
+    outcome: TeamOutcome;
+    /** Full per-agent trajectories (graph nodes) */
+    members: MemberTrajectory[];
+    /** Step-level interactions between agents (graph edges) */
+    interactions: AgentInteraction[];
+    /** Graph-level structural metrics */
+    graphMetrics: GraphStructuralMetrics;
+    /** Expected interaction patterns from team.yaml */
+    expectedPatterns?: ExpectedInteractionPattern[];
+    /** When the trajectory was recorded */
+    timestamp: Date;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Create a new team trajectory with defaults.
+ */
+export declare function createTeamTrajectory(params: {
+    id?: string;
+    teamName: string;
+    templateName: string;
+    topologyType: TeamTrajectory['topologyType'];
+    roles: string[];
+    teamSize: number;
+    enforcement: TeamTrajectory['enforcement'];
+    objective: string;
+    domain: string;
+    complexity: TeamTrajectory['complexity'];
+    events: TeamEvent[];
+    interactionGraph: InteractionEdge[];
+    metrics: CoordinationMetrics;
+    memberOutcomes: MemberOutcome[];
+    outcome: TeamOutcome;
+    metadata?: Record<string, unknown>;
+    members: MemberTrajectory[];
+    interactions: AgentInteraction[];
+    graphMetrics: GraphStructuralMetrics;
+    expectedPatterns?: ExpectedInteractionPattern[];
+}): TeamTrajectory;
+/**
+ * Check if a team trajectory was successful.
+ */
+export declare function isTeamSuccessful(trajectory: TeamTrajectory): boolean;
+/**
+ * Build an interaction graph from InteractionTags embedded in member trajectories.
+ * Groups by interactionId, links source to target, aggregates into InteractionEdge[].
+ */
+export declare function buildInteractionGraph(members: MemberTrajectoryInput[]): InteractionEdge[];
+/**
+ * Build a TeamTrajectory from TeamTrajectoryInput.
+ * Populates both graph data (members, interactions, graphMetrics) and
+ * derived flat data (events, interactionGraph, metrics, memberOutcomes).
+ */
+export declare function buildTeamTrajectory(input: TeamTrajectoryInput): TeamTrajectory;
+//# sourceMappingURL=team-trajectory.d.ts.map