@mneme-ai/core 1.72.0 → 1.74.0

package/dist/permeate/transport_menu.js

@@ -0,0 +1,96 @@
+/**
+ * v1.74.0 -- PERMEATE P4: CROSS-MACHINE TRANSPORT MENU.
+ *
+ * Answers the user's question: "How do I move a soul prompt across
+ * two computers?" Returns 4 ranked options with concrete steps.
+ */
+export const TRANSPORT_OPTIONS = [
+    {
+        method: "clipboard-relay",
+        title: "Copy-paste via clipboard (messenger / email / Slack)",
+        whatItDoes: "Move soul prompt as plain text from machine A to machine B using any chat / email / Slack DM.",
+        steps: [
+            "Machine A: AI runs mneme.genesplice.transmit -> outputs ~500-token soul prompt",
+            "Machine A: highlight + copy the soul prompt",
+            "Machine A: paste into your messenger of choice (Telegram / Slack / Email to yourself)",
+            "Machine B: open the message, copy the soul prompt",
+            "Machine B: paste into ChatGPT / Gemini / Claude.ai chat input",
+            "Receiving AI replies: 'Resumed from claude-opus-4-7...' — context transferred",
+        ],
+        pros: ["Works on every OS", "No accounts needed", "Plain text, future-proof"],
+        friction: 1,
+    },
+    {
+        method: "gist",
+        title: "GitHub Gist (user-owned cloud)",
+        whatItDoes: "Upload soul prompt to your own GitHub Gist; share URL with yourself; receiving AI fetches it.",
+        steps: [
+            "Machine A: AI runs mneme.genesplice.transmit with includeGistPackage=true",
+            "Machine A: copy the wrapped content; open https://gist.github.com/new",
+            "Machine A: paste content, set visibility to 'secret', click Create gist",
+            "Machine A: copy the gist URL",
+            "Machine B: tell the AI: 'Resume Mneme soul from this gist: <URL>'",
+            "Receiving AI fetches the URL, ingests the soul, continues",
+        ],
+        pros: ["Persistent URL works across all your machines", "Secret gist is private but accessible by you", "Version history if you create new gist revisions"],
+        friction: 2,
+    },
+    {
+        method: "wanderer-mwt",
+        title: "Wanderer .mwt portable bundle (USB / email attachment)",
+        whatItDoes: "Pack entire Mneme state (capsules, vaccines, genome) into a single signed .mwt file; transport via USB / email attachment / cloud storage.",
+        steps: [
+            "Machine A: AI runs mneme wanderer pack -> .mwt file",
+            "Move the .mwt to machine B (USB / email / Dropbox / WhatsApp file)",
+            "Machine B: AI runs mneme wanderer unpack <file>.mwt",
+            "Machine B: Mneme state restored; capsules + vaccines + genome merged",
+            "Both machines now share full Mneme history; cross-vendor handover works locally on each",
+        ],
+        pros: ["Full state transfer (not just current session)", "HMAC-signed = tamper-evident", "Works offline"],
+        friction: 3,
+    },
+    {
+        method: "qr-code-svg",
+        title: "QR code (laptop -> phone -> any AI app)",
+        whatItDoes: "Encode the soul prompt as a QR code; scan with phone; paste into a mobile AI app or share back.",
+        steps: [
+            "Machine A: AI runs mneme.permeate.qr-encode <soul-prompt>",
+            "Machine A: display the SVG QR code on screen",
+            "Machine B (phone): scan QR with camera app",
+            "Phone: copy the decoded text",
+            "Phone: paste into ChatGPT mobile app / Gemini app",
+            "Receiving AI replies with resumed context",
+        ],
+        pros: ["No accounts needed", "Works between laptop + phone instantly", "No cloud / network needed"],
+        friction: 2,
+    },
+];
+export function recommendTransport(opts = {}) {
+    if (opts.laptopToPhone) {
+        return {
+            recommended: "qr-code-svg",
+            rationale: "Laptop->phone transfer; QR is instant + no accounts needed.",
+            rankedOptions: [...TRANSPORT_OPTIONS].sort((a, b) => a.friction - b.friction),
+        };
+    }
+    if (opts.preferOffline) {
+        return {
+            recommended: "wanderer-mwt",
+            rationale: "Offline preference; .mwt bundle works over USB without any network.",
+            rankedOptions: [...TRANSPORT_OPTIONS].sort((a, b) => a.friction - b.friction),
+        };
+    }
+    if (opts.hasGithubAccount) {
+        return {
+            recommended: "gist",
+            rationale: "GitHub account present; Gist gives persistent URL across all machines.",
+            rankedOptions: [...TRANSPORT_OPTIONS].sort((a, b) => a.friction - b.friction),
+        };
+    }
+    return {
+        recommended: "clipboard-relay",
+        rationale: "No account / setup required. Works for everyone via any messenger.",
+        rankedOptions: [...TRANSPORT_OPTIONS].sort((a, b) => a.friction - b.friction),
+    };
+}
+//# sourceMappingURL=transport_menu.js.map

