cognitive-core 0.1.0 → 0.2.0

package/dist/utils/partitioned-store.js

@@ -0,0 +1,251 @@
+/**
+ * Partitioned Store
+ *
+ * Domain-partitioned wrapper around JsonStore. Items are routed to partition
+ * subdirectories based on a caller-supplied key function. Queries can target
+ * a single partition (fast) or scan all partitions (full).
+ *
+ * On first init with existing flat data (no partition subdirs), items are
+ * auto-migrated into partition directories. This is a one-time operation.
+ */
+import { JsonStore, ensureDir, loadJson, listFiles } from './storage.js';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { rename } from 'node:fs/promises';
+const GLOBAL_PARTITION = '_global';
+/**
+ * Domain-partitioned key-value store backed by JSON files
+ */
+export class PartitionedStore {
+    partitions = new Map();
+    keyIndex = new Map(); // key → partition name
+    baseDir;
+    collection;
+    partitionKeyFn;
+    options;
+    initialized = false;
+    constructor(baseDir, collection, partitionKeyFn, options) {
+        this.baseDir = baseDir;
+        this.collection = collection;
+        this.partitionKeyFn = partitionKeyFn;
+        this.options = options ?? {};
+    }
+    /**
+     * Initialize — discover existing partitions, auto-migrate flat data if needed
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        const collectionDir = join(this.baseDir, this.collection);
+        await ensureDir(collectionDir);
+        // Check if we need to migrate from flat layout
+        await this.maybeMigrate(collectionDir);
+        // Discover partition subdirectories
+        const entries = await listFiles(collectionDir);
+        for (const entry of entries) {
+            const entryPath = join(collectionDir, entry);
+            if (existsSync(entryPath) && !entry.endsWith('.json')) {
+                // It's a directory — treat as partition
+                await this.getOrCreatePartition(entry);
+            }
+        }
+        // Ensure global partition exists
+        await this.getOrCreatePartition(GLOBAL_PARTITION);
+        this.initialized = true;
+    }
+    /**
+     * Get an item by key. If partition is known, searches only that partition.
+     */
+    get(key, partition) {
+        if (partition) {
+            return this.partitions.get(partition)?.get(key);
+        }
+        // Check index first
+        const knownPartition = this.keyIndex.get(key);
+        if (knownPartition) {
+            return this.partitions.get(knownPartition)?.get(key);
+        }
+        // Fall back to scanning all partitions
+        for (const store of this.partitions.values()) {
+            const item = store.get(key);
+            if (item !== undefined)
+                return item;
+        }
+        return undefined;
+    }
+    /**
+     * Set an item — auto-routes to the correct partition based on partitionKeyFn
+     */
+    set(key, value) {
+        const partitionName = this.partitionKeyFn(value) || GLOBAL_PARTITION;
+        // If the item was in a different partition, remove it from the old one
+        const oldPartition = this.keyIndex.get(key);
+        if (oldPartition && oldPartition !== partitionName) {
+            this.partitions.get(oldPartition)?.delete(key);
+        }
+        const store = this.partitions.get(partitionName);
+        if (store) {
+            store.set(key, value);
+            this.keyIndex.set(key, partitionName);
+        }
+        else {
+            // Partition doesn't exist yet — create it synchronously by using the map
+            // (the directory will be created on flush/save)
+            const newStore = new JsonStore(join(this.baseDir, this.collection), partitionName, this.options);
+            this.partitions.set(partitionName, newStore);
+            newStore.set(key, value);
+            this.keyIndex.set(key, partitionName);
+        }
+    }
+    /**
+     * Delete an item by key
+     */
+    delete(key) {
+        const partition = this.keyIndex.get(key);
+        if (partition) {
+            this.keyIndex.delete(key);
+            return this.partitions.get(partition)?.delete(key) ?? false;
+        }
+        // Fall back to scanning
+        for (const store of this.partitions.values()) {
+            if (store.has(key)) {
+                store.delete(key);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Check if a key exists
+     */
+    has(key) {
+        if (this.keyIndex.has(key))
+            return true;
+        for (const store of this.partitions.values()) {
+            if (store.has(key))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Get all values within a single partition
+     */
+    valuesInPartition(partition) {
+        return this.partitions.get(partition)?.values() ?? [];
+    }
+    /**
+     * Get all values across all partitions
+     */
+    values() {
+        const result = [];
+        for (const store of this.partitions.values()) {
+            result.push(...store.values());
+        }
+        return result;
+    }
+    /**
+     * Get all keys across all partitions
+     */
+    keys() {
+        const result = [];
+        for (const store of this.partitions.values()) {
+            result.push(...store.keys());
+        }
+        return result;
+    }
+    /**
+     * Get total item count across all partitions
+     */
+    size() {
+        let total = 0;
+        for (const store of this.partitions.values()) {
+            total += store.size();
+        }
+        return total;
+    }
+    /**
+     * Get names of all partitions
+     */
+    getPartitionNames() {
+        return Array.from(this.partitions.keys());
+    }
+    /**
+     * Get all entries across all partitions
+     */
+    entries() {
+        const result = [];
+        for (const store of this.partitions.values()) {
+            result.push(...store.entries());
+        }
+        return result;
+    }
+    /**
+     * Flush all dirty partitions to disk
+     */
+    async flush() {
+        for (const store of this.partitions.values()) {
+            await store.flush();
+        }
+    }
+    /**
+     * Save a single item immediately
+     */
+    async save(key) {
+        const partition = this.keyIndex.get(key);
+        if (partition) {
+            await this.partitions.get(partition)?.save(key);
+        }
+    }
+    /**
+     * Close all partitions
+     */
+    async close() {
+        for (const store of this.partitions.values()) {
+            await store.close();
+        }
+    }
+    /**
+     * Get or create a partition's JsonStore, loading its data
+     */
+    async getOrCreatePartition(name) {
+        let store = this.partitions.get(name);
+        if (store)
+            return store;
+        store = new JsonStore(join(this.baseDir, this.collection), name, this.options);
+        await store.init();
+        this.partitions.set(name, store);
+        // Build key index for this partition
+        for (const key of store.keys()) {
+            this.keyIndex.set(key, name);
+        }
+        return store;
+    }
+    /**
+     * Migrate flat layout (files directly in collection dir) to partitioned layout.
+     * Only runs if flat JSON files exist alongside no partition directories.
+     */
+    async maybeMigrate(collectionDir) {
+        const entries = await listFiles(collectionDir);
+        const jsonFiles = entries.filter((f) => f.endsWith('.json') && !f.startsWith('_'));
+        const subdirs = entries.filter((f) => {
+            const p = join(collectionDir, f);
+            return existsSync(p) && !f.endsWith('.json');
+        });
+        // Only migrate if there are JSON files and no subdirectories yet
+        if (jsonFiles.length === 0 || subdirs.length > 0)
+            return;
+        // Load each file, determine its partition, move it
+        for (const file of jsonFiles) {
+            const filePath = join(collectionDir, file);
+            const data = await loadJson(filePath);
+            if (!data)
+                continue;
+            const partitionName = this.partitionKeyFn(data) || GLOBAL_PARTITION;
+            const partitionDir = join(collectionDir, partitionName);
+            await ensureDir(partitionDir);
+            const destPath = join(partitionDir, file);
+            await rename(filePath, destPath);
+        }
+    }
+}
+//# sourceMappingURL=partitioned-store.js.map

package/dist/utils/partitioned-store.js.map

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

package/dist/utils/trajectory-helpers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared trajectory analysis helpers.
+ *
+ * Consolidates action repetition detection and tool name extraction
+ * previously duplicated across analyzer.ts, reflexion-generator.ts,
+ * and meta-learner.ts.
+ */
+import type { Step } from '../types/index.js';
+/**
+ * An action that was repeated beyond the threshold.
+ */
+export interface RepeatedAction {
+    /** The action string (or normalized prefix) */
+    action: string;
+    /** How many times it occurred */
+    count: number;
+}
+/**
+ * Detect repeated actions in a list of steps.
+ *
+ * @param steps - The trajectory steps to analyze
+ * @param threshold - Minimum count to flag as repeated (default: 3)
+ * @param normalize - Optional normalization function for action strings.
+ *   Defaults to lowercasing + truncating to 50 chars.
+ * @returns Array of repeated actions exceeding the threshold.
+ */
+export declare function detectRepeatedActions(steps: ReadonlyArray<Pick<Step, 'action'>>, threshold?: number, normalize?: (action: string) => string): RepeatedAction[];
+/**
+ * Extract tool names from trajectory steps.
+ *
+ * Handles both formats:
+ *   - "ToolName args..."
+ *   - "tool_use: ToolName args..."
+ *
+ * @param steps - The trajectory steps to analyze
+ * @returns Set of unique tool names found.
+ */
+export declare function extractToolNames(steps: ReadonlyArray<Pick<Step, 'action'>>): Set<string>;
+//# sourceMappingURL=trajectory-helpers.d.ts.map

package/dist/utils/trajectory-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/trajectory-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAC1C,SAAS,SAAI,EACb,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GACrC,cAAc,EAAE,CAkBlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GACzC,GAAG,CAAC,MAAM,CAAC,CAab"}

package/dist/utils/trajectory-helpers.js

@@ -0,0 +1,57 @@
+/**
+ * Shared trajectory analysis helpers.
+ *
+ * Consolidates action repetition detection and tool name extraction
+ * previously duplicated across analyzer.ts, reflexion-generator.ts,
+ * and meta-learner.ts.
+ */
+/**
+ * Detect repeated actions in a list of steps.
+ *
+ * @param steps - The trajectory steps to analyze
+ * @param threshold - Minimum count to flag as repeated (default: 3)
+ * @param normalize - Optional normalization function for action strings.
+ *   Defaults to lowercasing + truncating to 50 chars.
+ * @returns Array of repeated actions exceeding the threshold.
+ */
+export function detectRepeatedActions(steps, threshold = 3, normalize) {
+    const norm = normalize ?? ((a) => a.toLowerCase().slice(0, 50));
+    const counts = new Map();
+    for (const step of steps) {
+        if (!step.action)
+            continue;
+        const key = norm(step.action);
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    const repeated = [];
+    for (const [action, count] of counts) {
+        if (count >= threshold) {
+            repeated.push({ action, count });
+        }
+    }
+    return repeated;
+}
+/**
+ * Extract tool names from trajectory steps.
+ *
+ * Handles both formats:
+ *   - "ToolName args..."
+ *   - "tool_use: ToolName args..."
+ *
+ * @param steps - The trajectory steps to analyze
+ * @returns Set of unique tool names found.
+ */
+export function extractToolNames(steps) {
+    const tools = new Set();
+    for (const step of steps) {
+        if (!step.action)
+            continue;
+        // Matches "tool_use: ToolName ..." or "ToolName ..."
+        const match = step.action.match(/^(?:tool_use:\s*)?(\w+(?:[A-Z]\w*)*)/);
+        if (match) {
+            tools.add(match[1]);
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=trajectory-helpers.js.map

package/dist/utils/trajectory-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-helpers.js","sourceRoot":"","sources":["../../src/utils/trajectory-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA0C,EAC1C,SAAS,GAAG,CAAC,EACb,SAAsC;IAEtC,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACrC,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA0C;IAE1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAC3B,qDAAqD;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxE,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,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,49 @@
+import type { WorkspaceManager } from 'agent-workspace';
+import type { AgentManager } from '../runtime/manager.js';
+import type { MemorySystem } from '../memory/system.js';
+import type { AgenticTaskTemplate, AgenticTaskResult, TrajectoryProcessor } 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: TrajectoryProcessor, 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: TrajectoryProcessor, 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;AAE7E,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,mBAAmB,EAEpB,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,mBAAmB,EACrC,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,mBAAmB,EACrC,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAQnB"}

package/dist/workspace/runner.js

@@ -0,0 +1,219 @@
+import { createTask } from '../types/task.js';
+import { AgenticTaskOutputError } from './types.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 class AgenticTaskRunner {
+    workspaceManager;
+    agentManager;
+    memory;
+    learningPipeline;
+    config;
+    constructor(workspaceManager, agentManager, memory, learningPipeline, config) {
+        this.workspaceManager = workspaceManager;
+        this.agentManager = agentManager;
+        this.memory = memory;
+        this.learningPipeline = learningPipeline;
+        this.config = config;
+    }
+    /**
+     * Run an agentic analysis task.
+     */
+    async run(template, input) {
+        const startTime = Date.now();
+        // Step 1: Complexity assessment
+        const complexity = template.assessComplexity(input);
+        if (complexity === 'heuristic' && template.heuristicFallback) {
+            const output = await template.heuristicFallback(input);
+            return {
+                output,
+                method: 'heuristic',
+                metrics: {
+                    totalTimeMs: Date.now() - startTime,
+                    tokensUsed: 0,
+                    toolCalls: 0,
+                },
+            };
+        }
+        // Step 2: Create workspace (with skills/ as additional directory)
+        const handle = await this.workspaceManager.create(template.taskType, {
+            additionalDirs: ['skills'],
+        });
+        let failed = false;
+        try {
+            // Step 3: Populate input files via handle
+            await template.prepareWorkspace(input, handle);
+            // Step 4: Populate skills
+            const skills = template.getSkills(input);
+            for (const skill of skills) {
+                await handle.writeRaw('skills', `${skill.name}/SKILL.md`, skill.content);
+            }
+            // Step 5: Populate resources
+            const resources = template.getResources(input);
+            for (const resource of resources) {
+                switch (resource.type) {
+                    case 'file':
+                        await handle.writeRaw('resources', resource.path, resource.source);
+                        break;
+                    case 'symlink':
+                        await handle.symlink('resources', resource.path, resource.source);
+                        break;
+                    case 'directory':
+                        await handle.copyDir('resources', resource.path, resource.source);
+                        break;
+                }
+            }
+            // Step 6: Query knowledge
+            const knowledge = await this.getKnowledge(template, input);
+            // Step 7: Spawn agent
+            const task = createTask({
+                domain: template.domain,
+                description: template.buildTaskPrompt(input),
+                context: {
+                    workspaceId: handle.id,
+                    taskType: template.taskType,
+                },
+            });
+            // Resolve compute requirements (dynamic > static > none)
+            const computeRequirements = template.getComputeRequirements
+                ? template.getComputeRequirements(input, complexity)
+                : template.computeRequirements;
+            const agentResult = await this.agentManager.spawn({
+                agentType: template.agentType ?? 'claude-code',
+                task,
+                cwd: handle.path,
+                injectedKnowledge: knowledge,
+                captureToolCalls: template.captureToolCalls ?? true,
+                timeout: this.getTimeout(template, complexity),
+                computeRequirements,
+            });
+            // Step 8: Validate output
+            const validation = await handle.validateOutput(template.outputConfig);
+            if (!validation.valid) {
+                const errorMessages = validation.errors.map(e => `${e.path}: ${e.message}`).join(', ');
+                throw new AgenticTaskOutputError(template.taskType, new Error(`Output validation failed: ${errorMessages}`));
+            }
+            // Step 9: Collect and validate output
+            const output = await this.collectWithRetry(template, handle);
+            // Step 10: Process output
+            const context = {
+                memory: this.memory,
+                learningPipeline: this.learningPipeline,
+            };
+            await template.processOutput(output, input, context);
+            // Step 11: Meta-learning — analysis agent's trajectory
+            await this.learningPipeline.processTrajectory(agentResult.trajectory);
+            return {
+                output,
+                method: 'agentic',
+                agentTrajectoryId: agentResult.trajectory.id,
+                metrics: {
+                    totalTimeMs: agentResult.metrics.totalTime,
+                    tokensUsed: agentResult.metrics.tokenEstimate ?? 0,
+                    toolCalls: agentResult.metrics.toolCallCount,
+                },
+            };
+        }
+        catch (error) {
+            failed = true;
+            throw error;
+        }
+        finally {
+            // Step 12: Cleanup
+            const shouldCleanup = this.config.cleanupWorkspaces &&
+                !(failed && this.config.keepFailedWorkspaces);
+            if (shouldCleanup) {
+                await this.workspaceManager.cleanup(handle);
+            }
+        }
+    }
+    /**
+     * Query knowledge for the analysis agent.
+     * Combines domain-scoped query + template-specific additional queries.
+     */
+    async getKnowledge(template, input) {
+        // Always query for playbooks in the template's domain
+        const domainKnowledge = await this.memory.queryV2(template.description, { domains: [template.domain] });
+        // Template-specific additional knowledge
+        if (template.getAdditionalKnowledge) {
+            const additional = await template.getAdditionalKnowledge(input, this.memory);
+            return mergeKnowledge(domainKnowledge, additional);
+        }
+        return domainKnowledge;
+    }
+    /**
+     * Collect output with retry on validation failure.
+     */
+    async collectWithRetry(template, handle, maxRetries = 1) {
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await template.collectOutput(handle);
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < maxRetries) {
+                    // Brief pause before retry
+                    await new Promise(resolve => setTimeout(resolve, 500));
+                }
+            }
+        }
+        throw new AgenticTaskOutputError(template.taskType, lastError);
+    }
+    /**
+     * Get timeout based on template default and complexity.
+     */
+    getTimeout(template, complexity) {
+        const base = template.timeout ?? 120_000;
+        switch (complexity) {
+            case 'lightweight': return Math.min(base, 60_000);
+            case 'standard': return base;
+            case 'thorough': return base * 2;
+            default: return base;
+        }
+    }
+}
+/**
+ * Merge two knowledge query results, deduplicating playbooks by ID.
+ */
+function mergeKnowledge(base, additional) {
+    if (!additional)
+        return base;
+    const seenPlaybookIds = new Set(base.playbooks.map(p => p.playbook.id));
+    const mergedPlaybooks = [...base.playbooks];
+    for (const match of additional.playbooks) {
+        if (!seenPlaybookIds.has(match.playbook.id)) {
+            mergedPlaybooks.push(match);
+            seenPlaybookIds.add(match.playbook.id);
+        }
+    }
+    const seenExpIds = new Set(base.experiences.map(e => e.experience.id));
+    const mergedExperiences = [...base.experiences];
+    for (const exp of additional.experiences) {
+        if (!seenExpIds.has(exp.experience.id)) {
+            mergedExperiences.push(exp);
+        }
+    }
+    return {
+        playbooks: mergedPlaybooks,
+        experiences: mergedExperiences,
+    };
+}
+/**
+ * Create an AgenticTaskRunner instance.
+ */
+export function createAgenticTaskRunner(workspaceManager, agentManager, memory, learningPipeline, config) {
+    return new AgenticTaskRunner(workspaceManager, agentManager, memory, learningPipeline, config);
+}
+//# sourceMappingURL=runner.js.map