mentedb 0.3.1 → 0.7.0

package/README.md

@@ -96,7 +96,9 @@ const next = tracker.predictNextTopics();
 | `recall(query)` | Recall memories via an MQL query. Returns `RecallResult`. |
 | `search(embedding, k)` | Vector similarity search. Returns `SearchResult[]`. |
 | `relate(source, target, edgeType?, weight?)` | Create a typed edge between two memories. |
+| `processTurn(userMessage, assistantResponse?, turnId?, projectContext?, agentId?)` | Process a conversation turn through the full cognitive pipeline. Returns context, actions, sentiment, predictions, and more. |
 | `forget(memoryId)` | Remove a memory by ID. |
+| `ingest(conversation, provider?, agentId?)` | Extract and store memories from a conversation via LLM. |
 | `close()` | Flush and close the database. |
 
 ### `CognitionStream`

package/npm/client.d.ts

@@ -0,0 +1,56 @@
+import { EdgeType, type StoreOptions, type RecallResult, type SearchResult } from './types';
+/**
+ * MenteDB client. Wraps the native Rust database engine and exposes a
+ * TypeScript-friendly API for storing, recalling, searching, relating, and
+ * forgetting memories.
+ */
+export declare class MenteDB {
+    private native;
+    constructor(dataDir?: string);
+    /** Store a memory and return its UUID. */
+    store(options: StoreOptions): string;
+    /** Recall memories using an MQL query string. */
+    recall(query: string): RecallResult;
+    /** Vector similarity search returning top-k results. */
+    search(embedding: number[], k?: number): SearchResult[];
+    /** Create a typed, weighted edge between two memories. */
+    relate(source: string, target: string, edgeType?: EdgeType, weight?: number): void;
+    /** Remove a memory by ID. */
+    forget(memoryId: string): void;
+    /** Flush all data and close the database. */
+    close(): void;
+}
+/**
+ * Monitors an LLM token stream for contradictions, forgotten facts,
+ * corrections, and reinforcements.
+ */
+export declare class CognitionStream {
+    private native;
+    constructor(bufferSize?: number);
+    /** Push a token into the stream buffer. */
+    feedToken(token: string): void;
+    /** Drain the accumulated buffer and return its content. */
+    drainBuffer(): string;
+}
+/**
+ * Tracks the reasoning arc of a conversation and predicts next topics.
+ */
+export declare class TrajectoryTracker {
+    private native;
+    constructor(maxTurns?: number);
+    /**
+     * Record a conversation turn.
+     *
+     * `decisionState` accepts one of:
+     *   - `"investigating"`
+     *   - `"interrupted"`
+     *   - `"completed"`
+     *   - `"narrowed:<choice>"`
+     *   - `"decided:<decision>"`
+     */
+    recordTurn(topic: string, decisionState: string, openQuestions?: string[]): void;
+    /** Get a resume context string describing the current trajectory. */
+    getResumeContext(): string | null;
+    /** Predict the next likely topics based on trajectory. */
+    predictNextTopics(): string[];
+}

package/npm/client.js

