@mysten-incubation/memwal 0.0.1-dev.0

package/dist/ai/middleware.js

@@ -0,0 +1,145 @@
+/**
+ * MemWal AI SDK Integration — withMemWal Middleware
+ *
+ * Wraps any AI SDK model with automatic memory management.
+ *
+ * @example
+ * ```typescript
+ * import { generateText } from "ai"
+ * import { withMemWal } from "@mysten-incubation/memwal/ai"
+ * import { openai } from "@ai-sdk/openai"
+ *
+ * const model = withMemWal(openai("gpt-4o"), {
+ *   key: process.env.MEMWAL_KEY,  // Ed25519 delegate key (hex)
+ * })
+ *
+ * const result = await generateText({
+ *   model,
+ *   messages: [{ role: "user", content: "What do you know about me?" }]
+ * })
+ * // → Automatically searches memories, injects context, saves new facts
+ * ```
+ */
+import { wrapLanguageModel } from "ai";
+import { MemWal } from "../memwal.js";
+// ============================================================
+// Middleware
+// ============================================================
+/**
+ * Wrap an AI SDK model with MemWal memory management
+ *
+ * BEFORE each LLM call:
+ * - Uses the last user message as a search query
+ * - Recalls relevant memories (server: search → download → decrypt)
+ * - Injects relevant memories into the system prompt
+ *
+ * AFTER each LLM call:
+ * - Analyzes and saves important facts (server: LLM extract → embed → encrypt → Walrus → store)
+ * - Fire-and-forget — does not block the response
+ */
+export function withMemWal(model, options) {
+    const memwal = MemWal.create(options);
+    const maxMemories = options.maxMemories ?? 5;
+    const autoSave = options.autoSave ?? true;
+    const minRelevance = options.minRelevance ?? 0.3;
+    const debug = options.debug ?? false;
+    const log = debug
+        ? (...args) => console.warn("[MemWal]", ...args)
+        : () => { };
+    return wrapLanguageModel({
+        model,
+        middleware: {
+            specificationVersion: 'v3', // Required by ai SDK v6+; ignored by v4/v5
+            // ============================================================
+            // BEFORE: Search memories + inject into prompt
+            // ============================================================
+            transformParams: async ({ params }) => {
+                try {
+                    const lastUserMessage = findLastUserMessage(params.prompt);
+                    if (!lastUserMessage)
+                        return params;
+                    const recallResult = await memwal.recall(lastUserMessage, maxMemories);
+                    // Filter by minimum relevance (distance < 1 - minRelevance)
+                    const relevant = recallResult.results.filter((m) => (1 - m.distance) >= minRelevance);
+                    if (relevant.length === 0)
+                        return params;
+                    const memoryContext = formatMemories(relevant);
+                    const enrichedPrompt = injectMemoryContext(params.prompt, memoryContext);
+                    log(`🔍 Found ${relevant.length} relevant memories`);
+                    return { ...params, prompt: enrichedPrompt };
+                }
+                catch (error) {
+                    log("Memory search failed:", error);
+                    return params;
+                }
+            },
+            // ============================================================
+            // AFTER: Analyze and save important facts (fire-and-forget)
+            // ============================================================
+            wrapGenerate: async ({ doGenerate, params }) => {
+                const result = await doGenerate();
+                if (autoSave) {
+                    const userMessage = findLastUserMessage(params.prompt);
+                    if (userMessage) {
+                        memwal.analyze(userMessage).catch((err) => log("Auto-save failed:", err));
+                    }
+                }
+                return result;
+            },
+            // Stream variant — needed for streamText()
+            wrapStream: async ({ doStream, params }) => {
+                const result = await doStream();
+                if (autoSave) {
+                    const userMessage = findLastUserMessage(params.prompt);
+                    if (userMessage) {
+                        memwal.analyze(userMessage).catch((err) => log("Auto-save failed:", err));
+                    }
+                }
+                return result;
+            },
+        },
+    });
+}
+// ============================================================
+// Helpers
+// ============================================================
+function findLastUserMessage(prompt) {
+    if (!Array.isArray(prompt))
+        return null;
+    for (let i = prompt.length - 1; i >= 0; i--) {
+        const msg = prompt[i];
+        if (msg.role === "user") {
+            if (typeof msg.content === "string")
+                return msg.content;
+            if (Array.isArray(msg.content)) {
+                const textParts = msg.content
+                    .filter((p) => p.type === "text")
+                    .map((p) => p.text);
+                return textParts.join(" ") || null;
+            }
+        }
+    }
+    return null;
+}
+function formatMemories(memories) {
+    const lines = memories.map((m) => `- ${m.text} (relevance: ${(1 - m.distance).toFixed(2)})`);
+    return `[Memory Context] The following are known facts about this user from their personal memory store. Use these facts to answer the user's question:\n${lines.join("\n")}`;
+}
+function injectMemoryContext(prompt, memoryContext) {
+    if (!Array.isArray(prompt))
+        return prompt;
+    // Insert memory as a separate system message right before the last user message
+    // This ensures the LLM sees it prominently, not buried in a long system prompt
+    const lastUserIndex = prompt.reduce((idx, m, i) => (m.role === "user" ? i : idx), -1);
+    if (lastUserIndex > 0) {
+        const result = [...prompt];
+        result.splice(lastUserIndex, 0, {
+            role: "system",
+            content: memoryContext,
+        });
+        return result;
+    }
+    // Fallback: prepend as system message
+    return [{ role: "system", content: memoryContext }, ...prompt];
+}
+//# sourceMappingURL=middleware.js.map

