@edwardlee5423/magi 0.1.0-alpha.0

package/dist/context/compaction.js

@@ -0,0 +1,353 @@
+import { MagiUsageError } from "../errors.js";
+import { triggerHooks } from "../hooks/events.js";
+export function compactSession(input) {
+    const session = input.store.getSession(input.sessionId);
+    if (!session) {
+        throw new MagiUsageError(`Session not found: ${input.sessionId}`);
+    }
+    const recentMessages = input.recentMessages ?? 20;
+    const summaryText = buildDeterministicSummary(session, {
+        recentMessages,
+        maxSummaryChars: input.maxSummaryChars ?? 6000
+    });
+    const summary = input.store.recordContextSummary({
+        sessionId: session.id,
+        summary: summaryText,
+        sourceMessageCount: session.messages.length,
+        metadata: {
+            kind: "deterministic-extractive-summary",
+            recentMessages
+        }
+    });
+    return {
+        summary,
+        recovered: recoverSessionContext({
+            store: input.store,
+            sessionId: session.id,
+            recentMessages
+        })
+    };
+}
+export async function compactSessionWithHooks(input) {
+    const session = input.store.getSession(input.sessionId);
+    if (!session) {
+        throw new MagiUsageError(`Session not found: ${input.sessionId}`);
+    }
+    const trigger = input.trigger ?? "manual";
+    const pre = await triggerHooks({
+        event: "pre_compact",
+        hooks: input.hooks,
+        store: input.store,
+        sessionId: session.id,
+        cwd: input.cwd,
+        env: input.env,
+        context: {
+            source: "compact",
+            message: `Compacting session ${session.id}`,
+            notificationType: "compact_started",
+            trigger,
+            customInstructions: input.customInstructions,
+            sourceMessageCount: session.messages.length
+        }
+    });
+    const block = pre.find((hook) => hook.blocked);
+    if (block) {
+        throw new MagiUsageError(`Compaction blocked by hook: ${block.output || block.error || "blocked"}`);
+    }
+    const compacted = input.modelRunner
+        ? await compactSessionWithModel({
+            store: input.store,
+            sessionId: session.id,
+            adapter: input.modelRunner.adapter,
+            model: input.modelRunner.model,
+            providerName: input.modelRunner.providerName,
+            recentMessages: input.recentMessages,
+            maxSummaryChars: input.maxSummaryChars
+        })
+        : compactSession({
+            store: input.store,
+            sessionId: session.id,
+            recentMessages: input.recentMessages,
+            maxSummaryChars: input.maxSummaryChars
+        });
+    const post = await triggerHooks({
+        event: "post_compact",
+        hooks: input.hooks,
+        store: input.store,
+        sessionId: session.id,
+        cwd: input.cwd,
+        env: input.env,
+        context: {
+            source: "compact",
+            message: `Compacted session ${session.id}`,
+            notificationType: "compact_completed",
+            trigger,
+            customInstructions: input.customInstructions,
+            compactSummary: compacted.summary.summary,
+            sourceMessageCount: compacted.summary.sourceMessageCount
+        }
+    });
+    return {
+        ...compacted,
+        hooks: { pre, post }
+    };
+}
+export async function compactSessionWithModel(input) {
+    const session = input.store.getSession(input.sessionId);
+    if (!session) {
+        throw new MagiUsageError(`Session not found: ${input.sessionId}`);
+    }
+    if (!input.model.trim()) {
+        throw new MagiUsageError("Compaction model must be explicit");
+    }
+    const recentMessages = input.recentMessages ?? 20;
+    const micro = microcompactMessages(session.messages, {
+        maxToolResultChars: 2_000
+    });
+    const response = await input.adapter.complete({
+        model: input.model,
+        messages: [{
+                role: "user",
+                content: [{
+                        type: "text",
+                        text: buildSummarizationPrompt(session, micro.messages)
+                    }]
+            }],
+        maxOutputTokens: input.maxOutputTokens ?? 20_000
+    });
+    const summaryText = truncateAtLineBoundary(response.text.trim(), input.maxSummaryChars ?? 20_000);
+    if (!summaryText) {
+        throw new MagiUsageError("Compaction model returned an empty summary");
+    }
+    const summary = input.store.recordContextSummary({
+        sessionId: session.id,
+        summary: summaryText,
+        sourceMessageCount: session.messages.length,
+        metadata: {
+            kind: "llm-summary",
+            provider: input.providerName,
+            model: input.model,
+            recentMessages,
+            microcompact: {
+                removedDuplicateToolResults: micro.removedDuplicateToolResults,
+                truncatedToolResults: micro.truncatedToolResults,
+                mergedSystemMessages: micro.mergedSystemMessages
+            }
+        }
+    });
+    return {
+        summary,
+        recovered: recoverSessionContext({
+            store: input.store,
+            sessionId: session.id,
+            recentMessages
+        })
+    };
+}
+export function microcompactMessages(messages, input = {}) {
+    const maxToolResultChars = input.maxToolResultChars ?? 2_000;
+    const compacted = [];
+    const seenToolResults = new Set();
+    let removedDuplicateToolResults = 0;
+    let truncatedToolResults = 0;
+    let mergedSystemMessages = 0;
+    for (const message of messages) {
+        if (message.role === "tool") {
+            const normalized = singleLine(message.content, maxToolResultChars);
+            if (seenToolResults.has(normalized)) {
+                removedDuplicateToolResults += 1;
+                continue;
+            }
+            seenToolResults.add(normalized);
+            if (message.content.length > maxToolResultChars) {
+                truncatedToolResults += 1;
+                compacted.push({
+                    ...message,
+                    content: `${message.content.slice(0, maxToolResultChars).trimEnd()}\n[tool result truncated]`
+                });
+                continue;
+            }
+        }
+        if (message.role === "system" && compacted.at(-1)?.role === "system") {
+            const previous = compacted[compacted.length - 1];
+            compacted[compacted.length - 1] = {
+                ...previous,
+                content: `${previous.content}\n${message.content}`
+            };
+            mergedSystemMessages += 1;
+            continue;
+        }
+        compacted.push(message);
+    }
+    return {
+        messages: compacted,
+        removedDuplicateToolResults,
+        truncatedToolResults,
+        mergedSystemMessages
+    };
+}
+export function recoverSessionContext(input) {
+    const session = input.store.getSession(input.sessionId);
+    if (!session) {
+        throw new MagiUsageError(`Session not found: ${input.sessionId}`);
+    }
+    const count = input.recentMessages ?? 20;
+    return {
+        sessionId: session.id,
+        summary: input.store.getLatestContextSummary(session.id),
+        recentMessages: session.messages.slice(Math.max(0, session.messages.length - count))
+    };
+}
+export function formatCompactResult(result) {
+    return [
+        `summaryId: ${result.summary.id}`,
+        `sessionId: ${result.summary.sessionId}`,
+        `sourceMessages: ${result.summary.sourceMessageCount}`,
+        `recoveredRecentMessages: ${result.recovered.recentMessages.length}`,
+        "summary:",
+        result.summary.summary,
+        ""
+    ].join("\n");
+}
+function buildDeterministicSummary(session, input) {
+    const lines = [
+        `Session ${session.id}`,
+        `Title: ${session.title ?? "(untitled)"}`,
+        `Cwd: ${session.cwd}`,
+        `Messages: ${session.messages.length}`
+    ];
+    const requiredFacts = extractRequiredFacts(session.messages);
+    if (requiredFacts.length > 0) {
+        lines.push("Required facts:");
+        for (const fact of requiredFacts) {
+            lines.push(`- ${fact}`);
+        }
+    }
+    const recent = session.messages.slice(Math.max(0, session.messages.length - input.recentMessages));
+    if (recent.length > 0) {
+        lines.push("Recent messages:");
+        for (const message of recent) {
+            lines.push(`- ${message.role}: ${singleLine(message.content, 300)}`);
+        }
+    }
+    return truncateAtLineBoundary(lines.join("\n"), input.maxSummaryChars);
+}
+function buildSummarizationPrompt(session, messages) {
+    // Pre-extract structured facts mechanically so the LLM has them as ground
+    // truth and won't drop file paths, install lists, or error states even if
+    // the conversation is too long for it to summarize accurately.
+    const facts = extractRequiredFacts(messages);
+    const lines = [
+        "Summarize this Magi session concisely while preserving:",
+        "- Key decisions made",
+        "- Files modified and their current state",
+        "- Pending tasks",
+        "- Requirements, constraints, blockers, and facts needed to continue",
+        "",
+        "Below are MECHANICALLY EXTRACTED facts. Treat them as ground truth and",
+        "include them verbatim in your summary. Add narrative context only where",
+        "it helps a future session pick up the work.",
+        "",
+        `Session: ${session.id}`,
+        `Title: ${session.title ?? "(untitled)"}`,
+        `Cwd: ${session.cwd}`,
+        ""
+    ];
+    if (facts.length > 0) {
+        lines.push("Mechanically extracted facts:");
+        for (const fact of facts) {
+            lines.push(`- ${fact}`);
+        }
+        lines.push("");
+    }
+    lines.push("Messages:");
+    for (const message of messages) {
+        lines.push(`- ${message.role}: ${singleLine(message.content, 2_000)}`);
+    }
+    return lines.join("\n");
+}
+function extractRequiredFacts(messages) {
+    const facts = [];
+    const seen = new Set();
+    const add = (text, role) => {
+        const normalized = singleLine(text, 500);
+        const key = role ? `${role}: ${normalized}` : normalized;
+        if (!seen.has(key)) {
+            facts.push(key);
+            seen.add(key);
+        }
+    };
+    // The first user message captures the original task / intent. Always keep
+    // it so the model can re-orient after compaction.
+    const firstUser = messages.find((m) => m.role === "user");
+    if (firstUser) {
+        add(`task: ${singleLine(firstUser.content, 300)}`);
+    }
+    for (const message of messages) {
+        // 1. Explicit text markers users / models can put in messages.
+        for (const line of message.content.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            if (/^(FACT|TODO|DECISION|CONSTRAINT|REQUIREMENT|BLOCKER|NOTE):/i.test(trimmed)) {
+                add(trimmed, message.role);
+            }
+        }
+        // 2. Tool results — extract structured side effects so that even if
+        // the LLM summary is fuzzy, the workspace state is recoverable.
+        if (message.role === "tool") {
+            const content = message.content;
+            // File writes / edits — preserved exactly so future turns can locate
+            // the files we touched.
+            const fileWrite = /^Wrote (\S+)/m.exec(content);
+            if (fileWrite)
+                add(`file_written: ${fileWrite[1]}`);
+            const fileEdit = /^Edited (\S+)/m.exec(content);
+            if (fileEdit)
+                add(`file_edited: ${fileEdit[1]}`);
+            const fileDelete = /^Deleted (\S+)/m.exec(content);
+            if (fileDelete)
+                add(`file_deleted: ${fileDelete[1]}`);
+            const fileMove = /^Moved (\S+) (?:→|->|to) (\S+)/m.exec(content);
+            if (fileMove)
+                add(`file_moved: ${fileMove[1]} -> ${fileMove[2]}`);
+            // Package installs. Captures pip/npm/cargo style output.
+            const pipInstall = /Successfully installed ([^\n]+)/m.exec(content);
+            if (pipInstall)
+                add(`installed: ${pipInstall[1].trim()}`);
+            const npmAdded = /^added (\d+) packages? in /m.exec(content);
+            if (npmAdded)
+                add(`npm_installed_packages: ${npmAdded[1]}`);
+            // Errors: capture exit codes, ToolError messages, stack traces.
+            const exitCode = /^Exit code: ([1-9]\d*)/m.exec(content);
+            if (exitCode)
+                add(`error_exit_code: ${exitCode[1]}`);
+            const toolError = /^ToolError: ([^\n]+)/m.exec(content);
+            if (toolError)
+                add(`tool_error: ${toolError[1].trim()}`);
+            // Git operations — what branch, what was committed.
+            const gitCommit = /\[([a-z0-9-]+) ([a-f0-9]{7,12})\] /m.exec(content);
+            if (gitCommit)
+                add(`git_commit: ${gitCommit[2]} on ${gitCommit[1]}`);
+        }
+        // 3. Approval decisions — what the user explicitly allowed or denied.
+        if (message.role === "user") {
+            const trimmed = message.content.trim();
+            if (/^(approved|allow|yes|denied|deny|no)\b/i.test(trimmed) && trimmed.length < 100) {
+                add(`decision: ${trimmed}`, "user");
+            }
+        }
+    }
+    return facts;
+}
+function singleLine(value, maxChars) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    return normalized.length <= maxChars ? normalized : `${normalized.slice(0, Math.max(0, maxChars - 3))}...`;
+}
+function truncateAtLineBoundary(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    const clipped = value.slice(0, maxChars);
+    const boundary = clipped.lastIndexOf("\n");
+    return `${clipped.slice(0, boundary > 0 ? boundary : maxChars).trimEnd()}\n[truncated]`;
+}
+//# sourceMappingURL=compaction.js.map

