pi-mega-compact 0.13.0 → 0.13.2

package/dist/extensions/dashboard-server/api-contracts/embedder-health.js

@@ -0,0 +1,11 @@
+/**
+ * api-contracts/embedder-health.ts — Embedder health probe response types.
+ *
+ * Types for the GET /api/embedder-health endpoint used by the dashboard Setup
+ * tab's EmbedderHealthCard. Describes the result of round-tripping a test
+ * embed through the active embedder (latency + dimensions + reachability).
+ *
+ * PREVENT-PI-004: type definitions only, no network code.
+ * PREVENT-011: no `any` type — all types are explicit.
+ */
+export {};

package/dist/extensions/dashboard-server/api-contracts/endpoints/registry.js

@@ -0,0 +1,225 @@
+// ─── ENDPOINTS Registry ─────────────────────────────────────────────────────
+/**
+ * Central registry of all 14 dashboard API endpoints. Each entry is an
+ * `EndpointDef` or `SseEndpointDef` instance serving as the single source of
+ * truth for route paths, methods, descriptions, and typed request/response
+ * contracts.
+ *
+ * Usage:
+ *   import { ENDPOINTS } from './api-contracts';
+ *   ENDPOINTS.snapshot.path   // '/api/snapshot'
+ *   ENDPOINTS.snapshot.method // 'GET'
+ */
+export const ENDPOINTS = {
+    /** GET /api/snapshot — Full session, store, compression, and context snapshot. */
+    snapshot: {
+        method: "GET",
+        path: "/api/snapshot",
+        description: "Full session, store, compression, and context snapshot.",
+    },
+    /** GET /api/version — Dashboard server version string. */
+    version: {
+        method: "GET",
+        path: "/api/version",
+        description: "Dashboard server version for stale-server detection.",
+    },
+    /** GET /api/index — Multi-repo aggregate index (or fallback when unavailable). */
+    index: {
+        method: "GET",
+        path: "/api/index",
+        description: "Machine-wide multi-repo registry with checkpoints, tokens, and model info.",
+    },
+    /** GET /api/repos — Registry list with optional active-window filter. */
+    repos: {
+        method: "GET",
+        path: "/api/repos",
+        description: "Repo registry list, optionally filtered by recent activity.",
+    },
+    /** GET /api/summary — Lightweight header tiles without the full repo list. */
+    summary: {
+        method: "GET",
+        path: "/api/summary",
+        description: "Aggregate summary with active/total repo counts (no repo list).",
+    },
+    /** GET /api/drift — Cross-repo drift report. */
+    drift: {
+        method: "GET",
+        path: "/api/drift",
+        description: "Cross-repo drift report flagging stale repos, compaction lag, and model churn.",
+    },
+    /** GET /api/servers — Recently-active repo servers with live snapshot data. */
+    servers: {
+        method: "GET",
+        path: "/api/servers",
+        description: "Recently-active repo servers with live snapshot data.",
+    },
+    /** GET /api/events — SSE stream of dashboard events. */
+    events: {
+        type: "sse",
+        method: "GET",
+        path: "/api/events",
+        description: "Server-Sent Events stream of all dashboard events.",
+        event: "data",
+    },
+    /** GET /api/game-state — Current game-mode settings. */
+    getGameState: {
+        method: "GET",
+        path: "/api/game-state",
+        description: "Current game-mode configuration and active ritual state.",
+    },
+    /** PUT /api/game-state — Apply a partial patch to game-mode settings. */
+    putGameState: {
+        method: "PUT",
+        path: "/api/game-state",
+        description: "Apply a partial patch to game-mode settings and return the updated state.",
+    },
+    /** GET /api/game-scores — High-score leaderboard for a metric. */
+    gameScores: {
+        method: "GET",
+        path: "/api/game-scores",
+        description: "High-score leaderboard for a game metric.",
+    },
+    /** GET /api/perf — Rolling-window performance aggregates. */
+    perf: {
+        method: "GET",
+        path: "/api/perf",
+        description: "Rolling-window performance aggregates over perf_samples.",
+    },
+    /** GET /api/achievements — Achievement tiles with unlock state. */
+    achievements: {
+        method: "GET",
+        path: "/api/achievements",
+        description: "All achievement rows with unlock state.",
+    },
+    /** GET /api/sessions — Active sessions with latest token usage (S39). */
+    sessions: {
+        method: "GET",
+        path: "/api/sessions",
+        description: "Active pi sessions with latest token usage + heartbeat.",
+    },
+    /** GET /api/sessions/timeseries — Stacked per-session token timeseries (S39). */
+    sessionTimeseries: {
+        method: "GET",
+        path: "/api/sessions/timeseries",
+        description: "Recharts-ready per-session token timeseries for the stacked memory graph.",
+    },
+    /** GET /api/topics — Auto-categorizing wiki topics (S51). */
+    topics: {
+        method: "GET",
+        path: "/api/topics",
+        description: "Auto-categorized wiki topics from k-means + TF-IDF over real embeddings.",
+    },
+    /** GET /api/turns — Turn-by-turn memory tracking + recall (S52). */
+    turns: {
+        method: "GET",
+        path: "/api/turns",
+        description: "Per-conversation turn list with recall + epoch provenance (turn-by-turn memory tracking).",
+    },
+    /** GET /api/turns/conversation/:convId — per-turn detail + recall hits. */
+    conversationTurns: {
+        method: "GET",
+        path: "/api/turns/conversation/:convId",
+        description: "Per-turn metrics + injected-checkpoint recall provenance for one conversation.",
+    },
+    /** GET /api/turns/intents — pending rewind intents (S52A). */
+    turnIntents: {
+        method: "GET",
+        path: "/api/turns/intents",
+        description: "Pending rewind intents queued by the dashboard for the host to consume.",
+    },
+    /** POST /api/turns/intent — post a rewind intent. */
+    postTurnIntent: {
+        method: "POST",
+        path: "/api/turns/intent",
+        description: "Queue a rewind-to-turn-N intent for the host to apply at before_agent_start.",
+    },
+    /** POST /api/fork — fork a conversation at a turn. */
+    fork: {
+        method: "POST",
+        path: "/api/fork",
+        description: "Branch a child conversation off a parent turn + return the recall set to rehydrate.",
+    },
+    /** POST /api/turns/prune — admin prune (capability-gated). */
+    pruneTurns: {
+        method: "POST",
+        path: "/api/turns/prune",
+        description: "Prune old turns (admin capability — dashboard uses asAdmin()).",
+    },
+    /** GET /api/topics/:topicId/memories — wiki topic drill-down (S52). */
+    topicMemories: {
+        method: "GET",
+        path: "/api/topics/:topicId/memories",
+        description: "Member memories assigned to a wiki topic (drill-down).",
+    },
+    // ─── S49B Maintenance Tab ─────────────────────────────────────────
+    /** GET /api/maintenance — DB stats (table row counts + storage). */
+    maintenanceStats: {
+        method: "GET",
+        path: "/api/maintenance",
+        description: "SQLite table row counts, storage stats, and DB file sizes.",
+    },
+    /** GET /api/maintenance/schema-health — Schema version + integrity audit. */
+    schemaHealth: {
+        method: "GET",
+        path: "/api/maintenance/schema-health",
+        description: "SCHEMA_VERSION, PRAGMA integrity_check, FK check, and per-column audit.",
+    },
+    /** POST /api/maintenance/action — Trigger a maintenance action. */
+    maintenanceAction: {
+        method: "POST",
+        path: "/api/maintenance/action",
+        description: "Run vacuum, checkpoint, reindex, fts5-rebuild, reconcile-dedup, prune, or integrity-check.",
+    },
+    // ─── Provider Cache (Sprint A.2) ─────────────────────────────────
+    /** GET /api/provider-cache — Lifetime provider prompt cache aggregates + $ savings. */
+    providerCache: {
+        method: "GET",
+        path: "/api/provider-cache",
+        description: "Lifetime provider prompt cache hit-rate aggregates + dollar savings estimate.",
+    },
+    // ─── A3 Cache Stripes (PLAN_V2 Phase 4) ───────────────────────────
+    /** GET /api/cache-stripes — Per-stripe distribution + health score. */
+    cacheStripes: {
+        method: "GET",
+        path: "/api/cache-stripes",
+        description: "Per-stripe distribution counts, average stability scores, and composite cache health.",
+    },
+    // ─── Memory Effectiveness (S53B) ───────────────────────────────────────
+    /** GET /api/memory-status — Memory store aggregate statistics. */
+    memoryStatus: {
+        method: "GET",
+        path: "/api/memory-status",
+        description: "Memory store statistics: total count, 30-day window, top-N stable memories, avg recall score.",
+    },
+    /** GET /api/setup-status — Current embedder configuration. */
+    setupStatus: {
+        method: "GET",
+        path: "/api/setup-status",
+        description: "Current embedder configuration (which embedder is active, embedding URL, cache, MiniLM flag).",
+    },
+    /** GET /api/setup-detect — Detect available local embedder backends. */
+    setupDetect: {
+        method: "GET",
+        path: "/api/setup-detect",
+        description: "Best-effort detection of local embedder backends (ollama, llama.cpp, ONNX) available on the machine.",
+    },
+    /** POST /api/setup-configure — Write embedder config to .mega-compact.env. */
+    setupConfigure: {
+        method: "POST",
+        path: "/api/setup-configure",
+        description: "Write the chosen embedder configuration to .mega-compact.env (loaded at next startup). Returns whether a restart is required.",
+    },
+    // ─── RAPTOR tree (Part B) ───────────────────────────────────────
+    /** GET /api/raptor-tree — Hierarchical RAPTOR summary tree for a session. */
+    raptorTree: {
+        method: "GET",
+        path: "/api/raptor-tree",
+        description: "Hierarchical RAPTOR tree (summary nodes by level) for a session; defaults to the latest session with nodes.",
+    },
+    /** GET /api/embedder-health — Round-trip a test embed through the active embedder. */
+    embedderHealth: {
+        method: "GET",
+        path: "/api/embedder-health",
+        description: "Probe the active embedder with a test embed and report status, latency, dimensions, and masked URL.",
+    },
+};

