@echomem/mcp 1.4.44 → 1.4.45

package/dist/source-session.js

@@ -1,7 +1,6 @@
 import fs from "node:fs";
-import os from "node:os";
 import path from "node:path";
-import { resolveClaudeProjectsDir, resolveCodexSessionRoots } from "./local-data-paths.js";
+import { resolveClaudeCoworkSessionsDir, resolveClaudeProjectsDir, resolveCodexSessionRoots, } from "./local-data-paths.js";
 export const SOURCE_SESSION_BINDING_EVIDENCE = "local_jsonl_tool_call";
 export const SOURCE_SESSION_HOOK_EVIDENCE = "local_session_start_hook";
 export const SOURCE_SESSION_MCP_METADATA_EVIDENCE = "local_mcp_session_metadata";
@@ -81,18 +80,13 @@ function readableDirectory(candidate) {
         return false;
     }
 }
-function coworkRoot() {
-    const supportRoot = process.env.CLAUDE_DESKTOP_SUPPORT_DIR?.trim()
-        || path.join(os.homedir(), "Library", "Application Support", "Claude");
-    return path.join(supportRoot, "local-agent-mode-sessions");
-}
 function defaultRoots() {
     const claudeProjects = resolveClaudeProjectsDir();
-    const desktopRoot = coworkRoot();
+    const desktopRoot = resolveClaudeCoworkSessionsDir();
     return {
         codex: resolveCodexSessionRoots().map((root) => root.path),
         claudeCode: claudeProjects ? [claudeProjects] : [],
-        cowork: readableDirectory(desktopRoot) ? [desktopRoot] : [],
+        cowork: desktopRoot ? [desktopRoot] : [],
     };
 }
 function walkJsonlFiles(roots) {

package/dist/v1-contract.js

@@ -25,6 +25,7 @@ export const canonicalToolNames = {
     completeGroupPublication: "complete_group_publication",
     publishToGroup: "publish_memory_to_group",
     publishBatchToGroup: "publish_memories_to_group",
+    report: "echomem_usage_report",
     updateStatus: "echomem_update_status",
     contextHealth: "echo_context_health",
     recompose: "echo_recompose",
@@ -53,6 +54,7 @@ const READ_ONLY_TOOL_NAMES = new Set([
     canonicalToolNames.requestGroupSessionSharing,
     canonicalToolNames.getByContext,
     canonicalToolNames.checkpointByContext,
+    canonicalToolNames.report,
     canonicalToolNames.updateStatus,
     canonicalToolNames.contextHealth,
     canonicalToolNames.recompose,
@@ -82,6 +84,7 @@ const ALWAYS_LOAD_TOOL_NAMES = new Set([
     canonicalToolNames.save,
 ]);
 const LOCAL_ONLY_TOOL_NAMES = new Set([
+    canonicalToolNames.report,
     canonicalToolNames.contextHealth,
     canonicalToolNames.recompose,
 ]);
@@ -1020,6 +1023,11 @@ export function listToolSpecs(opts = {}) {
                 required: ["contextId"],
             },
         },
+        {
+            name: canonicalToolNames.report,
+            description: "Show the user a one-screen audit of THEIR OWN AI coding usage — computed locally from their Codex/Claude Code logs ($0, nothing uploaded): how many tokens their agents spent, how much was re-reading context, reads vs memory recalls, and what changes with EchoMem. Call this when the user asks about their usage, token spend, cost, how much they're wasting, or wants a summary of their agent activity — and you may offer it once right after EchoMem is first connected. Returns formatted text to show the user verbatim. Needs no login.",
+            inputSchema: { type: "object", properties: {} },
+        },
         {
             name: canonicalToolNames.updateStatus,
             description: `Check whether this installed EchoMem MCP bridge is behind the latest version. Works without login, uploads no user transcript, and normal background checks are cached. ${MCP_DESKTOP_MANAGED ? "Echo Desktop owns updates for this runtime; direct the user back to the desktop app." : "If it reports an update, tell the user and offer to run the returned update command."} After updating, the user must start a new agent/MCP session.${updateSection}`,

package/package.json

@@ -1,12 +1,9 @@
 {
   "name": "@echomem/mcp",
-  "version": "1.4.44",
-  "description": "EchoMem MCP bridge for cross-agent memory, local history import, and recall",
+  "version": "1.4.45",
+  "description": "EchoMem MCP bridge: cloud-first memory tools and the Agent Doctor workspace forensics report (cost ledger + 3D repo city)",
   "main": "dist/index.js",
   "type": "module",
-  "engines": {
-    "node": ">=18"
-  },
   "echoDesktop": {
     "minimumVersion": "1.0.0",
     "runtimeLayout": 1
@@ -22,21 +19,22 @@
     "README.md"
   ],
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc",
+    "build": "tsc",
     "start": "node dist/index.js",
     "predev": "npm run build",
     "dev": "node dist/index.js",
     "smoke": "node smoke.mjs",
     "preview:extraction": "npm run build && node scripts/preview-extraction.mjs",
+    "stress:long-history": "npm run build && node scripts/stress-long-history.mjs",
+    "stress:long-claude-history": "npm run build && node scripts/stress-long-claude-history.mjs",
     "test:artifact": "npm run build && node test/package-artifact.test.mjs",
     "test:registry": "node test/registry-artifact.test.mjs",
     "test:registry-ui": "npm run build && node test/registry-ui.test.mjs",
     "test:ui": "npm run build && node test/setup-ui.test.mjs",
     "test:onboarding-resilience": "npm run build && node test/onboarding-resilience.test.mjs",
-    "test:config-safety": "npm run build && node test/config-safety.test.mjs",
     "test:billing-ui": "npm run build && node test/setup-ui.test.mjs billing",
-    "test": "npm run build && node test/source-session.test.mjs && node test/source-session-hook.test.mjs && node test/local-data-paths.test.mjs && node test/crypto.test.mjs && node test/integration.test.mjs && node test/onboarding-resilience.test.mjs && node test/local-auth.test.mjs && node test/retrieval-only.test.mjs && node test/no-restart.test.mjs && node test/canonical-golden.test.mjs && node test/tools.test.mjs && node test/workspace-selector.test.mjs && node test/group-map.test.mjs && node test/update-check.test.mjs && node test/headless-runtime.test.mjs && node test/claude-code-config.test.mjs && node test/config-safety.test.mjs && node test/delete.test.mjs && node test/low-touch-tools.test.mjs && node test/migrate.test.mjs && node test/restart-recovery.test.mjs && node test/save-checkpoint-hook.test.mjs",
-    "prepack": "npm run build"
+    "test": "npm run build && node test/source-session.test.mjs && node test/source-session-hook.test.mjs && node test/local-data-paths.test.mjs && node test/crypto.test.mjs && node test/integration.test.mjs && node test/onboarding-resilience.test.mjs && node test/local-auth.test.mjs && node test/retrieval-only.test.mjs && node test/no-restart.test.mjs && node test/report.test.mjs && node test/forensics.test.mjs && node test/canonical-golden.test.mjs && node test/tools.test.mjs && node test/workspace-selector.test.mjs && node test/group-map.test.mjs && node test/update-check.test.mjs && node test/headless-runtime.test.mjs && node test/claude-code-config.test.mjs && node test/delete.test.mjs && node test/low-touch-tools.test.mjs && node test/migrate.test.mjs && node test/restart-recovery.test.mjs && node test/save-checkpoint-hook.test.mjs",
+    "prepack": "npm run build && node scripts/bundle-city.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.1",

package/dist/config-files.js

@@ -1,63 +0,0 @@
-import { randomUUID } from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-function isErrno(error, code) {
-    return error instanceof Error
-        && "code" in error
-        && error.code === code;
-}
-/**
- * Read a user-owned JSON configuration without treating corruption as an empty file.
- * Setup must fail closed here: replacing malformed JSON would destroy unrelated client settings.
- */
-export function readJsonObjectFile(file, label = "configuration") {
-    let raw;
-    try {
-        raw = fs.readFileSync(file, "utf8");
-    }
-    catch (error) {
-        if (isErrno(error, "ENOENT"))
-            return {};
-        throw new Error(`Could not read ${label} at ${file}: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (error) {
-        throw new Error(`Could not safely update ${label} at ${file} because the existing file is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        throw new Error(`Could not safely update ${label} at ${file} because the existing JSON root is not an object.`);
-    }
-    return parsed;
-}
-/** Write beside the destination and rename only after the complete replacement is durable locally. */
-export function atomicWriteTextFile(file, content) {
-    const directory = path.dirname(file);
-    fs.mkdirSync(directory, { recursive: true });
-    const temporary = path.join(directory, `.${path.basename(file)}.${process.pid}.${randomUUID()}.tmp`);
-    let mode;
-    try {
-        mode = fs.statSync(file).mode;
-    }
-    catch {
-        /* A fresh file uses the process default mode. */
-    }
-    try {
-        fs.writeFileSync(temporary, content, mode === undefined ? undefined : { mode });
-        fs.renameSync(temporary, file);
-    }
-    catch (error) {
-        try {
-            fs.rmSync(temporary, { force: true });
-        }
-        catch {
-            /* Preserve the original error. */
-        }
-        throw error;
-    }
-}
-export function atomicWriteJsonObject(file, value) {
-    atomicWriteTextFile(file, JSON.stringify(value, null, 2));
-}

package/dist/local-jsonl.js

@@ -1,87 +0,0 @@
-import fs from "node:fs";
-import { StringDecoder } from "node:string_decoder";
-import path from "node:path";
-/**
- * Stream a JSONL file without loading large agent transcripts into one string.
- * Malformed lines and unreadable files are skipped so local discovery remains recoverable.
- */
-export function eachJsonLine(file, visit) {
-    let descriptor;
-    try {
-        descriptor = fs.openSync(file, "r");
-    }
-    catch {
-        return;
-    }
-    try {
-        const decoder = new StringDecoder("utf8");
-        const buffer = Buffer.allocUnsafe(1 << 20);
-        let remainder = "";
-        let bytesRead;
-        const consume = (chunk) => {
-            const lines = (remainder + chunk).split("\n");
-            remainder = lines.pop() ?? "";
-            for (const line of lines) {
-                const value = line.trim();
-                if (!value)
-                    continue;
-                try {
-                    visit(JSON.parse(value));
-                }
-                catch {
-                    /* Ignore malformed or partially-written rows. */
-                }
-            }
-        };
-        while ((bytesRead = fs.readSync(descriptor, buffer, 0, buffer.length, null)) > 0) {
-            consume(decoder.write(buffer.subarray(0, bytesRead)));
-        }
-        const finalValue = (remainder + decoder.end()).trim();
-        if (finalValue) {
-            try {
-                visit(JSON.parse(finalValue));
-            }
-            catch {
-                /* Ignore a malformed or partially-written final row. */
-            }
-        }
-    }
-    finally {
-        try {
-            fs.closeSync(descriptor);
-        }
-        catch {
-            /* Best effort. */
-        }
-    }
-}
-/** Recursively list matching regular files without following child symlinks. */
-export function walkLocalFiles(directory, matches, skipDirectory, output = []) {
-    let entries;
-    try {
-        entries = fs.readdirSync(directory, { withFileTypes: true });
-    }
-    catch {
-        return output;
-    }
-    for (const entry of entries) {
-        const absolute = path.join(directory, entry.name);
-        let stat;
-        try {
-            stat = fs.lstatSync(absolute);
-        }
-        catch {
-            continue;
-        }
-        if (stat.isSymbolicLink())
-            continue;
-        if (stat.isDirectory()) {
-            if (!skipDirectory(entry.name))
-                walkLocalFiles(absolute, matches, skipDirectory, output);
-        }
-        else if (stat.isFile() && matches(absolute)) {
-            output.push(absolute);
-        }
-    }
-    return output;
-}

package/dist/onboarding-stats.js

@@ -1,16 +0,0 @@
-/**
- * The onboarding page only needs session discovery and import state. Usage-audit calculations
- * (tokens, cost, context reads, recall ratios, and memory totals) are intentionally excluded.
- */
-export function buildOnboardingStatsPayload(input) {
-    return {
-        schemaVersion: 1,
-        ...(input.partial ? { partial: true } : {}),
-        discovery: input.discovery,
-        generatedFrom: ["~/.codex/sessions", "~/.claude/projects"],
-        llmCallsUsed: 0,
-        transcriptsUploaded: false,
-        sessions: input.sessions,
-        migratable: input.migratable,
-    };
-}