package/dist/context/compaction.js.map

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

package/dist/context/layers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 6-layer context builder for the agent system prompt.
+ *
+ * Layers (in order):
+ * 1. System instructions (core behavior rules)
+ * 2. Project rules (AGENTS.md / .magi/rules/)
+ * 3. User memory index (MEMORY.md)
+ * 4. Dynamic memory (LLM-selected relevant memories)
+ * 5. Git context (branch, status)
+ * 6. Environment (date, cwd, platform)
+ */
+import { MagiPaths } from "../paths.js";
+export interface ContextLayer {
+    name: string;
+    content: string;
+}
+export interface ContextBuildInput {
+    cwd: string;
+    paths?: MagiPaths;
+    systemInstructions?: string;
+    memoryContext?: string;
+    userMemoryIndex?: string;
+    includeGit?: boolean;
+    includeDate?: boolean;
+    platform?: string;
+}
+export interface BuiltContext {
+    systemPrompt: string;
+    layers: ContextLayer[];
+}
+export declare function buildLayeredContext(input: ContextBuildInput): BuiltContext;
+export declare function getGitContext(cwd: string): string | undefined;

package/dist/context/layers.js

@@ -0,0 +1,114 @@
+/**
+ * 6-layer context builder for the agent system prompt.
+ *
+ * Layers (in order):
+ * 1. System instructions (core behavior rules)
+ * 2. Project rules (AGENTS.md / .magi/rules/)
+ * 3. User memory index (MEMORY.md)
+ * 4. Dynamic memory (LLM-selected relevant memories)
+ * 5. Git context (branch, status)
+ * 6. Environment (date, cwd, platform)
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { loadAgentInstructions, formatAgentInstructions } from "../rules/agents-loader.js";
+export function buildLayeredContext(input) {
+    const layers = [];
+    // Layer 1: System instructions
+    if (input.systemInstructions) {
+        layers.push({ name: "system", content: input.systemInstructions });
+    }
+    // Layer 2: Project rules (AGENTS.md)
+    const projectRules = loadProjectRules(input.cwd);
+    if (projectRules) {
+        layers.push({ name: "project-rules", content: projectRules });
+    }
+    // Layer 3: User memory index
+    const memoryIndex = input.userMemoryIndex ?? loadUserMemoryIndex(input.paths);
+    if (memoryIndex) {
+        layers.push({ name: "memory-index", content: `[User memory]\n${memoryIndex}` });
+    }
+    // Layer 4: Dynamic memory (selected relevant memories)
+    if (input.memoryContext) {
+        layers.push({ name: "dynamic-memory", content: input.memoryContext });
+    }
+    // Layer 5: Git context
+    if (input.includeGit !== false) {
+        const git = getGitContext(input.cwd);
+        if (git) {
+            layers.push({ name: "git", content: git });
+        }
+    }
+    // Layer 6: Environment
+    const env = buildEnvironmentLayer(input);
+    layers.push({ name: "environment", content: env });
+    const systemPrompt = layers.map((l) => l.content).join("\n\n");
+    return { systemPrompt, layers };
+}
+function loadProjectRules(cwd) {
+    const files = loadAgentInstructions(cwd);
+    if (files.length === 0) {
+        return undefined;
+    }
+    return formatAgentInstructions(files).trimEnd();
+}
+function loadUserMemoryIndex(paths) {
+    if (!paths) {
+        return undefined;
+    }
+    const indexFile = path.join(paths.root, "memory.md");
+    if (!existsSync(indexFile)) {
+        return undefined;
+    }
+    const content = readFileSync(indexFile, "utf8").trim();
+    return content || undefined;
+}
+export function getGitContext(cwd) {
+    try {
+        const branch = execSync("git rev-parse --abbrev-ref HEAD", {
+            cwd,
+            encoding: "utf8",
+            timeout: 3000,
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        let status;
+        try {
+            const raw = execSync("git status --porcelain -u", {
+                cwd,
+                encoding: "utf8",
+                timeout: 3000,
+                stdio: ["ignore", "pipe", "ignore"],
+            }).trim();
+            const lines = raw.split("\n").filter(Boolean);
+            if (lines.length === 0) {
+                status = "clean";
+            }
+            else if (lines.length <= 10) {
+                status = lines.join(", ");
+            }
+            else {
+                status = `${lines.length} changed files`;
+            }
+        }
+        catch {
+            status = "unknown";
+        }
+        return `[Git] branch=${branch} status=${status}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+function buildEnvironmentLayer(input) {
+    const parts = [];
+    if (input.includeDate !== false) {
+        parts.push(`date=${new Date().toISOString().slice(0, 10)}`);
+    }
+    parts.push(`cwd=${input.cwd}`);
+    if (input.platform) {
+        parts.push(`platform=${input.platform}`);
+    }
+    return `[Environment] ${parts.join(" ")}`;
+}
+//# sourceMappingURL=layers.js.map

package/dist/context/layers.js.map

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

package/dist/context/token-budget.d.ts

@@ -0,0 +1,21 @@
+import { ContextSummaryRecord, SessionRecord } from "../session-store.js";
+export interface ContextCategoryBudget {
+    category: string;
+    chars: number;
+    estimatedTokens: number;
+    items: number;
+}
+export interface SessionContextBudget {
+    sessionId: string;
+    messageCount: number;
+    summaryCount: number;
+    chars: number;
+    estimatedTokens: number;
+    categories: ContextCategoryBudget[];
+}
+export declare function estimateTokens(text: string): number;
+export declare function computeSessionContextBudget(input: {
+    session: SessionRecord;
+    summaries?: ContextSummaryRecord[];
+}): SessionContextBudget;
+export declare function formatSessionContextBudget(budget: SessionContextBudget): string;

package/dist/context/token-budget.js

@@ -0,0 +1,70 @@
+export function estimateTokens(text) {
+    const normalized = text.trim();
+    if (!normalized) {
+        return 0;
+    }
+    const asciiWords = normalized.match(/[A-Za-z0-9_]+/g)?.length ?? 0;
+    const nonWhitespaceChars = normalized.replace(/\s+/g, "").length;
+    return Math.max(1, Math.ceil(Math.max(nonWhitespaceChars / 4, asciiWords * 1.25)));
+}
+export function computeSessionContextBudget(input) {
+    const buckets = new Map();
+    for (const message of input.session.messages) {
+        const category = messageCategory(message);
+        addBucket(buckets, category, message.content.length);
+    }
+    for (const summary of input.summaries ?? []) {
+        addBucket(buckets, "summary", summary.summary.length);
+    }
+    const categories = Array.from(buckets.entries())
+        .map(([category, value]) => ({
+        category,
+        chars: value.chars,
+        estimatedTokens: estimateTokens("x".repeat(value.chars)),
+        items: value.items
+    }))
+        .sort((a, b) => categoryOrder(a.category) - categoryOrder(b.category) || a.category.localeCompare(b.category));
+    const chars = categories.reduce((sum, category) => sum + category.chars, 0);
+    return {
+        sessionId: input.session.id,
+        messageCount: input.session.messages.length,
+        summaryCount: input.summaries?.length ?? 0,
+        chars,
+        estimatedTokens: categories.reduce((sum, category) => sum + category.estimatedTokens, 0),
+        categories
+    };
+}
+export function formatSessionContextBudget(budget) {
+    const lines = [
+        `sessionId: ${budget.sessionId}`,
+        `messages: ${budget.messageCount}`,
+        `summaries: ${budget.summaryCount}`,
+        `chars: ${budget.chars}`,
+        `estimatedTokens: ${budget.estimatedTokens}`,
+        "categories:"
+    ];
+    for (const category of budget.categories) {
+        lines.push(`  ${category.category}: ${category.estimatedTokens} tokens, ${category.chars} chars, ${category.items} items`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+function messageCategory(message) {
+    if (message.metadata.kind === "context-summary") {
+        return "summary";
+    }
+    if (message.role === "user" || message.role === "assistant" || message.role === "tool" || message.role === "system") {
+        return message.role;
+    }
+    return "other";
+}
+function addBucket(buckets, category, chars) {
+    const existing = buckets.get(category) ?? { chars: 0, items: 0 };
+    existing.chars += chars;
+    existing.items += 1;
+    buckets.set(category, existing);
+}
+function categoryOrder(category) {
+    const index = ["system", "user", "assistant", "tool", "summary", "other"].indexOf(category);
+    return index === -1 ? 999 : index;
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/context/token-budget.js.map

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

package/dist/control/auth.d.ts

@@ -0,0 +1,17 @@
+import { SessionStore } from "../session-store.js";
+export interface PairingToken {
+    deviceId: string;
+    token: string;
+    expiresAt: string;
+}
+export declare function createPairingToken(input: {
+    store: SessionStore;
+    deviceName: string;
+    ttlMs?: number;
+}): PairingToken;
+export declare function validateDeviceToken(input: {
+    store: SessionStore;
+    deviceId: string | undefined;
+    token: string | undefined;
+}): boolean;
+export declare function hashToken(token: string): string;