package/dist/extensions/dashboard-server/api-contracts/endpoints/types.js

@@ -0,0 +1 @@
+export {};

package/dist/extensions/dashboard-server/api-contracts/endpoints.js

@@ -1,231 +1,12 @@
 /**
  * api-contracts/endpoints.ts — Central registry of all dashboard API endpoints.
  *
- * Single source of truth for all 13 dashboard API routes. Each entry is an
- * `EndpointDef` (or `SseEndpointDef` for SSE) instance with method, path,
- * description, and typed request/response references.
+ * Delegate-shell (extensions split): single source of truth for all dashboard
+ * API routes. The inline response types + game-types re-exports live in
+ * ./endpoints/types.ts and the ENDPOINTS object literal in ./endpoints/registry.ts;
+ * this pointer re-exports the full public surface unchanged.
  *
  * Sprint A1 — PREVENT-PI-004: zero network code (type definitions only).
  * PREVENT-011: no `any` type — all types are explicit.
  */
-// ─── Provider Cache Lifetime (A.2) — see provider-cache.ts ─────────────────
-// ─── Game Score & Achievement Types ─────────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-// ─── Sessions Memory Graph (S39) ─────────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-// ─── Game State Patch (PUT request body) ────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-// ─── SSE Endpoint Definition ────────────────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-// ─── ENDPOINTS Registry ─────────────────────────────────────────────────────
-/**
- * Central registry of all 14 dashboard API endpoints. Each entry is an
- * `EndpointDef` or `SseEndpointDef` instance serving as the single source of
- * truth for route paths, methods, descriptions, and typed request/response
- * contracts.
- *
- * Usage:
- *   import { ENDPOINTS } from './api-contracts';
- *   ENDPOINTS.snapshot.path   // '/api/snapshot'
- *   ENDPOINTS.snapshot.method // 'GET'
- */
-export const ENDPOINTS = {
-    /** GET /api/snapshot — Full session, store, compression, and context snapshot. */
-    snapshot: {
-        method: "GET",
-        path: "/api/snapshot",
-        description: "Full session, store, compression, and context snapshot.",
-    },
-    /** GET /api/version — Dashboard server version string. */
-    version: {
-        method: "GET",
-        path: "/api/version",
-        description: "Dashboard server version for stale-server detection.",
-    },
-    /** GET /api/index — Multi-repo aggregate index (or fallback when unavailable). */
-    index: {
-        method: "GET",
-        path: "/api/index",
-        description: "Machine-wide multi-repo registry with checkpoints, tokens, and model info.",
-    },
-    /** GET /api/repos — Registry list with optional active-window filter. */
-    repos: {
-        method: "GET",
-        path: "/api/repos",
-        description: "Repo registry list, optionally filtered by recent activity.",
-    },
-    /** GET /api/summary — Lightweight header tiles without the full repo list. */
-    summary: {
-        method: "GET",
-        path: "/api/summary",
-        description: "Aggregate summary with active/total repo counts (no repo list).",
-    },
-    /** GET /api/drift — Cross-repo drift report. */
-    drift: {
-        method: "GET",
-        path: "/api/drift",
-        description: "Cross-repo drift report flagging stale repos, compaction lag, and model churn.",
-    },
-    /** GET /api/servers — Recently-active repo servers with live snapshot data. */
-    servers: {
-        method: "GET",
-        path: "/api/servers",
-        description: "Recently-active repo servers with live snapshot data.",
-    },
-    /** GET /api/events — SSE stream of dashboard events. */
-    events: {
-        type: "sse",
-        method: "GET",
-        path: "/api/events",
-        description: "Server-Sent Events stream of all dashboard events.",
-        event: "data",
-    },
-    /** GET /api/game-state — Current game-mode settings. */
-    getGameState: {
-        method: "GET",
-        path: "/api/game-state",
-        description: "Current game-mode configuration and active ritual state.",
-    },
-    /** PUT /api/game-state — Apply a partial patch to game-mode settings. */
-    putGameState: {
-        method: "PUT",
-        path: "/api/game-state",
-        description: "Apply a partial patch to game-mode settings and return the updated state.",
-    },
-    /** GET /api/game-scores — High-score leaderboard for a metric. */
-    gameScores: {
-        method: "GET",
-        path: "/api/game-scores",
-        description: "High-score leaderboard for a game metric.",
-    },
-    /** GET /api/perf — Rolling-window performance aggregates. */
-    perf: {
-        method: "GET",
-        path: "/api/perf",
-        description: "Rolling-window performance aggregates over perf_samples.",
-    },
-    /** GET /api/achievements — Achievement tiles with unlock state. */
-    achievements: {
-        method: "GET",
-        path: "/api/achievements",
-        description: "All achievement rows with unlock state.",
-    },
-    /** GET /api/sessions — Active sessions with latest token usage (S39). */
-    sessions: {
-        method: "GET",
-        path: "/api/sessions",
-        description: "Active pi sessions with latest token usage + heartbeat.",
-    },
-    /** GET /api/sessions/timeseries — Stacked per-session token timeseries (S39). */
-    sessionTimeseries: {
-        method: "GET",
-        path: "/api/sessions/timeseries",
-        description: "Recharts-ready per-session token timeseries for the stacked memory graph.",
-    },
-    /** GET /api/topics — Auto-categorizing wiki topics (S51). */
-    topics: {
-        method: "GET",
-        path: "/api/topics",
-        description: "Auto-categorized wiki topics from k-means + TF-IDF over real embeddings.",
-    },
-    /** GET /api/turns — Turn-by-turn memory tracking + recall (S52). */
-    turns: {
-        method: "GET",
-        path: "/api/turns",
-        description: "Per-conversation turn list with recall + epoch provenance (turn-by-turn memory tracking).",
-    },
-    /** GET /api/turns/conversation/:convId — per-turn detail + recall hits. */
-    conversationTurns: {
-        method: "GET",
-        path: "/api/turns/conversation/:convId",
-        description: "Per-turn metrics + injected-checkpoint recall provenance for one conversation.",
-    },
-    /** GET /api/turns/intents — pending rewind intents (S52A). */
-    turnIntents: {
-        method: "GET",
-        path: "/api/turns/intents",
-        description: "Pending rewind intents queued by the dashboard for the host to consume.",
-    },
-    /** POST /api/turns/intent — post a rewind intent. */
-    postTurnIntent: {
-        method: "POST",
-        path: "/api/turns/intent",
-        description: "Queue a rewind-to-turn-N intent for the host to apply at before_agent_start.",
-    },
-    /** POST /api/fork — fork a conversation at a turn. */
-    fork: {
-        method: "POST",
-        path: "/api/fork",
-        description: "Branch a child conversation off a parent turn + return the recall set to rehydrate.",
-    },
-    /** POST /api/turns/prune — admin prune (capability-gated). */
-    pruneTurns: {
-        method: "POST",
-        path: "/api/turns/prune",
-        description: "Prune old turns (admin capability — dashboard uses asAdmin()).",
-    },
-    /** GET /api/topics/:topicId/memories — wiki topic drill-down (S52). */
-    topicMemories: {
-        method: "GET",
-        path: "/api/topics/:topicId/memories",
-        description: "Member memories assigned to a wiki topic (drill-down).",
-    },
-    // ─── S49B Maintenance Tab ─────────────────────────────────────────
-    /** GET /api/maintenance — DB stats (table row counts + storage). */
-    maintenanceStats: {
-        method: "GET",
-        path: "/api/maintenance",
-        description: "SQLite table row counts, storage stats, and DB file sizes.",
-    },
-    /** GET /api/maintenance/schema-health — Schema version + integrity audit. */
-    schemaHealth: {
-        method: "GET",
-        path: "/api/maintenance/schema-health",
-        description: "SCHEMA_VERSION, PRAGMA integrity_check, FK check, and per-column audit.",
-    },
-    /** POST /api/maintenance/action — Trigger a maintenance action. */
-    maintenanceAction: {
-        method: "POST",
-        path: "/api/maintenance/action",
-        description: "Run vacuum, checkpoint, reindex, fts5-rebuild, reconcile-dedup, prune, or integrity-check.",
-    },
-    // ─── Provider Cache (Sprint A.2) ─────────────────────────────────
-    /** GET /api/provider-cache — Lifetime provider prompt cache aggregates + $ savings. */
-    providerCache: {
-        method: "GET",
-        path: "/api/provider-cache",
-        description: "Lifetime provider prompt cache hit-rate aggregates + dollar savings estimate.",
-    },
-    // ─── A3 Cache Stripes (PLAN_V2 Phase 4) ───────────────────────────
-    /** GET /api/cache-stripes — Per-stripe distribution + health score. */
-    cacheStripes: {
-        method: "GET",
-        path: "/api/cache-stripes",
-        description: "Per-stripe distribution counts, average stability scores, and composite cache health.",
-    },
-    // ─── Memory Effectiveness (S53B) ───────────────────────────────────────
-    /** GET /api/memory-status — Memory store aggregate statistics. */
-    memoryStatus: {
-        method: "GET",
-        path: "/api/memory-status",
-        description: "Memory store statistics: total count, 30-day window, top-N stable memories, avg recall score.",
-    },
-    /** GET /api/setup-status — Current embedder configuration. */
-    setupStatus: {
-        method: "GET",
-        path: "/api/setup-status",
-        description: "Current embedder configuration (which embedder is active, embedding URL, cache, MiniLM flag).",
-    },
-    /** GET /api/setup-detect — Detect available local embedder backends. */
-    setupDetect: {
-        method: "GET",
-        path: "/api/setup-detect",
-        description: "Best-effort detection of local embedder backends (ollama, llama.cpp, ONNX) available on the machine.",
-    },
-    /** POST /api/setup-configure — Write embedder config to .mega-compact.env. */
-    setupConfigure: {
-        method: "POST",
-        path: "/api/setup-configure",
-        description: "Write the chosen embedder configuration to .mega-compact.env (loaded at next startup). Returns whether a restart is required.",
-    },
-};
+export { ENDPOINTS } from "./endpoints/registry.js";

