cognitive-core 0.1.0 → 0.1.2

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

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

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/utils/frontmatter.d.ts

@@ -0,0 +1,34 @@
+import { type KnowledgeNoteFrontmatter, type KnowledgeNote } from '../types/knowledge.js';
+/**
+ * Parse markdown content with YAML frontmatter into a KnowledgeNoteFrontmatter + body.
+ *
+ * Uses the `yaml` npm package for full-fidelity parsing (nested objects,
+ * arrays of objects, etc.). Validates against the Zod schema.
+ *
+ * Returns null frontmatter if the content has no frontmatter block or
+ * if the frontmatter fails validation (logged, not thrown).
+ */
+export declare function parseKnowledgeFrontmatter(content: string): {
+    frontmatter: KnowledgeNoteFrontmatter | null;
+    body: string;
+};
+/**
+ * Serialize a KnowledgeNoteFrontmatter into a YAML frontmatter block.
+ *
+ * Keeps simple top-level fields (created, updated, tags) in a format
+ * that minimem's simpler parser can partially read.
+ */
+export declare function serializeKnowledgeFrontmatter(frontmatter: KnowledgeNoteFrontmatter): string;
+/**
+ * Serialize a full KnowledgeNote (frontmatter + body) into markdown content.
+ */
+export declare function serializeKnowledgeNote(note: KnowledgeNote): string;
+/**
+ * Parse a full markdown file into a KnowledgeNote.
+ * Returns null if frontmatter is missing or invalid.
+ *
+ * @param content - The raw markdown file content
+ * @param filePath - The file path (stored on the note for reference)
+ */
+export declare function parseKnowledgeNote(content: string, filePath: string): KnowledgeNote | null;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAI/B;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG;IAC1D,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd,CA6BA;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,wBAAwB,GACpC,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAGlE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,aAAa,GAAG,IAAI,CAStB"}

package/dist/utils/frontmatter.js