@@ -0,0 +1,150 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrajectoryTracker = exports.CognitionStream = exports.MenteDB = void 0;
+const types_1 = require("./types");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const PLATFORM_TRIPLES = {
+    'linux-x64': 'linux-x64-gnu',
+    'darwin-arm64': 'darwin-arm64',
+    'darwin-x64': 'darwin-x64',
+    'win32-x64': 'win32-x64-msvc',
+};
+function loadNativeBinding() {
+    const key = `${os.platform()}-${os.arch()}`;
+    const triple = PLATFORM_TRIPLES[key];
+    // Try platform-specific binary first (from CI cross-compile)
+    if (triple) {
+        try {
+            return require(path.join(__dirname, '..', `mentedb.${triple}.node`));
+        }
+        catch { }
+    }
+    // Fall back to unqualified binary (local `napi build --release`)
+    try {
+        return require(path.join(__dirname, '..', 'mentedb.node'));
+    }
+    catch { }
+    const supported = Object.keys(PLATFORM_TRIPLES).join(', ');
+    throw new Error(`No native binding found for ${key}. ` +
+        `Supported platforms: ${supported}. ` +
+        `Build locally with: cd sdks/typescript && npm run build`);
+}
+const nativeBinding = loadNativeBinding();
+/**
+ * MenteDB client. Wraps the native Rust database engine and exposes a
+ * TypeScript-friendly API for storing, recalling, searching, relating, and
+ * forgetting memories.
+ */
+class MenteDB {
+    constructor(dataDir = './mentedb-data') {
+        this.native = new nativeBinding.MenteDb(dataDir);
+    }
+    /** Store a memory and return its UUID. */
+    store(options) {
+        const { content, memoryType = types_1.MemoryType.Episodic, embedding = [], agentId, tags, } = options;
+        return this.native.store(content, memoryType, embedding, agentId, tags);
+    }
+    /** Recall memories using an MQL query string. */
+    recall(query) {
+        return this.native.recall(query);
+    }
+    /** Vector similarity search returning top-k results. */
+    search(embedding, k = 10) {
+        return this.native.search(embedding, k);
+    }
+    /** Create a typed, weighted edge between two memories. */
+    relate(source, target, edgeType = types_1.EdgeType.Related, weight = 1.0) {
+        this.native.relate(source, target, edgeType, weight);
+    }
+    /** Remove a memory by ID. */
+    forget(memoryId) {
+        this.native.forget(memoryId);
+    }
+    /** Flush all data and close the database. */
+    close() {
+        this.native.close();
+    }
+}
+exports.MenteDB = MenteDB;
+/**
+ * Monitors an LLM token stream for contradictions, forgotten facts,
+ * corrections, and reinforcements.
+ */
+class CognitionStream {
+    constructor(bufferSize = 1000) {
+        this.native = new nativeBinding.JsCognitionStream(bufferSize);
+    }
+    /** Push a token into the stream buffer. */
+    feedToken(token) {
+        this.native.feedToken(token);
+    }
+    /** Drain the accumulated buffer and return its content. */
+    drainBuffer() {
+        return this.native.drainBuffer();
+    }
+}
+exports.CognitionStream = CognitionStream;
+/**
+ * Tracks the reasoning arc of a conversation and predicts next topics.
+ */
+class TrajectoryTracker {
+    constructor(maxTurns = 100) {
+        this.native = new nativeBinding.JsTrajectoryTracker(maxTurns);
+    }
+    /**
+     * Record a conversation turn.
+     *
+     * `decisionState` accepts one of:
+     *   - `"investigating"`
+     *   - `"interrupted"`
+     *   - `"completed"`
+     *   - `"narrowed:<choice>"`
+     *   - `"decided:<decision>"`
+     */
+    recordTurn(topic, decisionState, openQuestions = []) {
+        this.native.recordTurn(topic, decisionState, openQuestions);
+    }
+    /** Get a resume context string describing the current trajectory. */
+    getResumeContext() {
+        return this.native.getResumeContext() ?? null;
+    }
+    /** Predict the next likely topics based on trajectory. */
+    predictNextTopics() {
+        return this.native.predictNextTopics();
+    }
+}
+exports.TrajectoryTracker = TrajectoryTracker;