package/dist/extensions/dashboard-server/api-contracts/raptor.js

@@ -0,0 +1,8 @@
+/**
+ * api-contracts/raptor.ts — RAPTOR tree API contract.
+ *
+ * Response shape for GET /api/raptor-tree: the hierarchical RAPTOR tree
+ * (summary nodes by level) for a session. Client-safe — the raw 512-dim
+ * embedding vector is stripped before sending.
+ */
+export {};

package/dist/extensions/dashboard-server/api-contracts.test/_helpers.js

@@ -0,0 +1,32 @@
+/**
+ * Shared runtime-helpers for the api-contracts split test files.
+ *
+ * Extracted from api-contracts.test.ts so each per-endpoint describe file can
+ * reuse the same field/type assertion primitives without duplicating them.
+ * Only runtime helpers live here — compile-time `satisfies` checks and the
+ * ENDPOINTS registry assertions stay in endpoints-registry.test.ts.
+ */
+import assert from "node:assert/strict";
+/** Primitive type name from a JSON-parsed value (matches typeof for JSON types). */
+export function primitiveType(v) {
+    if (v === null)
+        return "null";
+    if (Array.isArray(v))
+        return "array";
+    return typeof v;
+}
+/** Assert that a field exists on an object and has one of the expected primitive types. */
+export function assertField(obj, field, expected) {
+    assert.ok(field in obj, `field "${field}" must exist`);
+    const actual = primitiveType(obj[field]);
+    assert.ok(expected.includes(actual), `field "${field}" expected type ${expected.join("|")}, got ${actual}`);
+}
+/** Assert that a nested object field exists and is an object (or null if allowed). */
+export function assertObject(obj, field, allowNull = false) {
+    assert.ok(field in obj, `field "${field}" must exist`);
+    const val = obj[field];
+    if (allowNull && val === null)
+        return null;
+    assert.equal(primitiveType(val), "object", `field "${field}" must be an object${allowNull ? " or null" : ""}`);
+    return val;
+}

