cognitive-core 0.0.2 → 0.1.0

package/dist/index.js

@@ -1,509 +1,84 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  CognitiveCore: () => CognitiveCore,
-  CognitiveCoreClient: () => CognitiveCoreClient,
-  default: () => index_default,
-  getPythonPath: () => getPythonPath,
-  isSetUp: () => isSetUp,
-  setup: () => setup
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/client.ts
-var import_child_process = require("child_process");
-var import_events = require("events");
-var CognitiveCoreClient = class extends import_events.EventEmitter {
-  process = null;
-  buffer = "";
-  pendingRequests = /* @__PURE__ */ new Map();
-  requestId = 0;
-  options;
-  constructor(options = {}) {
-    super();
-    this.options = {
-      pythonPath: options.pythonPath ?? "python",
-      cwd: options.cwd ?? process.cwd(),
-      env: options.env ?? {},
-      timeout: options.timeout ?? 3e4
-    };
-  }
-  /**
-   * Start the Python subprocess.
-   */
-  async start() {
-    if (this.process) {
-      throw new Error("Client already started");
-    }
-    return new Promise((resolve2, reject) => {
-      this.process = (0, import_child_process.spawn)(
-        this.options.pythonPath,
-        ["-m", "cognitive_core.cli", "--json"],
-        {
-          cwd: this.options.cwd,
-          env: { ...process.env, ...this.options.env },
-          stdio: ["pipe", "pipe", "pipe"]
-        }
-      );
-      this.process.on("error", (error) => {
-        this.emit("error", error);
-        reject(error);
-      });
-      this.process.on("exit", (code, signal) => {
-        this.emit("exit", { code, signal });
-        this.cleanup();
-      });
-      this.process.stdout?.on("data", (data) => {
-        this.handleData(data.toString());
-      });
-      this.process.stderr?.on("data", (data) => {
-        this.emit("stderr", data.toString());
-      });
-      setTimeout(async () => {
-        try {
-          const response = await this.execute("version");
-          if (response.version) {
-            this.emit("ready", response);
-            resolve2();
-          } else {
-            reject(new Error("Failed to verify Python process"));
-          }
-        } catch (error) {
-          reject(error);
-        }
-      }, 100);
-    });
-  }
-  /**
-   * Stop the Python subprocess.
-   */
-  async stop() {
-    if (!this.process) {
-      return;
-    }
-    return new Promise((resolve2) => {
-      if (this.process) {
-        this.process.once("exit", () => {
-          this.cleanup();
-          resolve2();
-        });
-        this.process.stdin?.end();
-        this.process.kill("SIGTERM");
-        setTimeout(() => {
-          if (this.process) {
-            this.process.kill("SIGKILL");
-          }
-          resolve2();
-        }, 5e3);
-      } else {
-        resolve2();
-      }
-    });
-  }
-  /**
-   * Execute a command on the Python process.
-   *
-   * @param command - Command to execute (e.g., "memory.search", "env.reset")
-   * @param args - Command arguments
-   * @returns Command result
-   */
-  async execute(command, args = {}) {
-    if (!this.process?.stdin) {
-      throw new Error("Client not started. Call start() first.");
-    }
-    const request = { command, args };
-    const response = await this.sendRequest(request);
-    if (!response.success) {
-      throw new Error(response.error ?? "Unknown error");
-    }
-    return response.result;
-  }
-  /**
-   * Check if the client is running.
-   */
-  get isRunning() {
-    return this.process !== null && !this.process.killed;
-  }
-  sendRequest(request) {
-    return new Promise((resolve2, reject) => {
-      const id = this.requestId++;
-      const json = JSON.stringify(request);
-      const timeout = setTimeout(() => {
-        this.pendingRequests.delete(id);
-        reject(new Error(`Command timed out: ${request.command}`));
-      }, this.options.timeout);
-      this.pendingRequests.set(id, { resolve: resolve2, reject, timeout });
-      this.process?.stdin?.write(json + "\n");
-    });
-  }
-  handleData(data) {
-    this.buffer += data;
-    const lines = this.buffer.split("\n");
-    this.buffer = lines.pop() ?? "";
-    for (const line of lines) {
-      if (line.trim()) {
-        try {
-          const response = JSON.parse(line);
-          this.handleResponse(response);
-        } catch (error) {
-          this.emit("parseError", { line, error });
-        }
-      }
-    }
-  }
-  handleResponse(response) {
-    const [id, pending] = this.pendingRequests.entries().next().value ?? [
-      null,
-      null
-    ];
-    if (id !== null && pending) {
-      clearTimeout(pending.timeout);
-      this.pendingRequests.delete(id);
-      pending.resolve(response);
-    }
-  }
-  cleanup() {
-    for (const [id, pending] of this.pendingRequests) {
-      clearTimeout(pending.timeout);
-      pending.reject(new Error("Process terminated"));
-    }
-    this.pendingRequests.clear();
-    this.process = null;
-    this.buffer = "";
-  }
-};
-
-// src/setup.ts
-var import_child_process2 = require("child_process");
-var import_fs = require("fs");
-var import_path = require("path");
-var import_os = require("os");
-function findPython(preferredPath) {
-  const candidates = preferredPath ? [preferredPath] : (0, import_os.platform)() === "win32" ? ["python", "python3", "py"] : ["python3", "python"];
-  for (const cmd of candidates) {
-    try {
-      (0, import_child_process2.execSync)(`${cmd} --version`, { stdio: "pipe" });
-      return cmd;
-    } catch {
-      continue;
-    }
-  }
-  throw new Error(
-    "Python not found. Please install Python 3.10+ and ensure it's in your PATH.\nDownload from: https://www.python.org/downloads/"
-  );
-}
-function getVenvPaths(venvDir) {
-  const isWindows = (0, import_os.platform)() === "win32";
-  const binDir = isWindows ? "Scripts" : "bin";
-  const ext = isWindows ? ".exe" : "";
-  return {
-    python: (0, import_path.join)(venvDir, binDir, `python${ext}`),
-    pip: (0, import_path.join)(venvDir, binDir, `pip${ext}`)
-  };
-}
-function runCommand(command, args, options = {}) {
-  return new Promise((resolve2, reject) => {
-    const proc = (0, import_child_process2.spawn)(command, args, {
-      cwd: options.cwd,
-      stdio: options.verbose ? "inherit" : "pipe",
-      shell: (0, import_os.platform)() === "win32"
-    });
-    let output = "";
-    if (!options.verbose) {
-      proc.stdout?.on("data", (data) => {
-        output += data.toString();
-      });
-      proc.stderr?.on("data", (data) => {
-        output += data.toString();
-      });
-    }
-    proc.on("error", reject);
-    proc.on("close", (code) => {
-      if (code === 0) {
-        resolve2(output);
-      } else {
-        reject(new Error(`Command failed with code ${code}: ${command} ${args.join(" ")}
-${output}`));
-      }
-    });
-  });
-}
-async function getInstalledVersion(pythonPath) {
-  try {
-    const output = await runCommand(pythonPath, [
-      "-c",
-      "import cognitive_core; print(cognitive_core.__version__)"
-    ]);
-    return output.trim();
-  } catch {
-    return null;
-  }
-}
-async function setup(options = {}) {
-  const {
-    venvDir = ".cognitive-core",
-    pythonPath: preferredPython,
-    version,
-    extras = [],
-    verbose = true
-  } = options;
-  const venvPath = (0, import_path.resolve)(venvDir);
-  const log = verbose ? console.log.bind(console) : () => {
-  };
-  log("\u{1F50D} Finding Python...");
-  const systemPython = findPython(preferredPython);
-  log(`   Found: ${systemPython}`);
-  const versionOutput = (0, import_child_process2.execSync)(`${systemPython} --version`, { encoding: "utf-8" });
-  const versionMatch = versionOutput.match(/Python (\d+)\.(\d+)/);
-  if (versionMatch) {
-    const [, major, minor] = versionMatch;
-    if (parseInt(major) < 3 || parseInt(major) === 3 && parseInt(minor) < 10) {
-      throw new Error(
-        `Python 3.10+ required, found ${versionOutput.trim()}.
-Please upgrade Python: https://www.python.org/downloads/`
-      );
-    }
-  }
-  const venvPaths = getVenvPaths(venvPath);
-  const venvExists = (0, import_fs.existsSync)(venvPaths.python);
-  let created = false;
-  if (!venvExists) {
-    log("\u{1F4E6} Creating virtual environment...");
-    (0, import_fs.mkdirSync)(venvPath, { recursive: true });
-    await runCommand(systemPython, ["-m", "venv", venvPath], { verbose });
-    created = true;
-    log(`   Created: ${venvPath}`);
-  } else {
-    log(`\u{1F4E6} Using existing virtual environment: ${venvPath}`);
-  }
-  let installedVersion = await getInstalledVersion(venvPaths.python);
-  if (!installedVersion) {
-    log("\u2B07\uFE0F  Installing cognitive-core...");
-    let packageSpec = "cognitive-core";
-    if (version) {
-      packageSpec += `==${version}`;
-    }
-    if (extras.length > 0) {
-      packageSpec += `[${extras.join(",")}]`;
-    }
-    await runCommand(
-      venvPaths.pip,
-      ["install", "--upgrade", "pip"],
-      { verbose }
-    );
-    await runCommand(
-      venvPaths.pip,
-      ["install", packageSpec],
-      { verbose }
-    );
-    installedVersion = await getInstalledVersion(venvPaths.python);
-    log(`   Installed: cognitive-core ${installedVersion}`);
-  } else {
-    log(`\u2705 cognitive-core ${installedVersion} already installed`);
-  }
-  log("");
-  log("\u{1F389} Setup complete!");
-  log(`   Python: ${venvPaths.python}`);
-  log(`   Version: ${installedVersion}`);
-  log("");
-  return {
-    venvPath,
-    pythonPath: venvPaths.python,
-    pipPath: venvPaths.pip,
-    created,
-    version: installedVersion ?? "unknown"
-  };
-}
-function isSetUp(venvDir = ".cognitive-core") {
-  const venvPath = (0, import_path.resolve)(venvDir);
-  const venvPaths = getVenvPaths(venvPath);
-  return (0, import_fs.existsSync)(venvPaths.python);
-}
-function getPythonPath(venvDir = ".cognitive-core") {
-  const venvPath = (0, import_path.resolve)(venvDir);
-  const venvPaths = getVenvPaths(venvPath);
-  return (0, import_fs.existsSync)(venvPaths.python) ? venvPaths.python : null;
-}
-
-// src/index.ts
-var EnvironmentAPI = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Create a new environment.
-   */
-  async create(domain = "passthrough") {
-    const result = await this.client.execute(
-      "env.create",
-      { domain }
-    );
-    return { envId: result.env_id, domain: result.domain };
-  }
-  /**
-   * Reset an environment with a task.
-   */
-  async reset(envId, task) {
-    const result = await this.client.execute(
-      "env.reset",
-      { env_id: envId, task }
-    );
-    return { envId: result.env_id, observation: result.observation };
-  }
-  /**
-   * Execute an action in the environment.
-   */
-  async step(envId, action) {
-    return this.client.execute("env.step", { env_id: envId, action });
-  }
-  /**
-   * Verify a solution.
-   */
-  async verify(envId, solution) {
-    const result = await this.client.execute("env.verify", { env_id: envId, solution });
-    return {
-      success: result.success,
-      partialScore: result.partial_score,
-      verificationDetails: result.details
-    };
-  }
-};
-var MemoryAPI = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Search for similar experiences.
-   */
-  async searchExperiences(query, k = 5) {
-    const result = await this.client.execute(
-      "memory.search",
-      { query, k, type: "experience" }
-    );
-    return result.experiences ?? [];
-  }
-  /**
-   * Search for relevant strategies.
-   */
-  async searchStrategies(query, k = 5) {
-    const result = await this.client.execute(
-      "memory.search",
-      { query, k, type: "strategy" }
-    );
-    return result.strategies ?? [];
-  }
-  /**
-   * Search for relevant concepts.
-   */
-  async searchConcepts(query, k = 5) {
-    const result = await this.client.execute(
-      "memory.search",
-      { query, k, type: "concept" }
-    );
-    return result.concepts ?? [];
-  }
-  /**
-   * Store a trajectory in memory.
-   */
-  async store(trajectory) {
-    return this.client.execute("memory.store", { trajectory });
-  }
-};
-var SearchAPI = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Solve a task using the configured search strategy.
-   */
-  async solve(task) {
-    return this.client.execute("search.solve", { task });
-  }
-};
-var CognitiveCore = class {
-  client;
-  /**
-   * Environment operations (create, reset, step, verify)
-   */
-  env;
-  /**
-   * Memory operations (search, store)
-   */
-  memory;
-  /**
-   * Search operations (solve)
-   */
-  search;
-  constructor(options = {}) {
-    let pythonPath = options.pythonPath;
-    if (!pythonPath) {
-      const venvPython = getPythonPath();
-      if (venvPython) {
-        pythonPath = venvPython;
-      }
-    }
-    this.client = new CognitiveCoreClient({ ...options, pythonPath });
-    this.env = new EnvironmentAPI(this.client);
-    this.memory = new MemoryAPI(this.client);
-    this.search = new SearchAPI(this.client);
-  }
-  /**
-   * Start the Python subprocess.
-   */
-  async start() {
-    await this.client.start();
-  }
-  /**
-   * Stop the Python subprocess.
-   */
-  async stop() {
-    await this.client.stop();
-  }
-  /**
-   * Get the version of the Python cognitive-core package.
-   */
-  async version() {
-    const result = await this.client.execute("version");
-    return result.version;
-  }
-  /**
-   * Check if the client is running.
-   */
-  get isRunning() {
-    return this.client.isRunning;
-  }
-  /**
-   * Access the underlying client for advanced usage.
-   */
-  get rawClient() {
-    return this.client;
-  }
-};
-var index_default = CognitiveCore;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  CognitiveCore,
-  CognitiveCoreClient,
-  getPythonPath,
-  isSetUp,
-  setup
-});
+/**
+ * Atlas - Adaptive Trajectory Learning and Abstraction System
+ *
+ * A TypeScript-native cognitive core for building agents that learn
+ * from experience. Extracts playbooks from problem-solving trajectories
+ * to guide future task solving.
+ *
+ * @example
+ * ```typescript
+ * import { createAtlas, createTask } from 'cognitive-core';
+ *
+ * const atlas = createAtlas();
+ * await atlas.init();
+ *
+ * // Set your LLM provider
+ * atlas.setProvider(myProvider);
+ *
+ * // Solve a task
+ * const task = createTask({
+ *   domain: 'code',
+ *   description: 'Write a function that...',
+ * });
+ *
+ * const result = await atlas.solve(task);
+ * console.log(result.trajectory.outcome);
+ *
+ * // Close when done
+ * await atlas.close();
+ * ```
+ */
+// Main Atlas class
+export { Atlas, createAtlas, createAtlasWithProvider, createAtlasWithAgents, } from './atlas.js';
+// Types
+export * from './types/index.js';
+// Memory system
+export { MemorySystem, createMemorySystem, ExperienceMemory, 
+// Playbook-based memory
+PlaybookLibrary, createPlaybookLibrary, 
+// Meta-learning memory
+MetaMemory, createMetaMemory, } from './memory/index.js';
+// Learning engine
+export { LearningPipeline, createLearningPipeline, TrajectoryAnalyzer, createAnalyzer, 
+// Playbook-based learning
+PlaybookExtractor, createPlaybookExtractor, 
+// Meta-learning
+MetaLearner, createMetaLearner, 
+// Usage inference
+PlaybookUsageInference, createUsageInference, 
+// LLM-based extraction
+LLMPlaybookExtractor, createLLMExtractor, } from './learning/index.js';
+// Search/solving
+export { TaskRouter, createRouter, DirectSolver, createSolver, 
+// Refinement
+SolutionEvaluator, createSolutionEvaluator, RefinementLoop, createRefinementLoop, createEvaluationResult, scoreToQuality, isQualityAcceptable, 
+// Verification runner
+VerificationRunner, createVerificationRunner, TestRunners, } from './search/index.js';
+// Agents
+export { Agent, MockLLMProvider, createMockProvider, } from './agents/index.js';
+// Utilities
+export { cosineSimilarity, textSimilarity, findTopK, JsonStore, saveJson, loadJson, } from './utils/index.js';
+// Embeddings - Vector search and similarity
+export { OpenAIEmbeddingProvider, VoyageEmbeddingProvider, LocalEmbeddingProvider, createEmbeddingProvider, 
+// BM25 text search fallback
+BM25Index, createBM25Index, 
+// Vector store
+SqliteVectorStore, createVectorStore, 
+// Embedding manager
+EmbeddingManager, createEmbeddingManager, } from './embeddings/index.js';
+// Runtime - Agent management and flows
+export { 
+// Manager
+AgentManager, createAgentManager, DefaultKnowledgeInjector, DefaultTrajectoryExtractor, 
+// Backends
+SubprocessBackend, createSubprocessBackend, claudeCodeConfig, MockBackend, createMockBackend, ACPBackend, createACPBackend, claudeCodeACPConfig, claudeCodeDirectConfig, 
+// Flows
+LearningFlow, createLearningFlow, ValidationFlow, createValidationFlow, } from './runtime/index.js';
+// Surfacing - Skill library for agent consumption
+export { SkillLibrary, createSkillLibrary, } from './surfacing/index.js';
+// MCP Server - On-demand playbook access
+// @deprecated Use the CLI (bin/cognitive-core) + SKILL.md approach instead
+export { PlaybookMCPServer, createPlaybookMCPServer, } from './mcp/index.js';
+// Factory - Unified interface for external integration (e.g., skill-tree)
+export { createCognitiveCoreFactory, cognitiveCoreFactory, } from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,mBAAmB;AACnB,OAAO,EACL,KAAK,EACL,WAAW,EACX,uBAAuB,EACvB,qBAAqB,GAGtB,MAAM,YAAY,CAAC;AAEpB,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB;AAGhB,wBAAwB;AACxB,eAAe,EACf,qBAAqB;AAErB,uBAAuB;AACvB,UAAU,EACV,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc;AAId,0BAA0B;AAC1B,iBAAiB,EACjB,uBAAuB;AAIvB,gBAAgB;AAChB,WAAW,EACX,iBAAiB;AAEjB,kBAAkB;AAClB,sBAAsB,EACtB,oBAAoB;AAGpB,uBAAuB;AACvB,oBAAoB,EACpB,kBAAkB,GAGnB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY;AAGZ,aAAa;AACb,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,mBAAmB;AAWnB,sBAAsB;AACtB,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,GAIZ,MAAM,mBAAmB,CAAC;AAE3B,SAAS;AACT,OAAO,EACL,KAAK,EACL,eAAe,EACf,kBAAkB,GAKnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAE1B,4CAA4C;AAC5C,OAAO,EAIL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB;AACvB,4BAA4B;AAC5B,SAAS,EACT,eAAe;AAEf,eAAe;AACf,iBAAiB,EACjB,iBAAiB;AAEjB,oBAAoB;AACpB,gBAAgB,EAChB,sBAAsB,GAGvB,MAAM,uBAAuB,CAAC;AAE/B,uCAAuC;AACvC,OAAO;AACL,UAAU;AACV,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B;AAC1B,WAAW;AACX,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB;AACtB,QAAQ;AACR,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GAoBrB,MAAM,oBAAoB,CAAC;AAE5B,kDAAkD;AAClD,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,yCAAyC;AACzC,2EAA2E;AAC3E,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAKxB,MAAM,gBAAgB,CAAC;AAExB,0EAA0E;AAC1E,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GASrB,MAAM,cAAc,CAAC"}