cognitive-core 0.0.2 → 0.1.2

package/dist/utils/validation.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Input validation utilities
+ * Provides validation helpers for API boundaries
+ */
+import { z } from 'zod';
+/**
+ * Validation error with details
+ */
+export declare class ValidationError extends Error {
+    readonly field: string;
+    readonly value: unknown;
+    constructor(message: string, field: string, value: unknown);
+}
+/**
+ * Validate a string field
+ */
+export declare function validateString(value: unknown, field: string, options?: {
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+    allowEmpty?: boolean;
+}): string;
+/**
+ * Validate an optional string field
+ */
+export declare function validateOptionalString(value: unknown, field: string, options?: {
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+}): string | undefined;
+/**
+ * Validate a number field
+ */
+export declare function validateNumber(value: unknown, field: string, options?: {
+    min?: number;
+    max?: number;
+    integer?: boolean;
+}): number;
+/**
+ * Validate an optional number field
+ */
+export declare function validateOptionalNumber(value: unknown, field: string, options?: {
+    min?: number;
+    max?: number;
+    integer?: boolean;
+}): number | undefined;
+/**
+ * Validate an array field
+ */
+export declare function validateArray<T>(value: unknown, field: string, itemValidator: (item: unknown, index: number) => T, options?: {
+    minLength?: number;
+    maxLength?: number;
+}): T[];
+/**
+ * Validate a vector (array of numbers) for embeddings
+ */
+export declare function validateVector(value: unknown, field: string, expectedDimension?: number): number[];
+/**
+ * Validate task input parameters
+ */
+export declare const TaskInputSchema: z.ZodObject<{
+    description: z.ZodString;
+    domain: z.ZodDefault<z.ZodString>;
+    context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    constraints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+    description: string;
+    context: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    constraints: string[];
+}, {
+    description: string;
+    domain?: string | undefined;
+    context?: Record<string, unknown> | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    constraints?: string[] | undefined;
+}>;
+export type TaskInput = z.infer<typeof TaskInputSchema>;
+/**
+ * Validate task input
+ */
+export declare function validateTaskInput(input: unknown): TaskInput;
+/**
+ * Validate trajectory step count
+ */
+export declare function validateTrajectoryStepCount(stepCount: number, options?: {
+    minSteps?: number;
+    maxSteps?: number;
+}): void;
+/**
+ * MCP tool argument validation schemas
+ */
+export declare const MCPSearchPlaybooksSchema: z.ZodObject<{
+    query: z.ZodString;
+    domain: z.ZodOptional<z.ZodString>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    domain?: string | undefined;
+    maxResults?: number | undefined;
+}, {
+    query: string;
+    domain?: string | undefined;
+    maxResults?: number | undefined;
+}>;
+export declare const MCPGetPlaybookDetailsSchema: z.ZodObject<{
+    playbookId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    playbookId: string;
+}, {
+    playbookId: string;
+}>;
+export declare const MCPGetPlaybooksByDomainSchema: z.ZodObject<{
+    domain: z.ZodString;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+    maxResults?: number | undefined;
+}, {
+    domain: string;
+    maxResults?: number | undefined;
+}>;
+/**
+ * Validate MCP tool arguments
+ */
+export declare function validateMCPArgs<T>(schema: z.ZodSchema<T>, args: unknown, toolName: string): T;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO;CAKjC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GACA,MAAM,CAyBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,MAAM,GAAG,SAAS,CAKpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,MAAM,GAAG,SAAS,CAKpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,EAClD,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,CAAC,EAAE,CAgBL;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,EAAE,CAwBV;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAW3D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,IAAI,CAkBN;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;EAEtC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;EAGxC,CAAC;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,CAAC,CAWH"}

package/dist/utils/validation.js

