@bubstack/moe-memory 0.1.0

package/.mcp.json

@@ -0,0 +1,18 @@
+{
+  "mcpServers": {
+    "moe-memory": {
+      "command": "node",
+      "args": ["./dist/cli.js", "mcp-server"],
+      "cwd": ".",
+      "env_vars": [
+        "MOE_MEMORY_CONFIG_DIR",
+        "MOE_MEMORY_DB_PATH",
+        "MOE_MEMORY_JOURNAL_PATH",
+        "MOE_MEMORY_MODEL_CACHE_DIR",
+        "MOE_DATA_DIR",
+        "XDG_CONFIG_HOME",
+        "CONVERSATION_SEARCH_EXCLUDE_PROJECTS"
+      ]
+    }
+  }
+}

package/README.md

@@ -0,0 +1,47 @@
+# Moe Memory
+
+Memory provides semantic recall over coding-agent conversations and deliberate
+journal entries. One CLI owns indexing, search, diagnostics, and the MCP server.
+
+## CLI
+
+```sh
+moe-memory sync
+moe-memory index --cleanup
+moe-memory search "authentication decision"
+moe-memory journal search "release lesson"
+moe-memory stats
+moe-memory mcp-server
+```
+
+Run `moe-memory --help` or `moe-memory <command> --help` for details.
+
+## Harness integration
+
+The Claude Code and Codex plugin paths feed the same index. Claude Code sessions
+are read from its configured transcript directories; Codex sessions are read
+from `~/.codex/sessions` unless `CODEX_HOME` selects another profile.
+
+Data lives under the Moe memory directory selected by the platform, or under
+`$MOE_DATA_DIR/memory` when `MOE_DATA_DIR` is set. Journal roots can be
+overridden with `MOE_MEMORY_JOURNAL_PATH`.
+
+## Layout
+
+- `src/` — CLI commands, indexing, search, MCP, and storage.
+- `src/journal/` — journal parsing and indexing.
+- `hooks/` — sync integration.
+- `skills/`, `agents/`, `prompts/` — agent-facing surfaces.
+- `mint/` — plugin generation configuration.
+
+## Development
+
+```sh
+pnpm --filter @bubstack/moe-memory build
+pnpm --filter @bubstack/moe-memory typecheck
+pnpm --filter @bubstack/moe-memory test
+pnpm --filter @bubstack/moe-memory test:model
+```
+
+`test:model` downloads and runs an embedding model and is intentionally outside
+the normal Node-only gate.

package/agents/search-conversations.md

