cognitive-core 0.1.0 → 0.2.0

package/dist/workspace/templates/trajectory-analysis.js.map

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

package/dist/workspace/templates/usage-inference.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Usage Inference Template
+ *
+ * Replaces the heuristic PlaybookUsageInference with workspace-based
+ * semantic matching that determines which injected playbooks were
+ * actually followed by the agent.
+ *
+ * - No playbooks or very few steps → heuristic fallback
+ * - Otherwise → agent reads trajectory and judges playbook adherence
+ */
+import type { Trajectory, Playbook } from '../../types/index.js';
+import type { PlaybookUsageResult } from '../../learning/usage-inference.js';
+import type { AgenticTaskTemplate } from '../types.js';
+export interface UsageInferenceInput {
+    trajectory: Trajectory;
+    injectedPlaybooks: Playbook[];
+}
+export declare const usageInferenceTemplate: AgenticTaskTemplate<UsageInferenceInput, PlaybookUsageResult[]>;
+//# sourceMappingURL=usage-inference.d.ts.map

package/dist/workspace/templates/usage-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-inference.d.ts","sourceRoot":"","sources":["../../../src/workspace/templates/usage-inference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,iBAAiB,EAAE,QAAQ,EAAE,CAAC;CAC/B;AAQD,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CACtD,mBAAmB,EACnB,mBAAmB,EAAE,CA6HtB,CAAC"}

package/dist/workspace/templates/usage-inference.js

@@ -0,0 +1,125 @@
+/**
+ * Usage Inference Template
+ *
+ * Replaces the heuristic PlaybookUsageInference with workspace-based
+ * semantic matching that determines which injected playbooks were
+ * actually followed by the agent.
+ *
+ * - No playbooks or very few steps → heuristic fallback
+ * - Otherwise → agent reads trajectory and judges playbook adherence
+ */
+import { createUsageInference } from '../../learning/usage-inference.js';
+// Output: PlaybookUsageResult[] (reused from learning/usage-inference.ts)
+// ============================================================
+// Template Implementation
+// ============================================================
+export const usageInferenceTemplate = {
+    taskType: 'usage-inference',
+    domain: 'usage-inference',
+    description: 'Determine which injected playbooks were actually followed',
+    assessComplexity(input) {
+        if (input.injectedPlaybooks.length === 0)
+            return 'heuristic';
+        if (input.injectedPlaybooks.length <= 2 && input.trajectory.steps.length <= 10) {
+            return 'heuristic';
+        }
+        return 'lightweight';
+    },
+    async heuristicFallback(input) {
+        const inference = createUsageInference();
+        return inference.inferUsage(input.trajectory, input.injectedPlaybooks);
+    },
+    async prepareWorkspace(input, handle) {
+        const { trajectory, injectedPlaybooks } = input;
+        // Write trajectory summary + steps
+        await handle.writeJson('input', 'trajectory.json', {
+            taskDescription: trajectory.task.description,
+            domain: trajectory.task.domain,
+            success: trajectory.outcome.success,
+            stepCount: trajectory.steps.length,
+            steps: trajectory.steps.map((step, i) => ({
+                index: i,
+                thought: step.thought,
+                action: step.action,
+                observation: step.observation?.slice(0, 300),
+            })),
+        });
+        // Write injected playbooks
+        await handle.writeJson('input', 'playbooks.json', injectedPlaybooks.map(pb => ({
+            id: pb.id,
+            name: pb.name,
+            strategy: pb.guidance.strategy,
+            tactics: pb.guidance.tactics,
+            steps: pb.guidance.steps,
+            successIndicators: pb.verification.successIndicators,
+        })));
+    },
+    buildTaskPrompt(input) {
+        return [
+            `Analyze whether the agent followed ${input.injectedPlaybooks.length} injected playbooks.`,
+            '',
+            'Read input/trajectory.json for the agent execution trace.',
+            'Read input/playbooks.json for the playbooks that were injected.',
+            '',
+            'For each playbook, determine:',
+            '1. Was the playbook guidance followed? Look for tactical alignment, not literal matches.',
+            '2. How confident are you? (0.0-1.0)',
+            '3. Was the outcome successful when following this guidance?',
+            '4. Which trajectory steps aligned with the playbook?',
+            '',
+            'Write results to output/usage.json:',
+            '```json',
+            '[',
+            '  {',
+            '    "playbookId": "id",',
+            '    "playbookName": "name",',
+            '    "wasUsed": boolean,',
+            '    "usageConfidence": 0.0-1.0,',
+            '    "wasSuccessful": boolean,',
+            '    "matchedSteps": [step indices],',
+            '    "context": "brief explanation of usage or non-usage"',
+            '  }',
+            ']',
+            '```',
+        ].join('\n');
+    },
+    getSkills() { return []; },
+    getResources() { return []; },
+    outputConfig: {
+        files: [
+            {
+                path: 'usage.json',
+                format: 'json',
+                required: true,
+                description: 'Playbook usage inference results',
+            },
+        ],
+    },
+    async collectOutput(handle) {
+        const raw = await handle.readJson('output', 'usage.json');
+        if (!Array.isArray(raw))
+            return [];
+        return raw.map(item => ({
+            playbookId: String(item.playbookId ?? ''),
+            playbookName: String(item.playbookName ?? ''),
+            wasUsed: Boolean(item.wasUsed),
+            usageConfidence: typeof item.usageConfidence === 'number' ? item.usageConfidence : 0,
+            wasSuccessful: Boolean(item.wasSuccessful),
+            matchedSteps: Array.isArray(item.matchedSteps)
+                ? item.matchedSteps.map(Number)
+                : [],
+            context: item.context ? String(item.context) : undefined,
+        }));
+    },
+    async processOutput() {
+        // Atlas handles storage and skill library recording
+    },
+    computeRequirements: {
+        mode: 'local',
+        complexity: 'lightweight',
+    },
+    agentType: 'claude-code',
+    timeout: 120_000,
+    captureToolCalls: true,
+};
+//# sourceMappingURL=usage-inference.js.map

