@runcore-sh/runcore 0.4.0 → 0.5.1

package/dist/lib/brain-migrate.js

@@ -0,0 +1,137 @@
+/**
+ * Brain v2 migration — moves from 30+ top-level directories to 3:
+ *   log/    ← append-only JSONL (memory, ops, metrics, ledger)
+ *   files/  ← everything else (knowledge, identity, content, etc.)
+ *   .config/ ← settings, access, locked paths
+ *
+ * Safe to run multiple times. Moves directories, doesn't copy.
+ * Creates symlinks from old paths to new locations for backward compat.
+ */
+import { join } from "node:path";
+import { rename, mkdir, cp, access } from "node:fs/promises";
+import { BRAIN_DIR, LOG_DIR, FILES_DIR, CONFIG_DIR, isBrainV2 } from "./paths.js";
+/** Directories that contain append-only JSONL data → move to log/ */
+const TO_LOG = ["memory", "ops", "metrics", "ledger"];
+/** Directories that contain searchable files → move to files/ */
+const TO_FILES = [
+    "identity", "knowledge", "content", "operations", "skills",
+    "templates", "contacts", "calendar", "scheduling", "training",
+    "library", "dictionary", "browser", "registry", "channels",
+    "runtime", "calibration", "compliance", "membrane", "inference",
+    "db", "compost",
+];
+/** Files/dirs that move to .config/ */
+const TO_CONFIG = [
+    "settings.json", ".locked", ".access", ".core", ".ui",
+    "vault.policy.yaml",
+];
+/** Directories that stay at top level (runtime state, not brain data) */
+const STAYS = ["agents", "sessions", "vault", "volumes", "webhooks", "files"];
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function moveIfExists(src, dest) {
+    if (!(await exists(src)))
+        return false;
+    if (await exists(dest)) {
+        // Dest already exists — merge by copying contents
+        try {
+            await cp(src, dest, { recursive: true, force: false, errorOnExist: false });
+        }
+        catch {
+            // If cp fails, skip — don't lose data
+            return false;
+        }
+        return true;
+    }
+    // Ensure parent exists
+    const parent = join(dest, "..");
+    await mkdir(parent, { recursive: true });
+    try {
+        await rename(src, dest);
+        return true;
+    }
+    catch {
+        // Cross-device rename — fall back to copy
+        try {
+            await cp(src, dest, { recursive: true });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Migrate a brain directory from legacy layout to v2.
+ * Safe to run multiple times — skips already-migrated items.
+ */
+export async function migrateBrainToV2() {
+    const result = { migrated: [], skipped: [], errors: [], alreadyV2: false };
+    if (isBrainV2()) {
+        result.alreadyV2 = true;
+        return result;
+    }
+    // Create v2 directories
+    await mkdir(LOG_DIR, { recursive: true });
+    await mkdir(FILES_DIR, { recursive: true });
+    await mkdir(CONFIG_DIR, { recursive: true });
+    // Move log directories
+    for (const dir of TO_LOG) {
+        const src = join(BRAIN_DIR, dir);
+        const dest = join(LOG_DIR, dir);
+        try {
+            if (await moveIfExists(src, dest)) {
+                result.migrated.push(`${dir} → log/${dir}`);
+            }
+            else {
+                result.skipped.push(dir);
+            }
+        }
+        catch (err) {
+            result.errors.push(`${dir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Move files directories
+    for (const dir of TO_FILES) {
+        const src = join(BRAIN_DIR, dir);
+        const dest = join(FILES_DIR, dir);
+        try {
+            if (await moveIfExists(src, dest)) {
+                result.migrated.push(`${dir} → files/${dir}`);
+            }
+            else {
+                result.skipped.push(dir);
+            }
+        }
+        catch (err) {
+            result.errors.push(`${dir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Move config items
+    for (const item of TO_CONFIG) {
+        const src = join(BRAIN_DIR, item);
+        const dest = join(CONFIG_DIR, item);
+        try {
+            if (await moveIfExists(src, dest)) {
+                result.migrated.push(`${item} → .config/${item}`);
+            }
+            else {
+                result.skipped.push(item);
+            }
+        }
+        catch (err) {
+            result.errors.push(`${item}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Write a marker so isBrainV2() detects the migration
+    // (LOG_DIR existence is the marker — it was just created)
+    return result;
+}
+//# sourceMappingURL=brain-migrate.js.map

package/dist/lib/brain-migrate.js.map

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

package/dist/lib/paths.d.ts

@@ -5,7 +5,34 @@
  * Packages are code only, no data ever. The brain lives outside the package,
  * configured via CORE_BRAIN_DIR (or DASH_BRAIN_DIR) environment variable.
  * Default: process.cwd() + "brain" for backward compatibility.
+ *
+ * Brain structure (v2 — simplified):
+ *   brain/
+ *     log/      ← append-only JSONL. The trail. Never rewrite.
+ *     files/    ← everything else. Searchable. Flat or shallow.
+ *     .config/  ← settings, access policies, locked paths. Plumbing.
+ *
+ * Legacy paths (memory/, ops/, knowledge/, identity/, etc.) are resolved
+ * with fallback for backward compatibility during migration.
  */
 /** Absolute path to the brain data directory. */
 export declare const BRAIN_DIR: string;
+/** Append-only JSONL — the audit trail, memory, activity, metrics. */
+export declare const LOG_DIR: string;
+/** Everything else — notes, research, identity, templates, contacts. Searchable. */
+export declare const FILES_DIR: string;
+/** Settings, access policies, locked paths. Plumbing. */
+export declare const CONFIG_DIR: string;
+/**
+ * Resolve a brain subdirectory, checking v2 structure first, falling back to legacy.
+ * Use this for any path that might exist under old OR new layout.
+ *
+ * Example: resolveBrainDir("memory") → brain/log (if migrated) or brain/memory (legacy)
+ */
+export declare function resolveBrainDir(subdir: string): string;
+/**
+ * Detect whether this brain uses v2 structure.
+ * True if brain/log/ exists. False means legacy layout.
+ */
+export declare function isBrainV2(): boolean;
 //# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,iDAAiD;AACjD,eAAO,MAAM,SAAS,EAAE,MAEvB,CAAC"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,iDAAiD;AACjD,eAAO,MAAM,SAAS,EAAE,MAEvB,CAAC;AAIF,sEAAsE;AACtE,eAAO,MAAM,OAAO,EAAE,MAA+B,CAAC;AAEtD,oFAAoF;AACpF,eAAO,MAAM,SAAS,EAAE,MAAiC,CAAC;AAE1D,yDAAyD;AACzD,eAAO,MAAM,UAAU,EAAE,MAAmC,CAAC;AAe7D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/lib/paths.js

@@ -5,9 +5,74 @@
  * Packages are code only, no data ever. The brain lives outside the package,
  * configured via CORE_BRAIN_DIR (or DASH_BRAIN_DIR) environment variable.
  * Default: process.cwd() + "brain" for backward compatibility.
+ *
+ * Brain structure (v2 — simplified):
+ *   brain/
+ *     log/      ← append-only JSONL. The trail. Never rewrite.
+ *     files/    ← everything else. Searchable. Flat or shallow.
+ *     .config/  ← settings, access policies, locked paths. Plumbing.
+ *
+ * Legacy paths (memory/, ops/, knowledge/, identity/, etc.) are resolved
+ * with fallback for backward compatibility during migration.
  */
 import { resolve, join } from "node:path";
+import { existsSync } from "node:fs";
 import { resolveEnv } from "../instance.js";
 /** Absolute path to the brain data directory. */
 export const BRAIN_DIR = resolve(resolveEnv("BRAIN_DIR") ?? join(process.cwd(), "brain"));
+// ── v2 structure ──────────────────────────────────────────────────────────────
+/** Append-only JSONL — the audit trail, memory, activity, metrics. */
+export const LOG_DIR = join(BRAIN_DIR, "log");
+/** Everything else — notes, research, identity, templates, contacts. Searchable. */
+export const FILES_DIR = join(BRAIN_DIR, "files");
+/** Settings, access policies, locked paths. Plumbing. */
+export const CONFIG_DIR = join(BRAIN_DIR, ".config");
+// ── Legacy path resolution ────────────────────────────────────────────────────
+/** Map of legacy directory names to their v2 parent. */
+const LEGACY_TO_LOG = ["memory", "ops", "metrics", "ledger"];
+const LEGACY_TO_FILES = [
+    "identity", "knowledge", "content", "operations", "skills",
+    "templates", "contacts", "calendar", "scheduling", "training",
+    "agents", "library", "dictionary", "browser", "sessions",
+    "registry", "channels", "vault", "files", "runtime",
+    "calibration", "compliance", "membrane", "inference", "db",
+    "compost",
+];
+/**
+ * Resolve a brain subdirectory, checking v2 structure first, falling back to legacy.
+ * Use this for any path that might exist under old OR new layout.
+ *
+ * Example: resolveBrainDir("memory") → brain/log (if migrated) or brain/memory (legacy)
+ */
+export function resolveBrainDir(subdir) {
+    // Check v2 structure first
+    if (LEGACY_TO_LOG.includes(subdir)) {
+        const v2 = join(LOG_DIR, subdir);
+        if (existsSync(v2))
+            return v2;
+        // Fall back to legacy flat path
+        const legacy = join(BRAIN_DIR, subdir);
+        if (existsSync(legacy))
+            return legacy;
+        return v2; // default to v2 for new files
+    }
+    if (LEGACY_TO_FILES.includes(subdir)) {
+        const v2 = join(FILES_DIR, subdir);
+        if (existsSync(v2))
+            return v2;
+        const legacy = join(BRAIN_DIR, subdir);
+        if (existsSync(legacy))
+            return legacy;
+        return v2;
+    }
+    // Unknown subdir — check under brain/ directly
+    return join(BRAIN_DIR, subdir);
+}
+/**
+ * Detect whether this brain uses v2 structure.
+ * True if brain/log/ exists. False means legacy layout.
+ */
+export function isBrainV2() {
+    return existsSync(LOG_DIR);
+}
 //# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,iDAAiD;AACjD,MAAM,CAAC,MAAM,SAAS,GAAW,OAAO,CACtC,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CACxD,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,iDAAiD;AACjD,MAAM,CAAC,MAAM,SAAS,GAAW,OAAO,CACtC,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CACxD,CAAC;AAEF,iFAAiF;AAEjF,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAW,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAEtD,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAW,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAE1D,yDAAyD;AACzD,MAAM,CAAC,MAAM,UAAU,GAAW,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAE7D,iFAAiF;AAEjF,wDAAwD;AACxD,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AACtE,MAAM,eAAe,GAAG;IACtB,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ;IAC1D,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU;IAC7D,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU;IACxD,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS;IACnD,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI;IAC1D,SAAS;CACD,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,2BAA2B;IAC3B,IAAK,aAAmC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,UAAU,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9B,gCAAgC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACtC,OAAO,EAAE,CAAC,CAAC,8BAA8B;IAC3C,CAAC;IAED,IAAK,eAAqC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,UAAU,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+CAA+C;IAC/C,OAAO,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/dist/llm/call-log.d.ts

@@ -0,0 +1,40 @@
+/**
+ * LLM call log — append-only JSONL receipt for every LLM call.
+ *
+ * Records the mechanical state of each call: which provider, which model,
+ * how it was resolved, how long it took. No prompts, no responses, no content.
+ * Just the state of the machine at the time of the turn.
+ *
+ * Writes to brain/memory/llm-calls.jsonl (data lives in brain, not code).
+ */
+export interface LlmCallEntry {
+    /** ISO timestamp */
+    ts: string;
+    /** "stream" or "complete" */
+    mode: "stream" | "complete";
+    /** Provider that actually handled the call */
+    provider: string;
+    /** Model that was actually used */
+    model: string;
+    /** How the provider was resolved: "settings", "env", "taskRoute", "fallback", "privateMode" */
+    routeSource?: string;
+    /** Task type if routed via taskRoutes */
+    taskType?: string;
+    /** Agent ID if this call was made by a spawned agent */
+    agentId?: string;
+    /** Duration in ms */
+    durationMs: number;
+    /** Estimated input tokens (chars/4) */
+    inputTokens?: number;
+    /** Estimated output tokens (chars/4) */
+    outputTokens?: number;
+    /** Whether the call succeeded */
+    ok: boolean;
+    /** Error message on failure (no stack traces) */
+    error?: string;
+}
+/**
+ * Append a call receipt to the log. Fire-and-forget — never throws.
+ */
+export declare function logLlmCall(entry: LlmCallEntry): Promise<void>;
+//# sourceMappingURL=call-log.d.ts.map

package/dist/llm/call-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-log.d.ts","sourceRoot":"","sources":["../../src/llm/call-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAanE"}

package/dist/llm/call-log.js

@@ -0,0 +1,35 @@
+/**
+ * LLM call log — append-only JSONL receipt for every LLM call.
+ *
+ * Records the mechanical state of each call: which provider, which model,
+ * how it was resolved, how long it took. No prompts, no responses, no content.
+ * Just the state of the machine at the time of the turn.
+ *
+ * Writes to brain/memory/llm-calls.jsonl (data lives in brain, not code).
+ */
+import { appendFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { BRAIN_DIR } from "../lib/paths.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("llm.call-log");
+const LOG_PATH = join(BRAIN_DIR, "memory", "llm-calls.jsonl");
+let ensuredDir = false;
+/**
+ * Append a call receipt to the log. Fire-and-forget — never throws.
+ */
+export async function logLlmCall(entry) {
+    try {
+        if (!ensuredDir) {
+            await mkdir(join(BRAIN_DIR, "memory"), { recursive: true });
+            ensuredDir = true;
+        }
+        const line = JSON.stringify(entry) + "\n";
+        await appendFile(LOG_PATH, line, "utf-8");
+    }
+    catch (err) {
+        log.warn("Failed to write call log", {
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=call-log.js.map

package/dist/llm/call-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-log.js","sourceRoot":"","sources":["../../src/llm/call-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC9D,IAAI,UAAU,GAAG,KAAK,CAAC;AA6BvB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAmB;IAClD,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC1C,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACnC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/llm/complete.d.ts

@@ -14,6 +14,12 @@ export interface CompleteChatOptions {
     noCache?: boolean;
     /** Override default TTL for this request (ms). */
     cacheTTLMs?: number;
+    /** How the provider/model was resolved (for call log). */
+    routeSource?: string;
+    /** Task type if routed via taskRoutes (for call log). */
+    taskType?: string;
+    /** Agent ID if called by a spawned agent (for call log). */
+    agentId?: string;
 }
 /**
  * Non-streaming chat completion. Returns the full assistant response as a string.

package/dist/llm/complete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/llm/complete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF"}
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/llm/complete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF"}

package/dist/llm/complete.js

@@ -11,6 +11,7 @@ import { withRetry } from "./retry.js";
 import { rehydrateResponse } from "./redact.js";
 import { createLogger } from "../utils/logger.js";
 import { recordLlmRequest } from "../metrics/collector.js";
+import { logLlmCall } from "./call-log.js";
 const log = createLogger("llm");
 /**
  * Non-streaming chat completion. Returns the full assistant response as a string.
@@ -57,6 +58,12 @@ async function completeChatUncached(options) {
         const durationMs = Math.round(performance.now() - startMs);
         const outputTokens = Math.ceil(result.length / 4);
         recordLlmRequest(options.provider, model, durationMs, inputTokens, outputTokens, true);
+        logLlmCall({
+            ts: new Date().toISOString(), mode: "complete",
+            provider: options.provider, model,
+            routeSource: options.routeSource, taskType: options.taskType, agentId: options.agentId,
+            durationMs, inputTokens, outputTokens, ok: true,
+        });
         return result;
     }
     catch (err) {
@@ -81,11 +88,31 @@ async function completeChatUncached(options) {
                 // Also record the original provider's failure
                 const failDurationMs = Math.round(fallbackStartMs - startMs);
                 recordLlmRequest(options.provider, model, failDurationMs, inputTokens, 0, false);
+                // Log both: the failed cloud call and the successful fallback
+                logLlmCall({
+                    ts: new Date().toISOString(), mode: "complete",
+                    provider: options.provider, model,
+                    routeSource: options.routeSource, taskType: options.taskType, agentId: options.agentId,
+                    durationMs: failDurationMs, inputTokens, ok: false, error: "credits_exhausted",
+                });
+                logLlmCall({
+                    ts: new Date().toISOString(), mode: "complete",
+                    provider: "ollama", model: ollama.defaultUtilityModel,
+                    routeSource: "fallback", taskType: options.taskType, agentId: options.agentId,
+                    durationMs: fallbackDurationMs, inputTokens, outputTokens: fallbackOutputTokens, ok: true,
+                });
                 return fallbackResult;
             }
         }
         const durationMs = Math.round(performance.now() - startMs);
         recordLlmRequest(options.provider, model, durationMs, inputTokens, 0, false);
+        logLlmCall({
+            ts: new Date().toISOString(), mode: "complete",
+            provider: options.provider, model,
+            routeSource: options.routeSource, taskType: options.taskType, agentId: options.agentId,
+            durationMs, inputTokens, ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        });
         throw err;
     }
 }

package/dist/llm/complete.js.map

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

package/dist/mcp-server.js

@@ -24,9 +24,10 @@ import { sendAlert } from "./alert.js";
 import { Crystallizer, scoreEntry } from "./crystallizer.js";
 import { createCredentialStore } from "./credentials/store.js";
 import { readSessionKey, isDpapiAvailable } from "./lib/dpapi.js";
+import { BrainRAG } from "./search/brain-rag.js";
 // ── Helpers ──────────────────────────────────────────────────────────────────
-import { BRAIN_DIR } from "./lib/paths.js";
-const MEMORY_DIR = join(BRAIN_DIR, "memory");
+import { BRAIN_DIR, resolveBrainDir } from "./lib/paths.js";
+const MEMORY_DIR = resolveBrainDir("memory");
 /** Log to stderr so stdout stays clean for MCP protocol. */
 function log(msg) {
     process.stderr.write(`[core-brain-mcp] ${msg}\n`);
@@ -108,6 +109,16 @@ async function main() {
     });
     await crystallizer.init();
     log(`Open loops loaded: ${crystallizer.list("open").length} active`);
+    // 6b. Initialize Brain RAG (semantic file search)
+    const mcpRag = new BrainRAG();
+    await mcpRag.load(); // Load existing embeddings (fast, no Ollama needed)
+    log(`Brain RAG loaded: ${mcpRag.ready ? "ready" : "empty"}`);
+    // Background index — catch up on any changed files
+    mcpRag.indexAll().then((r) => {
+        log(`Brain RAG index: ${r.indexed} indexed, ${r.skipped} skipped, ${r.errors} errors`);
+    }).catch((err) => {
+        log(`Brain RAG index failed: ${err instanceof Error ? err.message : String(err)}`);
+    });
     // 6. Create MCP server
     const mcp = new McpServer({
         name: "core-brain",
@@ -259,6 +270,111 @@ async function main() {
             };
         }
     }));
+    mcp.tool("files_search", "Search brain files (notes, research, identity, templates, protocols — everything except logs) by keyword. Returns matching filenames with context snippets.", {
+        query: z.string().min(1).max(500).describe("Search query — keywords to find in brain files"),
+        max: z.number().int().min(1).max(20).optional().describe("Max results (default 10)"),
+    }, async ({ query, max }) => runWithAuditContext({ caller: "mcp:files_search", channel: "mcp" }, async () => {
+        const maxResults = max ?? 10;
+        const terms = query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
+        if (terms.length === 0) {
+            return { content: [{ type: "text", text: "No search terms provided." }] };
+        }
+        // Scan all non-log directories for readable files (md, yaml, yml, json, txt)
+        const searchExts = new Set([".md", ".yaml", ".yml", ".json", ".txt", ".jsonl"]);
+        const skipDirs = new Set(["log", ".config", "ops", "metrics", ".obsidian", ".git", "node_modules"]);
+        const hits = [];
+        async function scanDir(dir, rel) {
+            let entries;
+            try {
+                entries = await readdir(dir);
+            }
+            catch {
+                return;
+            }
+            for (const name of entries) {
+                if (name.startsWith(".") && rel === "") {
+                    // Skip hidden dirs at top level except .config
+                    if (skipDirs.has(name))
+                        continue;
+                }
+                if (skipDirs.has(name))
+                    continue;
+                const full = join(dir, name);
+                const childRel = rel ? `${rel}/${name}` : name;
+                try {
+                    const s = await stat(full);
+                    if (s.isDirectory()) {
+                        // Don't recurse into JSONL-heavy log dirs
+                        if (name === "memory" || name === "logs" || name === "tasks" || name === "daily" || name === "hourly")
+                            continue;
+                        await scanDir(full, childRel);
+                    }
+                    else {
+                        const ext = name.substring(name.lastIndexOf(".")).toLowerCase();
+                        if (!searchExts.has(ext))
+                            continue;
+                        if (isLocked(childRel))
+                            continue;
+                        // Skip large JSONL files (those are log data, not knowledge)
+                        if (ext === ".jsonl" && s.size > 100_000)
+                            continue;
+                        const content = await readBrainFile(full);
+                        const lower = content.toLowerCase();
+                        let score = 0;
+                        for (const term of terms) {
+                            const idx = lower.indexOf(term);
+                            if (idx !== -1) {
+                                score++;
+                                // Bonus for title/filename match
+                                if (name.toLowerCase().includes(term))
+                                    score += 2;
+                            }
+                            // Match against full relative path (catches parent directory names)
+                            if (childRel.toLowerCase().includes(term))
+                                score += 2;
+                        }
+                        if (score > 0) {
+                            // Extract a snippet around the first match
+                            const firstTerm = terms.find((t) => lower.includes(t));
+                            const matchIdx = lower.indexOf(firstTerm);
+                            const start = Math.max(0, matchIdx - 80);
+                            const end = Math.min(content.length, matchIdx + 120);
+                            const snippet = (start > 0 ? "..." : "") +
+                                content.substring(start, end).replace(/\n/g, " ").trim() +
+                                (end < content.length ? "..." : "");
+                            hits.push({ relPath: childRel, score, snippet });
+                        }
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        await scanDir(BRAIN_DIR, "");
+        // If keyword search found nothing, try semantic search via RAG
+        if (hits.length === 0 && mcpRag?.ready) {
+            try {
+                const ragResults = await mcpRag.query(query, maxResults);
+                if (ragResults.length > 0) {
+                    const result = ragResults.map((r) => `📄 ${r.filePath} (semantic score: ${r.score.toFixed(3)}, section: ${r.heading})${r.siblings ? `\n   Also in directory: ${r.siblings.join(", ")}` : ""}`).join("\n\n");
+                    return {
+                        content: [{ type: "text", text: `Keyword search found nothing. Semantic search found ${ragResults.length} file(s):\n\n${result}` }],
+                    };
+                }
+            }
+            catch { /* semantic search failed — fall through */ }
+        }
+        if (hits.length === 0) {
+            return { content: [{ type: "text", text: `No files matched: "${query}"` }] };
+        }
+        hits.sort((a, b) => b.score - a.score);
+        const top = hits.slice(0, maxResults);
+        const result = top.map((h) => `📄 ${h.relPath} (score: ${h.score})\n   ${h.snippet}`).join("\n\n");
+        return {
+            content: [{ type: "text", text: `Found ${hits.length} file(s) matching "${query}":\n\n${result}` }],
+        };
+    }));
     mcp.tool("get_settings", "Return safe subset of Core settings (no keys or secrets)", {}, async () => {
         const s = getSettings();
         const safe = {