cognitive-core 0.0.1 → 0.1.0

package/dist/memory/system.js

@@ -0,0 +1,383 @@
+import { createExperience } from '../types/index.js';
+import { ExperienceMemory } from './experience.js';
+import { PlaybookLibrary } from './playbook.js';
+import { MetaMemory } from './meta.js';
+import { LearningEffectivenessTracker, } from '../learning/effectiveness.js';
+/**
+ * Default capacity configuration
+ */
+const DEFAULT_CAPACITY = {
+    maxExperiences: 0,
+    maxPlaybooks: 0,
+    maxExperienceAgeDays: 0,
+    maxFailedExperienceAgeDays: 30,
+    autoPrune: true,
+    preserveDomainCoverage: true,
+    deduplicationThreshold: 0,
+};
+/**
+ * Unified Memory System
+ * Aggregates all memory components with parallel querying
+ */
+export class MemorySystem {
+    experiences;
+    playbooks;
+    meta;
+    effectiveness;
+    config;
+    capacityConfig;
+    initialized = false;
+    lastCapacityCheck = 0;
+    capacityCheckInterval = 60000; // Check every minute
+    constructor(baseDir, config) {
+        this.config = {
+            maxExperiences: config?.maxExperiences ?? 4,
+            maxStrategies: config?.maxStrategies ?? 3,
+            maxConcepts: config?.maxConcepts ?? 5,
+            maxSkills: config?.maxSkills ?? 3,
+            maxContextTokens: config?.maxContextTokens ?? 4000,
+            capacity: config?.capacity ?? DEFAULT_CAPACITY,
+        };
+        this.capacityConfig = { ...DEFAULT_CAPACITY, ...config?.capacity };
+        this.experiences = new ExperienceMemory(baseDir);
+        this.playbooks = new PlaybookLibrary(baseDir);
+        this.meta = new MetaMemory(baseDir);
+        this.effectiveness = new LearningEffectivenessTracker(baseDir);
+    }
+    /**
+     * Initialize all memory components
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        await Promise.all([
+            this.experiences.init(),
+            this.playbooks.init(),
+            this.meta.init(),
+            this.effectiveness.init(),
+        ]);
+        this.initialized = true;
+    }
+    /**
+     * Query memory (legacy format)
+     * @deprecated Use queryV2 for new code - this method returns empty arrays for deprecated fields
+     */
+    async query(input, options) {
+        await this.init();
+        const experiences = await this.experiences.findSimilar(input, {
+            k: this.config.maxExperiences,
+            domain: options?.domain,
+        });
+        // Return empty arrays for deprecated fields
+        return {
+            experiences,
+            concepts: [],
+            strategies: [],
+            skills: [],
+        };
+    }
+    /**
+     * Store a trajectory and extract experience from it
+     * Preserves trajectory structure in metadata for richer learning
+     */
+    async storeTrajectory(trajectory) {
+        await this.init();
+        // Create experience from trajectory
+        // Handle undefined solution (e.g., from failed trajectories)
+        const solutionOutput = trajectory.outcome.solution !== undefined
+            ? JSON.stringify(trajectory.outcome.solution)
+            : trajectory.outcome.errorInfo ?? 'No solution (task failed)';
+        // Preserve trajectory structure in metadata for learning from intermediate steps
+        const trajectoryMetadata = {
+            // Preserve steps with key information (limited to prevent bloat)
+            steps: trajectory.steps.map((step, index) => ({
+                index,
+                thought: step.thought?.slice(0, 500),
+                action: step.action?.slice(0, 200),
+                observation: step.observation?.slice(0, 300),
+                attributionScore: step.attributionScore,
+            })),
+            // Preserve outcome details
+            outcome: {
+                partialScore: trajectory.outcome.partialScore,
+                errorInfo: trajectory.outcome.errorInfo,
+            },
+            // Preserve agent and timing info
+            agentId: trajectory.agentId,
+            wallTimeSeconds: trajectory.wallTimeSeconds,
+            llmCalls: trajectory.llmCalls,
+            stepCount: trajectory.steps.length,
+            // Preserve task context
+            taskContext: trajectory.task.context,
+            // Original trajectory metadata
+            ...trajectory.metadata,
+        };
+        const experience = createExperience({
+            taskInput: trajectory.task.description,
+            solutionOutput,
+            feedback: trajectory.outcome.success
+                ? 'Success'
+                : trajectory.outcome.errorInfo ?? 'Failed',
+            success: trajectory.outcome.success,
+            domain: trajectory.task.domain,
+            trajectoryId: trajectory.id,
+            metadata: trajectoryMetadata,
+        });
+        await this.experiences.add(experience);
+        // Check capacity limits
+        await this.maybeEnforceCapacity();
+        return experience;
+    }
+    /**
+     * Record usage of an experience
+     */
+    async recordExperienceUsage(id) {
+        await this.init();
+        await this.experiences.recordUsage(id);
+    }
+    /**
+     * Query memory with new playbook-based format
+     */
+    async queryV2(input, options) {
+        await this.init();
+        const includeAll = !options ||
+            (options.includeExperiences === undefined &&
+                options.includePlaybooks === undefined);
+        const [experiences, playbooks] = await Promise.all([
+            includeAll || options?.includeExperiences
+                ? this.experiences.findSimilar(input, {
+                    k: this.config.maxExperiences,
+                    domain: options?.domains?.[0],
+                })
+                : Promise.resolve([]),
+            includeAll || options?.includePlaybooks
+                ? this.playbooks.findMatching(input, {
+                    k: this.config.maxStrategies + this.config.maxSkills, // Combined count
+                    domains: options?.domains,
+                    minConfidence: options?.minPlaybookConfidence,
+                    excludeAntiPatterns: true,
+                })
+                : Promise.resolve([]),
+        ]);
+        return { experiences, playbooks };
+    }
+    /**
+     * Format memory for context injection (new playbook format)
+     */
+    formatForPromptV2(result, options) {
+        const sections = [];
+        const includeRefinements = options?.includeRefinements ?? true;
+        // Format experiences
+        if (result.experiences.length > 0) {
+            sections.push('## Similar Experiences\n');
+            for (const { experience, score } of result.experiences) {
+                sections.push(`### Task (${Math.round(score * 100)}% match)`);
+                sections.push(`${experience.taskInput.slice(0, 200)}`);
+                sections.push(`**Approach**: ${experience.solutionOutput.slice(0, 300)}`);
+                sections.push(`**Outcome**: ${experience.success ? 'Succeeded' : 'Failed'}`);
+                sections.push('');
+            }
+        }
+        // Format playbooks
+        if (result.playbooks.length > 0) {
+            sections.push('## Applicable Playbooks\n');
+            for (const { playbook, score: _score, matchType } of result.playbooks) {
+                sections.push(`### ${playbook.name} (${Math.round(playbook.confidence * 100)}% confidence, matched on ${matchType})`);
+                sections.push(`**Strategy**: ${playbook.guidance.strategy}`);
+                if (playbook.guidance.tactics.length > 0) {
+                    sections.push('**Tactics**:');
+                    for (const tactic of playbook.guidance.tactics) {
+                        sections.push(`  - ${tactic}`);
+                    }
+                }
+                if (playbook.guidance.steps && playbook.guidance.steps.length > 0) {
+                    sections.push('**Steps**:');
+                    for (let i = 0; i < playbook.guidance.steps.length; i++) {
+                        sections.push(`  ${i + 1}. ${playbook.guidance.steps[i]}`);
+                    }
+                }
+                if (playbook.verification.successIndicators.length > 0) {
+                    sections.push(`**Success indicators**: ${playbook.verification.successIndicators.join(', ')}`);
+                }
+                // Include refinements if requested
+                if (includeRefinements && playbook.evolution.refinements.length > 0) {
+                    sections.push('**Context-specific notes**:');
+                    for (const refinement of playbook.evolution.refinements.slice(0, 3)) {
+                        sections.push(`  - In ${refinement.context}: ${refinement.addition}`);
+                    }
+                }
+                sections.push('');
+            }
+        }
+        return sections.join('\n');
+    }
+    // === META-LEARNING METHODS ===
+    /**
+     * Record a meta-observation after task completion
+     */
+    async recordMetaObservation(observation) {
+        await this.init();
+        await this.meta.recordObservation(observation);
+    }
+    /**
+     * Get meta-learning adjustments for routing
+     */
+    async getMetaAdjustments(context) {
+        await this.init();
+        return this.meta.getRoutingAdjustments(context);
+    }
+    /**
+     * Add a playbook to the library
+     */
+    async addPlaybook(playbook) {
+        await this.init();
+        await this.playbooks.add(playbook);
+    }
+    /**
+     * Record playbook usage
+     */
+    async recordPlaybookUsage(id, trajectoryId, success, failureContext, failureMode) {
+        await this.init();
+        if (success) {
+            await this.playbooks.recordSuccess(id, trajectoryId);
+        }
+        else {
+            await this.playbooks.recordFailure(id, trajectoryId, failureContext ?? 'Unknown context', failureMode ?? 'Unknown failure mode');
+        }
+    }
+    /**
+     * Get statistics about memory contents
+     */
+    async getStats() {
+        await this.init();
+        const [experienceCount, playbookCount, metaStats, annotationCount] = await Promise.all([
+            this.experiences.count(),
+            this.playbooks.count(),
+            this.meta.getStats(),
+            this.effectiveness.count(),
+        ]);
+        return {
+            experienceCount,
+            playbookCount,
+            metaObservationCount: metaStats.totalObservations,
+            annotationCount,
+        };
+    }
+    /**
+     * Get learning effectiveness metrics
+     */
+    async getEffectivenessMetrics(options) {
+        await this.init();
+        return this.effectiveness.computeMetrics(options);
+    }
+    // === CAPACITY MANAGEMENT ===
+    /**
+     * Check and enforce capacity limits (called automatically if autoPrune is enabled)
+     */
+    async enforceCapacityLimits() {
+        await this.init();
+        const result = {
+            experiencesPruned: null,
+            playbooksPruned: 0,
+        };
+        const capacity = this.capacityConfig;
+        // Check if we need to prune experiences
+        const experienceCount = await this.experiences.count();
+        const needsExperiencePrune = (capacity.maxExperiences > 0 && experienceCount > capacity.maxExperiences) ||
+            capacity.maxExperienceAgeDays > 0 ||
+            capacity.maxFailedExperienceAgeDays > 0 ||
+            capacity.deduplicationThreshold > 0;
+        if (needsExperiencePrune) {
+            result.experiencesPruned = await this.experiences.prune({
+                maxCount: capacity.maxExperiences > 0 ? capacity.maxExperiences : undefined,
+                maxAgeDays: capacity.maxExperienceAgeDays > 0 ? capacity.maxExperienceAgeDays : undefined,
+                removeFailedOlderThanDays: capacity.maxFailedExperienceAgeDays > 0
+                    ? capacity.maxFailedExperienceAgeDays
+                    : undefined,
+                similarityThreshold: capacity.deduplicationThreshold > 0
+                    ? capacity.deduplicationThreshold
+                    : undefined,
+                preserveDomainCoverage: capacity.preserveDomainCoverage,
+            });
+        }
+        // Check if we need to prune playbooks
+        if (capacity.maxPlaybooks > 0) {
+            const playbookCount = await this.playbooks.count();
+            if (playbookCount > capacity.maxPlaybooks) {
+                // Prune lowest confidence playbooks
+                const allPlaybooks = await this.playbooks.getAll();
+                const sorted = allPlaybooks.sort((a, b) => b.confidence - a.confidence);
+                const toRemove = sorted.slice(capacity.maxPlaybooks);
+                for (const playbook of toRemove) {
+                    await this.playbooks.delete(playbook.id);
+                    result.playbooksPruned++;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Check capacity and prune if necessary (throttled)
+     * Called automatically after adding experiences
+     */
+    async maybeEnforceCapacity() {
+        if (!this.capacityConfig.autoPrune)
+            return;
+        const now = Date.now();
+        if (now - this.lastCapacityCheck < this.capacityCheckInterval)
+            return;
+        this.lastCapacityCheck = now;
+        await this.enforceCapacityLimits();
+    }
+    /**
+     * Get capacity status
+     */
+    async getCapacityStatus() {
+        await this.init();
+        const experienceCount = await this.experiences.count();
+        const playbookCount = await this.playbooks.count();
+        const capacity = this.capacityConfig;
+        return {
+            experiences: {
+                current: experienceCount,
+                limit: capacity.maxExperiences,
+                utilizationPercent: capacity.maxExperiences > 0
+                    ? Math.round((experienceCount / capacity.maxExperiences) * 100)
+                    : 0,
+            },
+            playbooks: {
+                current: playbookCount,
+                limit: capacity.maxPlaybooks,
+                utilizationPercent: capacity.maxPlaybooks > 0
+                    ? Math.round((playbookCount / capacity.maxPlaybooks) * 100)
+                    : 0,
+            },
+            pruningEnabled: capacity.autoPrune,
+            lastCheck: this.lastCapacityCheck > 0 ? new Date(this.lastCapacityCheck) : null,
+        };
+    }
+    /**
+     * Update capacity configuration
+     */
+    updateCapacityConfig(config) {
+        this.capacityConfig = { ...this.capacityConfig, ...config };
+    }
+    /**
+     * Close all stores
+     */
+    async close() {
+        await Promise.all([
+            this.experiences.close(),
+            this.playbooks.close(),
+            this.meta.close(),
+            this.effectiveness.close(),
+        ]);
+    }
+}
+/**
+ * Create a memory system instance
+ */
+export function createMemorySystem(baseDir, config) {
+    return new MemorySystem(baseDir, config);
+}
+//# sourceMappingURL=system.js.map

package/dist/memory/system.js.map

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

package/dist/runtime/backends/acp.d.ts

@@ -0,0 +1,67 @@
+/**
+ * ACP Backend using acp-factory
+ *
+ * This backend uses the acp-factory package to spawn and manage ACP-compatible
+ * agents like Claude Code, providing a clean interface for Atlas integration.
+ */
+import { AgentHandle, Session, type AgentConfig } from 'acp-factory';
+import type { AgentBackend, AgentSpawnConfig, AgentSession } from '../types.js';
+/**
+ * ACP agent configuration
+ */
+export interface ACPAgentConfig extends AgentConfig {
+    /** Display name for the agent */
+    displayName?: string;
+}
+/**
+ * ACP Backend
+ * Uses acp-factory to spawn and manage ACP-compatible agents
+ */
+export declare class ACPBackend implements AgentBackend {
+    readonly name = "acp";
+    readonly supportedTypes: string[];
+    private sessions;
+    private handles;
+    constructor(configs: Record<string, ACPAgentConfig>);
+    isAvailable(): Promise<boolean>;
+    spawn(config: AgentSpawnConfig): Promise<AgentSession>;
+    /**
+     * Run a prompt and collect all updates
+     */
+    private runPrompt;
+    /**
+     * Process a session update from the agent
+     * Uses defensive typing since ACP types can vary
+     */
+    private processUpdate;
+    getSession(sessionId: string): Promise<AgentSession | undefined>;
+    sendMessage(sessionId: string, message: string): Promise<void>;
+    terminate(sessionId: string): Promise<void>;
+    listSessions(): Promise<AgentSession[]>;
+    /**
+     * Get a raw ACP session for advanced usage
+     */
+    getACPSession(sessionId: string): Session | undefined;
+    /**
+     * Get a raw agent handle for advanced usage
+     */
+    getAgentHandle(sessionId: string): AgentHandle | undefined;
+}
+/**
+ * Create an ACP backend with agent configurations
+ */
+export declare function createACPBackend(configs: Record<string, ACPAgentConfig>): ACPBackend;
+/**
+ * Pre-configured Claude Code agent via claude-code-acp
+ */
+export declare const claudeCodeACPConfig: ACPAgentConfig;
+/**
+ * Pre-configured Claude direct (requires --print mode)
+ * Note: This may not support full ACP protocol
+ */
+export declare const claudeCodeDirectConfig: ACPAgentConfig;
+/**
+ * Helper to register common agents
+ */
+export declare function registerCommonAgents(): void;
+//# sourceMappingURL=acp.d.ts.map

package/dist/runtime/backends/acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/acp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAEL,WAAW,EACX,OAAO,EACP,KAAK,WAAW,EAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EAGb,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD;;;GAGG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC7C,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAElC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,OAAO,CAAuC;gBAE1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAa7C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAmE5D;;OAEG;YACW,SAAS;IA2BvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAuGf,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIhE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9D,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC3C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7C;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIrD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC,UAAU,CAEZ;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAIjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAIpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}