package/dist/extensions/dashboard-server/routes-cache.test/_helpers.js

@@ -0,0 +1,48 @@
+/**
+ * Shared harness + types for the routes-cache split files.
+ * Extracted from routes-cache.test.ts: spawn-and-fetch server harness + DTOs.
+ */
+import { mkdtempSync, rmSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+const SERVER_ENTRY = new URL("../server.js", import.meta.url).pathname;
+export function waitFor(cond, timeoutMs = 6000) {
+    const start = Date.now();
+    return new Promise((resolve, reject) => {
+        const tick = async () => {
+            if (await cond())
+                return resolve();
+            if (Date.now() - start > timeoutMs)
+                return reject(new Error("timeout"));
+            setTimeout(tick, 50);
+        };
+        tick();
+    });
+}
+export function freshDir(prefix) {
+    return mkdtempSync(join(tmpdir(), prefix));
+}
+export async function withServer(port, dir, fn) {
+    process.env.MEGACOMPACT_DASHBOARD_PORT = port;
+    const child = spawn(process.execPath, [SERVER_ENTRY, dir], { stdio: "ignore" });
+    try {
+        await waitFor(async () => {
+            try {
+                const raw = JSON.parse(readFileSync(join(dir, "port.pid"), "utf-8"));
+                const res = await fetch(`http://localhost:${raw.port}/api/version`);
+                return res.ok;
+            }
+            catch {
+                return false;
+            }
+        });
+        const raw = JSON.parse(readFileSync(join(dir, "port.pid"), "utf-8"));
+        return await fn(raw.port);
+    }
+    finally {
+        child.kill("SIGTERM");
+        delete process.env.MEGACOMPACT_DASHBOARD_PORT;
+        rmSync(dir, { recursive: true, force: true });
+    }
+}

package/dist/extensions/dashboard-server/routes-embedder-health.js

@@ -0,0 +1,67 @@
+/**
+ * dashboard-server/routes-embedder-health.ts — Embedder health probe route.
+ *
+ * GET /api/embedder-health — Round-trips a test embed through the active
+ * embedder and reports reachability + latency + dimensions.
+ *
+ * PREVENT-PI-004: probes the active embedder, which is either the built-in
+ * TrigramEmbedder (pure local math) or the HttpEmbedder pointed at a
+ * user-spawned localhost server — the existing audited loopback exception
+ * (see httpEmbedder.ts). No new network paths are introduced here.
+ */
+import { performance } from "node:perf_hooks";
+import { detectCurrentEmbedder } from "./routes-setup.js";
+import { defaultEmbedder } from "../../src/embedder.js";
+/** Mask an embedding URL down to scheme://hostname:port, stripping path +
+ *  any embedded credentials. Returns null when the env URL is unset/empty. */
+function maskEmbeddingUrl() {
+    const raw = process.env["MEGACOMPACT_EMBEDDING_URL"];
+    if (!raw || raw.trim().length === 0)
+        return null;
+    try {
+        const u = new URL(raw);
+        return `${u.protocol}//${u.hostname}${u.port ? `:${u.port}` : ""}`;
+    }
+    catch {
+        return null;
+    }
+}
+export function handleEmbedderHealth(req, res, _ctx) {
+    if (req.url !== "/api/embedder-health")
+        return false;
+    if (req.method !== "GET") {
+        // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+        res.writeHead(405, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "method_not_allowed" }));
+        return true;
+    }
+    const activeEmbedder = detectCurrentEmbedder();
+    const url = maskEmbeddingUrl();
+    let status = "ok";
+    let dim = 0;
+    let error;
+    const start = performance.now();
+    try {
+        const embedder = defaultEmbedder();
+        embedder.embed("mega-compact health probe");
+        dim = embedder.dim;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        status = /unreachable/i.test(msg) ? "unreachable" : "error";
+        error = msg;
+    }
+    const latencyMs = performance.now() - start;
+    const body = {
+        activeEmbedder,
+        status,
+        latencyMs,
+        dim,
+        url,
+        ...(error !== undefined ? { error } : {}),
+    };
+    // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(body));
+    return true;
+}