package/dist/permeate/transport_menu.js.map

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

package/dist/permeate/userscript_generator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * v1.74.0 -- PERMEATE P1: USERSCRIPT GENERATOR.
+ *
+ * Routes around Chrome Web Store / Firefox Addons / Safari approval
+ * by emitting a Tampermonkey/Greasemonkey/Violentmonkey-compatible
+ * userscript. User installs the userscript manager once (free,
+ * single click) and the Mneme userscript adds a floating "💉
+ * Inject Mneme Soul" button to ChatGPT / Gemini / Claude.ai /
+ * Copilot / DeepSeek chats.
+ *
+ * The userscript is PURE BROWSER JS -- no Node, no HTTP, no
+ * backend. Reads soul prompt from clipboard, finds the chat input
+ * element via known selectors, injects + submits.
+ *
+ * Selectors per site (kept conservative; fallbacks included):
+ *   ChatGPT   div#prompt-textarea / textarea
+ *   Gemini    rich-textarea / textarea
+ *   Claude.ai div[contenteditable="true"]
+ *   Copilot   textarea[aria-label]
+ *   DeepSeek  textarea#chat-input
+ */
+export interface UserscriptOptions {
+    /** Mneme version stamped into the script header. */
+    mnemeVersion: string;
+    /** Optional Mneme HTTP bridge URL for auto-fetch (v1.72 D4). When
+     *  set, the userscript also adds a "Fetch from local Mneme" button
+     *  that hits the bridge instead of requiring clipboard paste. */
+    bridgeUrl?: string;
+    /** Bearer token for the bridge (only used when bridgeUrl is set). */
+    bridgeToken?: string;
+}
+export interface UserscriptArtifact {
+    /** Full .user.js file content. User saves this and Tampermonkey
+     *  asks to install. */
+    content: string;
+    /** Filename suggestion. */
+    filename: string;
+    /** Direct-install URL guidance (raw file from gist, etc). */
+    installNote: string;
+}
+export declare function generateUserscript(opts: UserscriptOptions): UserscriptArtifact;
+//# sourceMappingURL=userscript_generator.d.ts.map

package/dist/permeate/userscript_generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userscript_generator.d.ts","sourceRoot":"","sources":["../../src/permeate/userscript_generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB;;qEAEiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC;2BACuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,kBAAkB,CAsJ9E"}

package/dist/permeate/userscript_generator.js

