cognitive-core 0.2.5 → 0.3.1

package/dist/experimental/team/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 '../../types/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

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

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

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

@@ -0,0 +1,315 @@
+/**
+ * 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.
+ */
+/**
+ * Create a new team trajectory with defaults.
+ */
+export function createTeamTrajectory(params) {
+    return {
+        id: params.id ?? crypto.randomUUID(),
+        teamName: params.teamName,
+        templateName: params.templateName,
+        topologyType: params.topologyType,
+        roles: params.roles,
+        teamSize: params.teamSize,
+        enforcement: params.enforcement,
+        objective: params.objective,
+        domain: params.domain,
+        complexity: params.complexity,
+        events: params.events,
+        interactionGraph: params.interactionGraph,
+        metrics: params.metrics,
+        memberOutcomes: params.memberOutcomes,
+        outcome: params.outcome,
+        members: params.members,
+        interactions: params.interactions,
+        graphMetrics: params.graphMetrics,
+        expectedPatterns: params.expectedPatterns,
+        timestamp: new Date(),
+        metadata: params.metadata ?? {},
+    };
+}
+/**
+ * Check if a team trajectory was successful.
+ */
+export function isTeamSuccessful(trajectory) {
+    return trajectory.outcome.success;
+}
+/**
+ * Build an interaction graph from InteractionTags embedded in member trajectories.
+ * Groups by interactionId, links source to target, aggregates into InteractionEdge[].
+ */
+export function buildInteractionGraph(members) {
+    // Collect all interaction tags from step metadata
+    const tagsByInteraction = new Map();
+    for (const member of members) {
+        for (const step of member.trajectory.steps) {
+            const tag = step.metadata?.interactionTag;
+            if (!tag)
+                continue;
+            if (!tagsByInteraction.has(tag.interactionId)) {
+                tagsByInteraction.set(tag.interactionId, {});
+            }
+            const entry = tagsByInteraction.get(tag.interactionId);
+            if (tag.stepRole === 'source') {
+                entry.source = { role: member.role, agentId: member.agentId, type: tag.interactionType };
+            }
+            else {
+                entry.target = { role: member.role, agentId: member.agentId };
+            }
+        }
+    }
+    // Aggregate into edges (from role → to role)
+    const edgeMap = new Map();
+    for (const entry of tagsByInteraction.values()) {
+        if (!entry.source || !entry.target)
+            continue;
+        const key = `${entry.source.role}->${entry.target.role}`;
+        if (!edgeMap.has(key)) {
+            edgeMap.set(key, {
+                from: entry.source.role,
+                to: entry.target.role,
+                count: 0,
+                types: [],
+            });
+        }
+        const edge = edgeMap.get(key);
+        edge.count++;
+        const eventType = interactionTypeToEventType(entry.source.type);
+        if (eventType && !edge.types.includes(eventType)) {
+            edge.types.push(eventType);
+        }
+    }
+    return [...edgeMap.values()];
+}
+/**
+ * Map InteractionType to closest TeamEventType.
+ */
+function interactionTypeToEventType(type) {
+    switch (type) {
+        case 'delegation':
+            return 'task_delegated';
+        case 'result_return':
+            return 'task_completed';
+        case 'message':
+            return 'message_sent';
+        case 'signal':
+            return 'signal_emitted';
+        case 'spawn':
+            return 'agent_spawned';
+        case 'escalation':
+            return 'escalation';
+        default:
+            return null;
+    }
+}
+/**
+ * Build a TeamTrajectory from TeamTrajectoryInput.
+ * Populates both graph data (members, interactions, graphMetrics) and
+ * derived flat data (events, interactionGraph, metrics, memberOutcomes).
+ */
+export function buildTeamTrajectory(input) {
+    // === GRAPH DATA (primary) ===
+    // Preserve full member trajectories as graph nodes
+    const members = input.memberTrajectories.map((m) => ({
+        agentId: m.agentId,
+        role: m.role,
+        trajectory: m.trajectory,
+    }));
+    // Build step-level interactions from InteractionTag metadata
+    const interactions = buildAgentInteractions(input.memberTrajectories, input.expectedPatterns);
+    // Build aggregated interaction graph (flat, for backward compat)
+    const interactionGraph = buildInteractionGraph(input.memberTrajectories);
+    // === FLAT DATA (derived from graph for backward compat) ===
+    // Convert individual trajectories to team events
+    const events = [];
+    const memberOutcomes = [];
+    for (const member of input.memberTrajectories) {
+        // Add spawn event
+        events.push({
+            timestamp: new Date(member.trajectory.steps[0]?.metadata?.timestamp ?? Date.now()),
+            type: 'agent_spawned',
+            agentId: member.agentId,
+            role: member.role,
+            payload: {},
+        });
+        // Convert steps to events
+        for (const step of member.trajectory.steps) {
+            events.push({
+                timestamp: new Date(step.metadata?.timestamp ?? Date.now()),
+                type: stepToEventType(step),
+                agentId: member.agentId,
+                role: member.role,
+                payload: { action: step.action, result: step.observation },
+            });
+        }
+        // Build member outcome
+        const traj = member.trajectory;
+        memberOutcomes.push({
+            agentId: member.agentId,
+            role: member.role,
+            tasksAssigned: traj.steps.length,
+            tasksCompleted: traj.outcome?.success
+                ? traj.steps.length
+                : Math.floor(traj.steps.length * (traj.outcome?.partialScore ?? 0)),
+            tasksFailed: traj.outcome?.success
+                ? 0
+                : Math.ceil(traj.steps.length * (1 - (traj.outcome?.partialScore ?? 0))),
+            llmCalls: traj.steps.length,
+            totalTokens: traj.steps.reduce((sum, s) => sum + (Number(s.metadata?.tokens) || 0), 0),
+            trajectoryId: traj.id,
+        });
+    }
+    // Sort events by timestamp
+    events.sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+    // Compute coordination metrics (flat)
+    const wallTime = input.outcome.totalWallTimeSeconds;
+    const metrics = {
+        totalWallTimeSeconds: wallTime,
+        timeToFirstOutputSeconds: wallTime > 0 ? wallTime * 0.1 : 0,
+        coordinationOverheadRatio: interactionGraph.length > 0
+            ? Math.min(interactionGraph.reduce((s, e) => s + e.count, 0) / Math.max(events.length, 1), 1)
+            : 0,
+        bottleneckAgent: findBottleneck(memberOutcomes),
+        communicationCycles: interactionGraph.filter((e) => interactionGraph.some((e2) => e2.from === e.to && e2.to === e.from)).length,
+        maxDependencyDepth: 1,
+        reDelegationCount: 0,
+        parallelismRatio: input.memberTrajectories.length > 1 ? 0.5 : 0,
+    };
+    // Compute graph structural metrics
+    const totalSteps = members.reduce((s, m) => s + m.trajectory.steps.length, 0);
+    const totalTokens = members.reduce((s, m) => s + (m.trajectory.totalTokens ?? 0), 0);
+    const graphMetrics = computeGraphMetrics(members, interactions, wallTime, totalSteps, totalTokens, metrics.parallelismRatio);
+    return createTeamTrajectory({
+        teamName: input.teamName,
+        templateName: input.templateName,
+        topologyType: input.topologyType,
+        roles: [...new Set(input.memberTrajectories.map((m) => m.role))],
+        teamSize: input.memberTrajectories.length,
+        enforcement: input.enforcement,
+        objective: input.objective,
+        domain: input.domain,
+        complexity: input.complexity,
+        events,
+        interactionGraph,
+        metrics,
+        memberOutcomes,
+        outcome: input.outcome,
+        metadata: input.metadata ?? {},
+        // Graph data
+        members,
+        interactions,
+        graphMetrics,
+        expectedPatterns: input.expectedPatterns,
+    });
+}
+/**
+ * Build step-level AgentInteraction objects from InteractionTag metadata.
+ */
+function buildAgentInteractions(memberTrajectories, expectedPatterns) {
+    // Collect all tagged steps, grouped by interactionId
+    const tagGroups = new Map();
+    for (const member of memberTrajectories) {
+        for (let i = 0; i < member.trajectory.steps.length; i++) {
+            const step = member.trajectory.steps[i];
+            const tag = step.metadata?.interactionTag;
+            if (!tag)
+                continue;
+            if (!tagGroups.has(tag.interactionId)) {
+                tagGroups.set(tag.interactionId, {});
+            }
+            const group = tagGroups.get(tag.interactionId);
+            const entry = { agentId: member.agentId, role: member.role, stepIndex: i, step, tag };
+            if (tag.stepRole === 'source') {
+                group.source = entry;
+            }
+            else {
+                group.target = entry;
+            }
+        }
+    }
+    // Build AgentInteraction for each complete pair
+    const interactions = [];
+    for (const [interactionId, group] of tagGroups) {
+        if (!group.source || !group.target)
+            continue;
+        const { source, target } = group;
+        const sourceTs = source.step.timestamp?.getTime() ?? 0;
+        const targetTs = target.step.timestamp?.getTime() ?? 0;
+        // Check if this interaction was expected
+        const wasExpected = expectedPatterns?.some((p) => p.fromRole === source.role &&
+            p.toRole === target.role &&
+            p.type === source.tag.interactionType) ?? false;
+        interactions.push({
+            id: interactionId,
+            type: source.tag.interactionType,
+            from: { agentId: source.agentId, role: source.role, stepIndex: source.stepIndex },
+            to: { agentId: target.agentId, role: target.role, stepIndex: target.stepIndex },
+            content: source.step.observation ?? '',
+            channel: source.tag.channel,
+            signal: source.tag.signal,
+            timestamp: source.step.timestamp ?? new Date(),
+            latencyMs: sourceTs > 0 && targetTs > 0 ? Math.abs(targetTs - sourceTs) : undefined,
+            wasExpected,
+        });
+    }
+    return interactions.sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+}
+/**
+ * Compute GraphStructuralMetrics from members and interactions.
+ */
+function computeGraphMetrics(members, interactions, wallTime, totalSteps, totalTokens, parallelismRatio) {
+    // Compute in-degree and out-degree per agent
+    const inDegree = new Map();
+    const outDegree = new Map();
+    for (const interaction of interactions) {
+        inDegree.set(interaction.to.agentId, (inDegree.get(interaction.to.agentId) ?? 0) + 1);
+        outDegree.set(interaction.from.agentId, (outDegree.get(interaction.from.agentId) ?? 0) + 1);
+    }
+    let maxIn = { agentId: '', count: 0 };
+    for (const [agentId, count] of inDegree) {
+        if (count > maxIn.count)
+            maxIn = { agentId, count };
+    }
+    let maxOut = { agentId: '', count: 0 };
+    for (const [agentId, count] of outDegree) {
+        if (count > maxOut.count)
+            maxOut = { agentId, count };
+    }
+    return {
+        teamSize: members.length,
+        totalSteps,
+        totalInteractions: interactions.length,
+        interactionDensity: totalSteps > 0 ? interactions.length / totalSteps : 0,
+        maxInDegree: maxIn,
+        maxOutDegree: maxOut,
+        parallelismRatio,
+        totalWallTimeSeconds: wallTime,
+        totalTokens,
+    };
+}
+function stepToEventType(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';
+    return 'task_completed';
+}
+function findBottleneck(outcomes) {
+    if (outcomes.length === 0)
+        return undefined;
+    const maxTokens = Math.max(...outcomes.map((m) => m.totalTokens));
+    const bottleneck = outcomes.find((m) => m.totalTokens === maxTokens);
+    return bottleneck?.agentId;
+}
+//# sourceMappingURL=team-trajectory.js.map

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

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