@@ -0,0 +1,171 @@
+---
+# Folded scalar, not a bare string, because of the colon in "prior experience:".
+# As a plain scalar YAML read everything up to that colon as a KEY and the rest
+# as a nested mapping, which is a parse error (BLOCK_AS_IMPLICIT_KEY) — this
+# frontmatter did not parse at all. Found by wiring moe-mint: it was the only
+# invalid block of 62 across every content package. The text is unchanged; a
+# folded scalar joins its lines with single spaces.
+description: >-
+  Use when searching Claude Code and Codex history for information learned in
+  past conversations or prior experience: decisions, patterns, solutions,
+  pitfalls, project context, repeated workflows, or lessons from similar work.
+capabilities: ["semantic-search", "conversation-synthesis", "historical-context", "pattern-recognition", "decision-archaeology"]
+model: haiku
+tools: Read, mcp__plugin_moe-memory_moe-memory__search_conversations, mcp__plugin_moe-memory_moe-memory__read_conversation
+---
+
+# Conversation Search Agent
+
+You are searching historical Claude Code and Codex conversations for relevant context.
+
+**Your task:**
+1. Search conversations using the `search_conversations` tool
+2. Read the top 2-5 most relevant results using the `read_conversation` tool
+3. Synthesize key findings (max 1000 words)
+4. Return synthesis + source pointers (so main agent can dig deeper)
+
+## How to Search
+
+Use the MCP tool `search_conversations`:
+```
+mcp__plugin_moe-memory_moe-memory__search_conversations
+  query: "your search query"
+  mode: "both"  # or "vector" or "text"
+  limit: 10
+```
+
+This returns:
+- Project name and date
+- Conversation summary (AI-generated)
+- Matched exchange with similarity score
+- File path and line numbers
+
+Read the full conversations for top 2-5 results using `read_conversation` to get complete context.
+
+## What to Look For
+
+When analyzing conversations, focus on:
+- What was the problem or question?
+- What solution was chosen and why?
+- What alternatives were considered and rejected?
+- What relevant context, constraints, or lessons were learned?
+- Any gotchas, edge cases, or lessons learned?
+- Relevant code patterns, APIs, or approaches used
+- Architectural decisions and rationale
+
+## Output Format
+
+**Required structure:**
+
+### Summary
+[Synthesize findings in 200-1000 words. Adapt structure to what you found:
+- Quick answer? 1-2 paragraphs.
+- Complex topic? Use sections (Context/Solution/Rationale/Lessons/Code).
+- Multiple approaches? Compare and contrast.
+- Historical evolution? Show progression chronologically.
+
+Focus on actionable insights for the current task.]
+
+### Sources
+[List ALL conversations examined, in order of relevance:]
+
+**1. [project-name, YYYY-MM-DD]** - X% match
+Conversation summary: [One sentence - what was this conversation about?]
+File: ~/.config/moe/memory/conversation-archive/.../uuid.jsonl:start-end
+Status: [Read in detail | Reviewed summary only | Skimmed]
+
+**2. [project-name, YYYY-MM-DD]** - X% match
+Conversation summary: ...
+File: ...
+Status: ...
+
+[Continue for all examined sources...]
+
+### For Follow-Up
+
+Main agent can:
+- Ask you to dig deeper into specific source (#1, #2, etc.)
+- Ask you to read adjacent exchanges in a conversation
+- Ask you to search with refined query
+- Read sources directly (discouraged - risks context bloat)
+
+## Critical Rules
+
+**DO:**
+- Search using the provided query
+- Read full conversations for top results
+- Synthesize into actionable insights (200-1000 words)
+- Include ALL sources with metadata (project, date, summary, file, status)
+- Focus on what will help the current task
+- Include specific details (function names, error messages, line numbers)
+
+**DO NOT:**
+- Include raw conversation excerpts (synthesize instead)
+- Paste full file contents
+- Add meta-commentary ("I searched and found...")
+- Exceed 1000 words in Summary section
+- Return search results verbatim
+
+## Example Output
+
+```
+### Summary
+
+developer needed to handle authentication errors in React Router 7 data loaders
+without crashing the app. The solution uses RR7's errorElement + useRouteError()
+to catch 401s and redirect to login.
+
+**Key implementation:**
+Protected route wrapper catches loader errors, checks error.status === 401.
+If 401, redirects to /login with return URL. Otherwise shows error boundary.
+
+**Why this works:**
+Loaders can't use hooks (tried useNavigate, failed). Throwing redirect()
+bypasses error handling. Final approach lets errors bubble to errorElement
+where component context is available.
+
+**Critical gotchas:**
+- Test with expired tokens, not just missing tokens
+- Error boundaries need unique keys per route or won't reset
+- Always include return URL in redirect
+- Loaders execute before components, no hook access
+
+**Code pattern:**
+```typescript
+// In loader
+if (!response.ok) throw { status: response.status, message: 'Failed' };
+
+// In ErrorBoundary
+const error = useRouteError();
+if (error.status === 401) navigate('/login?return=' + location.pathname);
+```
+
+### Sources
+
+**1. [react-router-7-starter, 2024-09-17]** - 92% match
+Conversation summary: Built authentication system with JWT, implemented protected routes
+File: ~/.config/moe/memory/conversation-archive/react-router-7-starter/19df92b9.jsonl:145-289
+Status: Read in detail (multiple exchanges on error handling evolution)
+
+**2. [react-router-docs-reading, 2024-09-10]** - 78% match
+Conversation summary: Read RR7 docs, discussed new loader patterns and errorElement
+File: ~/.config/moe/memory/conversation-archive/react-router-docs-reading/a3c871f2.jsonl:56-98
+Status: Reviewed summary only (confirmed errorElement usage)
+
+**3. [auth-debugging, 2024-09-18]** - 73% match
+Conversation summary: Fixed token expiration handling and error boundary reset issues
+File: ~/.config/moe/memory/conversation-archive/react-router-7-starter/7b2e8d91.jsonl:201-345
+Status: Read in detail (discovered gotchas about keys and expired tokens)
+
+### For Follow-Up
+
+Main agent can ask me to:
+- Dig deeper into source #1 (full error handling evolution)
+- Read adjacent exchanges in #3 (more debugging context)
+- Search for "React Router error boundary patterns" more broadly
+```
+
+This output:
+- Synthesis: ~350 words (actionable, specific)
+- Sources: Full metadata for 3 conversations
+- Enables iteration without context bloat

package/dist/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2025 Jesse Vincent
+Copyright (c) 2024 Anthropic
+Copyright (c) 2026 Matt Pocock
+Copyright (c) 2026 Prime Radiant, Inc.
+Copyright (c) 2026 Open GSD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * `moe-memory` — the package's single bin, compiled to dist/cli.js.
+ *
+ * Replaces FIVE upstream entry points:
+ *
+ *   episodic-memory              -> moe-memory
+ *   episodic-memory-index        -> moe-memory index
+ *   episodic-memory-search       -> moe-memory search
+ *   episodic-memory-mcp-server   -> moe-memory mcp-server
+ *   private-journal-mcp          -> moe-memory mcp-server  (one server now)
+ *
+ * and, with them, an entire layer of shims. episodic-memory shipped four
+ * extensionless files that spawned four `.js` dispatchers that spawned the
+ * compiled `dist/*-cli.js` scripts — `join(__dirname, '../dist')`, three times,
+ * two of them resolving `__dirname` through `realpathSync` and two not, so half
+ * of them broke under a symlinked bin. All of that is gone: this file imports
+ * the command modules and calls them in-process. There is no `../dist/` prefix
+ * left in the package.
+ *
+ * Subcommands are dispatched through dynamic import so that `moe-memory show`
+ * does not load better-sqlite3 or transformers.js just to render a JSONL file.
+ */
+export declare function main(argv?: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAwFH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlF"}

package/dist/cli.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * `moe-memory` — the package's single bin, compiled to dist/cli.js.
+ *
+ * Replaces FIVE upstream entry points:
+ *
+ *   episodic-memory              -> moe-memory
+ *   episodic-memory-index        -> moe-memory index
+ *   episodic-memory-search       -> moe-memory search
+ *   episodic-memory-mcp-server   -> moe-memory mcp-server
+ *   private-journal-mcp          -> moe-memory mcp-server  (one server now)
+ *
+ * and, with them, an entire layer of shims. episodic-memory shipped four
+ * extensionless files that spawned four `.js` dispatchers that spawned the
+ * compiled `dist/*-cli.js` scripts — `join(__dirname, '../dist')`, three times,
+ * two of them resolving `__dirname` through `realpathSync` and two not, so half
+ * of them broke under a symlinked bin. All of that is gone: this file imports
+ * the command modules and calls them in-process. There is no `../dist/` prefix
+ * left in the package.
+ *
+ * Subcommands are dispatched through dynamic import so that `moe-memory show`
+ * does not load better-sqlite3 or transformers.js just to render a JSONL file.
+ */
+const HELP = `moe-memory - semantic recall over past sessions and journal entries
+
+USAGE:
+  moe-memory <command> [options]
+
+COMMANDS:
+  sync         Sync conversations from Claude Code and Codex and index them
+  index        Index, verify, repair or rebuild the conversation index
+  search       Search indexed conversations
+  show         Display a conversation in readable format
+  stats        Show index statistics for both record types
+  journal      Index and search deliberately-written journal entries
+  doctor       Diagnose Claude Code or Codex integration issues
+  mcp-server   Run the moe-memory MCP server on stdio
+
+Run 'moe-memory <command> --help' for command-specific help.
+
+EXAMPLES:
+  # Backfill the conversation index
+  moe-memory index --cleanup
+
+  # Search past conversations
+  moe-memory search "React Router auth"
+
+  # Search what you wrote down deliberately
+  moe-memory journal search "why we dropped the sidecars"
+
+  # Display a conversation
+  moe-memory show path/to/conversation.jsonl
+`;
+async function dispatch(command, args) {
+    switch (command) {
+        case "sync": {
+            const { runSync } = await import("./sync-cli.js");
+            return runSync(args);
+        }
+        case "index": {
+            const { runIndex } = await import("./index-cli.js");
+            return runIndex(args);
+        }
+        case "search": {
+            const { runSearch } = await import("./search-cli.js");
+            return runSearch(args);
+        }
+        case "show": {
+            const { runShow } = await import("./show-cli.js");
+            return runShow(args);
+        }
+        case "stats": {
+            const { runStats } = await import("./stats-cli.js");
+            return runStats(args);
+        }
+        case "journal": {
+            const { runJournal } = await import("./journal-cli.js");
+            return runJournal(args);
+        }
+        case "doctor": {
+            const { runDoctor } = await import("./doctor-cli.js");
+            return runDoctor(args);
+        }
+        case "mcp-server": {
+            const { runMemoryMcpServer } = await import("./mcp-server.js");
+            await runMemoryMcpServer(args);
+            // The stdio transport owns the process from here.
+            return 0;
+        }
+        case "--help":
+        case "-h":
+        case "help":
+        case undefined:
+            console.log(HELP);
+            return 0;
+        case "--version":
+        case "-v": {
+            const { VERSION } = await import("./version.js");
+            console.log(VERSION);
+            return 0;
+        }
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.error("Try: moe-memory --help");
+            return 1;
+    }
+}
+export async function main(argv = process.argv.slice(2)) {
+    const [command, ...args] = argv;
+    try {
+        return await dispatch(command, args);
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+main().then((code) => {
+    // `mcp-server` keeps the event loop alive through its transport; every other
+    // command has finished by the time we get here, so an explicit exit is only
+    // needed for a non-zero status.
+    if (code !== 0)
+        process.exit(code);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/codex-hook-trust.d.ts

@@ -0,0 +1,4 @@
+export type CodexHookTrustState = "trusted" | "untrusted" | "modified" | "not_found" | "unknown";
+export declare function trustStateFromHooksList(result: unknown): CodexHookTrustState;
+export declare function detectCodexHookTrustState(codexHome: string, cwd: string, timeoutMs?: number): Promise<CodexHookTrustState>;
+//# sourceMappingURL=codex-hook-trust.d.ts.map

package/dist/codex-hook-trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook-trust.d.ts","sourceRoot":"","sources":["../src/codex-hook-trust.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAkBjG,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAiC5E;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,SAAS,SAAQ,GAChB,OAAO,CAAC,mBAAmB,CAAC,CA4E9B"}

package/dist/codex-hook-trust.js

@@ -0,0 +1,114 @@
+import { spawn } from "node:child_process";
+import readline from "node:readline";
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function hookBelongsToMoeMemory(hook) {
+    const pluginId = typeof hook.pluginId === "string" ? hook.pluginId : "";
+    const key = typeof hook.key === "string" ? hook.key : "";
+    return pluginId.startsWith("moe-memory@") || key.startsWith("moe-memory@");
+}
+export function trustStateFromHooksList(result) {
+    if (!isRecord(result) || !Array.isArray(result.data)) {
+        return "unknown";
+    }
+    const matchingHooks = [];
+    for (const entry of result.data) {
+        if (!isRecord(entry) || !Array.isArray(entry.hooks))
+            continue;
+        for (const hook of entry.hooks) {
+            if (isRecord(hook) && hookBelongsToMoeMemory(hook)) {
+                matchingHooks.push(hook);
+            }
+        }
+    }
+    if (matchingHooks.length === 0) {
+        return "not_found";
+    }
+    const trustStates = matchingHooks
+        .map((hook) => hook.trustStatus ?? hook.trust ?? hook.trust_status)
+        .filter((trust) => typeof trust === "string");
+    if (trustStates.includes("trusted") || trustStates.includes("managed")) {
+        return "trusted";
+    }
+    if (trustStates.includes("modified")) {
+        return "modified";
+    }
+    if (trustStates.includes("untrusted")) {
+        return "untrusted";
+    }
+    return "unknown";
+}
+export async function detectCodexHookTrustState(codexHome, cwd, timeoutMs = 10000) {
+    const child = spawn("codex", ["app-server"], {
+        env: { ...process.env, CODEX_HOME: codexHome },
+        stdio: ["pipe", "pipe", "ignore"],
+    });
+    const rl = readline.createInterface({ input: child.stdout });
+    const pending = new Map();
+    let nextId = 1;
+    child.on("error", (error) => {
+        for (const entry of pending.values()) {
+            entry.reject(error);
+        }
+        pending.clear();
+    });
+    rl.on("line", (line) => {
+        if (!line.trim())
+            return;
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (typeof message.id !== "number")
+            return;
+        const entry = pending.get(message.id);
+        if (!entry)
+            return;
+        pending.delete(message.id);
+        if (message.error) {
+            entry.reject(new Error(JSON.stringify(message.error)));
+        }
+        else {
+            entry.resolve(message.result);
+        }
+    });
+    const send = (method, params) => {
+        const id = nextId++;
+        child.stdin.write(`${JSON.stringify({ id, method, params })}\n`);
+        return new Promise((resolve, reject) => {
+            pending.set(id, { resolve, reject });
+        });
+    };
+    const notify = (method) => {
+        child.stdin.write(`${JSON.stringify({ method })}\n`);
+    };
+    const timeout = setTimeout(() => {
+        child.kill("SIGTERM");
+        for (const entry of pending.values()) {
+            entry.reject(new Error("timed out inspecting Codex hooks"));
+        }
+        pending.clear();
+    }, timeoutMs);
+    try {
+        await send("initialize", {
+            clientInfo: { name: "moe-memory-doctor", version: "0.0.0" },
+            capabilities: { experimentalApi: true },
+        });
+        notify("initialized");
+        const hooksList = await send("hooks/list", { cwds: [cwd] });
+        return trustStateFromHooksList(hooksList);
+    }
+    catch {
+        return "unknown";
+    }
+    finally {
+        clearTimeout(timeout);
+        rl.close();
+        child.kill("SIGTERM");
+    }
+}
+//# sourceMappingURL=codex-hook-trust.js.map

package/dist/codex-hook-trust.js.map

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

package/dist/codex-support.d.ts

@@ -0,0 +1,6 @@
+export declare const MIN_CODEX_VERSION = "0.130.0";
+export declare function parseCodexCliVersion(output: string): string | undefined;
+export declare function compareSemver(a: string, b: string): number;
+export declare function versionMeetsMinimum(version: string, minimum?: string): boolean;
+export declare function codexVersionRequirementMessage(versionOutput: string): string;
+//# sourceMappingURL=codex-support.d.ts.map

package/dist/codex-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-support.d.ts","sourceRoot":"","sources":["../src/codex-support.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAe1D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,SAAoB,GAAG,OAAO,CAEzF;AAED,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAM5E"}

package/dist/codex-support.js

@@ -0,0 +1,29 @@
+export const MIN_CODEX_VERSION = "0.130.0";
+export function parseCodexCliVersion(output) {
+    return output.match(/\b(\d+\.\d+\.\d+)\b/)?.[1];
+}
+export function compareSemver(a, b) {
+    const aParts = a.split(".").map((part) => Number.parseInt(part, 10));
+    const bParts = b.split(".").map((part) => Number.parseInt(part, 10));
+    for (let i = 0; i < 3; i++) {
+        const aRaw = aParts[i];
+        const bRaw = bParts[i];
+        const aPart = aRaw !== undefined && Number.isFinite(aRaw) ? aRaw : 0;
+        const bPart = bRaw !== undefined && Number.isFinite(bRaw) ? bRaw : 0;
+        if (aPart !== bPart) {
+            return aPart - bPart;
+        }
+    }
+    return 0;
+}
+export function versionMeetsMinimum(version, minimum = MIN_CODEX_VERSION) {
+    return compareSemver(version, minimum) >= 0;
+}
+export function codexVersionRequirementMessage(versionOutput) {
+    const version = parseCodexCliVersion(versionOutput);
+    if (!version) {
+        return `Codex summarization requires codex-cli >= ${MIN_CODEX_VERSION}; unable to parse version from: ${versionOutput.trim() || "(empty output)"}`;
+    }
+    return `Codex summarization requires codex-cli >= ${MIN_CODEX_VERSION}; found ${version}. Run codex update and retry.`;
+}
+//# sourceMappingURL=codex-support.js.map

package/dist/codex-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-support.js","sourceRoot":"","sources":["../src/codex-support.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAErE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,OAAO,GAAG,iBAAiB;IAC9E,OAAO,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,aAAqB;IAClE,MAAM,OAAO,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,6CAA6C,iBAAiB,mCAAmC,aAAa,CAAC,IAAI,EAAE,IAAI,gBAAgB,EAAE,CAAC;IACrJ,CAAC;IACD,OAAO,6CAA6C,iBAAiB,WAAW,OAAO,+BAA+B,CAAC;AACzH,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Marker text that identifies summarizer agent conversations.
+ * When this text appears in a conversation, it will be excluded from indexing.
+ * Used in summarizer prompts to prevent agent conversations from polluting search results.
+ */
+export declare const SUMMARIZER_CONTEXT_MARKER = "Context: This summary will be shown in a list to help users and Claude choose which conversations are relevant";
+/**
+ * Embedding width. Lives here rather than in embeddings.ts so db.ts can declare
+ * the vec0 columns without importing the encoder — loading embeddings.ts pulls
+ * in transformers.js and mutates its global `env`, which `moe-memory stats` and
+ * `moe-memory show` have no business doing.
+ */
+export declare const EMBEDDING_DIMENSIONS = 384;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,mHAC4E,CAAC;AAEnH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC"}

package/dist/constants.js

@@ -0,0 +1,14 @@
+/**
+ * Marker text that identifies summarizer agent conversations.
+ * When this text appears in a conversation, it will be excluded from indexing.
+ * Used in summarizer prompts to prevent agent conversations from polluting search results.
+ */
+export const SUMMARIZER_CONTEXT_MARKER = "Context: This summary will be shown in a list to help users and Claude choose which conversations are relevant";
+/**
+ * Embedding width. Lives here rather than in embeddings.ts so db.ts can declare
+ * the vec0 columns without importing the encoder — loading embeddings.ts pulls
+ * in transformers.js and mutates its global `env`, which `moe-memory stats` and
+ * `moe-memory show` have no business doing.
+ */
+export const EMBEDDING_DIMENSIONS = 384;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,gHAAgH,CAAC;AAEnH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC"}