package/dist/ai/middleware.js.map

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

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG7E,YAAY,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,GAChB,MAAM,YAAY,CAAC"}

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,qDAAqD;AACrD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @mysten-incubation/memwal
+ *
+ * Privacy-first AI memory SDK.
+ * Ed25519 delegate key auth + server-side TEE processing.
+ *
+ * This is the default entry point — MemWal client + types only.
+ * Does NOT import account.js (which requires @mysten/sui).
+ *
+ * For account management, import from "@mysten-incubation/memwal/account".
+ * For manual (client-side SEAL + Walrus), import from "@mysten-incubation/memwal/manual".
+ */
+export { MemWal } from "./memwal.js";
+export { delegateKeyToSuiAddress, delegateKeyToPublicKey } from "./utils.js";
+export type { MemWalConfig, RememberResult, RecallResult, RecallMemory, EmbedResult, AnalyzeResult, AnalyzedFact, HealthResult, RestoreResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG7E,YAAY,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @mysten-incubation/memwal
+ *
+ * Privacy-first AI memory SDK.
+ * Ed25519 delegate key auth + server-side TEE processing.
+ *
+ * This is the default entry point — MemWal client + types only.
+ * Does NOT import account.js (which requires @mysten/sui).
+ *
+ * For account management, import from "@mysten-incubation/memwal/account".
+ * For manual (client-side SEAL + Walrus), import from "@mysten-incubation/memwal/manual".
+ */
+// Core client (server-mode: server handles SEAL + Walrus + embedding)
+export { MemWal } from "./memwal.js";
+// Delegate key utilities (no @mysten/sui dependency)
+export { delegateKeyToSuiAddress, delegateKeyToPublicKey } from "./utils.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;;;;;;;;;;;GAWG;AAEH,sEAAsE;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,qDAAqD;AACrD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/manual-entry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @mysten-incubation/memwal/manual
+ *
+ * Manual (client-side) mode entry point.
+ * Requires: @mysten/seal, @mysten/walrus, @mysten/sui
+ *
+ * Usage:
+ *   import { MemWalManual } from "@mysten-incubation/memwal/manual";
+ */
+export { MemWalManual } from "./manual.js";
+export type { MemWalManualConfig, WalletSigner, RememberManualOptions, RememberManualResult, RecallManualOptions, RecallManualResult, RecallManualHit, RecallManualMemory, } from "./types.js";
+//# sourceMappingURL=manual-entry.d.ts.map

package/dist/manual-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-entry.d.ts","sourceRoot":"","sources":["../src/manual-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,YAAY,EACR,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACrB,MAAM,YAAY,CAAC"}

package/dist/manual-entry.js

@@ -0,0 +1,11 @@
+/**
+ * @mysten-incubation/memwal/manual
+ *
+ * Manual (client-side) mode entry point.
+ * Requires: @mysten/seal, @mysten/walrus, @mysten/sui
+ *
+ * Usage:
+ *   import { MemWalManual } from "@mysten-incubation/memwal/manual";
+ */
+export { MemWalManual } from "./manual.js";
+//# sourceMappingURL=manual-entry.js.map

package/dist/manual-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-entry.js","sourceRoot":"","sources":["../src/manual-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/manual.d.ts

@@ -0,0 +1,97 @@
+/**
+ * memwal — Manual Client (Full Client-Side)
+ *
+ * User-side flow where the SDK handles everything locally:
+ * - SEAL encrypt/decrypt via @mysten/seal (user's own Sui wallet)
+ * - Walrus upload/download via @mysten/walrus
+ * - Embedding via OpenAI-compatible API (user's own key)
+ * - Vector registration via MemWal server (Ed25519 signed)
+ *
+ * @example
+ * ```typescript
+ * import { MemWalManual } from "@mysten-incubation/memwal"
+ *
+ * const memwal = MemWalManual.create({
+ *     key: process.env.MEMWAL_DELEGATE_KEY!,      // Ed25519 delegate key
+ *     suiPrivateKey: process.env.SUI_PRIVATE_KEY!, // suiprivkey1... for SEAL + Walrus
+ *     embeddingApiKey: process.env.OPENAI_API_KEY!,
+ *     packageId: "0x...",
+ *     accountId: "0x...",
+ * })
+ *
+ * // Remember — all client-side: embed → SEAL encrypt → Walrus upload → register
+ * await memwal.rememberManual("I'm allergic to peanuts")
+ *
+ * // Recall — all client-side: embed → search → download → SEAL decrypt
+ * const result = await memwal.recallManual("food allergies")
+ * ```
+ */
+import type { MemWalManualConfig, RememberManualResult, RecallManualResult, RestoreResult } from "./types.js";
+export declare class MemWalManual {
+    private delegatePrivateKey;
+    private delegatePublicKey;
+    private serverUrl;
+    private config;
+    private walletSigner;
+    private namespace;
+    private _suiClient;
+    private _sealClient;
+    private _walrusClient;
+    private _keypair;
+    private constructor();
+    /**
+     * Create a new MemWalManual client.
+     *
+     * Requires peer dependencies: @mysten/sui, @mysten/seal, @mysten/walrus
+     *
+     * @param config.key - Ed25519 delegate private key (hex) for server auth
+     * @param config.suiPrivateKey - Sui private key (bech32) for SEAL + Walrus (OR walletSigner)
+     * @param config.walletSigner - Connected wallet signer from dapp-kit (OR suiPrivateKey)
+     * @param config.embeddingApiKey - OpenAI/OpenRouter API key for embeddings
+     * @param config.packageId - MemWal contract package ID
+     * @param config.accountId - MemWalAccount object ID (for SEAL seal_approve)
+     */
+    static create(config: MemWalManualConfig): MemWalManual;
+    /** Whether this client uses a connected wallet signer (vs raw keypair) */
+    get isWalletMode(): boolean;
+    private getSuiClient;
+    private getKeypair;
+    /** Get the owner address — from wallet signer or derived from keypair */
+    private getOwnerAddress;
+    /** Sign and execute a transaction — via wallet popup or programmatic keypair */
+    private signAndExecuteTransaction;
+    private getSealClient;
+    private getWalrusClient;
+    /**
+     * Remember (hybrid flow):
+     * 1. Embed text (OpenAI/OpenRouter)
+     * 2. SEAL encrypt locally (no wallet signature needed)
+     * 3. Send {encrypted_data, vector} to server — server handles Walrus upload relay
+     */
+    rememberManual(text: string, namespace?: string): Promise<RememberManualResult>;
+    /**
+     * Recall (manual/full client-side):
+     * 1. Embed query (OpenAI)
+     * 2. Search server for matching vectors
+     * 3. Download blobs from Walrus
+     * 4. SEAL decrypt each blob
+     */
+    recallManual(query: string, limit?: number, namespace?: string): Promise<RecallManualResult>;
+    /** Create a signer adapter — either from wallet or keypair */
+    private createSigner;
+    private embed;
+    private sealEncrypt;
+    private walrusUpload;
+    private walrusDownload;
+    private getDelegatePublicKey;
+    private signedRequest;
+    /**
+     * Restore a namespace — server downloads all blobs from Walrus,
+     * decrypts with delegate key, re-embeds, and re-indexes.
+     *
+     * @param namespace - Namespace to restore
+     * @returns RestoreResult with count of restored entries
+     */
+    restore(namespace: string, limit?: number): Promise<RestoreResult>;
+}
+//# sourceMappingURL=manual.d.ts.map

package/dist/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../src/manual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EACR,kBAAkB,EAElB,oBAAoB,EACpB,kBAAkB,EAElB,aAAa,EAChB,MAAM,YAAY,CAAC;AAuBpB,qBAAa,YAAY;IACrB,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,SAAS,CAAS;IAG1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAa;IAE7B,OAAO;IAcP;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY;IAIvD,0EAA0E;IAC1E,IAAI,YAAY,IAAI,OAAO,CAE1B;YASa,YAAY;YA8BZ,UAAU;IAaxB,yEAAyE;YAC3D,eAAe;IAQ7B,gFAAgF;YAClE,yBAAyB;YAYzB,aAAa;YAyBb,eAAe;IAyB7B;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqBrF;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2HtG,8DAA8D;YAChD,YAAY;YAuBZ,KAAK;YAsCL,WAAW;YAkBX,YAAY;YAiCZ,cAAc;YAoBd,oBAAoB;YAQpB,aAAa;IAyC3B;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CAM/E"}