cognitive-core 0.0.1 → 0.1.0

package/dist/agents/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Agent types and protocols for Atlas
+ */
+/**
+ * Message in a conversation
+ */
+export interface Message {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/**
+ * LLM completion options
+ */
+export interface CompletionOptions {
+    temperature?: number;
+    maxTokens?: number;
+    stopSequences?: string[];
+}
+/**
+ * LLM provider interface
+ * Implement this to use different LLM backends
+ */
+export interface LLMProvider {
+    /**
+     * Generate a completion
+     */
+    complete(messages: Message[], options?: CompletionOptions): Promise<string>;
+    /**
+     * Get the provider name
+     */
+    readonly name: string;
+}
+/**
+ * Agent configuration
+ */
+export interface AgentConfig {
+    /** Name of this agent */
+    name: string;
+    /** System prompt */
+    systemPrompt: string;
+    /** LLM provider to use */
+    provider: LLMProvider;
+    /** Default completion options */
+    defaultOptions?: CompletionOptions;
+}
+/**
+ * Base agent class
+ */
+export declare abstract class Agent {
+    protected config: AgentConfig;
+    protected conversationHistory: Message[];
+    constructor(config: AgentConfig);
+    /**
+     * Reset the agent state
+     */
+    reset(): void;
+    /**
+     * Send a message and get a response
+     */
+    chat(content: string, options?: CompletionOptions): Promise<string>;
+    /**
+     * Get conversation history
+     */
+    getHistory(): Message[];
+    /**
+     * Get agent name
+     */
+    get name(): string;
+}
+/**
+ * Tool definition for function calling
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/**
+ * Tool call result
+ */
+export interface ToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * Agent with tool use capabilities
+ */
+export interface ToolAgent extends Agent {
+    /**
+     * Available tools
+     */
+    readonly tools: ToolDefinition[];
+    /**
+     * Execute a tool
+     */
+    executeTool(call: ToolCall): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,WAAW,CAAC;IACtB,iCAAiC;IACjC,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED;;GAEG;AACH,8BAAsB,KAAK;IACzB,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,mBAAmB,EAAE,OAAO,EAAE,CAAM;gBAElC,MAAM,EAAE,WAAW;IAK/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAazE;;OAEG;IACH,UAAU,IAAI,OAAO,EAAE;IAIvB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK;IACtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IAEjC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C"}

package/dist/agents/types.js

@@ -0,0 +1,44 @@
+/**
+ * Agent types and protocols for Atlas
+ */
+/**
+ * Base agent class
+ */
+export class Agent {
+    config;
+    conversationHistory = [];
+    constructor(config) {
+        this.config = config;
+        this.reset();
+    }
+    /**
+     * Reset the agent state
+     */
+    reset() {
+        this.conversationHistory = [
+            { role: 'system', content: this.config.systemPrompt },
+        ];
+    }
+    /**
+     * Send a message and get a response
+     */
+    async chat(content, options) {
+        this.conversationHistory.push({ role: 'user', content });
+        const response = await this.config.provider.complete(this.conversationHistory, { ...this.config.defaultOptions, ...options });
+        this.conversationHistory.push({ role: 'assistant', content: response });
+        return response;
+    }
+    /**
+     * Get conversation history
+     */
+    getHistory() {
+        return [...this.conversationHistory];
+    }
+    /**
+     * Get agent name
+     */
+    get name() {
+        return this.config.name;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoDH;;GAEG;AACH,MAAM,OAAgB,KAAK;IACf,MAAM,CAAc;IACpB,mBAAmB,GAAc,EAAE,CAAC;IAE9C,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,mBAAmB,GAAG;YACzB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;SACtD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,OAA2B;QACrD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAClD,IAAI,CAAC,mBAAmB,EACxB,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,OAAO,EAAE,CAC9C,CAAC;QAEF,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAExE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF"}

package/dist/atlas.d.ts

@@ -0,0 +1,196 @@
+import type { Task, Trajectory, AtlasConfig, Playbook } from './types/index.js';
+import { MemorySystem } from './memory/index.js';
+import { LearningPipeline, type ProcessResult, type BatchResult } from './learning/index.js';
+import { type RoutingDecision } from './search/router.js';
+import { RefinementLoop } from './search/refinement-loop.js';
+import type { RefinementResult } from './search/refinement-types.js';
+import type { LLMProvider } from './agents/types.js';
+import { AgentManager } from './runtime/manager.js';
+import type { AgentBackend } from './runtime/types.js';
+import { SkillLibrary } from './surfacing/skill-library.js';
+import { PlaybookMCPServer } from './mcp/playbook-server.js';
+/**
+ * Atlas statistics
+ */
+export interface AtlasStats {
+    memory: {
+        experienceCount: number;
+        playbookCount: number;
+        metaObservationCount: number;
+    };
+    learning: {
+        trajectoriesProcessed: number;
+        pendingTrajectories: number;
+    };
+    execution?: {
+        agentManagerEnabled: boolean;
+        refinementEnabled: boolean;
+        backends: string[];
+    };
+    skillLibrary?: {
+        coreSkillCount: number;
+        domainSkillCounts: Record<string, number>;
+        mcpServerEnabled: boolean;
+    };
+}
+/**
+ * Playbook usage tracking
+ */
+export interface PlaybookUsage {
+    playbookId: string;
+    playbookName: string;
+    wasUsed: boolean;
+    usageConfidence: number;
+    wasSuccessful: boolean;
+}
+/**
+ * Extended solve result with refinement info
+ */
+export interface SolveResult {
+    /** The execution trajectory */
+    trajectory: Trajectory;
+    /** Whether memory was used */
+    usedMemory?: boolean;
+    /** Strategy used (from legacy solver) */
+    strategy?: string;
+    /** Routing decision (when using AgentManager) */
+    routing?: RoutingDecision;
+    /** Whether the result came from agent execution (vs direct solver) */
+    usedAgentManager: boolean;
+    /** Refinement result if refinement was performed */
+    refinement?: RefinementResult;
+    /** Playbooks that were injected for this task */
+    injectedPlaybooks?: Playbook[];
+    /** Playbook usage inference results */
+    playbookUsage?: PlaybookUsage[];
+}
+/**
+ * Atlas - Adaptive Trajectory Learning and Abstraction System
+ *
+ * Main orchestrator that combines:
+ * - Memory systems (experiences, playbooks, meta-observations)
+ * - Learning engine (trajectory analysis, playbook extraction)
+ * - Task routing (deciding how to solve tasks)
+ * - Skill surfacing (providing playbooks to agents)
+ */
+export declare class Atlas {
+    private memory;
+    private learning;
+    private router;
+    private solver;
+    private agentManager;
+    private refinementLoop;
+    private config;
+    private provider;
+    private trajectoriesProcessed;
+    private skillLibrary;
+    private usageInference;
+    private mcpServer;
+    constructor(config?: Partial<AtlasConfig>);
+    /**
+     * Initialize Atlas (load persisted data)
+     */
+    init(): Promise<void>;
+    /**
+     * Set the LLM provider for solving (deprecated)
+     * @deprecated Use setAgentManager() with backends for real execution
+     */
+    setProvider(provider: LLMProvider): void;
+    /**
+     * Set up the AgentManager with backends for real action execution
+     * This is the recommended way to configure Atlas for execution
+     */
+    setAgentManager(backends: AgentBackend[]): void;
+    /**
+     * Get the AgentManager for direct access
+     */
+    getAgentManager(): AgentManager | null;
+    /**
+     * Get the RefinementLoop for registering domain verifiers
+     */
+    getRefinementLoop(): RefinementLoop | null;
+    /**
+     * Check if agent execution is available
+     */
+    hasAgentExecution(): boolean;
+    /**
+     * Solve a task using the best available method
+     * Prefers AgentManager with refinement when available
+     */
+    solve(task: Task): Promise<SolveResult>;
+    /**
+     * Solve using AgentManager with optional refinement
+     */
+    private solveWithAgent;
+    /**
+     * Solve multiple tasks
+     */
+    solveBatch(tasks: Task[]): Promise<SolveResult[]>;
+    /**
+     * Process an external trajectory (from another agent)
+     */
+    processTrajectory(trajectory: Trajectory): Promise<ProcessResult>;
+    /**
+     * Run batch learning explicitly
+     */
+    runBatchLearning(): Promise<BatchResult>;
+    /**
+     * Query memory for relevant context
+     */
+    queryMemory(query: string, options?: {
+        domains?: string[];
+        includeExperiences?: boolean;
+        includePlaybooks?: boolean;
+    }): Promise<import("./index.js").MemoryQueryResultV2>;
+    /**
+     * Get Atlas statistics
+     */
+    getStats(): Promise<AtlasStats>;
+    /**
+     * Get the memory system for direct access
+     */
+    getMemory(): MemorySystem;
+    /**
+     * Get the learning pipeline for direct access
+     */
+    getLearning(): LearningPipeline;
+    /**
+     * Get the skill library for direct access
+     */
+    getSkillLibrary(): SkillLibrary | null;
+    /**
+     * Get the MCP server for direct access
+     */
+    getMCPServer(): PlaybookMCPServer | null;
+    /**
+     * Start the MCP server for playbook access
+     */
+    startMCPServer(): Promise<void>;
+    /**
+     * Stop the MCP server
+     */
+    stopMCPServer(): Promise<void>;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<AtlasConfig>): void;
+    /**
+     * Close Atlas (flush data to disk)
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create an Atlas instance
+ */
+export declare function createAtlas(config?: Partial<AtlasConfig>): Atlas;
+/**
+ * Create an Atlas instance with an LLM provider
+ * @deprecated Use createAtlasWithAgents() for real action execution
+ */
+export declare function createAtlasWithProvider(provider: LLMProvider, config?: Partial<AtlasConfig>): Atlas;
+/**
+ * Create an Atlas instance with AgentManager backends
+ * This is the recommended way to create Atlas for production use
+ */
+export declare function createAtlasWithAgents(backends: AgentBackend[], config?: Partial<AtlasConfig>): Atlas;
+//# sourceMappingURL=atlas.d.ts.map

package/dist/atlas.d.ts.map

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