package/dist/workspace/templates/usage-inference.js.map

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

package/dist/workspace/types.d.ts

@@ -0,0 +1,152 @@
+import type { WorkspaceHandle, OutputSpec } from 'agent-workspace';
+import type { MemorySystem, MemoryQueryResultV2 } from '../memory/system.js';
+import type { Trajectory } from '../types/index.js';
+import type { ComputeRequirements } from '../runtime/compute-provider.js';
+export type { WorkspaceHandle, OutputSpec, OutputFileSpec, ValidationResult } from 'agent-workspace';
+/**
+ * Skill to load into workspace skills/ directory.
+ * Agent Skills open standard format (SKILL.md).
+ */
+export interface AgentSkillSpec {
+    /** Skill directory name */
+    name: string;
+    /** SKILL.md content */
+    content: string;
+    /** Source of this skill */
+    source: 'playbook-conversion' | 'curated' | 'extracted';
+}
+/**
+ * Supplementary resource to load into workspace resources/ directory.
+ */
+export interface ResourceSpec {
+    /** Path relative to resources/ directory */
+    path: string;
+    /** How to populate this resource */
+    type: 'directory' | 'file' | 'symlink';
+    /** Source path (for symlink/copy) or content (for file) */
+    source: string;
+    /** Description for the agent */
+    description?: string;
+}
+/**
+ * Complexity level determines whether to use heuristic or agentic analysis.
+ */
+export type AnalysisComplexity = 'heuristic' | 'lightweight' | 'standard' | 'thorough';
+/**
+ * Context passed to processOutput for storing/accumulating results.
+ */
+/**
+ * Minimal pipeline interface for workspace processing context.
+ * Satisfied by both LearningPipeline and UnifiedLearningPipeline.
+ */
+export interface TrajectoryProcessor {
+    processTrajectory(trajectory: Trajectory, ...args: unknown[]): Promise<unknown>;
+}
+export interface ProcessingContext {
+    memory: MemorySystem;
+    learningPipeline: TrajectoryProcessor;
+}
+/**
+ * Declarative recipe for an agentic analysis task.
+ *
+ * TInput: the typed input data for this analysis
+ * TOutput: the typed output the agent produces
+ */
+export interface AgenticTaskTemplate<TInput, TOutput> {
+    /** Unique identifier for this task type */
+    taskType: string;
+    /** Domain for knowledge injection and meta-learning */
+    domain: string;
+    /** Human-readable description */
+    description: string;
+    /**
+     * Prepare the workspace filesystem from typed input.
+     * Uses the WorkspaceHandle to write input files via typed I/O methods.
+     */
+    prepareWorkspace(input: TInput, handle: WorkspaceHandle): Promise<void>;
+    /**
+     * Build the task description for the agent.
+     * Natural language prompt explaining what to do and what output to produce.
+     */
+    buildTaskPrompt(input: TInput): string;
+    /**
+     * Skills to load into the workspace skills/ directory.
+     * Playbooks from memory are converted to skills via the converter.
+     */
+    getSkills(input: TInput): AgentSkillSpec[];
+    /**
+     * Supplementary resources for the workspace resources/ directory.
+     */
+    getResources(input: TInput): ResourceSpec[];
+    /**
+     * Additional memory queries beyond the automatic domain-scoped query.
+     */
+    getAdditionalKnowledge?(input: TInput, memory: MemorySystem): Promise<MemoryQueryResultV2>;
+    /** Configuration defining the expected output shape */
+    outputConfig: OutputSpec;
+    /**
+     * Read and validate agent output from workspace.
+     * Uses the WorkspaceHandle to read output via typed I/O methods.
+     * Returns typed output or throws if validation fails.
+     */
+    collectOutput(handle: WorkspaceHandle): Promise<TOutput>;
+    /**
+     * Process the validated output — store results, accumulate for batch learning, etc.
+     */
+    processOutput(output: TOutput, input: TInput, context: ProcessingContext): Promise<void>;
+    /**
+     * Assess whether this input needs agentic analysis or heuristic fallback.
+     */
+    assessComplexity(input: TInput): AnalysisComplexity;
+    /**
+     * Heuristic fallback for simple cases.
+     * Called when assessComplexity returns 'heuristic'.
+     */
+    heuristicFallback?(input: TInput): Promise<TOutput>;
+    /** Agent type to spawn (default: 'claude-code') */
+    agentType?: string;
+    /** Timeout for the analysis agent (default: 120_000ms) */
+    timeout?: number;
+    /** Whether to capture detailed tool calls (default: true) */
+    captureToolCalls?: boolean;
+    /**
+     * Static compute requirements for this template.
+     * Used by ComputeProvider to select appropriate backend.
+     */
+    computeRequirements?: ComputeRequirements;
+    /**
+     * Dynamic compute requirements based on input and assessed complexity.
+     * Overrides static computeRequirements when provided.
+     */
+    getComputeRequirements?(input: TInput, complexity: AnalysisComplexity): ComputeRequirements;
+}
+/**
+ * Result from running an agentic task.
+ */
+export interface AgenticTaskResult<TOutput> {
+    /** The validated output */
+    output: TOutput;
+    /** Whether heuristic or agentic path was used */
+    method: 'heuristic' | 'agentic';
+    /** Trajectory ID of the analysis agent (if agentic) */
+    agentTrajectoryId?: string;
+    /** Execution metrics */
+    metrics: AgenticTaskMetrics;
+}
+/**
+ * Metrics from an agentic task execution.
+ */
+export interface AgenticTaskMetrics {
+    totalTimeMs: number;
+    tokensUsed: number;
+    toolCalls: number;
+}
+/**
+ * Error thrown when agent output validation fails.
+ */
+export declare class AgenticTaskOutputError extends Error {
+    readonly taskType: string;
+    readonly cause: Error;
+    constructor(taskType: string, cause: Error);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/workspace/types.js

@@ -0,0 +1,17 @@
+// ============================================================
+// Errors
+// ============================================================
+/**
+ * Error thrown when agent output validation fails.
+ */
+export class AgenticTaskOutputError extends Error {
+    taskType;
+    cause;
+    constructor(taskType, cause) {
+        super(`Agentic task '${taskType}' output validation failed: ${cause.message}`);
+        this.taskType = taskType;
+        this.cause = cause;
+        this.name = 'AgenticTaskOutputError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/workspace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAiOA,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAE/D;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAE7B;IACA;IAFlB,YACkB,QAAgB,EAChB,KAAY;QAE5B,KAAK,CAAC,iBAAiB,QAAQ,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAH/D,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAO;QAG5B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}