@@ -0,0 +1,171 @@
+/**
+ * Input validation utilities
+ * Provides validation helpers for API boundaries
+ */
+import { z } from 'zod';
+/**
+ * Validation error with details
+ */
+export class ValidationError extends Error {
+    field;
+    value;
+    constructor(message, field, value) {
+        super(`Validation error for '${field}': ${message}`);
+        this.field = field;
+        this.value = value;
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Validate a string field
+ */
+export function validateString(value, field, options) {
+    if (typeof value !== 'string') {
+        throw new ValidationError(`Expected string, got ${typeof value}`, field, value);
+    }
+    const str = value;
+    const opts = options ?? {};
+    if (!opts.allowEmpty && str.trim().length === 0) {
+        throw new ValidationError('Cannot be empty', field, value);
+    }
+    if (opts.minLength !== undefined && str.length < opts.minLength) {
+        throw new ValidationError(`Must be at least ${opts.minLength} characters`, field, value);
+    }
+    if (opts.maxLength !== undefined && str.length > opts.maxLength) {
+        throw new ValidationError(`Must be at most ${opts.maxLength} characters`, field, value);
+    }
+    if (opts.pattern && !opts.pattern.test(str)) {
+        throw new ValidationError(`Does not match required pattern`, field, value);
+    }
+    return str;
+}
+/**
+ * Validate an optional string field
+ */
+export function validateOptionalString(value, field, options) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    return validateString(value, field, options);
+}
+/**
+ * Validate a number field
+ */
+export function validateNumber(value, field, options) {
+    if (typeof value !== 'number' || isNaN(value)) {
+        throw new ValidationError(`Expected number, got ${typeof value}`, field, value);
+    }
+    const opts = options ?? {};
+    if (opts.integer && !Number.isInteger(value)) {
+        throw new ValidationError('Must be an integer', field, value);
+    }
+    if (opts.min !== undefined && value < opts.min) {
+        throw new ValidationError(`Must be at least ${opts.min}`, field, value);
+    }
+    if (opts.max !== undefined && value > opts.max) {
+        throw new ValidationError(`Must be at most ${opts.max}`, field, value);
+    }
+    return value;
+}
+/**
+ * Validate an optional number field
+ */
+export function validateOptionalNumber(value, field, options) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    return validateNumber(value, field, options);
+}
+/**
+ * Validate an array field
+ */
+export function validateArray(value, field, itemValidator, options) {
+    if (!Array.isArray(value)) {
+        throw new ValidationError(`Expected array, got ${typeof value}`, field, value);
+    }
+    const opts = options ?? {};
+    if (opts.minLength !== undefined && value.length < opts.minLength) {
+        throw new ValidationError(`Must have at least ${opts.minLength} items`, field, value);
+    }
+    if (opts.maxLength !== undefined && value.length > opts.maxLength) {
+        throw new ValidationError(`Must have at most ${opts.maxLength} items`, field, value);
+    }
+    return value.map((item, index) => itemValidator(item, index));
+}
+/**
+ * Validate a vector (array of numbers) for embeddings
+ */
+export function validateVector(value, field, expectedDimension) {
+    if (!Array.isArray(value)) {
+        throw new ValidationError(`Expected array, got ${typeof value}`, field, value);
+    }
+    for (let i = 0; i < value.length; i++) {
+        if (typeof value[i] !== 'number' || isNaN(value[i])) {
+            throw new ValidationError(`Element at index ${i} is not a valid number`, field, value[i]);
+        }
+    }
+    if (expectedDimension !== undefined && value.length !== expectedDimension) {
+        throw new ValidationError(`Expected dimension ${expectedDimension}, got ${value.length}`, field, value);
+    }
+    return value;
+}
+/**
+ * Validate task input parameters
+ */
+export const TaskInputSchema = z.object({
+    description: z.string().min(1, 'Task description cannot be empty'),
+    domain: z.string().default('general'),
+    context: z.record(z.unknown()).default({}),
+    constraints: z.array(z.string()).default([]),
+    metadata: z.record(z.unknown()).default({}),
+});
+/**
+ * Validate task input
+ */
+export function validateTaskInput(input) {
+    const result = TaskInputSchema.safeParse(input);
+    if (!result.success) {
+        const firstError = result.error.errors[0];
+        throw new ValidationError(firstError.message, firstError.path.join('.'), input);
+    }
+    return result.data;
+}
+/**
+ * Validate trajectory step count
+ */
+export function validateTrajectoryStepCount(stepCount, options) {
+    const opts = options ?? { minSteps: 1, maxSteps: 10000 };
+    if (stepCount < (opts.minSteps ?? 1)) {
+        throw new ValidationError(`Must have at least ${opts.minSteps ?? 1} steps`, 'steps', stepCount);
+    }
+    if (opts.maxSteps !== undefined && stepCount > opts.maxSteps) {
+        throw new ValidationError(`Must have at most ${opts.maxSteps} steps`, 'steps', stepCount);
+    }
+}
+/**
+ * MCP tool argument validation schemas
+ */
+export const MCPSearchPlaybooksSchema = z.object({
+    query: z.string().min(1, 'Query cannot be empty'),
+    domain: z.string().optional(),
+    maxResults: z.number().int().min(1).max(50).optional(),
+});
+export const MCPGetPlaybookDetailsSchema = z.object({
+    playbookId: z.string().min(1, 'Playbook ID cannot be empty'),
+});
+export const MCPGetPlaybooksByDomainSchema = z.object({
+    domain: z.string().min(1, 'Domain cannot be empty'),
+    maxResults: z.number().int().min(1).max(100).optional(),
+});
+/**
+ * Validate MCP tool arguments
+ */
+export function validateMCPArgs(schema, args, toolName) {
+    const result = schema.safeParse(args);
+    if (!result.success) {
+        const firstError = result.error.errors[0];
+        throw new ValidationError(`Invalid arguments for ${toolName}: ${firstError.message}`, firstError.path.join('.') || 'arguments', args);
+    }
+    return result.data;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

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"}

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

package/dist/workspace/runner.js.map

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

package/dist/workspace/skill-converter.d.ts

@@ -0,0 +1,18 @@
+import type { Playbook } from '../types/playbook.js';
+import type { AgentSkillSpec } from './types.js';
+/**
+ * Convert Playbooks to Agent Skills (SKILL.md format).
+ * Playbooks are cognitive-core's internal format; SKILL.md is the
+ * portable open standard used in agentic workspaces.
+ */
+export declare function convertPlaybooksToSkills(playbooks: Playbook[]): AgentSkillSpec[];
+/**
+ * Generate a SKILL.md file from a Playbook.
+ */
+export declare function generateSkillMd(playbook: Playbook): string;
+/**
+ * Parse a SKILL.md file back into Playbook fields.
+ * Best-effort parsing — handles optional/missing sections gracefully.
+ */
+export declare function parseSkillMdToPlaybook(skillMd: string, skillName: string): Partial<Playbook>;
+//# sourceMappingURL=skill-converter.d.ts.map

package/dist/workspace/skill-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-converter.d.ts","sourceRoot":"","sources":["../../src/workspace/skill-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAMhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAgH1D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmD5F"}