mem-os-python 1.6.27__py3-none-any.whl

memos/_js/adapters/anthropic.js

@@ -0,0 +1,348 @@
+/**
+ * MemOS Anthropic Adapter — first-class memory integration for the
+ * Anthropic SDK (Claude).
+ *
+ * Wraps a MemOS instance and exposes helpers that map cleanly onto the
+ * Anthropic Messages API: a memory-backed tool definition, system-prompt
+ * context injection, automatic fact extraction from conversations, and
+ * simple store/forget helpers.
+ *
+ * The adapter has **zero hard dependencies** on the `@anthropic-ai/sdk`
+ * package. Every exported message/tool/content-block shape is structurally
+ * compatible with the corresponding SDK types, so they can be passed
+ * straight into `client.messages.create(...)` with no glue layer. Install
+ * `@anthropic-ai/sdk` only if you want to call the model; the adapter
+ * itself only needs MemOS.
+ *
+ * @example
+ * ```ts
+ * import Anthropic from "@anthropic-ai/sdk";
+ * import { createAnthropicMemory } from "@mem-os/sdk/anthropic";
+ *
+ * const { plugin } = await createAnthropicMemory({ dbPath: "./my-app.db" });
+ * const client = new Anthropic();
+ *
+ * const message = await client.messages.create({
+ *   model: "claude-3-5-sonnet-20241022",
+ *   max_tokens: 1024,
+ *   system: "You are a helpful assistant.",
+ *   messages: [{ role: "user", content: "What theme do I like?" }],
+ *   tools: [plugin.memoryTool],
+ * });
+ * ```
+ *
+ * @module @memos/adapters/anthropic
+ */
+import { MemOS } from "../index.js";
+// ---------------------------------------------------------------------------
+// Plugin
+// ---------------------------------------------------------------------------
+/**
+ * Anthropic SDK memory plugin backed by MemOS.
+ *
+ * Wrap an existing MemOS instance, or use {@link createAnthropicMemory} to
+ * construct both in one call. The plugin does not call the Anthropic API
+ * itself — it prepares memories (as tools, tool-result blocks, and
+ * system-prompt strings) for you to feed into your own
+ * `client.messages.create` calls.
+ */
+export class MemOSAnthropicPlugin {
+    /** The wrapped MemOS instance. */
+    memos;
+    opts;
+    /**
+     * Create a new Anthropic memory plugin.
+     *
+     * @param memos - An initialised MemOS instance.
+     * @param opts  - Plugin options. All fields optional with sensible defaults.
+     */
+    constructor(memos, opts = {}) {
+        this.memos = memos;
+        this.opts = {
+            maxContextMemories: opts.maxContextMemories ?? 5,
+            autoExtractFacts: opts.autoExtractFacts ?? true,
+            minMessageLength: opts.minMessageLength ?? 15,
+            source: opts.source ?? "user_input",
+            minConfidence: opts.minConfidence ?? 0.6,
+            namespace: opts.namespace ?? "default",
+        };
+    }
+    /**
+     * Anthropic tool definition that lets the model search the user's memory.
+     * Pass it via the `tools` parameter of `client.messages.create`.
+     *
+     * When the model invokes it (a `tool_use` content block), call
+     * {@link searchMemories} and return the `tool_result` block (built via
+     * the result's `toToolResult(toolUseId)`) as a `user` message.
+     */
+    get memoryTool() {
+        return {
+            name: "search_memories",
+            description: "Search the user's persistent MemOS memory for relevant facts, " +
+                "preferences, and context. Call this before answering personal or " +
+                "preference questions, or when prior context seems relevant.",
+            input_schema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Natural-language search query.",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "Maximum number of memories to return.",
+                        default: 5,
+                    },
+                },
+                required: ["query"],
+            },
+        };
+    }
+    /**
+     * Extract facts from a conversation and store them in MemOS.
+     *
+     * Runs MemOS' local rule-based fact extractor over the conversation,
+     * persisting any candidate facts whose confidence meets the configured
+     * `minConfidence` threshold. Near-duplicates are skipped automatically
+     * when embeddings are available.
+     *
+     * @param conversation - The messages to extract facts from.
+     * @returns The extraction result (candidate facts, stored ids, dup count).
+     */
+    async addMessages(conversation) {
+        const candidates = conversation.filter((m) => m.content.trim().length >= this.opts.minMessageLength);
+        if (candidates.length === 0) {
+            return { facts: [], storedIds: [], duplicates: 0 };
+        }
+        return this.memos.extractFacts(candidates, {
+            autoStore: true,
+            minConfidence: this.opts.minConfidence,
+            namespace: this.opts.namespace,
+            dedupe: true,
+        });
+    }
+    /**
+     * Search memories and format the results for Anthropic tool use.
+     *
+     * @param query - Natural-language search query.
+     * @param opts  - Search options (limit, type, namespace).
+     * @returns An object containing the ranked memory entries, a JSON string,
+     *   and a `toToolResult(toolUseId)` factory that builds a `tool_result`
+     *   content block ready to send back as a `user` message.
+     */
+    async searchMemories(query, opts = {}) {
+        const filter = {
+            query,
+            limit: opts.limit ?? this.opts.maxContextMemories,
+        };
+        if (opts.type)
+            filter.type = opts.type;
+        if (opts.namespace)
+            filter.namespace = opts.namespace;
+        const results = await this.memos.search(filter);
+        const memories = results.map((r) => this.toEntry(r));
+        const content = memories.length > 0
+            ? JSON.stringify(memories, null, 2)
+            : "No relevant memories found.";
+        return {
+            query,
+            memories,
+            content,
+            toToolResult: (toolUseId) => ({
+                type: "tool_result",
+                tool_use_id: toolUseId,
+                content,
+            }),
+        };
+    }
+    /**
+     * Build a system-prompt string of relevant memories for injection.
+     *
+     * Optionally extracts & stores facts from the recent `messages` first,
+     * then searches MemOS using the most recent user message and returns the
+     * matches as a formatted block ready to pass as the top-level `system`
+     * parameter of `client.messages.create`.
+     *
+     * @param messages - Recent conversation messages.
+     * @param opts     - Context options (limit, whether to extract).
+     * @returns A memory-context string, or `""` if nothing relevant was found.
+     */
+    async getMemoryContext(messages, opts = {}) {
+        const shouldExtract = opts.extract ?? this.opts.autoExtractFacts;
+        if (shouldExtract && messages.length > 0) {
+            await this.addMessages(messages);
+        }
+        const lastUser = [...messages].reverse().find((m) => m.role === "user");
+        const query = lastUser?.content.trim() ?? "";
+        if (!query)
+            return "";
+        const results = await this.memos.search({
+            query,
+            limit: opts.limit ?? this.opts.maxContextMemories,
+        });
+        if (results.length === 0)
+            return "";
+        const lines = ["Relevant memories from prior conversations:"];
+        results.forEach((m, i) => {
+            lines.push(`  ${i + 1}. [${m.node.type}] ${m.node.content}`);
+        });
+        return lines.join("\n");
+    }
+    /**
+     * Manually store a memory.
+     *
+     * @param content - Text to remember.
+     * @param opts    - Additional memory parameters (type, tags, importance…).
+     * @returns The created memory node.
+     */
+    async remember(content, opts = {}) {
+        const { node } = await this.memos.store(content, {
+            ...opts,
+            source: opts.source ?? this.opts.source,
+            namespace: opts.namespace ?? this.opts.namespace,
+        });
+        return node;
+    }
+    /**
+     * Search for relevant memories.
+     *
+     * @param query - Search query.
+     * @param limit - Maximum number of results. @default 5
+     * @returns Scored memory nodes.
+     */
+    async recall(query, limit = 5) {
+        return this.memos.search({ query, limit });
+    }
+    /**
+     * Permanently forget a memory.
+     *
+     * @param memoryId - ID of the memory to delete.
+     * @returns `true` if the memory existed and was deleted.
+     */
+    async forget(memoryId) {
+        return this.memos.forget(memoryId);
+    }
+    /**
+     * Remove all memories and edges from the underlying MemOS instance.
+     *
+     * This is destructive and cannot be undone.
+     */
+    async clearMemories() {
+        await this.memos.clear();
+    }
+    /**
+     * Return the total number of stored memories.
+     *
+     * @returns The current memory count.
+     */
+    getMemoryCount() {
+        return this.memos.count;
+    }
+    /** Convert a scored memory into a JSON-friendly entry. */
+    toEntry(scored) {
+        return {
+            id: scored.node.id,
+            content: scored.node.content,
+            summary: scored.node.summary,
+            type: scored.node.type,
+            score: scored.score,
+            tags: scored.node.tags,
+            trustScore: scored.node.trustScore,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Convenience constructor
+// ---------------------------------------------------------------------------
+/**
+ * Create a MemOS instance and an Anthropic memory plugin in one call.
+ *
+ * The MemOS instance is created with `config`, initialised, and wrapped in a
+ * {@link MemOSAnthropicPlugin}. Plugin-level options go under `config.plugin`.
+ *
+ * @param config - MemOS config plus optional `plugin` options.
+ * @returns The initialised `memos` instance and bound `plugin`.
+ *
+ * @example
+ * ```ts
+ * const { memos, plugin } = await createAnthropicMemory({
+ *   dbPath: "./my-app.db",
+ *   plugin: { maxContextMemories: 8 },
+ * });
+ * ```
+ */
+export async function createAnthropicMemory(config = {}) {
+    const { plugin: pluginOpts, ...memosConfig } = config;
+    const memos = new MemOS(memosConfig);
+    await memos.init();
+    const plugin = new MemOSAnthropicPlugin(memos, pluginOpts);
+    return { memos, plugin };
+}
+// ---------------------------------------------------------------------------
+// Usage example
+// ---------------------------------------------------------------------------
+/*
+ * End-to-end example using the official `@anthropic-ai/sdk`.
+ *
+ *   npm install @anthropic-ai/sdk
+ *
+ * import Anthropic from "@anthropic-ai/sdk";
+ * import { createAnthropicMemory } from "@mem-os/sdk/anthropic";
+ *
+ * // 1. Boot MemOS + the plugin.
+ * const { memos, plugin } = await createAnthropicMemory({
+ *   dbPath: "./my-app.db",
+ *   plugin: { maxContextMemories: 6 },
+ * });
+ *
+ * const client = new Anthropic();
+ *
+ * // 2. Teach it something. addMessages() extracts & stores facts.
+ * await plugin.addMessages([
+ *   { role: "user", content: "I prefer dark mode in all my apps." },
+ *   { role: "assistant", content: "Got it — dark mode it is." },
+ * ]);
+ *
+ * // 3a. Context-injection style: fold memories into the system prompt.
+ * //     Anthropic takes `system` as a top-level param, not a message role.
+ * const systemCtx = await plugin.getMemoryContext([
+ *   { role: "user", content: "What theme do I like?" },
+ * ]);
+ * const a = await client.messages.create({
+ *   model: "claude-3-5-sonnet-20241022",
+ *   max_tokens: 1024,
+ *   system: `You are a helpful assistant.\n\n${systemCtx}`,
+ *   messages: [{ role: "user", content: "What theme do I like?" }],
+ * });
+ * console.log(a.content[0]); // → "dark mode"
+ *
+ * // 3b. Tool style: let the model call search_memories itself.
+ * const tools = [plugin.memoryTool];
+ * const res = await client.messages.create({
+ *   model: "claude-3-5-sonnet-20241022",
+ *   max_tokens: 1024,
+ *   messages: [{ role: "user", content: "What theme do I like?" }],
+ *   tools,
+ * });
+ * const toolUse = res.content.find((b) => b.type === "tool_use");
+ * if (toolUse && toolUse.name === "search_memories") {
+ *   const { query } = toolUse.input as { query: string };
+ *   const { toToolResult } = await plugin.searchMemories(query);
+ *   const followUp = await client.messages.create({
+ *     model: "claude-3-5-sonnet-20241022",
+ *     max_tokens: 1024,
+ *     messages: [
+ *       { role: "user", content: "What theme do I like?" },
+ *       { role: "assistant", content: res.content },
+ *       { role: "user", content: [toToolResult(toolUse.id)] },
+ *     ],
+ *     tools,
+ *   });
+ *   console.log(followUp.content[0]); // → "dark mode"
+ * }
+ *
+ * // 4. Housekeeping helpers.
+ * console.log(plugin.getMemoryCount()); // number of stored memories
+ * await plugin.clearMemories();         // wipe everything
+ */
+//# sourceMappingURL=anthropic.js.map

memos/_js/adapters/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA2JpC,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAoB;IAC/B,kCAAkC;IACzB,KAAK,CAAQ;IAEL,IAAI,CAOnB;IAEF;;;;;OAKG;IACH,YAAY,KAAY,EAAE,IAAI,GAAgC,EAAE;QAC9D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG;YACV,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,CAAC;YAChD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;YAC/C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;YAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY;YACnC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,GAAG;YACxC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;SACvC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,UAAU;QACZ,OAAO;YACL,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,gEAAgE;gBAChE,mEAAmE;gBACnE,6DAA6D;YAC/D,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,gCAAgC;qBAC9C;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,uCAAuC;wBACpD,OAAO,EAAE,CAAC;qBACX;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,WAAW,CACf,YAAmC;QAEnC,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAC7D,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE;YACzC,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;YACtC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC9B,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,IAAI,GAAmC,EAAE;QAEzC,MAAM,MAAM,GAAiB;YAC3B,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,kBAAkB;SAClD,CAAC;QACF,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvC,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAEtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,OAAO,GACX,QAAQ,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACnC,CAAC,CAAC,6BAA6B,CAAC;QAEpC,OAAO;YACL,KAAK;YACL,QAAQ;YACR,OAAO;YACP,YAAY,EAAE,CAAC,SAAiB,EAA4B,EAAE,CAAC,CAAC;gBAC9D,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,SAAS;gBACtB,OAAO;aACR,CAAC;SACH,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,gBAAgB,CACpB,QAA+B,EAC/B,IAAI,GAAqC,EAAE;QAE3C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;QACjE,IAAI,aAAa,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YACtC,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,kBAAkB;SAClD,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAC9D,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,IAAI,GAAuC,EAAE;QAE7C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE;YAC/C,GAAG,IAAI;YACP,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM;YACvC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS;SACjD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAK,GAAW,CAAC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,0DAA0D;IAClD,OAAO,CAAC,MAAoB;QAClC,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;YAClB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;YAC5B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;YACtB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;YACtB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;SACnC,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAM,GAA0B,EAAE;IAElC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,MAAM,GAAG,IAAI,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAC9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG"}

memos/_js/adapters/base.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Storage adapter base interface.
+ *
+ * Re-exports the {@link StorageAdapter} contract from `types.ts` so that
+ * backend implementations can import from `@memos/adapters/base`.
+ *
+ * @module @memos/adapters/base
+ */
+export type { StorageAdapter } from "../types.js";
+//# sourceMappingURL=base.d.ts.map

memos/_js/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

memos/_js/adapters/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

memos/_js/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":""}

memos/_js/adapters/openai.d.ts

@@ -0,0 +1,264 @@
+/**
+ * MemOS OpenAI Adapter — first-class memory integration for the OpenAI SDK.
+ *
+ * Wraps a MemOS instance and exposes helpers that map cleanly onto the
+ * OpenAI Chat Completions API: a memory-backed function tool, system-prompt
+ * context injection, automatic fact extraction from conversations, and
+ * simple store/forget helpers.
+ *
+ * The adapter has **zero hard dependencies** on the `openai` package. Every
+ * exported message/tool shape is structurally compatible with the
+ * corresponding `openai` types (`ChatCompletionMessageParam`,
+ * `ChatCompletionTool`, `ChatCompletionToolMessageParam`), so they can be
+ * passed straight into `openai.chat.completions.create(...)` with no glue
+ * layer. Install `openai` only if you want to call the model; the adapter
+ * itself only needs MemOS.
+ *
+ * @example
+ * ```ts
+ * import OpenAI from "openai";
+ * import { createOpenAIMemory } from "@mem-os/sdk/openai";
+ *
+ * const { plugin } = await createOpenAIMemory({ dbPath: "./my-app.db" });
+ * const openai = new OpenAI();
+ *
+ * const completion = await openai.chat.completions.create({
+ *   model: "gpt-4o",
+ *   messages: [{ role: "user", content: "What theme do I like?" }],
+ *   tools: [plugin.memoryTool],
+ * });
+ * ```
+ *
+ * @module @memos/adapters/openai
+ */
+import { MemOS } from "../index.js";
+import type { ConversationMessage, CreateMemoryInput, ExtractFactsResult, MemoryNode, MemorySource, MemoryType, MemOSConfig, ScoredMemory } from "../index.js";
+/** Chat message role, compatible with the OpenAI Chat Completions API. */
+export type OpenAIRole = "system" | "user" | "assistant" | "tool";
+/**
+ * Minimal OpenAI-compatible chat message.
+ *
+ * Structurally compatible with `openai.ChatCompletionMessageParam` for the
+ * plain-text cases this adapter produces and consumes.
+ */
+export interface OpenAIChatMessage {
+    role: OpenAIRole;
+    content: string;
+    name?: string;
+    tool_call_id?: string;
+}
+/**
+ * A `tool`-role message returned to the model after a tool call.
+ * Compatible with `openai.ChatCompletionToolMessageParam`.
+ *
+ * Note: `tool_call_id` is left optional here; set it to the id of the
+ * `tool_call` you are responding to before sending.
+ */
+export interface OpenAIToolMessage {
+    role: "tool";
+    content: string;
+    tool_call_id?: string;
+}
+/**
+ * A function-tool definition registrable via the `tools` parameter of
+ * `openai.chat.completions.create`. Compatible with
+ * `openai.ChatCompletionTool`.
+ */
+export interface OpenAIToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        /** A JSON Schema object describing the function parameters. */
+        parameters: Record<string, unknown>;
+    };
+}
+/**
+ * A single memory rendered as a plain JSON object, suitable for returning
+ * as a tool result.
+ */
+export interface OpenAIMemoryEntry {
+    id: string;
+    content: string;
+    summary: string;
+    type: MemoryType;
+    /** Relevance score from the search. */
+    score: number;
+    tags: string[];
+    trustScore: number;
+}
+/** Options for {@link MemOSOpenAIPlugin.searchMemories}. */
+export interface OpenAISearchMemoriesOptions {
+    /** Maximum number of memories to return. @default 5 */
+    limit?: number;
+    /** Restrict results to a memory type. */
+    type?: MemoryType;
+    /** Restrict results to a namespace. */
+    namespace?: string;
+}
+/** Options for {@link MemOSOpenAIPlugin.getMemoryContext}. */
+export interface OpenAIGetMemoryContextOptions {
+    /** Maximum memories to inject. @default 5 */
+    limit?: number;
+    /** Whether to extract & store facts from `messages` first. @default true */
+    extract?: boolean;
+}
+/** Result returned by {@link MemOSOpenAIPlugin.searchMemories}. */
+export interface OpenAIMemorySearchResult {
+    /** The query that was searched. */
+    query: string;
+    /** Ranked memory entries. */
+    memories: OpenAIMemoryEntry[];
+    /** A ready-to-send `tool` message containing the JSON-encoded memories. */
+    toolMessage: OpenAIToolMessage;
+}
+/** Options for {@link MemOSOpenAIPlugin}. */
+export interface MemOSOpenAIPluginOptions {
+    /** Maximum memories to inject into context / return from a search. @default 5 */
+    maxContextMemories?: number;
+    /**
+     * Automatically extract & store facts when `addMessages` or
+     * `getMemoryContext` are called. @default true
+     */
+    autoExtractFacts?: boolean;
+    /** Minimum message length (chars) to consider for fact extraction. @default 15 */
+    minMessageLength?: number;
+    /** Provenance source tag for memories created by this adapter. @default "user_input" */
+    source?: MemorySource;
+    /** Minimum confidence for an extracted fact to be stored. @default 0.6 */
+    minConfidence?: number;
+    /** Namespace to store/search memories in (experimental). @default "default" */
+    namespace?: string;
+}
+/** Configuration for {@link createOpenAIMemory}. */
+export interface OpenAIMemoryConfig extends MemOSConfig {
+    /** Plugin-level options. */
+    plugin?: MemOSOpenAIPluginOptions;
+}
+/** Result of {@link createOpenAIMemory}. */
+export interface CreateOpenAIMemoryResult {
+    /** The initialised MemOS instance. */
+    memos: MemOS;
+    /** The OpenAI memory plugin bound to that instance. */
+    plugin: MemOSOpenAIPlugin;
+}
+/**
+ * OpenAI SDK memory plugin backed by MemOS.
+ *
+ * Wrap an existing MemOS instance, or use {@link createOpenAIMemory} to
+ * construct both in one call. The plugin does not call the OpenAI API
+ * itself — it prepares memories (as tools, tool messages, and system-prompt
+ * strings) for you to feed into your own `openai.chat.completions` calls.
+ */
+export declare class MemOSOpenAIPlugin {
+    /** The wrapped MemOS instance. */
+    readonly memos: MemOS;
+    private readonly opts;
+    /**
+     * Create a new OpenAI memory plugin.
+     *
+     * @param memos - An initialised MemOS instance.
+     * @param opts  - Plugin options. All fields optional with sensible defaults.
+     */
+    constructor(memos: MemOS, opts?: MemOSOpenAIPluginOptions);
+    /**
+     * OpenAI function-tool definition that lets the model search the user's
+     * memory. Pass it via the `tools` parameter of
+     * `openai.chat.completions.create`.
+     *
+     * When the model invokes it, call {@link searchMemories} and return the
+     * `toolMessage` field (after setting `tool_call_id`) as a tool message.
+     */
+    get memoryTool(): OpenAIToolDefinition;
+    /**
+     * Extract facts from a conversation and store them in MemOS.
+     *
+     * Runs MemOS' local rule-based fact extractor over the conversation,
+     * persisting any candidate facts whose confidence meets the configured
+     * `minConfidence` threshold. Near-duplicates are skipped automatically
+     * when embeddings are available.
+     *
+     * @param conversation - The messages to extract facts from.
+     * @returns The extraction result (candidate facts, stored ids, dup count).
+     */
+    addMessages(conversation: ConversationMessage[]): Promise<ExtractFactsResult>;
+    /**
+     * Search memories and format the results for OpenAI tool use.
+     *
+     * @param query - Natural-language search query.
+     * @param opts  - Search options (limit, type, namespace).
+     * @returns An object containing the ranked memory entries and a
+     *   ready-to-send `tool` message (JSON-encoded memories). Set
+     *   `toolMessage.tool_call_id` to the model's `tool_call` id before
+     *   returning it.
+     */
+    searchMemories(query: string, opts?: OpenAISearchMemoriesOptions): Promise<OpenAIMemorySearchResult>;
+    /**
+     * Build a system-prompt string of relevant memories for injection.
+     *
+     * Optionally extracts & stores facts from the recent `messages` first,
+     * then searches MemOS using the most recent user message and returns the
+     * matches as a formatted block ready to prepend to the `system` prompt.
+     *
+     * @param messages - Recent conversation messages.
+     * @param opts     - Context options (limit, whether to extract).
+     * @returns A memory-context string, or `""` if nothing relevant was found.
+     */
+    getMemoryContext(messages: ConversationMessage[], opts?: OpenAIGetMemoryContextOptions): Promise<string>;
+    /**
+     * Manually store a memory.
+     *
+     * @param content - Text to remember.
+     * @param opts    - Additional memory parameters (type, tags, importance…).
+     * @returns The created memory node.
+     */
+    remember(content: string, opts?: Omit<CreateMemoryInput, "content">): Promise<MemoryNode>;
+    /**
+     * Search for relevant memories.
+     *
+     * @param query - Search query.
+     * @param limit - Maximum number of results. @default 5
+     * @returns Scored memory nodes.
+     */
+    recall(query: string, limit?: number): Promise<ScoredMemory[]>;
+    /**
+     * Permanently forget a memory.
+     *
+     * @param memoryId - ID of the memory to delete.
+     * @returns `true` if the memory existed and was deleted.
+     */
+    forget(memoryId: string): Promise<boolean>;
+    /**
+     * Remove all memories and edges from the underlying MemOS instance.
+     *
+     * This is destructive and cannot be undone.
+     */
+    clearMemories(): Promise<void>;
+    /**
+     * Return the total number of stored memories.
+     *
+     * @returns The current memory count.
+     */
+    getMemoryCount(): number;
+    /** Convert a scored memory into a JSON-friendly entry. */
+    private toEntry;
+}
+/**
+ * Create a MemOS instance and an OpenAI memory plugin in one call.
+ *
+ * The MemOS instance is created with `config`, initialised, and wrapped in a
+ * {@link MemOSOpenAIPlugin}. Plugin-level options go under `config.plugin`.
+ *
+ * @param config - MemOS config plus optional `plugin` options.
+ * @returns The initialised `memos` instance and bound `plugin`.
+ *
+ * @example
+ * ```ts
+ * const { memos, plugin } = await createOpenAIMemory({
+ *   dbPath: "./my-app.db",
+ *   plugin: { maxContextMemories: 8 },
+ * });
+ * ```
+ */
+export declare function createOpenAIMemory(config?: OpenAIMemoryConfig): Promise<CreateOpenAIMemoryResult>;
+//# sourceMappingURL=openai.d.ts.map

memos/_js/adapters/openai.d.ts.map

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