package/dist/factory.d.ts

@@ -21,7 +21,7 @@
 import type { Task, Trajectory, Step, Outcome } from './types/index.js';
 import { createTask, createTrajectory, createStep, successOutcome, failureOutcome } from './types/index.js';
 import { createMemorySystem } from './memory/system.js';
-import type { ImmediateResult, UnifiedBatchResult } from './learning/unified-pipeline.js';
+import type { ImmediateResult } from './learning/unified-pipeline.js';
 import { createUnifiedPipeline } from './learning/unified-pipeline.js';
 /**
  * Parameters for creating a Task
@@ -77,7 +77,6 @@ export interface LearningPipelineConfig {
 export interface ILearningPipeline {
     init(): Promise<void>;
     processTrajectory(trajectory: Trajectory): Promise<ImmediateResult>;
-    runBatch(): Promise<UnifiedBatchResult>;
     getAccumulatedCount(): number;
 }
 /**
@@ -89,7 +88,7 @@ export interface IMemorySystem {
     playbooks: {
         getAll(): Promise<import('./types/playbook.js').Playbook[]>;
         get(id: string): Promise<import('./types/playbook.js').Playbook | undefined>;
-        add(playbook: import('./types/playbook.js').Playbook): Promise<void>;
+        add(playbook: import('./types/playbook.js').Playbook): Promise<string>;
         recordSuccess(id: string, trajectoryId: string): Promise<void>;
         recordFailure(id: string, trajectoryId: string, context: string, failureMode: string): Promise<void>;
     };