cognitive-core 0.0.2 → 0.1.2

package/dist/types/team-trajectory.js

@@ -0,0 +1,304 @@
+/**
+ * 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/types/team-trajectory.js.map

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

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

@@ -0,0 +1,39 @@
+import type { Trajectory } from './trajectory.js';
+import type { AnalysisResult } from '../learning/analyzer.js';
+/**
+ * A trajectory paired with its optional pre-computed analysis.
+ * If analysis is missing, the consumer should compute it.
+ */
+export interface TrajectoryWithAnalysis {
+    trajectory: Trajectory;
+    analysis?: AnalysisResult;
+}
+/**
+ * Options for filtering trajectories when loading.
+ */
+export interface TrajectoryLoadOptions {
+    /** Only load trajectories created after this date */
+    since?: Date;
+    /** Filter to a specific domain */
+    domain?: string;
+    /** Maximum number of trajectories to return */
+    limit?: number;
+    /** Only include successful trajectories */
+    successOnly?: boolean;
+}
+/**
+ * TrajectorySource — abstract interface for loading trajectories from
+ * different backends (in-memory arrays, filesystem, pipeline accumulators, etc.).
+ *
+ * Consumers of this interface (e.g. KnowledgeBank.extractFrom) don't care
+ * where trajectories come from — they just load and process them.
+ */
+export interface TrajectorySource {
+    /** Human-readable name for this source */
+    readonly name: string;
+    /** Load trajectories, optionally filtered */
+    load(options?: TrajectoryLoadOptions): Promise<TrajectoryWithAnalysis[]>;
+    /** Count available trajectories without loading them */
+    count(options?: TrajectoryLoadOptions): Promise<number>;
+}
+//# sourceMappingURL=trajectory-source.d.ts.map

package/dist/types/trajectory-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-source.d.ts","sourceRoot":"","sources":["../../src/types/trajectory-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6CAA6C;IAC7C,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAEzE,wDAAwD;IACxD,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzD"}

package/dist/types/trajectory-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trajectory-source.js.map

package/dist/types/trajectory-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-source.js","sourceRoot":"","sources":["../../src/types/trajectory-source.ts"],"names":[],"mappings":""}

package/dist/types/trajectory.d.ts

@@ -0,0 +1,221 @@
+import { z } from 'zod';
+import { type Task } from './task.js';
+import { type Step } from './step.js';
+import { type Outcome } from './outcome.js';
+/**
+ * Trajectory - A complete record of an agent's task-solving attempt
+ * The atomic unit of learning in Atlas
+ */
+export declare const TrajectorySchema: z.ZodObject<{
+    /** Unique trajectory identifier */
+    id: z.ZodString;
+    /** The task being solved */
+    task: z.ZodObject<{
+        id: z.ZodString;
+        domain: z.ZodString;
+        description: z.ZodString;
+        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        verification: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["exact_match", "fuzzy_match", "function", "llm"]>;
+            expected: z.ZodOptional<z.ZodUnknown>;
+            tolerance: z.ZodOptional<z.ZodNumber>;
+            verifier_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        }, {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        }>>;
+        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        createdAt: z.ZodDefault<z.ZodDate>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        domain: string;
+        description: string;
+        context: Record<string, unknown>;
+        metadata: Record<string, unknown>;
+        createdAt: Date;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+    }, {
+        id: string;
+        domain: string;
+        description: string;
+        context?: Record<string, unknown> | undefined;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: Date | undefined;
+    }>;
+    /** Sequence of steps taken */
+    steps: z.ZodArray<z.ZodObject<{
+        thought: z.ZodOptional<z.ZodString>;
+        action: z.ZodString;
+        observation: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodDate>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attributionScore: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        metadata: Record<string, unknown>;
+        action: string;
+        observation: string;
+        timestamp: Date;
+        thought?: string | undefined;
+        attributionScore?: number | undefined;
+    }, {
+        action: string;
+        observation: string;
+        metadata?: Record<string, unknown> | undefined;
+        thought?: string | undefined;
+        timestamp?: Date | undefined;
+        attributionScore?: number | undefined;
+    }>, "many">;
+    /** Final outcome */
+    outcome: z.ZodObject<{
+        success: z.ZodBoolean;
+        partialScore: z.ZodDefault<z.ZodNumber>;
+        errorInfo: z.ZodOptional<z.ZodString>;
+        verificationDetails: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        solution: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        partialScore: number;
+        verificationDetails: Record<string, unknown>;
+        errorInfo?: string | undefined;
+        solution?: unknown;
+    }, {
+        success: boolean;
+        partialScore?: number | undefined;
+        errorInfo?: string | undefined;
+        verificationDetails?: Record<string, unknown> | undefined;
+        solution?: unknown;
+    }>;
+    /** Identifier of the agent that produced this trajectory */
+    agentId: z.ZodString;
+    /** When the trajectory was created */
+    timestamp: z.ZodDefault<z.ZodDate>;
+    /** Number of LLM API calls made */
+    llmCalls: z.ZodDefault<z.ZodNumber>;
+    /** Total tokens used */
+    totalTokens: z.ZodDefault<z.ZodNumber>;
+    /** Wall clock time in seconds */
+    wallTimeSeconds: z.ZodDefault<z.ZodNumber>;
+    /** Additional metadata */
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    metadata: Record<string, unknown>;
+    timestamp: Date;
+    task: {
+        id: string;
+        domain: string;
+        description: string;
+        context: Record<string, unknown>;
+        metadata: Record<string, unknown>;
+        createdAt: Date;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+    };
+    steps: {
+        metadata: Record<string, unknown>;
+        action: string;
+        observation: string;
+        timestamp: Date;
+        thought?: string | undefined;
+        attributionScore?: number | undefined;
+    }[];
+    outcome: {
+        success: boolean;
+        partialScore: number;
+        verificationDetails: Record<string, unknown>;
+        errorInfo?: string | undefined;
+        solution?: unknown;
+    };
+    agentId: string;
+    llmCalls: number;
+    totalTokens: number;
+    wallTimeSeconds: number;
+}, {
+    id: string;
+    task: {
+        id: string;
+        domain: string;
+        description: string;
+        context?: Record<string, unknown> | undefined;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: Date | undefined;
+    };
+    steps: {
+        action: string;
+        observation: string;
+        metadata?: Record<string, unknown> | undefined;
+        thought?: string | undefined;
+        timestamp?: Date | undefined;
+        attributionScore?: number | undefined;
+    }[];
+    outcome: {
+        success: boolean;
+        partialScore?: number | undefined;
+        errorInfo?: string | undefined;
+        verificationDetails?: Record<string, unknown> | undefined;
+        solution?: unknown;
+    };
+    agentId: string;
+    metadata?: Record<string, unknown> | undefined;
+    timestamp?: Date | undefined;
+    llmCalls?: number | undefined;
+    totalTokens?: number | undefined;
+    wallTimeSeconds?: number | undefined;
+}>;
+export type Trajectory = z.infer<typeof TrajectorySchema>;
+/**
+ * Create a new trajectory
+ */
+export declare function createTrajectory(params: {
+    id?: string;
+    task: Task;
+    steps: Step[];
+    outcome: Outcome;
+    agentId: string;
+    llmCalls?: number;
+    totalTokens?: number;
+    wallTimeSeconds?: number;
+    metadata?: Record<string, unknown>;
+}): Trajectory;
+/**
+ * Check if trajectory was successful
+ */
+export declare function isSuccessful(trajectory: Trajectory): boolean;
+/**
+ * Get key steps (those with high attribution scores)
+ */
+export declare function getKeySteps(trajectory: Trajectory, threshold?: number): Step[];
+//# sourceMappingURL=trajectory.d.ts.map