@@ -0,0 +1,170 @@
+/**
+ * v1.74.0 -- PERMEATE P1: USERSCRIPT GENERATOR.
+ *
+ * Routes around Chrome Web Store / Firefox Addons / Safari approval
+ * by emitting a Tampermonkey/Greasemonkey/Violentmonkey-compatible
+ * userscript. User installs the userscript manager once (free,
+ * single click) and the Mneme userscript adds a floating "💉
+ * Inject Mneme Soul" button to ChatGPT / Gemini / Claude.ai /
+ * Copilot / DeepSeek chats.
+ *
+ * The userscript is PURE BROWSER JS -- no Node, no HTTP, no
+ * backend. Reads soul prompt from clipboard, finds the chat input
+ * element via known selectors, injects + submits.
+ *
+ * Selectors per site (kept conservative; fallbacks included):
+ *   ChatGPT   div#prompt-textarea / textarea
+ *   Gemini    rich-textarea / textarea
+ *   Claude.ai div[contenteditable="true"]
+ *   Copilot   textarea[aria-label]
+ *   DeepSeek  textarea#chat-input
+ */
+export function generateUserscript(opts) {
+    const header = [
+        "// ==UserScript==",
+        "// @name         Mneme Soul Injector",
+        "// @namespace    https://github.com/patsa2561-art/mneme-ai",
+        `// @version      ${opts.mnemeVersion}`,
+        "// @description  Inject Mneme cross-vendor brain (soul prompt) into ChatGPT, Gemini, Claude.ai, Copilot, DeepSeek. No store approval needed.",
+        "// @author       Mneme",
+        "// @match        https://chatgpt.com/*",
+        "// @match        https://chat.openai.com/*",
+        "// @match        https://gemini.google.com/*",
+        "// @match        https://aistudio.google.com/*",
+        "// @match        https://claude.ai/*",
+        "// @match        https://copilot.microsoft.com/*",
+        "// @match        https://chat.deepseek.com/*",
+        "// @match        https://chat.qwenlm.ai/*",
+        "// @grant        GM_setClipboard",
+        "// @grant        GM_xmlhttpRequest",
+        "// @run-at       document-idle",
+        "// ==/UserScript==",
+    ].join("\n");
+    const bridgeBlock = opts.bridgeUrl
+        ? `
+// ── BRIDGE FETCH (when local Mneme HTTP bridge is reachable) ─────
+const BRIDGE_URL = ${JSON.stringify(opts.bridgeUrl)};
+const BRIDGE_TOKEN = ${JSON.stringify(opts.bridgeToken ?? "")};
+async function fetchSoulFromBridge() {
+  try {
+    const res = await fetch(BRIDGE_URL + "/v1/health", {
+      headers: BRIDGE_TOKEN ? { Authorization: "Bearer " + BRIDGE_TOKEN } : {}
+    });
+    if (!res.ok) return null;
+    // The user must transmit the soul prompt server-side; bridge
+    // doesn't yet have a /v1/soul GET. Future: add endpoint.
+    return null;
+  } catch { return null; }
+}
+`
+        : "";
+    const body = `
+(function() {
+  'use strict';
+
+  const SITE = (() => {
+    const h = location.hostname;
+    if (h.includes('chatgpt.com') || h.includes('openai.com')) return 'chatgpt';
+    if (h.includes('gemini.google.com') || h.includes('aistudio.google.com')) return 'gemini';
+    if (h.includes('claude.ai')) return 'claude-ai';
+    if (h.includes('copilot.microsoft.com')) return 'copilot';
+    if (h.includes('deepseek.com')) return 'deepseek';
+    if (h.includes('qwenlm.ai')) return 'qwen';
+    return 'unknown';
+  })();
+
+  // Selector ladder per site -- try each, use the first that matches.
+  const SELECTORS = {
+    chatgpt:   ['div#prompt-textarea', 'textarea[data-id="root"]', 'textarea#prompt-textarea', 'div[contenteditable="true"]'],
+    gemini:    ['rich-textarea div[contenteditable="true"]', 'rich-textarea', 'textarea'],
+    'claude-ai':['div[contenteditable="true"]', 'div[data-placeholder]'],
+    copilot:   ['textarea[aria-label*="Ask"]', 'textarea'],
+    deepseek:  ['textarea#chat-input', 'textarea'],
+    qwen:      ['textarea', 'div[contenteditable="true"]'],
+    unknown:   ['textarea', 'div[contenteditable="true"]'],
+  };
+
+  function findInput() {
+    const candidates = SELECTORS[SITE] || SELECTORS.unknown;
+    for (const sel of candidates) {
+      const el = document.querySelector(sel);
+      if (el) return el;
+    }
+    return null;
+  }
+
+  function injectText(el, text) {
+    if (el.tagName === 'TEXTAREA' || el.tagName === 'INPUT') {
+      const setter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')?.set
+                  || Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')?.set;
+      if (setter) setter.call(el, text);
+      else el.value = text;
+      el.dispatchEvent(new Event('input', { bubbles: true }));
+    } else {
+      // contenteditable -- use execCommand for compat with React-controlled fields
+      el.focus();
+      try {
+        document.execCommand('selectAll', false);
+        document.execCommand('insertText', false, text);
+      } catch {
+        el.textContent = text;
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+      }
+    }
+  }
+
+  function makeButton() {
+    const btn = document.createElement('button');
+    btn.textContent = '💉 Inject Mneme Soul';
+    btn.style.cssText = \`
+      position: fixed; top: 12px; right: 12px; z-index: 99999;
+      background: linear-gradient(135deg,#7c3aed,#ec4899);
+      color: #fff; font-weight: 600; border: 0; border-radius: 8px;
+      padding: 8px 14px; cursor: pointer;
+      font-family: ui-sans-serif, system-ui, sans-serif;
+      box-shadow: 0 4px 14px rgba(124,58,237,0.4);
+      font-size: 13px;
+    \`;
+    btn.title = 'Paste a Mneme soul prompt to inject into the chat input';
+    btn.onclick = async () => {
+      let soul;
+      try { soul = await navigator.clipboard.readText(); }
+      catch { soul = prompt('Paste your Mneme soul prompt:'); }
+      if (!soul || !soul.includes('MNEME SOUL PROMPT')) {
+        alert('That does not look like a Mneme soul prompt. Copy the full text starting with "# 🧬 MNEME SOUL PROMPT".');
+        return;
+      }
+      const el = findInput();
+      if (!el) {
+        alert('Could not find the chat input on this page. The site UI may have changed.');
+        return;
+      }
+      injectText(el, soul);
+      btn.textContent = '✓ Soul injected';
+      setTimeout(() => { btn.textContent = '💉 Inject Mneme Soul'; }, 2500);
+    };
+    return btn;
+  }
+
+  function ensureButton() {
+    if (document.getElementById('mneme-inject-btn')) return;
+    const btn = makeButton();
+    btn.id = 'mneme-inject-btn';
+    document.body.appendChild(btn);
+  }
+
+  // React-rendered sites re-mount; observe DOM and re-attach if needed.
+  const obs = new MutationObserver(() => ensureButton());
+  obs.observe(document.body, { childList: true, subtree: false });
+  ensureButton();
+  console.log('[Mneme] Soul injector ready -- site=' + SITE);
+})();
+`.trim();
+    const content = `${header}\n\n${bridgeBlock}${body}\n`;
+    return {
+        content,
+        filename: `mneme-soul-injector-${opts.mnemeVersion}.user.js`,
+        installNote: `Install: (1) Add the Tampermonkey/Violentmonkey extension to your browser. (2) Click the .user.js file -- Tampermonkey will prompt to install. (3) Open ChatGPT/Gemini/Claude.ai -- the 💉 button appears top-right. (4) Copy a Mneme soul prompt, click the button, soul is injected into the chat.`,
+    };
+}
+//# sourceMappingURL=userscript_generator.js.map