@@ -0,0 +1,93 @@
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { KnowledgeNoteFrontmatterSchema, } from '../types/knowledge.js';
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+/**
+ * Parse markdown content with YAML frontmatter into a KnowledgeNoteFrontmatter + body.
+ *
+ * Uses the `yaml` npm package for full-fidelity parsing (nested objects,
+ * arrays of objects, etc.). Validates against the Zod schema.
+ *
+ * Returns null frontmatter if the content has no frontmatter block or
+ * if the frontmatter fails validation (logged, not thrown).
+ */
+export function parseKnowledgeFrontmatter(content) {
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return { frontmatter: null, body: content };
+    }
+    const [, yamlBlock, body] = match;
+    try {
+        const raw = parseYaml(yamlBlock);
+        if (!raw || typeof raw !== 'object') {
+            return { frontmatter: null, body };
+        }
+        const parsed = KnowledgeNoteFrontmatterSchema.safeParse(raw);
+        if (!parsed.success) {
+            console.warn(`[frontmatter] Validation failed for note: ${JSON.stringify(parsed.error.issues)}`);
+            return { frontmatter: null, body };
+        }
+        return { frontmatter: parsed.data, body: body.trim() };
+    }
+    catch (error) {
+        console.warn(`[frontmatter] YAML parse error: ${error instanceof Error ? error.message : String(error)}`);
+        return { frontmatter: null, body: content };
+    }
+}
+/**
+ * Serialize a KnowledgeNoteFrontmatter into a YAML frontmatter block.
+ *
+ * Keeps simple top-level fields (created, updated, tags) in a format
+ * that minimem's simpler parser can partially read.
+ */
+export function serializeKnowledgeFrontmatter(frontmatter) {
+    // Build a clean object for serialization, omitting null/undefined/empty values
+    const obj = {
+        id: frontmatter.id,
+        type: frontmatter.type,
+    };
+    if (frontmatter.domain.length > 0)
+        obj.domain = frontmatter.domain;
+    if (frontmatter.entities.length > 0)
+        obj.entities = frontmatter.entities;
+    if (frontmatter.tags.length > 0)
+        obj.tags = frontmatter.tags;
+    obj.confidence = frontmatter.confidence;
+    obj.source = frontmatter.source;
+    if (frontmatter.links.length > 0)
+        obj.links = frontmatter.links;
+    obj.created = frontmatter.created;
+    obj.updated = frontmatter.updated;
+    if (frontmatter.supersedes)
+        obj.supersedes = frontmatter.supersedes;
+    const yaml = stringifyYaml(obj, {
+        lineWidth: 120,
+        defaultKeyType: 'PLAIN',
+        defaultStringType: 'PLAIN',
+    });
+    return `---\n${yaml}---\n`;
+}
+/**
+ * Serialize a full KnowledgeNote (frontmatter + body) into markdown content.
+ */
+export function serializeKnowledgeNote(note) {
+    const header = serializeKnowledgeFrontmatter(note.frontmatter);
+    return `${header}\n${note.body}\n`;
+}
+/**
+ * Parse a full markdown file into a KnowledgeNote.
+ * Returns null if frontmatter is missing or invalid.
+ *
+ * @param content - The raw markdown file content
+ * @param filePath - The file path (stored on the note for reference)
+ */
+export function parseKnowledgeNote(content, filePath) {
+    const { frontmatter, body } = parseKnowledgeFrontmatter(content);
+    if (!frontmatter)
+        return null;
+    return {
+        frontmatter,
+        body,
+        filePath,
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

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

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { cosineSimilarity, jaccardSimilarity, textSimilarity, ngramSimilarity, tokenize, findTopK, } from './similarity.js';
 export { ensureDir, saveJson, loadJson, listFiles, exists, JsonStore, saveIndex, loadIndex, type StorageOptions, } from './storage.js';
 export { ValidationError, validateString, validateOptionalString, validateNumber, validateOptionalNumber, validateArray, validateVector, validateTaskInput, validateTrajectoryStepCount, validateMCPArgs, TaskInputSchema, MCPSearchPlaybooksSchema, MCPGetPlaybookDetailsSchema, MCPGetPlaybooksByDomainSchema, type TaskInput, } from './validation.js';
+export { parseKnowledgeFrontmatter, serializeKnowledgeFrontmatter, serializeKnowledgeNote, parseKnowledgeNote, } from './frontmatter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -1,4 +1,5 @@
 export { cosineSimilarity, jaccardSimilarity, textSimilarity, ngramSimilarity, tokenize, findTopK, } from './similarity.js';
 export { ensureDir, saveJson, loadJson, listFiles, exists, JsonStore, saveIndex, loadIndex, } from './storage.js';
 export { ValidationError, validateString, validateOptionalString, validateNumber, validateOptionalNumber, validateArray, validateVector, validateTaskInput, validateTrajectoryStepCount, validateMCPArgs, TaskInputSchema, MCPSearchPlaybooksSchema, MCPGetPlaybookDetailsSchema, MCPGetPlaybooksByDomainSchema, } from './validation.js';
+export { parseKnowledgeFrontmatter, serializeKnowledgeFrontmatter, serializeKnowledgeNote, parseKnowledgeNote, } from './frontmatter.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,GAEV,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,GAEV,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/workspace/index.d.ts

@@ -0,0 +1,6 @@
+export { WorkspaceManager, WorkspaceHandle } from 'agent-workspace';
+export { type OutputSpec, type OutputFileSpec, type ValidationResult, type AgentSkillSpec, type ResourceSpec, type AnalysisComplexity, type ProcessingContext, type AgenticTaskTemplate, type AgenticTaskResult, type AgenticTaskMetrics, AgenticTaskOutputError, } from './types.js';
+export { AgenticTaskRunner, createAgenticTaskRunner, } from './runner.js';
+export { convertPlaybooksToSkills, generateSkillMd, parseSkillMdToPlaybook, } from './skill-converter.js';
+export { trajectoryAnalysisTemplate, type TrajectoryAnalysisInput, playbookExtractionTemplate, type PlaybookExtractionInput, usageInferenceTemplate, type UsageInferenceInput, metaReflectionTemplate, type MetaReflectionInput, type MetaReflectionOutput, solutionEvaluationTemplate, type SolutionEvaluationInput, refinementAnalysisTemplate, type RefinementAnalysisInput, type RefinementPlan, } from './templates/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/workspace/index.js

@@ -0,0 +1,11 @@
+// Workspace management (from agent-workspace package)
+export { WorkspaceManager, WorkspaceHandle } from 'agent-workspace';
+// Workspace types
+export { AgenticTaskOutputError, } from './types.js';
+// AgenticTaskRunner
+export { AgenticTaskRunner, createAgenticTaskRunner, } from './runner.js';
+// Playbook ↔ Skill converter
+export { convertPlaybooksToSkills, generateSkillMd, parseSkillMdToPlaybook, } from './skill-converter.js';
+// Templates
+export { trajectoryAnalysisTemplate, playbookExtractionTemplate, usageInferenceTemplate, metaReflectionTemplate, solutionEvaluationTemplate, refinementAnalysisTemplate, } from './templates/index.js';
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,kBAAkB;AAClB,OAAO,EAWL,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,6BAA6B;AAC7B,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,0BAA0B,EAE1B,0BAA0B,EAE1B,sBAAsB,EAEtB,sBAAsB,EAGtB,0BAA0B,EAE1B,0BAA0B,GAG3B,MAAM,sBAAsB,CAAC"}

package/dist/workspace/runner.d.ts

@@ -0,0 +1,50 @@
+import type { WorkspaceManager } from 'agent-workspace';
+import type { AgentManager } from '../runtime/manager.js';
+import type { MemorySystem } from '../memory/system.js';
+import type { LearningPipeline } from '../learning/pipeline.js';
+import type { AgenticTaskTemplate, AgenticTaskResult } from './types.js';
+import type { AgenticTaskRunnerConfig } from '../types/config.js';
+/**
+ * AgenticTaskRunner — orchestrates the full lifecycle of agentic analysis tasks.
+ *
+ * Flow:
+ * 1. Check complexity → use heuristic fallback for simple inputs
+ * 2. Create workspace and populate input files
+ * 3. Load skills and resources
+ * 4. Query knowledge for injection
+ * 5. Spawn agent with workspace as cwd
+ * 6. Validate and collect output
+ * 7. Process output (store, accumulate)
+ * 8. Route analysis agent's trajectory through learning pipeline
+ * 9. Cleanup workspace
+ */
+export declare class AgenticTaskRunner {
+    private workspaceManager;
+    private agentManager;
+    private memory;
+    private learningPipeline;
+    private config;
+    constructor(workspaceManager: WorkspaceManager, agentManager: AgentManager, memory: MemorySystem, learningPipeline: LearningPipeline, config: AgenticTaskRunnerConfig);
+    /**
+     * Run an agentic analysis task.
+     */
+    run<TInput, TOutput>(template: AgenticTaskTemplate<TInput, TOutput>, input: TInput): Promise<AgenticTaskResult<TOutput>>;
+    /**
+     * Query knowledge for the analysis agent.
+     * Combines domain-scoped query + template-specific additional queries.
+     */
+    private getKnowledge;
+    /**
+     * Collect output with retry on validation failure.
+     */
+    private collectWithRetry;
+    /**
+     * Get timeout based on template default and complexity.
+     */
+    private getTimeout;
+}
+/**
+ * Create an AgenticTaskRunner instance.
+ */
+export declare function createAgenticTaskRunner(workspaceManager: WorkspaceManager, agentManager: AgentManager, memory: MemorySystem, learningPipeline: LearningPipeline, config: AgenticTaskRunnerConfig): AgenticTaskRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/workspace/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/workspace/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,MAAM;gBAJN,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,YAAY,EACpB,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,uBAAuB;IAGzC;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,OAAO,EACvB,QAAQ,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IA6HtC;;;OAGG;YACW,YAAY;IAmB1B;;OAEG;YACW,gBAAgB;IAoB9B;;OAEG;IACH,OAAO,CAAC,UAAU;CAYnB;AAkCD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,YAAY,EACpB,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAQnB"}