@mnemonic-ai/core 0.1.0

package/dist/index.js

@@ -0,0 +1,160 @@
+import {
+  buildEmbedder
+} from "./chunk-CZDK53NR.js";
+import {
+  BUILTIN_SALIENCE_SIGNALS,
+  BUILTIN_TIERS,
+  Mnemonic,
+  MnemonicConfig,
+  SQLiteStore,
+  SalienceSignal,
+  TRANSIENT_ERRORS,
+  applyTierChange,
+  assemble,
+  checkDemotions,
+  checkPromotions,
+  classify,
+  detectSalience,
+  findConsolidationCandidates,
+  findLinks,
+  formatContext,
+  mergeCluster,
+  registerStore,
+  score,
+  syncToAsync
+} from "./chunk-NA7L5FQN.js";
+import {
+  PostgresStore
+} from "./chunk-M3IZJTMM.js";
+import {
+  Memory,
+  MemoryTier,
+  bruteForceCosineSearch,
+  cosineSimilarity,
+  cosineSimilarityMatrix,
+  cosineSimilarityVector,
+  createEdge,
+  estimateTokens,
+  parseDuration
+} from "./chunk-5Z46NSNR.js";
+import {
+  OpenAIEmbedder
+} from "./chunk-YZW6DYUY.js";
+import {
+  LocalEmbedder
+} from "./chunk-L7SCUMC3.js";
+
+// src/adapters/raw.ts
+async function recallAsPrompt(mnemonic, query, options) {
+  return mnemonic.recall(query, {
+    maxTokens: options?.maxTokens ?? 3e3,
+    header: options?.header ?? "Relevant context from memory:"
+  });
+}
+
+// src/adapters/langchain.ts
+async function createLangChainMemory(options) {
+  let BaseMemory;
+  let getInputValues;
+  let getOutputValues;
+  try {
+    const lcPath = "@langchain/core/memory";
+    const mod = await import(lcPath);
+    BaseMemory = mod.BaseMemory ?? mod.default?.BaseMemory;
+    getInputValues = mod.getInputValues ?? mod.default?.getInputValues;
+    getOutputValues = mod.getOutputValues ?? mod.default?.getOutputValues;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("Cannot find") || msg.includes("MODULE_NOT_FOUND")) {
+      throw new Error(
+        "LangChain adapter requires '@langchain/core'. Install it with: npm install @langchain/core"
+      );
+    }
+    throw err;
+  }
+  const {
+    mnemonic,
+    memoryKey = "memory",
+    maxTokens = 3e3,
+    inputKey,
+    outputKey
+  } = options;
+  function extractString(record, helper, key) {
+    if (helper && key) {
+      try {
+        const vals = helper(record, key);
+        const v = vals[key];
+        return typeof v === "string" ? v : void 0;
+      } catch {
+      }
+    }
+    if (key && typeof record[key] === "string") return record[key];
+    return Object.values(record).find((v) => typeof v === "string");
+  }
+  class MnemonicLangChainMemory extends BaseMemory {
+    // BaseMemory v1.x requires `memoryKeys` (not `memoryVariables`)
+    get memoryKeys() {
+      return [memoryKey];
+    }
+    async loadMemoryVariables(inputs) {
+      const query = extractString(inputs, getInputValues, inputKey) ?? "";
+      const context = await mnemonic.recall(String(query), { maxTokens });
+      return { [memoryKey]: context };
+    }
+    async saveContext(inputs, outputs) {
+      const humanInput = extractString(inputs, getInputValues, inputKey);
+      if (humanInput) {
+        await mnemonic.add(String(humanInput), {
+          source: "langchain",
+          actor: "user"
+        });
+      }
+      const aiOutput = extractString(outputs, getOutputValues, outputKey);
+      if (aiOutput) {
+        await mnemonic.add(String(aiOutput), {
+          source: "langchain",
+          actor: "assistant"
+        });
+      }
+    }
+  }
+  return new MnemonicLangChainMemory();
+}
+export {
+  BUILTIN_SALIENCE_SIGNALS,
+  BUILTIN_TIERS,
+  LocalEmbedder,
+  Memory,
+  MemoryTier,
+  Mnemonic,
+  MnemonicConfig,
+  OpenAIEmbedder,
+  PostgresStore,
+  SQLiteStore,
+  SalienceSignal,
+  TRANSIENT_ERRORS,
+  applyTierChange,
+  assemble,
+  bruteForceCosineSearch,
+  buildEmbedder,
+  checkDemotions,
+  checkPromotions,
+  classify,
+  cosineSimilarity,
+  cosineSimilarityMatrix,
+  cosineSimilarityVector,
+  createEdge,
+  createLangChainMemory,
+  detectSalience,
+  estimateTokens,
+  findConsolidationCandidates,
+  findLinks,
+  formatContext,
+  mergeCluster,
+  parseDuration,
+  recallAsPrompt,
+  registerStore,
+  score,
+  syncToAsync
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/raw.ts","../src/adapters/langchain.ts"],"sourcesContent":["/**\n * Raw API adapter — simple helper for injecting memory context into prompts.\n */\n\nimport type { Mnemonic } from \"../client.js\";\n\nexport interface RecallAsPromptOptions {\n  maxTokens?: number;\n  header?: string;\n}\n\n/**\n * Retrieve memory context formatted for direct inclusion in a system prompt.\n *\n * ```ts\n * const context = await recallAsPrompt(mem, userQuery);\n * const systemPrompt = `You are helpful.\\n\\n${context}`;\n * ```\n */\nexport async function recallAsPrompt(\n  mnemonic: Mnemonic,\n  query: string,\n  options?: RecallAsPromptOptions,\n): Promise<string> {\n  return mnemonic.recall(query, {\n    maxTokens: options?.maxTokens ?? 3000,\n    header: options?.header ?? \"Relevant context from memory:\",\n  });\n}\n","/**\n * LangChain.js adapter — wraps Mnemonic as a LangChain BaseMemory.\n * Requires @langchain/core as a peer dependency.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { Mnemonic } from \"../client.js\";\n\nexport interface LangChainMemoryOptions {\n  /** The Mnemonic client instance. */\n  mnemonic: Mnemonic;\n  /** Key used in the memory variables dict (default \"memory\"). */\n  memoryKey?: string;\n  /** Max tokens for recall (default 3000). */\n  maxTokens?: number;\n  /** Input key for multi-key chains (auto-detected if single key). */\n  inputKey?: string;\n  /** Output key for multi-key chains (auto-detected if single key). */\n  outputKey?: string;\n}\n\n/**\n * Create a LangChain-compatible memory wrapper.\n * Must be called with await since it dynamically imports @langchain/core.\n *\n * ```ts\n * const memory = await createLangChainMemory({ mnemonic: client });\n * const chain = new ConversationChain({ memory });\n * ```\n */\nexport async function createLangChainMemory(\n  options: LangChainMemoryOptions,\n): Promise<any> {\n  let BaseMemory: any;\n  let getInputValues: ((inputs: Record<string, any>, key?: string) => any) | undefined;\n  let getOutputValues: ((outputs: Record<string, any>, key?: string) => any) | undefined;\n  try {\n    const lcPath = \"@langchain/core/memory\";\n    const mod: any = await import(lcPath);\n    BaseMemory = mod.BaseMemory ?? mod.default?.BaseMemory;\n    getInputValues = mod.getInputValues ?? mod.default?.getInputValues;\n    getOutputValues = mod.getOutputValues ?? mod.default?.getOutputValues;\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    if (msg.includes(\"Cannot find\") || msg.includes(\"MODULE_NOT_FOUND\")) {\n      throw new Error(\n        \"LangChain adapter requires '@langchain/core'. \" +\n          \"Install it with: npm install @langchain/core\",\n      );\n    }\n    throw err;\n  }\n\n  const {\n    mnemonic,\n    memoryKey = \"memory\",\n    maxTokens = 3000,\n    inputKey,\n    outputKey,\n  } = options;\n\n  /** Extract a single string value from an inputs/outputs record. */\n  function extractString(\n    record: Record<string, any>,\n    helper: typeof getInputValues | typeof getOutputValues,\n    key?: string,\n  ): string | undefined {\n    // Use LangChain helpers when available (handles multi-key validation)\n    if (helper && key) {\n      try {\n        const vals = helper(record, key);\n        const v = vals[key];\n        return typeof v === \"string\" ? v : undefined;\n      } catch {\n        // Fall through to simple extraction\n      }\n    }\n    // Fallback: explicit key or first string value\n    if (key && typeof record[key] === \"string\") return record[key];\n    return Object.values(record).find((v) => typeof v === \"string\") as\n      | string\n      | undefined;\n  }\n\n  class MnemonicLangChainMemory extends BaseMemory {\n    // BaseMemory v1.x requires `memoryKeys` (not `memoryVariables`)\n    get memoryKeys(): string[] {\n      return [memoryKey];\n    }\n\n    async loadMemoryVariables(\n      inputs: Record<string, any>,\n    ): Promise<Record<string, string>> {\n      const query = extractString(inputs, getInputValues, inputKey) ?? \"\";\n      const context = await mnemonic.recall(String(query), { maxTokens });\n      return { [memoryKey]: context };\n    }\n\n    async saveContext(\n      inputs: Record<string, any>,\n      outputs: Record<string, any>,\n    ): Promise<void> {\n      const humanInput = extractString(inputs, getInputValues, inputKey);\n      if (humanInput) {\n        await mnemonic.add(String(humanInput), {\n          source: \"langchain\",\n          actor: \"user\",\n        });\n      }\n      const aiOutput = extractString(outputs, getOutputValues, outputKey);\n      if (aiOutput) {\n        await mnemonic.add(String(aiOutput), {\n          source: \"langchain\",\n          actor: \"assistant\",\n        });\n      }\n    }\n  }\n\n  return new MnemonicLangChainMemory();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA,eAAsB,eACpB,UACA,OACA,SACiB;AACjB,SAAO,SAAS,OAAO,OAAO;AAAA,IAC5B,WAAW,SAAS,aAAa;AAAA,IACjC,QAAQ,SAAS,UAAU;AAAA,EAC7B,CAAC;AACH;;;ACGA,eAAsB,sBACpB,SACc;AACd,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,UAAM,SAAS;AACf,UAAM,MAAW,MAAM,OAAO;AAC9B,iBAAa,IAAI,cAAc,IAAI,SAAS;AAC5C,qBAAiB,IAAI,kBAAkB,IAAI,SAAS;AACpD,sBAAkB,IAAI,mBAAmB,IAAI,SAAS;AAAA,EACxD,SAAS,KAAc;AACrB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,QAAI,IAAI,SAAS,aAAa,KAAK,IAAI,SAAS,kBAAkB,GAAG;AACnE,YAAM,IAAI;AAAA,QACR;AAAA,MAEF;AAAA,IACF;AACA,UAAM;AAAA,EACR;AAEA,QAAM;AAAA,IACJ;AAAA,IACA,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,EACF,IAAI;AAGJ,WAAS,cACP,QACA,QACA,KACoB;AAEpB,QAAI,UAAU,KAAK;AACjB,UAAI;AACF,cAAM,OAAO,OAAO,QAAQ,GAAG;AAC/B,cAAM,IAAI,KAAK,GAAG;AAClB,eAAO,OAAO,MAAM,WAAW,IAAI;AAAA,MACrC,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,QAAI,OAAO,OAAO,OAAO,GAAG,MAAM,SAAU,QAAO,OAAO,GAAG;AAC7D,WAAO,OAAO,OAAO,MAAM,EAAE,KAAK,CAAC,MAAM,OAAO,MAAM,QAAQ;AAAA,EAGhE;AAAA,EAEA,MAAM,gCAAgC,WAAW;AAAA;AAAA,IAE/C,IAAI,aAAuB;AACzB,aAAO,CAAC,SAAS;AAAA,IACnB;AAAA,IAEA,MAAM,oBACJ,QACiC;AACjC,YAAM,QAAQ,cAAc,QAAQ,gBAAgB,QAAQ,KAAK;AACjE,YAAM,UAAU,MAAM,SAAS,OAAO,OAAO,KAAK,GAAG,EAAE,UAAU,CAAC;AAClE,aAAO,EAAE,CAAC,SAAS,GAAG,QAAQ;AAAA,IAChC;AAAA,IAEA,MAAM,YACJ,QACA,SACe;AACf,YAAM,aAAa,cAAc,QAAQ,gBAAgB,QAAQ;AACjE,UAAI,YAAY;AACd,cAAM,SAAS,IAAI,OAAO,UAAU,GAAG;AAAA,UACrC,QAAQ;AAAA,UACR,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AACA,YAAM,WAAW,cAAc,SAAS,iBAAiB,SAAS;AAClE,UAAI,UAAU;AACZ,cAAM,SAAS,IAAI,OAAO,QAAQ,GAAG;AAAA,UACnC,QAAQ;AAAA,UACR,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,SAAO,IAAI,wBAAwB;AACrC;","names":[]}

package/dist/local-MYLINANE.js

@@ -0,0 +1,7 @@
+import {
+  LocalEmbedder
+} from "./chunk-L7SCUMC3.js";
+export {
+  LocalEmbedder
+};
+//# sourceMappingURL=local-MYLINANE.js.map

package/dist/local-MYLINANE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}