package/dist/permeate/userscript_generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userscript_generator.js","sourceRoot":"","sources":["../../src/permeate/userscript_generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAuBH,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,MAAM,MAAM,GAAG;QACb,mBAAmB;QACnB,sCAAsC;QACtC,4DAA4D;QAC5D,oBAAoB,IAAI,CAAC,YAAY,EAAE;QACvC,8IAA8I;QAC9I,wBAAwB;QACxB,wCAAwC;QACxC,4CAA4C;QAC5C,8CAA8C;QAC9C,gDAAgD;QAChD,sCAAsC;QACtC,kDAAkD;QAClD,8CAA8C;QAC9C,2CAA2C;QAC3C,kCAAkC;QAClC,oCAAoC;QACpC,gCAAgC;QAChC,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS;QAChC,CAAC,CAAC;;qBAEe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;uBAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;;;;;;;;;;;;CAY5D;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqGd,CAAC,IAAI,EAAE,CAAC;IAEP,MAAM,OAAO,GAAG,GAAG,MAAM,OAAO,WAAW,GAAG,IAAI,IAAI,CAAC;IACvD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,uBAAuB,IAAI,CAAC,YAAY,UAAU;QAC5D,WAAW,EAAE,sSAAsS;KACpT,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/core",
-  "version": "1.72.0",
+  "version": "1.74.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",