package/npm/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EdgeType = exports.MemoryType = exports.TrajectoryTracker = exports.CognitionStream = exports.MenteDB = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "MenteDB", { enumerable: true, get: function () { return client_1.MenteDB; } });
+Object.defineProperty(exports, "CognitionStream", { enumerable: true, get: function () { return client_1.CognitionStream; } });
+Object.defineProperty(exports, "TrajectoryTracker", { enumerable: true, get: function () { return client_1.TrajectoryTracker; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "MemoryType", { enumerable: true, get: function () { return types_1.MemoryType; } });
+Object.defineProperty(exports, "EdgeType", { enumerable: true, get: function () { return types_1.EdgeType; } });

package/npm/types.d.ts

@@ -0,0 +1,34 @@
+export declare enum MemoryType {
+    Episodic = "episodic",
+    Semantic = "semantic",
+    Procedural = "procedural",
+    AntiPattern = "anti_pattern",
+    Reasoning = "reasoning",
+    Correction = "correction"
+}
+export declare enum EdgeType {
+    Caused = "caused",
+    Before = "before",
+    Related = "related",
+    Contradicts = "contradicts",
+    Supports = "supports",
+    Supersedes = "supersedes",
+    Derived = "derived",
+    PartOf = "part_of"
+}
+export interface RecallResult {
+    text: string;
+    totalTokens: number;
+    memoryCount: number;
+}
+export interface SearchResult {
+    id: string;
+    score: number;
+}
+export interface StoreOptions {
+    content: string;
+    memoryType?: MemoryType;
+    embedding?: number[];
+    agentId?: string;
+    tags?: string[];
+}

package/npm/types.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EdgeType = exports.MemoryType = void 0;
+var MemoryType;
+(function (MemoryType) {
+    MemoryType["Episodic"] = "episodic";
+    MemoryType["Semantic"] = "semantic";
+    MemoryType["Procedural"] = "procedural";
+    MemoryType["AntiPattern"] = "anti_pattern";
+    MemoryType["Reasoning"] = "reasoning";
+    MemoryType["Correction"] = "correction";
+})(MemoryType || (exports.MemoryType = MemoryType = {}));
+var EdgeType;
+(function (EdgeType) {
+    EdgeType["Caused"] = "caused";
+    EdgeType["Before"] = "before";
+    EdgeType["Related"] = "related";
+    EdgeType["Contradicts"] = "contradicts";
+    EdgeType["Supports"] = "supports";
+    EdgeType["Supersedes"] = "supersedes";
+    EdgeType["Derived"] = "derived";
+    EdgeType["PartOf"] = "part_of";
+})(EdgeType || (exports.EdgeType = EdgeType = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mentedb",
-  "version": "0.3.1",
+  "version": "0.7.0",
   "description": "The mind database for AI agents",
   "main": "npm/index.js",
   "types": "npm/index.d.ts",
@@ -27,7 +27,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "napi": {
-    "name": "mentedb",
+    "binaryName": "mentedb",
     "triples": {}
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3"
   }
 }

package/npm/client.ts

@@ -1,143 +0,0 @@
-import {
-  MemoryType,
-  EdgeType,
-  type StoreOptions,
-  type RecallResult,
-  type SearchResult,
-} from './types';
-
-let nativeBinding: any;
-
-try {
-  nativeBinding = require('../mentedb.node');
-} catch {
-  nativeBinding = null;
-}
-
-function requireNative(): any {
-  if (!nativeBinding) {
-    throw new Error(
-      'Native extension not loaded. Build with: npm run build'
-    );
-  }
-  return nativeBinding;
-}
-
-/**
- * MenteDB client. Wraps the native Rust database engine and exposes a
- * TypeScript-friendly API for storing, recalling, searching, relating, and
- * forgetting memories.
- */
-export class MenteDB {
-  private native: any;
-
-  constructor(dataDir: string = './mentedb-data') {
-    const binding = requireNative();
-    this.native = new binding.MenteDB(dataDir);
-  }
-
-  /** Store a memory and return its UUID. */
-  store(options: StoreOptions): string {
-    const {
-      content,
-      memoryType = MemoryType.Episodic,
-      embedding = [],
-      agentId,
-      tags,
-    } = options;
-    return this.native.store(content, memoryType, embedding, agentId, tags);
-  }
-
-  /** Recall memories using an MQL query string. */
-  recall(query: string): RecallResult {
-    return this.native.recall(query);
-  }
-
-  /** Vector similarity search returning top-k results. */
-  search(embedding: number[], k: number = 10): SearchResult[] {
-    return this.native.search(embedding, k);
-  }
-
-  /** Create a typed, weighted edge between two memories. */
-  relate(
-    source: string,
-    target: string,
-    edgeType: EdgeType = EdgeType.Related,
-    weight: number = 1.0,
-  ): void {
-    this.native.relate(source, target, edgeType, weight);
-  }
-
-  /** Remove a memory by ID. */
-  forget(memoryId: string): void {
-    this.native.forget(memoryId);
-  }
-
-  /** Flush all data and close the database. */
-  close(): void {
-    this.native.close();
-  }
-}
-
-/**
- * Monitors an LLM token stream for contradictions, forgotten facts,
- * corrections, and reinforcements.
- */
-export class CognitionStream {
-  private native: any;
-
-  constructor(bufferSize: number = 1000) {
-    const binding = requireNative();
-    this.native = new binding.JsCognitionStream(bufferSize);
-  }
-
-  /** Push a token into the stream buffer. */
-  feedToken(token: string): void {
-    this.native.feedToken(token);
-  }
-
-  /** Drain the accumulated buffer and return its content. */
-  drainBuffer(): string {
-    return this.native.drainBuffer();
-  }
-}
-
-/**
- * Tracks the reasoning arc of a conversation and predicts next topics.
- */
-export class TrajectoryTracker {
-  private native: any;
-
-  constructor(maxTurns: number = 100) {
-    const binding = requireNative();
-    this.native = new binding.JsTrajectoryTracker(maxTurns);
-  }
-
-  /**
-   * Record a conversation turn.
-   *
-   * `decisionState` accepts one of:
-   *   - `"investigating"`
-   *   - `"interrupted"`
-   *   - `"completed"`
-   *   - `"narrowed:<choice>"`
-   *   - `"decided:<decision>"`
-   */
-  recordTurn(
-    topic: string,
-    decisionState: string,
-    openQuestions: string[] = [],
-  ): void {
-    this.native.recordTurn(topic, decisionState, openQuestions);
-  }
-
-  /** Get a resume context string describing the current trajectory. */
-  getResumeContext(): string | null {
-    return this.native.getResumeContext() ?? null;
-  }
-
-  /** Predict the next likely topics based on trajectory. */
-  predictNextTopics(): string[] {
-    return this.native.predictNextTopics();
-  }
-}

package/npm/types.ts

@@ -1,38 +0,0 @@
-export enum MemoryType {
-  Episodic = 'episodic',
-  Semantic = 'semantic',
-  Procedural = 'procedural',
-  AntiPattern = 'anti_pattern',
-  Reasoning = 'reasoning',
-  Correction = 'correction',
-}
-
-export enum EdgeType {
-  Caused = 'caused',
-  Before = 'before',
-  Related = 'related',
-  Contradicts = 'contradicts',
-  Supports = 'supports',
-  Supersedes = 'supersedes',
-  Derived = 'derived',
-  PartOf = 'part_of',
-}
-
-export interface RecallResult {
-  text: string;
-  totalTokens: number;
-  memoryCount: number;
-}
-
-export interface SearchResult {
-  id: string;
-  score: number;
-}
-
-export interface StoreOptions {
-  content: string;
-  memoryType?: MemoryType;
-  embedding?: number[];
-  agentId?: string;
-  tags?: string[];
-}