package/dist/types/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/types/trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B,mCAAmC;;IAEnC,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE5B,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;IAE9B,oBAAoB;;;;;;;;;;;;;;;;;;;;IAEpB,4DAA4D;;IAE5D,sCAAsC;;IAEtC,mCAAmC;;IAEnC,wBAAwB;;IAExB,iCAAiC;;IAEjC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE1B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAab;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,UAAU,EACtB,SAAS,SAAO,GACf,IAAI,EAAE,CAIR"}

package/dist/types/trajectory.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { TaskSchema } from './task.js';
+import { StepSchema } from './step.js';
+import { OutcomeSchema } from './outcome.js';
+/**
+ * Trajectory - A complete record of an agent's task-solving attempt
+ * The atomic unit of learning in Atlas
+ */
+export const TrajectorySchema = z.object({
+    /** Unique trajectory identifier */
+    id: z.string(),
+    /** The task being solved */
+    task: TaskSchema,
+    /** Sequence of steps taken */
+    steps: z.array(StepSchema),
+    /** Final outcome */
+    outcome: OutcomeSchema,
+    /** Identifier of the agent that produced this trajectory */
+    agentId: z.string(),
+    /** When the trajectory was created */
+    timestamp: z.date().default(() => new Date()),
+    /** Number of LLM API calls made */
+    llmCalls: z.number().default(0),
+    /** Total tokens used */
+    totalTokens: z.number().default(0),
+    /** Wall clock time in seconds */
+    wallTimeSeconds: z.number().default(0),
+    /** Additional metadata */
+    metadata: z.record(z.unknown()).default({}),
+});
+/**
+ * Create a new trajectory
+ */
+export function createTrajectory(params) {
+    return TrajectorySchema.parse({
+        id: params.id ?? crypto.randomUUID(),
+        task: params.task,
+        steps: params.steps,
+        outcome: params.outcome,
+        agentId: params.agentId,
+        timestamp: new Date(),
+        llmCalls: params.llmCalls ?? 0,
+        totalTokens: params.totalTokens ?? 0,
+        wallTimeSeconds: params.wallTimeSeconds ?? 0,
+        metadata: params.metadata ?? {},
+    });
+}
+/**
+ * Check if trajectory was successful
+ */
+export function isSuccessful(trajectory) {
+    return trajectory.outcome.success;
+}
+/**
+ * Get key steps (those with high attribution scores)
+ */
+export function getKeySteps(trajectory, threshold = 0.15) {
+    return trajectory.steps.filter((step) => (step.attributionScore ?? 0) >= threshold);
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/types/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../src/types/trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,aAAa,EAAgB,MAAM,cAAc,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,mCAAmC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,4BAA4B;IAC5B,IAAI,EAAE,UAAU;IAChB,8BAA8B;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1B,oBAAoB;IACpB,OAAO,EAAE,aAAa;IACtB,4DAA4D;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,sCAAsC;IACtC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7C,mCAAmC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/B,wBAAwB;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,iCAAiC;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAUhC;IACC,OAAO,gBAAgB,CAAC,KAAK,CAAC;QAC5B,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC;QACpC,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;QAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAsB;IACjD,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,UAAsB,EACtB,SAAS,GAAG,IAAI;IAEhB,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,SAAS,CACpD,CAAC;AACJ,CAAC"}