@edwardlee5423/magi 0.1.0-alpha.0

package/dist/memdir.js

@@ -0,0 +1,219 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync, statSync } from "node:fs";
+import path from "node:path";
+import { atomicWrite } from "./fs-utils.js";
+const MEMDIR_DIRNAME = "memdir";
+const INDEX_FILENAME = "MEMORY.md";
+const MAX_INDEX_LINES = 200;
+export function memdirRoot(input) {
+    return path.join(input.root, MEMDIR_DIRNAME);
+}
+export function memdirIndexFile(input) {
+    return path.join(memdirRoot(input), INDEX_FILENAME);
+}
+export function ensureMemdir(input) {
+    const root = memdirRoot(input);
+    mkdirSync(root, { recursive: true });
+    const indexFile = memdirIndexFile(input);
+    if (!existsSync(indexFile)) {
+        writeFileSync(indexFile, "", "utf8");
+    }
+    return root;
+}
+export function listMemdirEntries(input) {
+    const root = memdirRoot(input);
+    if (!existsSync(root))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((name) => name.endsWith(".md") && name !== INDEX_FILENAME)
+        .sort()
+        .flatMap((filename) => {
+        const filePath = path.join(root, filename);
+        try {
+            if (!statSync(filePath).isFile())
+                return [];
+            const content = readFileSync(filePath, "utf8");
+            const parsed = parseMemdirFile(content);
+            if (!parsed)
+                return [];
+            return [{
+                    ...parsed,
+                    filename,
+                    path: filePath
+                }];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+export function readMemdirIndex(input) {
+    const file = memdirIndexFile(input);
+    if (!existsSync(file))
+        return "";
+    return readFileSync(file, "utf8");
+}
+export function writeMemdirEntry(input) {
+    const root = ensureMemdir(input.paths);
+    const filename = `${input.type}_${slugify(input.name)}.md`;
+    const filePath = path.join(root, filename);
+    const content = formatMemdirFile({
+        name: input.name,
+        description: input.description,
+        type: input.type,
+        body: input.body
+    });
+    atomicWrite(filePath, content);
+    updateIndex(input.paths);
+    return {
+        name: input.name,
+        description: input.description,
+        type: input.type,
+        body: input.body,
+        filename,
+        path: filePath
+    };
+}
+export function deleteMemdirEntry(input, filename) {
+    const root = memdirRoot(input);
+    const filePath = path.join(root, filename);
+    if (!existsSync(filePath))
+        return false;
+    unlinkSync(filePath);
+    updateIndex(input);
+    return true;
+}
+export function findMemdirEntry(input, filenameOrName) {
+    const entries = listMemdirEntries(input);
+    return entries.find((e) => e.filename === filenameOrName || e.name === filenameOrName)
+        ?? entries.find((e) => slugify(e.name) === slugify(filenameOrName));
+}
+export function searchMemdir(input) {
+    const terms = tokenize(input.query);
+    if (terms.length === 0)
+        return [];
+    const entries = listMemdirEntries(input.paths)
+        .filter((e) => !input.types || input.types.includes(e.type));
+    return entries
+        .map((entry) => ({
+        ...entry,
+        score: scoreEntry(entry, terms)
+    }))
+        .filter((e) => e.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, input.maxResults ?? 8);
+}
+export function formatMemdirIndex(input) {
+    const entries = listMemdirEntries(input);
+    if (entries.length === 0)
+        return "";
+    const lines = ["# Memory index", ""];
+    const byType = {
+        user: [],
+        feedback: [],
+        project: [],
+        reference: []
+    };
+    for (const entry of entries) {
+        byType[entry.type].push(entry);
+    }
+    for (const type of ["user", "feedback", "project", "reference"]) {
+        const list = byType[type];
+        if (list.length === 0)
+            continue;
+        lines.push(`## ${type}`);
+        for (const entry of list) {
+            lines.push(`- [${entry.name}](${entry.filename}) - ${entry.description}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd() + "\n";
+}
+function updateIndex(input) {
+    const indexFile = memdirIndexFile(input);
+    let content = formatMemdirIndex(input);
+    const lines = content.split("\n");
+    if (lines.length > MAX_INDEX_LINES) {
+        content = lines.slice(0, MAX_INDEX_LINES).join("\n") + "\n... (truncated)\n";
+    }
+    atomicWrite(indexFile, content);
+}
+function parseMemdirFile(content) {
+    if (!content.startsWith("---\n"))
+        return undefined;
+    const end = content.indexOf("\n---\n", 4);
+    if (end === -1)
+        return undefined;
+    const frontmatter = content.slice(4, end);
+    const body = content.slice(end + 5).trim();
+    const fields = {};
+    for (const line of frontmatter.split("\n")) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim();
+        fields[key] = value;
+    }
+    if (!fields.name || !fields.description || !fields.type)
+        return undefined;
+    if (!isValidType(fields.type))
+        return undefined;
+    return {
+        name: fields.name,
+        description: fields.description,
+        type: fields.type,
+        body
+    };
+}
+function formatMemdirFile(input) {
+    return [
+        "---",
+        `name: ${input.name}`,
+        `description: ${input.description}`,
+        `type: ${input.type}`,
+        "---",
+        "",
+        input.body.trim(),
+        ""
+    ].join("\n");
+}
+function slugify(text) {
+    return text.toLowerCase()
+        .replace(/[^a-z0-9_]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .slice(0, 60) || "entry";
+}
+function isValidType(value) {
+    return value === "user" || value === "feedback" || value === "project" || value === "reference";
+}
+function tokenize(text) {
+    return Array.from(new Set(text
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}_-]+/gu, " ")
+        .split(/\s+/)
+        .filter((t) => t.length >= 2)));
+}
+function scoreEntry(entry, terms) {
+    const haystack = tokenize(`${entry.name} ${entry.description} ${entry.body}`);
+    const haystackSet = new Set(haystack);
+    let score = 0;
+    for (const term of terms) {
+        if (haystackSet.has(term)) {
+            score += 3;
+        }
+        else if (haystack.some((w) => w.includes(term) || term.includes(w))) {
+            score += 1;
+        }
+    }
+    // Boost for type relevance
+    const typeBoost = { user: 2, feedback: 2, project: 1, reference: 1 };
+    return score + typeBoost[entry.type];
+}
+//# sourceMappingURL=memdir.js.map

package/dist/memdir.js.map

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

package/dist/memory-selection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * LLM-based memory relevance selection.
+ * When a selectionModel is configured, uses a fast model to pick ≤N most relevant memories.
+ * Falls back to keyword-based searchMemory when no model is available.
+ */
+import { ProviderAdapter } from "./providers/ir.js";
+import { MemorySearchResult } from "./memory.js";
+import { MagiPaths } from "./paths.js";
+import { MemoryScope } from "./memory.js";
+export interface MemorySelectionRoute {
+    adapter: ProviderAdapter;
+    model: string;
+    providerName: string;
+}
+export interface SelectMemoryInput {
+    paths: MagiPaths;
+    cwd: string;
+    sessionId?: string;
+    scopes?: MemoryScope[];
+    maxResults: number;
+    prompt: string;
+    selectionRoute?: MemorySelectionRoute;
+    signal?: AbortSignal;
+}
+export interface SelectMemoryResult {
+    entries: MemorySearchResult[];
+    method: "keyword" | "llm";
+    formatted: string | undefined;
+}
+export declare function selectRelevantMemories(input: SelectMemoryInput): Promise<SelectMemoryResult>;

package/dist/memory-selection.js

@@ -0,0 +1,102 @@
+/**
+ * LLM-based memory relevance selection.
+ * When a selectionModel is configured, uses a fast model to pick ≤N most relevant memories.
+ * Falls back to keyword-based searchMemory when no model is available.
+ */
+import { textMessage } from "./providers/ir.js";
+import { listMemoryEntries, searchMemory, formatMemorySearchResults } from "./memory.js";
+export async function selectRelevantMemories(input) {
+    const allEntries = listMemoryEntries({
+        paths: input.paths,
+        cwd: input.cwd,
+        sessionId: input.sessionId,
+        scopes: input.scopes
+    });
+    if (allEntries.length === 0) {
+        return { entries: [], method: "keyword", formatted: undefined };
+    }
+    // If no selection model or few entries, use keyword search
+    if (!input.selectionRoute || allEntries.length <= input.maxResults) {
+        const results = searchMemory({
+            paths: input.paths,
+            cwd: input.cwd,
+            sessionId: input.sessionId,
+            scopes: input.scopes,
+            maxResults: input.maxResults,
+            query: input.prompt
+        });
+        const formatted = results.length > 0 ? formatMemorySearchResults(results) : undefined;
+        return { entries: results, method: "keyword", formatted };
+    }
+    // Use LLM to select relevant memories
+    try {
+        const selected = await llmSelectMemories({
+            entries: allEntries,
+            prompt: input.prompt,
+            maxResults: input.maxResults,
+            route: input.selectionRoute,
+            signal: input.signal
+        });
+        const formatted = selected.length > 0 ? formatMemorySearchResults(selected) : undefined;
+        return { entries: selected, method: "llm", formatted };
+    }
+    catch {
+        // Fallback to keyword search on LLM failure
+        const results = searchMemory({
+            paths: input.paths,
+            cwd: input.cwd,
+            sessionId: input.sessionId,
+            scopes: input.scopes,
+            maxResults: input.maxResults,
+            query: input.prompt
+        });
+        const formatted = results.length > 0 ? formatMemorySearchResults(results) : undefined;
+        return { entries: results, method: "keyword", formatted };
+    }
+}
+async function llmSelectMemories(input) {
+    const numbered = input.entries.map((entry, i) => `[${i}] (${entry.scope}) ${entry.text}`);
+    const selectionPrompt = [
+        `Given the user's current prompt, select up to ${input.maxResults} most relevant memory entries.`,
+        `Return ONLY a JSON array of indices (e.g. [0, 3, 7]). No explanation.`,
+        ``,
+        `User prompt: ${input.prompt.slice(0, 2000)}`,
+        ``,
+        `Available memories:`,
+        ...numbered
+    ].join("\n");
+    const request = {
+        model: input.route.model,
+        messages: [textMessage("user", selectionPrompt)],
+        temperature: 0,
+        maxOutputTokens: 256,
+        signal: input.signal
+    };
+    const response = await input.route.adapter.complete(request);
+    const indices = parseIndices(response.text, input.entries.length);
+    return indices
+        .slice(0, input.maxResults)
+        .map((index) => ({
+        ...input.entries[index],
+        score: input.maxResults - indices.indexOf(index) // Higher score for earlier picks
+    }));
+}
+function parseIndices(text, maxIndex) {
+    // Extract JSON array from response
+    const match = /\[[\d\s,]*\]/.exec(text);
+    if (!match) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(match[0]);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed
+            .filter((v) => typeof v === "number" && Number.isInteger(v) && v >= 0 && v < maxIndex);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=memory-selection.js.map

package/dist/memory-selection.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,85 @@
+import { MagiPaths } from "./paths.js";
+import { SessionStore } from "./session-store.js";
+export type MemoryScope = "project" | "user" | "session";
+export type DurableMemoryScope = "project" | "user";
+export interface MemoryEntry {
+    scope: MemoryScope;
+    text: string;
+    key?: string;
+    value?: string;
+    createdAt?: string;
+    file: string;
+    line: number;
+}
+export interface MemorySearchResult extends MemoryEntry {
+    score: number;
+}
+export interface MemoryConflict {
+    scope: MemoryScope;
+    key: string;
+    existing: MemoryEntry;
+    incoming: MemoryEntry;
+}
+export interface AppendMemoryResult {
+    file: string;
+    entry: MemoryEntry;
+    appended: boolean;
+    duplicate: boolean;
+    conflicts: MemoryConflict[];
+}
+export declare function memoryFile(paths: MagiPaths, scope: MemoryScope, cwd: string): string;
+export declare function sessionMemoryFile(paths: MagiPaths, sessionId: string): string;
+export declare function resolveMemoryFile(input: {
+    paths: MagiPaths;
+    scope: MemoryScope;
+    cwd: string;
+    sessionId?: string;
+}): string;
+export declare function readMemory(input: {
+    paths: MagiPaths;
+    scope: MemoryScope;
+    cwd: string;
+    sessionId?: string;
+}): string;
+export declare function appendMemory(input: {
+    paths: MagiPaths;
+    scope: MemoryScope;
+    cwd: string;
+    text: string;
+    store?: SessionStore;
+    sessionId?: string;
+}): string;
+export declare function appendMemory(input: {
+    paths: MagiPaths;
+    scope: MemoryScope;
+    cwd: string;
+    text: string;
+    store?: SessionStore;
+    sessionId?: string;
+    detailed: true;
+}): AppendMemoryResult;
+export declare function formatMemory(input: {
+    paths: MagiPaths;
+    cwd: string;
+    scope?: MemoryScope;
+    sessionId?: string;
+}): string;
+export declare function listMemoryEntries(input: {
+    paths: MagiPaths;
+    cwd: string;
+    sessionId?: string;
+    scopes?: MemoryScope[];
+}): MemoryEntry[];
+export declare function searchMemory(input: {
+    paths: MagiPaths;
+    cwd: string;
+    query: string;
+    sessionId?: string;
+    scopes?: MemoryScope[];
+    maxResults?: number;
+}): MemorySearchResult[];
+export declare function formatMemorySearchResults(results: MemorySearchResult[]): string;
+export declare function extractExplicitMemoryWrite(prompt: string): {
+    scope: MemoryScope;
+    text: string;
+} | undefined;