@sage-protocol/pi-adapter 0.4.3 → 0.5.1

package/dist/sage-pi-adapter.js

@@ -1,2862 +0,0 @@
-import { Type } from "@sinclair/typebox";
-import { spawn } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { createRequire } from "node:module";
-const require = createRequire(import.meta.url);
-// ── Unicode glyph fallback ──
-// Some terminals lack glyph support for arrows, checkmarks, and dotted separators.
-// Set SAGE_NO_UNICODE=1 to force ASCII-safe output in widget, summary, and quality icons.
-// Even in Unicode mode, we use → (U+2192) instead of ↳ (U+21B3) for wider terminal support.
-const GLYPH_FALLBACK = {
-    "\u00B7": "|", // Middle Dot
-    "\u2192": ">", // Rightwards Arrow (replaces ↳)
-    "\u21B3": ">", // Downwards Arrow with Tip Rightwards (legacy)
-    "\u2713": "[+]", // Check Mark
-    "\u26A0": "[!]", // Warning Sign
-    "\u2717": "[-]", // Ballot X
-    "\u25CF": "*", // Black Circle (status: healthy)
-    "\u25D0": "~", // Circle with Left Half Black (status: degraded)
-    "\u25CB": "o", // White Circle (status: offline)
-    "\u2026": "...", // Horizontal Ellipsis (activity hint)
-};
-function isAsciiMode() {
-    const env = process.env.SAGE_NO_UNICODE;
-    return env === "1" || env === "true" || env === "yes";
-}
-export function unicodeSafe(text) {
-    if (!isAsciiMode())
-        return text;
-    let out = "";
-    for (const ch of text) {
-        out += GLYPH_FALLBACK[ch] ?? ch;
-    }
-    return out;
-}
-const SAGE_ENV_PASSTHROUGH = [
-    "SAGE_FILTER_EXECUTION",
-    "SAGE_SKILL_USED",
-    "SAGE_SKILL_OUTCOME",
-    "SAGE_SOURCE",
-    "SAGE_SESSION_ID",
-];
-function sagePassthroughEnv() {
-    const env = {};
-    for (const key of SAGE_ENV_PASSTHROUGH) {
-        const value = process.env[key];
-        if (value !== undefined)
-            env[key] = value;
-    }
-    return env;
-}
-const SAGE_COMMAND_TIMEOUT_KILL_GRACE_MS = 500;
-const SAGE_SOFT_COMMAND_LOG_COOLDOWN_MS = 60_000;
-const SAGE_HOOK_TIMEOUTS = {
-    sessionContext: 4_000,
-    skillVisibility: 2_500,
-    suggest: 4_000,
-    capture: 1_500,
-    feedback: 1_500,
-    securityScan: 4_000,
-    resolveSkill: 4_000,
-    quality: 3_000,
-};
-function formatSageCommand(command, args) {
-    const quoted = [command, ...args].map((part) => {
-        if (!part)
-            return "''";
-        return /[\s"'`$\\]/.test(part) ? JSON.stringify(part) : part;
-    });
-    return quoted.join(" ");
-}
-const CODE_MODE_SEARCH_TOOLS = ["sage_search", "sage_code_sage_search"];
-const CODE_MODE_EXECUTE_TOOLS = ["sage_execute", "sage_code_sage_execute"];
-const SEARCH_ACTION_ALIASES = {
-    skills: {
-        search_skills: "search",
-        list_skills: "list",
-        get_skill: "get",
-        use_skill: "use",
-        sync_skills: "sync",
-    },
-    prompts: {
-        search_prompts: "search",
-        list_prompts: "list",
-        get_prompt: "get",
-    },
-    external: {
-        list_external_servers: "list_servers",
-        search_external: "search",
-    },
-    hub: {
-        hub_list_servers: "list_servers",
-        hub_status: "status",
-        hub_session_list: "session_list",
-    },
-};
-const EXECUTE_ACTION_ALIASES = {
-    skills: {
-        use_skill: "use",
-        sync_skills: "sync",
-    },
-    library: {
-        skill_add: "skill_add",
-        skill_remove: "skill_remove",
-        skill_move: "skill_move",
-    },
-    external: {
-        execute_external: "execute",
-        call_external: "call",
-    },
-    hub: {
-        hub_start_server: "start",
-        hub_stop_server: "stop",
-    },
-};
-const EXTERNAL_SEARCH_ACTIONS = new Set(["list_servers", "search"]);
-const EXTERNAL_EXECUTE_ACTIONS = new Set(["execute", "call"]);
-const EXTERNAL_TOOL_ALIASES = {
-    web_search: "duckduckgo_web_search",
-};
-const WEB_SEARCH_PROVIDER_TOOLS = new Set([
-    "duckduckgo_web_search",
-    "brave_web_search",
-]);
-const WEB_SEARCH_RETRY_PATTERNS = [
-    /ddg detected an anomaly/i,
-    /too quickly/i,
-    /rate\s*limit/i,
-    /\b429\b/,
-    /temporarily unavailable/i,
-    /timed out/i,
-    /timeout/i,
-    /socket hang up/i,
-    /econnreset/i,
-    /network error/i,
-];
-const WEB_SEARCH_MAX_ATTEMPTS_PER_PROVIDER = 2;
-const WEB_SEARCH_MIN_INTERVAL_MS = 250;
-const WEB_SEARCH_RETRY_BASE_MS = 250;
-const LAST_WEB_SEARCH_CALL_BY_PROVIDER = new Map();
-const DAEMON_IPC_MAX_ATTEMPTS = Math.max(1, Number.parseInt(process.env.SAGE_DAEMON_IPC_MAX_ATTEMPTS || "3", 10) || 3);
-const DAEMON_IPC_RETRY_BASE_MS = Math.max(50, Number.parseInt(process.env.SAGE_DAEMON_IPC_RETRY_BASE_MS || "350", 10) ||
-    350);
-const DOMAINLESS_ACTION_DOMAIN_HINTS = {
-    search: "prompts",
-    list: "prompts",
-    get: "prompts",
-    search_prompts: "prompts",
-    list_prompts: "prompts",
-    get_prompt: "prompts",
-    use: "skills",
-    sync: "skills",
-    search_skills: "skills",
-    list_skills: "skills",
-    get_skill: "skills",
-    use_skill: "skills",
-    sync_skills: "skills",
-    recommend: "builder",
-    suggest: "meta",
-    skill_add: "library",
-    skill_remove: "library",
-    skill_move: "library",
-    status: "hub",
-    list_servers: "hub",
-    session_list: "hub",
-    start: "hub",
-    stop: "hub",
-    hub_list_servers: "hub",
-    hub_status: "hub",
-    hub_session_list: "hub",
-    hub_start_server: "hub",
-    hub_stop_server: "hub",
-    search_external: "external",
-    list_external_servers: "external",
-    execute_external: "external",
-    call_external: "external",
-};
-const DEFAULT_SEARCH_ACTION_BY_DOMAIN = {
-    prompts: "list",
-    behaviors: "recommend",
-    skills: "list",
-    builder: "recommend",
-    governance: "list_subdaos",
-    chat: "list_rooms",
-    social: "following",
-    rlm: "stats",
-    library_sync: "sync",
-    security: "scan",
-    meta: "get_project_context",
-    hub: "status",
-    activation: "active",
-    wallet: "balance",
-    library: "get_active",
-    help: "list",
-    external: "list_servers",
-};
-const DOMAINLESS_ACTIONS = new Set(Object.keys(DOMAINLESS_ACTION_DOMAIN_HINTS));
-function mapExternalToolAlias(toolName) {
-    const normalized = toolName.trim().toLowerCase();
-    if (normalized === "web_search") {
-        return hasBraveApiKey() ? "brave_web_search" : "duckduckgo_web_search";
-    }
-    return EXTERNAL_TOOL_ALIASES[normalized] ?? normalized;
-}
-/**
- * Check whether the Brave API key is likely available.
- * We check both the local process environment AND assume availability when
- * the brave-search hub server has been configured (its env vars are injected
- * by the Sage daemon at server spawn time, not exposed to this process).
- * The resilience layer will naturally skip Brave if the call actually fails,
- * so a false-positive here is harmless.
- */
-function hasBraveApiKey() {
-    // Always return true -- Brave should be tried as a fallback provider.
-    // The key lives in Sage hub env (injected at server spawn time), not in
-    // this process's env, so process.env.BRAVE_API_KEY is almost never set.
-    // If Brave isn't configured, the MCP call will fail and the resilience
-    // layer moves to the next provider.
-    return true;
-}
-function toErrorMessage(error) {
-    if (error instanceof Error)
-        return error.message;
-    return String(error);
-}
-function isTransientWebSearchError(error) {
-    const msg = toErrorMessage(error);
-    return WEB_SEARCH_RETRY_PATTERNS.some((pattern) => pattern.test(msg));
-}
-function isTransientDaemonIpcError(error) {
-    const msg = toErrorMessage(error).toLowerCase();
-    return (msg.includes("daemon ipc failed") ||
-        msg.includes("resource temporarily unavailable") ||
-        msg.includes("os error 35") ||
-        msg.includes("eagain") ||
-        msg.includes("temporarily unavailable"));
-}
-function getExternalWebSearchTool(request) {
-    if (request.domain !== "external")
-        return "";
-    if (request.action === "list_servers")
-        return "";
-    const toolName = request.params.tool_name;
-    if (typeof toolName !== "string")
-        return "";
-    return toolName.trim().toLowerCase();
-}
-function webSearchProviderOrder(requestedTool) {
-    const order = [];
-    const add = (provider) => {
-        if (!provider || order.includes(provider))
-            return;
-        order.push(provider);
-    };
-    // If a specific provider was requested, put it first with the other as fallback
-    if (requestedTool === "brave_web_search") {
-        add("brave_web_search");
-        add("duckduckgo_web_search");
-        return order;
-    }
-    if (requestedTool === "duckduckgo_web_search") {
-        add("duckduckgo_web_search");
-        add("brave_web_search");
-        return order;
-    }
-    // Default: Brave first (more reliable, no rate limiting), DuckDuckGo as fallback
-    add("brave_web_search");
-    add("duckduckgo_web_search");
-    return order;
-}
-async function wait(ms) {
-    if (ms <= 0)
-        return;
-    await new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function enforceWebSearchPacing(provider) {
-    const now = Date.now();
-    const last = LAST_WEB_SEARCH_CALL_BY_PROVIDER.get(provider) ?? 0;
-    const elapsed = now - last;
-    if (elapsed < WEB_SEARCH_MIN_INTERVAL_MS) {
-        await wait(WEB_SEARCH_MIN_INTERVAL_MS - elapsed);
-    }
-    LAST_WEB_SEARCH_CALL_BY_PROVIDER.set(provider, Date.now());
-}
-function retryBackoffMs(attempt) {
-    const jitter = Math.floor(Math.random() * 200);
-    return WEB_SEARCH_RETRY_BASE_MS * 2 ** Math.max(attempt - 1, 0) + jitter;
-}
-function daemonRetryBackoffMs(attempt) {
-    const jitter = Math.floor(Math.random() * 150);
-    return DAEMON_IPC_RETRY_BASE_MS * 2 ** Math.max(attempt - 1, 0) + jitter;
-}
-async function callWithDaemonRetry(call, args) {
-    let lastError;
-    for (let attempt = 1; attempt <= DAEMON_IPC_MAX_ATTEMPTS; attempt += 1) {
-        try {
-            return await call(args);
-        }
-        catch (error) {
-            lastError = error;
-            const retryable = isTransientDaemonIpcError(error);
-            if (!retryable || attempt >= DAEMON_IPC_MAX_ATTEMPTS)
-                throw error;
-            await wait(daemonRetryBackoffMs(attempt));
-        }
-    }
-    throw lastError instanceof Error
-        ? lastError
-        : new Error(String(lastError ?? "unknown daemon IPC failure"));
-}
-function withExternalToolName(request, toolName) {
-    return {
-        ...request,
-        params: {
-            ...request.params,
-            tool_name: toolName,
-        },
-    };
-}
-async function callCodeModeWithWebResilience(mcpBridge, mode, request) {
-    const call = mode === "search"
-        ? (args) => mcpBridge.callCodeModeSearch(args)
-        : (args) => mcpBridge.callCodeModeExecute(args);
-    const requestedTool = getExternalWebSearchTool(request);
-    if (!WEB_SEARCH_PROVIDER_TOOLS.has(requestedTool)) {
-        return callWithDaemonRetry(call, request);
-    }
-    const providers = webSearchProviderOrder(requestedTool);
-    const failures = [];
-    for (const provider of providers) {
-        const providerRequest = withExternalToolName(request, provider);
-        for (let attempt = 1; attempt <= WEB_SEARCH_MAX_ATTEMPTS_PER_PROVIDER; attempt += 1) {
-            try {
-                await enforceWebSearchPacing(provider);
-                return await callWithDaemonRetry(call, providerRequest);
-            }
-            catch (error) {
-                failures.push(`${provider} (attempt ${attempt}): ${toErrorMessage(error)}`);
-                const shouldRetry = isTransientWebSearchError(error) &&
-                    attempt < WEB_SEARCH_MAX_ATTEMPTS_PER_PROVIDER;
-                if (shouldRetry) {
-                    await wait(retryBackoffMs(attempt));
-                    continue;
-                }
-                break;
-            }
-        }
-    }
-    throw new Error(`Web search failed after trying providers. ${failures.join(" | ")}`);
-}
-function normalizeParams(input) {
-    return input && typeof input === "object" && !Array.isArray(input)
-        ? input
-        : {};
-}
-function looksLikeExternalToolAction(action) {
-    if (!action)
-        return false;
-    if (EXTERNAL_TOOL_ALIASES[action])
-        return true;
-    if (DOMAINLESS_ACTIONS.has(action))
-        return false;
-    return action.includes("_");
-}
-function normalizeCodeModeRequest(mode, args) {
-    const rawDomain = String(args.domain ?? "")
-        .trim()
-        .toLowerCase();
-    const rawAction = String(args.action ?? "")
-        .trim()
-        .toLowerCase();
-    const payload = normalizeParams(args.params);
-    if (!rawAction) {
-        if (mode === "search") {
-            const fallbackDomain = rawDomain || "help";
-            const fallbackAction = DEFAULT_SEARCH_ACTION_BY_DOMAIN[fallbackDomain] ||
-                DEFAULT_SEARCH_ACTION_BY_DOMAIN.help;
-            return {
-                domain: fallbackDomain,
-                action: fallbackAction,
-                params: payload,
-            };
-        }
-        throw new Error("Missing required parameter 'action'");
-    }
-    if (!rawDomain && looksLikeExternalToolAction(rawAction)) {
-        return {
-            domain: "external",
-            action: mode === "search" ? "search" : "call",
-            params: {
-                tool_name: mapExternalToolAlias(rawAction),
-                tool_params: payload,
-            },
-        };
-    }
-    const domain = rawDomain || DOMAINLESS_ACTION_DOMAIN_HINTS[rawAction] || "";
-    if (!domain) {
-        throw new Error("Missing required parameter 'domain'. Include a Sage domain like prompts, skills, or external.");
-    }
-    const action = normalizeAction(mode === "search" ? SEARCH_ACTION_ALIASES : EXECUTE_ACTION_ALIASES, domain, rawAction);
-    if (domain === "external") {
-        const allowedActions = mode === "search" ? EXTERNAL_SEARCH_ACTIONS : EXTERNAL_EXECUTE_ACTIONS;
-        if (!allowedActions.has(action)) {
-            return {
-                domain,
-                action: mode === "search" ? "search" : "call",
-                params: {
-                    tool_name: mapExternalToolAlias(action),
-                    tool_params: payload,
-                },
-            };
-        }
-        if (action !== "list_servers" &&
-            typeof payload.tool_name === "string" &&
-            payload.tool_name.trim()) {
-            return {
-                domain,
-                action,
-                params: {
-                    ...payload,
-                    tool_name: mapExternalToolAlias(payload.tool_name),
-                },
-            };
-        }
-    }
-    return { domain, action, params: payload };
-}
-function normalizeAction(aliasesByDomain, domain, action) {
-    const normalizedDomain = domain.trim().toLowerCase();
-    const normalizedAction = action.trim().toLowerCase();
-    if (!normalizedAction)
-        return "";
-    const domainAliases = aliasesByDomain[normalizedDomain];
-    if (!domainAliases)
-        return normalizedAction;
-    return domainAliases[normalizedAction] ?? normalizedAction;
-}
-export async function defaultSageCommandRunner(request) {
-    return new Promise((resolve, reject) => {
-        const proc = spawn(request.command, request.args, {
-            cwd: request.cwd,
-            env: { ...process.env, ...request.env },
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-        let stdout = "";
-        let stderr = "";
-        let timedOut = false;
-        let settled = false;
-        let killEscalation = null;
-        const timeout = setTimeout(() => {
-            timedOut = true;
-            proc.kill("SIGTERM");
-            killEscalation = setTimeout(() => {
-                if (settled)
-                    return;
-                proc.kill("SIGKILL");
-            }, SAGE_COMMAND_TIMEOUT_KILL_GRACE_MS);
-        }, request.timeoutMs);
-        const finish = (result) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timeout);
-            if (killEscalation)
-                clearTimeout(killEscalation);
-            resolve(result);
-        };
-        const fail = (err) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timeout);
-            if (killEscalation)
-                clearTimeout(killEscalation);
-            reject(err);
-        };
-        proc.on("error", (err) => {
-            fail(err);
-        });
-        proc.stdin.on("error", (err) => {
-            fail(err instanceof Error ? err : new Error(String(err)));
-        });
-        proc.stdout.setEncoding("utf8");
-        proc.stderr.setEncoding("utf8");
-        proc.stdout.on("data", (chunk) => {
-            stdout += chunk;
-        });
-        proc.stderr.on("data", (chunk) => {
-            stderr += chunk;
-        });
-        proc.on("close", (code) => {
-            finish({
-                exitCode: code ?? -1,
-                stdout,
-                stderr,
-                timedOut,
-            });
-        });
-        if (!request.stdin) {
-            proc.stdin.end();
-            return;
-        }
-        if (!proc.stdin.writable || proc.stdin.destroyed) {
-            proc.stdin.end();
-            return;
-        }
-        proc.stdin.end(request.stdin, (err) => {
-            if (!err)
-                return;
-            fail(err instanceof Error ? err : new Error(String(err)));
-        });
-    });
-}
-function extractText(input) {
-    if (typeof input === "string")
-        return input;
-    if (Array.isArray(input)) {
-        return input
-            .map((block) => {
-            if (!block || typeof block !== "object")
-                return "";
-            const text = block.text;
-            return typeof text === "string" ? text : "";
-        })
-            .filter(Boolean)
-            .join("\n")
-            .trim();
-    }
-    if (!input || typeof input !== "object")
-        return "";
-    const obj = input;
-    const direct = [obj.text, obj.content, obj.prompt, obj.message, obj.input];
-    for (const candidate of direct) {
-        if (typeof candidate === "string" && candidate.trim())
-            return candidate.trim();
-    }
-    if (Array.isArray(obj.content)) {
-        const fromBlocks = obj.content
-            .map((block) => {
-            if (!block || typeof block !== "object")
-                return "";
-            const blockText = block.text;
-            return typeof blockText === "string" ? blockText : "";
-        })
-            .filter(Boolean)
-            .join("\n")
-            .trim();
-        if (fromBlocks)
-            return fromBlocks;
-    }
-    return "";
-}
-function extractUsage(input) {
-    if (!input || typeof input !== "object")
-        return {};
-    const obj = input;
-    const usage = (obj.usage && typeof obj.usage === "object"
-        ? obj.usage
-        : undefined) ?? obj;
-    const toStringOrUndefined = (value) => {
-        if (typeof value === "string" && value.trim())
-            return value.trim();
-        if (typeof value === "number" && Number.isFinite(value))
-            return String(value);
-        return undefined;
-    };
-    return {
-        input: toStringOrUndefined(usage.tokens_input) ??
-            toStringOrUndefined(usage.input_tokens) ??
-            toStringOrUndefined(usage.inputTokens),
-        output: toStringOrUndefined(usage.tokens_output) ??
-            toStringOrUndefined(usage.output_tokens) ??
-            toStringOrUndefined(usage.outputTokens),
-    };
-}
-function parseMessageEndEvent(event) {
-    if (!event || typeof event !== "object")
-        return null;
-    const root = event;
-    if (root.type !== "message_end")
-        return null;
-    const message = root.message;
-    if (!message || typeof message !== "object")
-        return null;
-    const msg = message;
-    const role = typeof msg.role === "string" ? msg.role : "";
-    if (!role)
-        return null;
-    const content = extractText(msg.content ?? msg);
-    return { role, content, usage: msg.usage };
-}
-function extractJsonFromMcpResult(result) {
-    if (!result || typeof result !== "object")
-        return undefined;
-    const obj = result;
-    if (!Array.isArray(obj.content) || obj.content.length === 0)
-        return undefined;
-    const text = obj.content
-        .map((entry) => {
-        if (!entry || typeof entry !== "object")
-            return "";
-        const raw = entry.text;
-        return typeof raw === "string" ? raw : "";
-    })
-        .filter(Boolean)
-        .join("\n");
-    if (!text)
-        return undefined;
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return undefined;
-    }
-}
-function toToolResultText(result) {
-    return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-        details: result,
-    };
-}
-function appendText(result, text) {
-    const existing = Array.isArray(result.content) ? [...result.content] : [];
-    existing.push({ type: "text", text });
-    return { ...result, content: existing };
-}
-let hostPiTuiResolved = false;
-let hostPiTui = null;
-function loadHostPiTui() {
-    if (hostPiTuiResolved)
-        return hostPiTui;
-    hostPiTuiResolved = true;
-    const anchors = [];
-    const entry = typeof process !== "undefined" && Array.isArray(process.argv) ? process.argv[1] : undefined;
-    if (entry)
-        anchors.push(entry); // pi process entry — sibling pi-tui
-    anchors.push(import.meta.url); // adapter-local (usually fails, kept last)
-    for (const anchor of anchors) {
-        let req;
-        try {
-            req = createRequire(anchor);
-        }
-        catch {
-            continue;
-        }
-        for (const name of ["@earendil-works/pi-tui", "@mariozechner/pi-tui"]) {
-            try {
-                const mod = req(name);
-                if (mod && typeof mod.Text === "function") {
-                    hostPiTui = mod;
-                    return mod;
-                }
-            }
-            catch {
-                /* try next anchor/name */
-            }
-        }
-    }
-    hostPiTui = null;
-    return null;
-}
-/** Return terminal-visible width while ignoring ANSI SGR sequences. */
-export function visibleWidthOf(line) {
-    const mod = loadHostPiTui();
-    if (mod?.visibleWidth) {
-        try {
-            return mod.visibleWidth(line);
-        }
-        catch {
-            /* fall through to the dependency-free counter */
-        }
-    }
-    // eslint-disable-next-line no-control-regex
-    return [...line.replace(/\x1b\[[0-9;]*m/g, "")].length;
-}
-/** Truncate one ANSI-styled line without counting styling bytes as columns. */
-export function truncateLineToWidth(line, width) {
-    const cols = Number.isFinite(width) && width > 0 ? Math.floor(width) : 80;
-    if (visibleWidthOf(line) <= cols)
-        return line;
-    const mod = loadHostPiTui();
-    if (mod?.truncateToWidth) {
-        try {
-            return mod.truncateToWidth(line, cols);
-        }
-        catch {
-            /* fall through to the dependency-free truncator */
-        }
-    }
-    // Preserve SGR styling while counting only visible code points.
-    // eslint-disable-next-line no-control-regex
-    const tokens = line.match(/\x1b\[[0-9;]*m|./gu) ?? [];
-    let visible = 0;
-    let sawStyle = false;
-    let result = "";
-    for (const token of tokens) {
-        // eslint-disable-next-line no-control-regex
-        if (/^\x1b\[[0-9;]*m$/.test(token)) {
-            result += token;
-            sawStyle = true;
-            continue;
-        }
-        if (visible >= cols)
-            break;
-        result += token;
-        visible += 1;
-    }
-    if (sawStyle && !result.endsWith("\x1b[0m"))
-        result += "\x1b[0m";
-    return result;
-}
-/** Clamp a line so custom TUI/status rendering cannot exceed terminal width. */
-export function clampLineToWidth(line, width) {
-    return truncateLineToWidth(line, width);
-}
-function createTextComponent(text) {
-    // Canonical path: return the host pi-tui's real Text component. It wraps via
-    // wrapTextWithAnsi and is always width-safe, preserving theme colors.
-    const mod = loadHostPiTui();
-    if (mod?.Text)
-        return new mod.Text(text, 0, 0);
-    // Safety net only if the host pi-tui genuinely cannot be resolved. The object
-    // MUST satisfy pi-tui's child contract — pi's Box.render calls
-    // `child.render(width)` and `child.invalidate()` — and every returned line
-    // MUST fit `width` (pi throws "Rendered line exceeds terminal width"
-    // otherwise). The `width` Box passes is already the content width, so wrap to
-    // the full value; strip ANSI so char length equals visible width.
-    return {
-        text,
-        setText(next) {
-            this.text = next;
-        },
-        invalidate() {
-            /* no cached render state to clear */
-        },
-        render(width) {
-            const raw = String(this.text ?? "");
-            if (raw === "")
-                return [];
-            const cols = typeof width === "number" && Number.isFinite(width) && width > 0
-                ? Math.floor(width)
-                : 80;
-            // eslint-disable-next-line no-control-regex
-            const ansi = /\x1b\[[0-9;]*m/g;
-            const lines = [];
-            for (const para of raw.replace(/\t/g, "   ").replace(ansi, "").split("\n")) {
-                if (para.length === 0) {
-                    lines.push("");
-                }
-                else {
-                    for (let i = 0; i < para.length; i += cols) {
-                        lines.push(para.slice(i, i + cols));
-                    }
-                }
-            }
-            return lines;
-        },
-    };
-}
-/**
- * Reuse the previous render's Text component when possible (pi docs
- * recommend mutating `context.lastComponent` instead of recreating, which
- * avoids TUI churn during streaming re-renders).
- */
-function textComponent(context, text) {
-    const last = context
-        ?.lastComponent;
-    if (last && typeof last.setText === "function") {
-        last.setText(text);
-        return last;
-    }
-    return createTextComponent(text);
-}
-function truncateText(text, max = 80) {
-    return text.length > max ? `${text.slice(0, Math.max(0, max - 3))}...` : text;
-}
-function quotedText(text, max = 72) {
-    return `"${truncateText(text, max)}"`;
-}
-function stringValue(value) {
-    return typeof value === "string" && value.trim() ? value.trim() : undefined;
-}
-function toolParamValue(request) {
-    return normalizeParams(request.params.tool_params);
-}
-function normalizeRenderRequest(mode, args) {
-    try {
-        return normalizeCodeModeRequest(mode, normalizeParams(args));
-    }
-    catch {
-        return null;
-    }
-}
-function formatOperationSubject(request) {
-    if (request.domain === "external") {
-        const toolName = stringValue(request.params.tool_name) ?? "tool";
-        return `${request.action} ${toolName}`;
-    }
-    return `${request.domain}/${request.action}`;
-}
-function summarizeInventoryItem(value) {
-    if (typeof value === "string" && value.trim()) {
-        return truncateText(value.trim(), 96);
-    }
-    if (!value || typeof value !== "object")
-        return null;
-    const item = value;
-    const toolName = stringValue(item.tool_name);
-    const sessionId = stringValue(item.session_id);
-    const instanceId = stringValue(item.instance_id);
-    const serverId = stringValue(item.server_id) ?? stringValue(item.id) ?? instanceId;
-    if (toolName && serverId) {
-        return truncateText(`${toolName} @ ${serverId}`, 96);
-    }
-    if (instanceId) {
-        return truncateText(sessionId ? `${instanceId} (session ${sessionId})` : instanceId, 96);
-    }
-    const label = stringValue(item.title) ??
-        stringValue(item.name) ??
-        stringValue(item.key) ??
-        stringValue(item.id) ??
-        stringValue(item.url) ??
-        serverId;
-    if (!label)
-        return null;
-    const suffix = [];
-    if (typeof item.running === "boolean") {
-        suffix.push(item.running ? "running" : "stopped");
-    }
-    if (typeof item.enabled === "boolean") {
-        suffix.push(item.enabled ? "enabled" : "disabled");
-    }
-    if (typeof item.available === "boolean" && item.available === false) {
-        suffix.push("unavailable");
-    }
-    if (Array.isArray(item.tools)) {
-        suffix.push(`${item.tools.length} ${item.tools.length === 1 ? "tool" : "tools"}`);
-    }
-    else if (typeof item.tool_count === "number") {
-        suffix.push(`${item.tool_count} ${item.tool_count === 1 ? "tool" : "tools"}`);
-    }
-    const status = stringValue(item.status);
-    if (status && !suffix.includes(status))
-        suffix.push(status);
-    const decorated = suffix.length > 0 ? `${label} (${suffix.slice(0, 3).join(", ")})` : label;
-    return truncateText(decorated, 96);
-}
-function formatOperationDetails(request) {
-    const details = [];
-    if (request.domain === "external") {
-        const toolName = stringValue(request.params.tool_name);
-        const toolParams = toolParamValue(request);
-        const query = stringValue(toolParams.query);
-        const url = stringValue(toolParams.url);
-        const libraryId = stringValue(toolParams.context7CompatibleLibraryID);
-        if (toolName)
-            details.push(`tool: ${toolName}`);
-        if (query)
-            details.push(`query: ${quotedText(query)}`);
-        if (url)
-            details.push(`url: ${truncateText(url, 84)}`);
-        if (libraryId)
-            details.push(`library: ${truncateText(libraryId, 84)}`);
-        return details;
-    }
-    const query = stringValue(request.params.query);
-    const key = stringValue(request.params.key) ?? stringValue(request.params.name);
-    const serverId = stringValue(request.params.server_id);
-    const sessionId = stringValue(request.params.session_id);
-    const library = stringValue(request.params.library);
-    if (query)
-        details.push(`query: ${quotedText(query)}`);
-    if (key)
-        details.push(`key: ${truncateText(key, 84)}`);
-    if (serverId)
-        details.push(`server: ${serverId}`);
-    if (sessionId)
-        details.push(`session: ${truncateText(sessionId, 84)}`);
-    if (library)
-        details.push(`library: ${truncateText(library, 84)}`);
-    return details;
-}
-function summarizePayloadItems(payload) {
-    const namedArrays = [
-        ["results", "results"],
-        ["tools", "tools"],
-        ["servers", "servers"],
-        ["running_servers", "servers"],
-        ["sessions", "sessions"],
-        ["skills", "skills"],
-        ["prompts", "prompts"],
-        ["libraries", "libraries"],
-        ["items", "items"],
-        ["rooms", "rooms"],
-        ["messages", "messages"],
-    ];
-    if (Array.isArray(payload)) {
-        return {
-            count: payload.length,
-            label: payload.length === 1 ? "item" : "items",
-            items: payload
-                .map(summarizeInventoryItem)
-                .filter((item) => Boolean(item))
-                .slice(0, 4),
-        };
-    }
-    if (!payload || typeof payload !== "object")
-        return null;
-    const obj = payload;
-    for (const [key, label] of namedArrays) {
-        const items = obj[key];
-        if (!Array.isArray(items))
-            continue;
-        return {
-            count: items.length,
-            label: items.length === 1 ? label.replace(/s$/, "") : label,
-            items: items
-                .map(summarizeInventoryItem)
-                .filter((item) => Boolean(item))
-                .slice(0, 4),
-        };
-    }
-    return null;
-}
-function defaultOperationStatus(request) {
-    switch (request?.action) {
-        case "search":
-            return "searched";
-        case "list":
-            return "loaded";
-        case "get":
-            return "fetched";
-        case "use":
-        case "activate":
-            return "activated";
-        case "deactivate":
-            return "deactivated";
-        case "update":
-            return "updated";
-        case "expose":
-            return "exposed";
-        case "unexpose":
-            return "unexposed";
-        case "add":
-            return "added";
-        case "remove":
-        case "delete":
-            return "removed";
-        case "call":
-        case "execute":
-            return "called";
-        case "run":
-            return "ran";
-        case "create":
-            return "created";
-        case "sync":
-            return "synced";
-        case "start":
-            return "started";
-        case "stop":
-            return "stopped";
-        case "status":
-            return "status loaded";
-        default:
-            return "completed";
-    }
-}
-/**
- * Compact digest of an object payload for the expanded tool view: top-level
- * scalar fields, one per line, so the user never sees "raw payload hidden"
- * for structured results (and never a wall of JSON either).
- */
-function payloadDigest(payload, maxLines = 6) {
-    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
-        return [];
-    }
-    const lines = [];
-    for (const [key, value] of Object.entries(payload)) {
-        if (lines.length >= maxLines)
-            break;
-        if (value === null || value === undefined)
-            continue;
-        if (typeof value === "object") {
-            const size = Array.isArray(value)
-                ? `${value.length} item${value.length === 1 ? "" : "s"}`
-                : `${Object.keys(value).length} field${Object.keys(value).length === 1 ? "" : "s"}`;
-            lines.push(`${key}: (${size})`);
-            continue;
-        }
-        lines.push(`${key}: ${truncateText(String(value), 80)}`);
-    }
-    return lines;
-}
-function summarizeRenderedResult(request, details, isError) {
-    if (isError) {
-        const errorText = extractText(details);
-        const preview = errorText
-            ? [truncateText(errorText.split(/\r?\n/)[0] ?? errorText, 120)]
-            : [];
-        return { status: "failed", preview };
-    }
-    const payload = extractJsonFromMcpResult(details) ?? details;
-    if (payload && typeof payload === "object") {
-        const obj = payload;
-        const explicitStatus = stringValue(obj.status);
-        if (request?.domain === "hub" && request.action === "start") {
-            const tools = Array.isArray(obj.tools)
-                ? obj.tools
-                    .map((item) => summarizeInventoryItem(item))
-                    .filter((item) => Boolean(item))
-                    .slice(0, 3)
-                : [];
-            const preview = [
-                ...tools,
-                ...[
-                    stringValue(obj.hint),
-                    stringValue(obj.message),
-                    stringValue(obj.summary),
-                ]
-                    .filter((item) => Boolean(item))
-                    .map((item) => truncateText(item, 120)),
-            ].slice(0, 3);
-            return {
-                status: explicitStatus ?? defaultOperationStatus(request),
-                preview,
-            };
-        }
-        const listSummary = summarizePayloadItems(payload);
-        if (listSummary) {
-            const preview = listSummary.items.length
-                ? listSummary.items
-                : stringValue(obj.hint)
-                    ? [truncateText(stringValue(obj.hint) ?? "", 120)]
-                    : [];
-            return {
-                status: `${listSummary.count} ${listSummary.label}`,
-                preview,
-            };
-        }
-        const message = stringValue(obj.message) ??
-            stringValue(obj.summary) ??
-            stringValue(obj.hint);
-        if (message) {
-            return {
-                status: explicitStatus ?? defaultOperationStatus(request),
-                preview: [truncateText(message, 120)],
-            };
-        }
-        if (explicitStatus) {
-            return { status: explicitStatus, preview: [] };
-        }
-        if (obj.ok === true) {
-            return { status: defaultOperationStatus(request), preview: [] };
-        }
-    }
-    return { status: defaultOperationStatus(request), preview: [] };
-}
-function renderSageToolCall(mode, args, theme) {
-    const request = normalizeRenderRequest(mode, args);
-    const toolName = mode === "search" ? "sage_search " : "sage_execute ";
-    if (!request) {
-        return createTextComponent(theme.fg("toolTitle", theme.bold(toolName)) +
-            theme.fg("warning", "(invalid request)"));
-    }
-    const lines = [
-        theme.fg("toolTitle", theme.bold(toolName)) +
-            theme.fg("accent", formatOperationSubject(request)),
-    ];
-    for (const detail of formatOperationDetails(request).slice(0, 3)) {
-        lines.push(theme.fg("dim", `  ${detail}`));
-    }
-    return createTextComponent(lines.join("\n"));
-}
-function renderSageToolResult(mode, result, options, theme, context) {
-    if (options.isPartial) {
-        // Track elapsed time across streaming re-renders via the per-call
-        // renderer state pi provides (context.state persists for this call).
-        const state = context?.state;
-        if (state && typeof state.sageStartedAt !== "number") {
-            state.sageStartedAt = Date.now();
-        }
-        const startedAt = state && typeof state.sageStartedAt === "number"
-            ? state.sageStartedAt
-            : undefined;
-        const elapsed = startedAt
-            ? Math.round((Date.now() - startedAt) / 1000)
-            : 0;
-        const verb = mode === "search" ? "Searching" : "Executing";
-        const suffix = elapsed >= 1 ? ` (${elapsed}s)` : "";
-        return textComponent(context, theme.fg("warning", `${verb}...${suffix}`));
-    }
-    const request = normalizeRenderRequest(mode, context?.args);
-    const isError = Boolean(context?.isError ?? result.isError);
-    const summary = summarizeRenderedResult(request, result.details, isError);
-    const statusColor = summary.status === "failed" ? "error" : "success";
-    // Status line: verb + subject. The call block rendered immediately above
-    // already shows the arg details — do not repeat them here. Instead show
-    // the OUTCOME: the first preview line is visible even when collapsed.
-    const lines = [
-        theme.fg(statusColor, summary.status) +
-            theme.fg("muted", " · ") +
-            theme.fg("accent", request
-                ? formatOperationSubject(request)
-                : mode === "search"
-                    ? "search"
-                    : "execute") +
-            (summary.preview.length > 0
-                ? theme.fg("muted", " — ") +
-                    theme.fg("muted", truncateText(summary.preview[0] ?? "", 100))
-                : ""),
-    ];
-    if (options.expanded) {
-        const rest = summary.preview.slice(1);
-        if (rest.length > 0) {
-            for (const line of rest) {
-                lines.push(theme.fg("muted", `  ${line}`));
-            }
-        }
-        else if (summary.preview.length === 0 && !isError) {
-            const digest = payloadDigest(extractJsonFromMcpResult(result.details) ?? result.details);
-            if (digest.length > 0) {
-                for (const line of digest) {
-                    lines.push(theme.fg("dim", `  ${line}`));
-                }
-            }
-            else {
-                lines.push(theme.fg("dim", "  no result payload"));
-            }
-        }
-    }
-    return textComponent(context, lines.join("\n"));
-}
-function looksUnknownToolError(error) {
-    const msg = error instanceof Error
-        ? error.message.toLowerCase()
-        : String(error).toLowerCase();
-    return (msg.includes("unknown tool") ||
-        msg.includes("not found") ||
-        msg.includes("no such tool") ||
-        msg.includes("does not exist"));
-}
-const FAILED_NATIVE_SKILL_LOAD_RESULT = {
-    schema: "sage.native-skill-load-signal.v1",
-    status: "failed",
-    recorded: false,
-};
-const NATIVE_SKILL_LOAD_EVIDENCE_TIERS = new Set([
-    "full_serve",
-    "native_observed",
-]);
-function parseJsonObject(stdout) {
-    try {
-        const parsed = JSON.parse(stdout.trim());
-        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
-            ? parsed
-            : null;
-    }
-    catch {
-        return null;
-    }
-}
-function parseNativeSkillLoadResult(stdout) {
-    const parsed = parseJsonObject(stdout);
-    if (!parsed ||
-        parsed.schema !== "sage.native-skill-load-signal.v1") {
-        return null;
-    }
-    if (parsed.status === "ignored" && parsed.recorded === false) {
-        const result = {
-            schema: "sage.native-skill-load-signal.v1",
-            status: "ignored",
-            recorded: false,
-        };
-        if (typeof parsed.reason === "string" && parsed.reason.trim()) {
-            result.reason = parsed.reason;
-        }
-        return result;
-    }
-    if (parsed.status !== "recorded" ||
-        parsed.recorded !== true ||
-        typeof parsed.qualified_key !== "string" ||
-        !parsed.qualified_key.trim() ||
-        parsed.load_evidence_tier !== "native_observed" ||
-        typeof parsed.loaded_at_ms !== "number" ||
-        !Number.isSafeInteger(parsed.loaded_at_ms) ||
-        parsed.loaded_at_ms < 0) {
-        return null;
-    }
-    return {
-        schema: "sage.native-skill-load-signal.v1",
-        status: "recorded",
-        recorded: true,
-        qualified_key: parsed.qualified_key,
-        load_evidence_tier: "native_observed",
-        loaded_at_ms: parsed.loaded_at_ms,
-    };
-}
-function normalizeNativeSkillName(value) {
-    return value.trim().toLocaleLowerCase("en-US");
-}
-function dedupeNativeSkillNames(skillKeys) {
-    const names = new Map();
-    for (const raw of skillKeys) {
-        const trimmed = raw.trim();
-        if (!trimmed)
-            continue;
-        const normalized = normalizeNativeSkillName(trimmed);
-        if (!names.has(normalized))
-            names.set(normalized, trimmed);
-    }
-    return [...names.values()];
-}
-function parseNativeSkillUseResult(stdout, expectedCaptureId, expectedNames) {
-    const parsed = parseJsonObject(stdout);
-    if (!parsed ||
-        parsed.schema !== "sage.native-skill-use.v1" ||
-        parsed.status !== "recorded" ||
-        parsed.capture_id !== expectedCaptureId ||
-        !Array.isArray(parsed.uses) ||
-        parsed.uses.length === 0) {
-        return null;
-    }
-    const expected = new Set(expectedNames.map(normalizeNativeSkillName));
-    if (expected.size === 0 || parsed.uses.length !== expected.size)
-        return null;
-    if (parsed.capture_linkage !== "explicit")
-        return null;
-    const returnedNames = new Set();
-    const returnedQualifiedKeys = new Set();
-    const uses = [];
-    for (const entry of parsed.uses) {
-        if (!entry || typeof entry !== "object" || Array.isArray(entry))
-            return null;
-        const record = entry;
-        if (typeof record.requested_name !== "string" ||
-            !record.requested_name.trim() ||
-            typeof record.qualified_key !== "string" ||
-            !record.qualified_key.trim() ||
-            typeof record.load_evidence_tier !== "string" ||
-            !NATIVE_SKILL_LOAD_EVIDENCE_TIERS.has(record.load_evidence_tier) ||
-            typeof record.load_observed_at_ms !== "number" ||
-            !Number.isSafeInteger(record.load_observed_at_ms) ||
-            record.load_observed_at_ms < 0 ||
-            typeof record.recorded !== "boolean") {
-            return null;
-        }
-        const requestedName = record.requested_name.trim();
-        const normalizedName = normalizeNativeSkillName(requestedName);
-        const qualifiedKey = record.qualified_key.trim();
-        const normalizedQualifiedKey = normalizeNativeSkillName(qualifiedKey);
-        if (!expected.has(normalizedName) ||
-            returnedNames.has(normalizedName) ||
-            returnedQualifiedKeys.has(normalizedQualifiedKey)) {
-            return null;
-        }
-        returnedNames.add(normalizedName);
-        returnedQualifiedKeys.add(normalizedQualifiedKey);
-        uses.push({
-            requested_name: requestedName,
-            qualified_key: qualifiedKey,
-            load_evidence_tier: record.load_evidence_tier,
-            load_observed_at_ms: record.load_observed_at_ms,
-            recorded: record.recorded,
-        });
-    }
-    if ([...expected].some((name) => !returnedNames.has(name)))
-        return null;
-    return {
-        schema: "sage.native-skill-use.v1",
-        status: "recorded",
-        capture_id: expectedCaptureId,
-        capture_linkage: "explicit",
-        uses,
-    };
-}
-function classifyNativeSkillUseFailure(failure) {
-    if (failure?.timedOut) {
-        return {
-            code: "native_use_timeout",
-            message: "Sage timed out while recording native guided use.",
-            recovery: "Check `sage daemon status`, then retry the same declaration.",
-        };
-    }
-    const parsed = failure ? parseJsonObject(failure.stdout) : null;
-    const error = parsed?.error && typeof parsed.error === "object" && !Array.isArray(parsed.error)
-        ? parsed.error
-        : null;
-    if (parsed?.schema === "sage.native-skill-use.v1" &&
-        parsed.status === "unsupported" &&
-        error?.code === "native_skill_use_unsupported") {
-        return {
-            code: "native_skill_use_unsupported",
-            message: "The running Sage daemon does not advertise native_skill_use_v1.",
-            recovery: "Update and restart `saged`, then retry the same declaration.",
-        };
-    }
-    const detail = `${failure?.stderr ?? ""}\n${failure?.stdout ?? ""}`;
-    if (/unrecognized subcommand\s+['"]native-use['"]/i.test(detail)) {
-        return {
-            code: "native_use_cli_unsupported",
-            message: "The configured Sage CLI does not expose feedback native-use.",
-            recovery: "Update the Sage CLI selected by `SAGE_BIN`, then retry. Restart `saged` only if the updated CLI reports a daemon capability mismatch.",
-        };
-    }
-    return {
-        code: "native_use_write_failed",
-        message: "Sage did not persist the native guided-use batch.",
-        recovery: "Check `sage daemon status` and daemon logs before retrying.",
-    };
-}
-function parseSecurityDecision(stdout) {
-    const lines = stdout
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean)
-        .reverse();
-    for (const line of lines) {
-        try {
-            const parsed = JSON.parse(line);
-            const rawDecision = typeof parsed.decision === "string" ? parsed.decision : "";
-            if (!rawDecision)
-                continue;
-            const reason = typeof parsed.reason === "string" ? parsed.reason : undefined;
-            if (rawDecision === "block") {
-                const isWarn = typeof reason === "string" && /security warning/i.test(reason);
-                return { decision: isWarn ? "warn" : "block", reason };
-            }
-            if (rawDecision === "warn")
-                return { decision: "warn", reason };
-            if (rawDecision === "allow")
-                return { decision: "allow", reason };
-        }
-        catch (_error) {
-            void _error;
-        }
-    }
-    return null;
-}
-export class SageMcpBridge {
-    command;
-    args;
-    env;
-    requestTimeoutMs;
-    proc = null;
-    pending = new Map();
-    ready = false;
-    stopped = false;
-    startPromise = null;
-    stderrBuffer = "";
-    degraded = false;
-    lastHealthError = null;
-    lastHealthCheckedAt = null;
-    cachedToolNames = [];
-    constructor(command, args, env = {}, requestTimeoutMs = 20_000) {
-        this.command = command;
-        this.args = args;
-        this.env = env;
-        this.requestTimeoutMs = requestTimeoutMs;
-    }
-    isReady() {
-        return this.ready && this.proc !== null && !this.stopped;
-    }
-    isDegraded() {
-        return this.degraded;
-    }
-    getHealthSnapshot() {
-        return {
-            bridgeConnected: this.isReady(),
-            degraded: this.degraded,
-            lastHealthError: this.lastHealthError,
-            lastHealthCheckedAt: this.lastHealthCheckedAt,
-            availableToolCount: this.cachedToolNames.length,
-            availableToolNames: [...this.cachedToolNames],
-        };
-    }
-    async start() {
-        if (this.isReady())
-            return;
-        if (this.startPromise)
-            return this.startPromise;
-        this.startPromise = (async () => {
-            this.stopped = false;
-            await this.spawn();
-            await this.initialize();
-            // Fail-open health probe: mark degraded if tools/list fails post-init,
-            // but never throw from start(). Tool-use call sites surface the
-            // structured degraded error when the bridge is unreachable.
-            await this.probeHealth(Math.min(this.requestTimeoutMs, 2_000));
-        })();
-        try {
-            await this.startPromise;
-        }
-        finally {
-            this.startPromise = null;
-        }
-    }
-    async probeHealth(timeoutMs = Math.min(this.requestTimeoutMs, 2_000)) {
-        this.lastHealthCheckedAt = Date.now();
-        try {
-            const tools = await this.listTools(timeoutMs);
-            this.cachedToolNames = tools.map((t) => t.name).filter(Boolean);
-            this.degraded = false;
-            this.lastHealthError = null;
-            return true;
-        }
-        catch (error) {
-            this.degraded = true;
-            this.lastHealthError =
-                error instanceof Error ? error.message : String(error);
-            return false;
-        }
-    }
-    async stop() {
-        this.stopped = true;
-        this.ready = false;
-        this.rejectAllPending("MCP bridge stopped");
-        if (this.proc) {
-            this.proc.kill("SIGTERM");
-            this.proc = null;
-        }
-    }
-    async listTools(timeoutMs) {
-        const result = (await this.request("tools/list", {}, timeoutMs));
-        return result.tools ?? [];
-    }
-    async callTool(name, args) {
-        const result = (await this.request("tools/call", {
-            name,
-            arguments: args,
-        }));
-        if (result.isError) {
-            const errorText = result.content
-                ?.map((entry) => entry.text ?? "")
-                .filter(Boolean)
-                .join("\n") || "MCP tool error";
-            throw new Error(errorText);
-        }
-        return result;
-    }
-    async callCodeModeSearch(args) {
-        this.assertReadyForToolCall();
-        try {
-            return await this.callWithFallback(CODE_MODE_SEARCH_TOOLS, args);
-        }
-        catch (error) {
-            this.markDegradedFromError(error);
-            throw error;
-        }
-    }
-    async callCodeModeExecute(args) {
-        this.assertReadyForToolCall();
-        try {
-            return await this.callWithFallback(CODE_MODE_EXECUTE_TOOLS, args);
-        }
-        catch (error) {
-            this.markDegradedFromError(error);
-            throw error;
-        }
-    }
-    assertReadyForToolCall() {
-        if (!this.isReady() || this.degraded) {
-            const detail = this.lastHealthError
-                ? ` Last health error: ${this.lastHealthError}.`
-                : "";
-            throw new Error(`Sage MCP bridge unavailable; restart Pi or verify 'sage mcp start' works.${detail}`);
-        }
-    }
-    markDegradedFromError(error) {
-        const message = error instanceof Error ? error.message : String(error);
-        // Only flip degraded on transport-level failures, not on known MCP-level
-        // errors (for example `tools/list` returning an unknown tool). Transport
-        // failures surface as "not running", "stopped", or plain JSON-RPC errors
-        // from dead processes.
-        const looksTransportFailure = /bridge stopped|not running|failed to spawn|request timed out|EPIPE|ECONNRESET|closed/i.test(message);
-        if (!looksTransportFailure)
-            return;
-        this.degraded = true;
-        this.lastHealthError = message;
-        this.lastHealthCheckedAt = Date.now();
-    }
-    async callWithFallback(candidates, args) {
-        let lastUnknownError = null;
-        for (const toolName of candidates) {
-            try {
-                return await this.callTool(toolName, args);
-            }
-            catch (error) {
-                if (!looksUnknownToolError(error))
-                    throw error;
-                lastUnknownError =
-                    error instanceof Error ? error : new Error(String(error));
-            }
-        }
-        if (lastUnknownError)
-            throw lastUnknownError;
-        throw new Error("Sage code-mode tools are unavailable");
-    }
-    async initialize() {
-        await this.request("initialize", {
-            protocolVersion: "2024-11-05",
-            capabilities: {},
-            clientInfo: { name: "sage-pi-adapter", version: "0.3.1" },
-        });
-        this.notify("notifications/initialized", {});
-        this.ready = true;
-    }
-    async spawn() {
-        await new Promise((resolve, reject) => {
-            const proc = spawn(this.command, this.args, {
-                stdio: ["pipe", "pipe", "pipe"],
-                env: { ...process.env, ...this.env },
-            });
-            let settled = false;
-            const rejectOnce = (err) => {
-                if (settled)
-                    return;
-                settled = true;
-                reject(err);
-            };
-            proc.on("error", (err) => {
-                if (!this.stopped)
-                    rejectOnce(err);
-            });
-            proc.on("exit", (code) => {
-                if (this.stopped)
-                    return;
-                const message = this.withRecentStderr(`MCP process exited${this.ready ? "" : " before initialization"} (code ${code ?? -1})`);
-                this.ready = false;
-                this.rejectAllPending(message);
-                rejectOnce(new Error(message));
-            });
-            proc.stdin.on("error", () => {
-                // Swallow EPIPE — the exit handler above handles cleanup
-            });
-            proc.stdout.setEncoding("utf8");
-            let buffer = "";
-            proc.stdout.on("data", (chunk) => {
-                buffer += chunk;
-                const lines = buffer.split("\n");
-                buffer = lines.pop() ?? "";
-                for (const line of lines) {
-                    if (line.trim())
-                        this.handleLine(line);
-                }
-            });
-            proc.stderr.setEncoding("utf8");
-            proc.stderr.on("data", (chunk) => {
-                this.appendStderr(chunk);
-            });
-            this.proc = proc;
-            settled = true;
-            resolve();
-        });
-    }
-    request(method, params, timeoutMs = this.requestTimeoutMs) {
-        return new Promise((resolve, reject) => {
-            if (!this.proc?.stdin?.writable) {
-                reject(new Error("MCP process not running"));
-                return;
-            }
-            const id = randomUUID();
-            const timeout = setTimeout(() => {
-                this.pending.delete(id);
-                reject(new Error(this.withRecentStderr(`MCP request timed out: ${method}`)));
-            }, timeoutMs);
-            this.pending.set(id, { resolve, reject, timeout });
-            const req = { jsonrpc: "2.0", id, method, params };
-            this.proc.stdin.write(JSON.stringify(req) + "\n", (err) => {
-                if (!err)
-                    return;
-                this.pending.delete(id);
-                clearTimeout(timeout);
-                reject(new Error(this.withRecentStderr(`Failed to write MCP request: ${err.message}`)));
-            });
-        });
-    }
-    notify(method, params) {
-        if (!this.proc?.stdin?.writable)
-            return;
-        const msg = { jsonrpc: "2.0", method, params };
-        this.proc.stdin.write(JSON.stringify(msg) + "\n");
-    }
-    handleLine(line) {
-        let msg;
-        try {
-            msg = JSON.parse(line);
-        }
-        catch {
-            return;
-        }
-        if (msg.id === undefined || msg.id === null)
-            return;
-        const id = String(msg.id);
-        const pending = this.pending.get(id);
-        if (!pending)
-            return;
-        this.pending.delete(id);
-        clearTimeout(pending.timeout);
-        if (msg.error) {
-            pending.reject(new Error(`MCP error: ${JSON.stringify(msg.error)}`));
-            return;
-        }
-        pending.resolve(msg.result);
-    }
-    rejectAllPending(reason) {
-        for (const pending of this.pending.values()) {
-            clearTimeout(pending.timeout);
-            pending.reject(new Error(reason));
-        }
-        this.pending.clear();
-    }
-    appendStderr(chunk) {
-        this.stderrBuffer += chunk;
-        const maxChars = 4000;
-        if (this.stderrBuffer.length > maxChars) {
-            this.stderrBuffer = this.stderrBuffer.slice(-maxChars);
-        }
-    }
-    withRecentStderr(message) {
-        const stderr = this.stderrBuffer.trim();
-        if (!stderr)
-            return message;
-        return `${message}\nRecent MCP stderr:\n${stderr}`;
-    }
-}
-export class SageHookRuntime {
-    config;
-    commandRunner;
-    workingDirectory;
-    sessionContextCache = new Map();
-    skillVisibilityCache = null;
-    softFailureState = new Map();
-    constructor(config) {
-        this.config = config;
-        this.commandRunner = config.commandRunner ?? defaultSageCommandRunner;
-    }
-    setWorkingDirectory(cwd) {
-        this.workingDirectory =
-            typeof cwd === "string" && cwd.trim() ? cwd.trim() : undefined;
-    }
-    getSoftTimeout(maxTimeoutMs) {
-        return Math.max(250, Math.min(this.config.timeoutMs, maxTimeoutMs));
-    }
-    clearSoftFailure(commandText) {
-        this.softFailureState.delete(commandText);
-    }
-    logSoftFailure(commandText, message) {
-        const now = Date.now();
-        const previous = this.softFailureState.get(commandText);
-        if (previous &&
-            now - previous.lastLoggedAt < SAGE_SOFT_COMMAND_LOG_COOLDOWN_MS) {
-            previous.suppressedCount += 1;
-            this.softFailureState.set(commandText, previous);
-            return;
-        }
-        const suffix = previous && previous.suppressedCount > 0
-            ? `\n[sage-pi-adapter] Suppressed ${previous.suppressedCount} similar timeout/error log(s) for ${commandText}`
-            : "";
-        this.softFailureState.set(commandText, {
-            lastLoggedAt: now,
-            suppressedCount: 0,
-        });
-        console.warn(`${message}${suffix}`);
-    }
-    async getSessionContext(sessionId) {
-        const cacheKey = sessionId?.trim() || "__default__";
-        const result = await this.run(["skill", "context", "--format", "pi"], { SAGE_SESSION_ID: sessionId ?? "" }, undefined, {
-            failurePolicy: "warn",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.sessionContext),
-        });
-        const context = result?.stdout.trim() ?? "";
-        if (context) {
-            this.sessionContextCache.set(cacheKey, context);
-            return context;
-        }
-        return this.sessionContextCache.get(cacheKey) ?? "";
-    }
-    /**
-     * Gather skill visibility summary for user-facing display.
-     *
-     * Runs `sage library list` and `sage library active` in parallel to
-     * produce a compact summary of active libraries with skill counts.
-     * Returns cached or empty summary when the CLI is unavailable.
-     */
-    async getSkillVisibilitySummary() {
-        const softRunOptions = {
-            failurePolicy: "warn",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.skillVisibility),
-        };
-        const [libraryResult, activeResult] = await Promise.allSettled([
-            this.run(["library", "list"], {}, undefined, softRunOptions),
-            this.run(["library", "active"], {}, undefined, softRunOptions),
-        ]);
-        const libraries = [];
-        const libraryOut = libraryResult.status === "fulfilled"
-            ? (libraryResult.value?.stdout.trim() ?? "")
-            : "";
-        if (libraryOut) {
-            for (const line of libraryOut.split("\n")) {
-                const m = line.match(/^\s*(.+?)\s+\((\d+)\s+prompts?,\s*(\d+)\s+skills?\)/);
-                if (m) {
-                    libraries.push({
-                        name: m[1].trim(),
-                        prompts: Number.parseInt(m[2], 10),
-                        skills: Number.parseInt(m[3], 10),
-                    });
-                }
-            }
-        }
-        const totalSkills = libraries.reduce((s, l) => s + l.skills, 0);
-        const activeOut = activeResult.status === "fulfilled"
-            ? (activeResult.value?.stdout.trim() ?? "")
-            : "";
-        const activeNames = [];
-        if (activeOut) {
-            for (const line of activeOut.split("\n")) {
-                if (line.includes("Skill-activated libraries"))
-                    break;
-                const numMatch = line.match(/^\s*\d+\.\s+(\S+)/);
-                if (numMatch)
-                    activeNames.push(numMatch[1]);
-            }
-        }
-        let summary = "";
-        if (activeNames.length > 0) {
-            const maxShow = 3;
-            const shown = activeNames.slice(0, maxShow).map((name) => {
-                const lib = libraries.find((l) => l.name === name);
-                if (lib && lib.skills > 0)
-                    return `${name} (${lib.skills}s)`;
-                if (lib && lib.prompts > 0)
-                    return `${name} (${lib.prompts}p)`;
-                return name;
-            });
-            const SEP = unicodeSafe("\u00B7");
-            const suffix = activeNames.length > maxShow
-                ? ` ${SEP} +${activeNames.length - maxShow} more`
-                : "";
-            summary = shown.join(` ${SEP} `) + suffix;
-        }
-        else if (libraries.length > 0) {
-            summary = `${libraries.length} libs, ${totalSkills} skills`;
-        }
-        summary = summary ? `[Sage] ${summary}` : "";
-        const current = {
-            summary,
-            libraryCount: libraries.length,
-            skillCount: totalSkills,
-        };
-        if (current.summary) {
-            this.skillVisibilityCache = current;
-            return current;
-        }
-        return this.skillVisibilityCache ?? current;
-    }
-    /**
-     * @deprecated Low-level compatibility helper. The default Pi path uses
-     * native skill discovery/loading and does not call this per prompt.
-     */
-    async suggestSkill(prompt, sessionId, model) {
-        const trimmed = prompt.trim();
-        if (!trimmed)
-            return "";
-        const args = [
-            "suggest",
-            "hook",
-            "skill",
-            "--limit",
-            String(this.config.suggestLimit ?? 3),
-        ];
-        if (this.config.enableProvision !== false)
-            args.push("--provision");
-        const result = await this.run(args, {
-            PROMPT: trimmed,
-            SAGE_PROMPT: trimmed,
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-            SAGE_MODEL: model ?? "",
-        }, JSON.stringify({ prompt: trimmed }), {
-            failurePolicy: "warn",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.suggest),
-        });
-        return result?.stdout.trim() ?? "";
-    }
-    async capturePrompt(prompt, sessionId) {
-        if (this.config.enableRlmFeedback === false)
-            return undefined;
-        const trimmed = prompt.trim();
-        if (!trimmed)
-            return undefined;
-        const result = await this.run(["capture", "hook", "prompt"], {
-            PROMPT: trimmed,
-            SAGE_PROMPT: trimmed,
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-        }, JSON.stringify({ prompt: trimmed }), {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.capture),
-        });
-        const captureId = result?.stdout
-            .trim()
-            .match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0];
-        return captureId;
-    }
-    async captureResponse(response, usage, sessionId, captureId) {
-        if (this.config.enableRlmFeedback === false)
-            return false;
-        const trimmed = response.trim();
-        if (!trimmed)
-            return false;
-        const args = ["capture", "hook", "response"];
-        const exactCaptureId = captureId?.trim();
-        if (exactCaptureId)
-            args.push("--correlation-id", exactCaptureId);
-        const result = await this.run(args, {
-            SAGE_RESPONSE: trimmed,
-            LAST_RESPONSE: trimmed,
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-            SAGE_DEFER_SUGGESTION_FEEDBACK: "1",
-            TOKENS_INPUT: usage.input ?? "",
-            TOKENS_OUTPUT: usage.output ?? "",
-        }, JSON.stringify({ response: trimmed }), {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.capture),
-        });
-        return result !== null;
-    }
-    async recordSuggestionUse(skillKeys, sessionId, correlationId) {
-        if (this.config.enableRlmFeedback === false)
-            return false;
-        const used = [
-            ...new Set(skillKeys.map((key) => key.trim()).filter(Boolean)),
-        ];
-        if (used.length === 0)
-            return false;
-        const args = [
-            "suggest",
-            "feedback",
-            "use",
-            ...used.flatMap((key) => ["--used", key]),
-        ];
-        const correlation = correlationId?.trim();
-        if (correlation)
-            args.push("--correlation-id", correlation);
-        const result = await this.run(args, {
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-        }, undefined, {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.feedback),
-        });
-        return result !== null;
-    }
-    /**
-     * Atomically record use of procedures that Pi loaded natively. This path
-     * intentionally has no fallback to legacy suggestion feedback: the daemon
-     * must authorize every returned qualified record from session-scoped load
-     * evidence and link the complete batch to the exact capture.
-     */
-    async recordNativeSkillUse(skillKeys, sessionId, captureId) {
-        return (await this.recordNativeSkillUseAttempt(skillKeys, sessionId, captureId)).result;
-    }
-    async recordNativeSkillUseAttempt(skillKeys, sessionId, captureId) {
-        if (this.config.enableRlmFeedback === false)
-            return { result: null, failure: null };
-        const used = dedupeNativeSkillNames(skillKeys);
-        const session = sessionId?.trim();
-        const capture = captureId?.trim();
-        if (used.length === 0 || !session || !capture)
-            return { result: null, failure: null };
-        const source = this.config.source?.trim() || "pi";
-        let commandFailure;
-        const result = await this.run([
-            "suggest",
-            "feedback",
-            "native-use",
-            ...used.flatMap((key) => ["--used", key]),
-            "--capture-id",
-            capture,
-            "--source",
-            source,
-            "--session",
-            session,
-            "--format",
-            "json",
-        ], {
-            SAGE_SOURCE: source,
-            SAGE_SESSION_ID: session,
-        }, undefined, {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.feedback),
-            onFailure: (failure) => {
-                commandFailure = failure;
-            },
-        });
-        if (!result) {
-            return { result: null, failure: classifyNativeSkillUseFailure(commandFailure) };
-        }
-        const parsed = parseNativeSkillUseResult(result.stdout, capture, used);
-        if (!parsed) {
-            return {
-                result: null,
-                failure: {
-                    code: "native_use_write_failed",
-                    message: "Sage returned an invalid native-use response.",
-                    recovery: "Check `sage daemon status` and daemon logs before retrying.",
-                },
-            };
-        }
-        return { result: parsed, failure: null };
-    }
-    /**
-     * Record a daemon load receipt for a full skill procedure this session
-     * loaded through Pi's native full SKILL.md read or sage_execute get. The
-     * structured result only reports `recorded: true` after validating the
-     * explicit CLI's versioned JSON receipt. Ignored and failed writes remain
-     * non-recorded so callers can retry honestly.
-     */
-    async recordSkillLoadSignal(skillKey, sessionId, via = "slash") {
-        if (this.config.enableRlmFeedback === false) {
-            return { ...FAILED_NATIVE_SKILL_LOAD_RESULT };
-        }
-        const key = skillKey.trim();
-        const session = sessionId?.trim();
-        // A receipt is session-scoped evidence. Without the real Pi session id,
-        // the CLI would fall back to ambient env (a foreign harness session) and
-        // record evidence that verifies the WRONG scope — worse than nothing.
-        if (!key || !session)
-            return { ...FAILED_NATIVE_SKILL_LOAD_RESULT };
-        const source = this.config.source?.trim() || "pi";
-        const result = await this.run([
-            "suggest",
-            "load-signal",
-            "--name",
-            key,
-            "--via",
-            via,
-            "--source",
-            source,
-            "--session",
-            session,
-            "--format",
-            "json",
-        ], {
-            SAGE_SOURCE: source,
-            SAGE_SESSION_ID: session,
-        }, undefined, {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.feedback),
-        });
-        if (!result)
-            return { ...FAILED_NATIVE_SKILL_LOAD_RESULT };
-        return (parseNativeSkillLoadResult(result.stdout) ?? {
-            ...FAILED_NATIVE_SKILL_LOAD_RESULT,
-        });
-    }
-    async recordSuggestionSkip(sessionId, correlationId) {
-        if (this.config.enableRlmFeedback === false)
-            return;
-        const args = ["suggest", "feedback", "skip"];
-        const correlation = correlationId?.trim();
-        if (correlation)
-            args.push("--correlation-id", correlation);
-        await this.run(args, {
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-        }, undefined, {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.feedback),
-        });
-    }
-    async recordSuggestionReject(sessionId, correlationId) {
-        if (this.config.enableRlmFeedback === false)
-            return;
-        const args = ["suggest", "feedback", "reject"];
-        const correlation = correlationId?.trim();
-        if (correlation)
-            args.push("--correlation-id", correlation);
-        await this.run(args, {
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-        }, undefined, {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.feedback),
-        });
-    }
-    async recordExecutionOutcome(skillKey, status, queryPreview, sessionId, _model, correlationId, captureId) {
-        if (this.config.enableRlmFeedback === false)
-            return;
-        const key = skillKey.trim();
-        if (!key)
-            return;
-        const args = ["suggest", "feedback", "outcome", key, "--status", status];
-        const preview = queryPreview?.trim();
-        if (preview)
-            args.push("--query-preview", preview.slice(0, 500));
-        const correlation = correlationId?.trim();
-        if (correlation)
-            args.push("--correlation-id", correlation);
-        const exactCaptureId = captureId?.trim();
-        if (exactCaptureId)
-            args.push("--capture-id", exactCaptureId);
-        await this.run(args, {
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-        }, undefined, {
-            failurePolicy: "silent",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.feedback),
-        });
-    }
-    async scanPreTool(toolName, toolInput, sessionId) {
-        if (this.config.enableSecurityHooks === false)
-            return null;
-        const payload = {
-            hook_event_name: "PreToolUse",
-            tool_name: toolName,
-            tool_input: toolInput,
-        };
-        const result = await this.run(["security", "scan-hook"], {
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-        }, JSON.stringify(payload), {
-            failurePolicy: "warn",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.securityScan),
-        });
-        return result ? parseSecurityDecision(result.stdout) : null;
-    }
-    async scanPostTool(toolName, toolInput, toolResult, sessionId) {
-        if (this.config.enableSecurityHooks === false)
-            return null;
-        const payload = {
-            hook_event_name: "PostToolUse",
-            tool_name: toolName,
-            tool_input: toolInput,
-            tool_response: toolResult,
-        };
-        const result = await this.run(["security", "scan-hook"], {
-            SAGE_SOURCE: this.config.source ?? "pi",
-            SAGE_SESSION_ID: sessionId ?? "",
-        }, JSON.stringify(payload), {
-            failurePolicy: "warn",
-            timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.securityScan),
-        });
-        return result ? parseSecurityDecision(result.stdout) : null;
-    }
-    /**
-     * Resolve skill content by name(s) via the `sage skill get` CLI call.
-     * Returns a map of skill name -> SKILL.md content (or empty string on miss).
-     *
-     * NOTE: current sage binaries have no `skill get` subcommand, so this is a
-     * legacy fallback that typically resolves nothing — the extension resolves
-     * skills through the MCP bridge (`skills.get`) first and only calls this
-     * when the bridge is unavailable (or a future CLI adds the subcommand).
-     */
-    async resolveSkills(names) {
-        const results = new Map();
-        if (!names.length)
-            return results;
-        const settled = await Promise.allSettled(names.map(async (name) => {
-            const result = await this.run(["skill", "get", name, "--format", "raw"], { SAGE_SOURCE: this.config.source ?? "pi" }, undefined, {
-                failurePolicy: "warn",
-                timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.resolveSkill),
-            });
-            const content = result?.stdout.trim() ?? "";
-            return { name, content };
-        }));
-        for (const outcome of settled) {
-            if (outcome.status === "fulfilled" && outcome.value.content) {
-                results.set(outcome.value.name, outcome.value.content);
-            }
-        }
-        return results;
-    }
-    /**
-     * Query per-skill execution quality from the Sage daemon.
-     * Calls `sage suggest feedback breakdown <key> --format json` and returns
-     * pass rate + sample size. Returns null when the daemon is unavailable,
-     * no data exists, or sample size is too small (<3).
-     *
-     * Results are cached for the session lifetime.
-     */
-    qualityCache = new Map();
-    async querySkillQuality(skillKey) {
-        const cached = this.qualityCache.get(skillKey);
-        if (cached !== undefined)
-            return cached;
-        try {
-            const result = await this.run(["suggest", "feedback", "breakdown", skillKey, "--format", "json"], {}, undefined, {
-                failurePolicy: "silent",
-                timeoutMs: this.getSoftTimeout(SAGE_HOOK_TIMEOUTS.quality),
-            });
-            if (!result?.stdout) {
-                this.qualityCache.set(skillKey, null);
-                return null;
-            }
-            const parsed = JSON.parse(result.stdout);
-            const passRate = parsed.totals?.pass_rate ?? 0;
-            const sampleSize = parsed.totals?.sample_size ?? 0;
-            if (sampleSize < 3) {
-                this.qualityCache.set(skillKey, null);
-                return null;
-            }
-            const entry = { passRate, sampleSize };
-            this.qualityCache.set(skillKey, entry);
-            return entry;
-        }
-        catch {
-            this.qualityCache.set(skillKey, null);
-            return null;
-        }
-    }
-    /** Get the execution quality score for a skill, or null if unknown. */
-    getSkillQuality(skillKey) {
-        // Synchronous lookup from cache; call querySkillQuality first to populate.
-        return this.qualityCache.get(skillKey) ?? null;
-    }
-    /**
-     * Pre-fetch quality scores for a batch of skill keys.
-     * Useful before rendering widget annotations to avoid N sequential CLI calls.
-     */
-    async prefetchSkillQualities(keys) {
-        await Promise.allSettled(keys.map((k) => this.querySkillQuality(k)));
-    }
-    async run(args, env, stdin, options = {}) {
-        const commandText = formatSageCommand(this.config.sageBin, args);
-        const failurePolicy = options.failurePolicy ?? "throw";
-        try {
-            const commandEnv = {
-                HOME: process.env.HOME ?? "",
-                PATH: process.env.PATH ?? "",
-                ...sagePassthroughEnv(),
-                ...(this.config.env ?? {}),
-                ...env,
-            };
-            if (this.config.sageProfile) {
-                commandEnv.SAGE_PROFILE = this.config.sageProfile;
-            }
-            if (this.workingDirectory && !commandEnv.SAGE_WORKSPACE) {
-                commandEnv.SAGE_WORKSPACE = this.workingDirectory;
-            }
-            const result = await this.commandRunner({
-                command: this.config.sageBin,
-                args,
-                env: commandEnv,
-                stdin,
-                cwd: this.workingDirectory,
-                timeoutMs: options.timeoutMs ?? this.config.timeoutMs,
-            });
-            if (result.timedOut || result.exitCode !== 0) {
-                options.onFailure?.(result);
-                const detail = (result.stderr || result.stdout || "").trim();
-                const message = result.timedOut
-                    ? `[sage-pi-adapter] Sage command timed out: ${commandText}`
-                    : `[sage-pi-adapter] Sage command failed (${result.exitCode}): ${commandText}${detail ? `\n${detail}` : ""}`;
-                if (failurePolicy === "throw") {
-                    throw new Error(message);
-                }
-                if (failurePolicy === "warn") {
-                    this.logSoftFailure(commandText, message);
-                }
-                return null;
-            }
-            this.clearSoftFailure(commandText);
-            return result;
-        }
-        catch (error) {
-            const detail = error instanceof Error ? error.message : String(error);
-            options.onFailure?.({
-                exitCode: -1,
-                stdout: "",
-                stderr: detail,
-                timedOut: false,
-            });
-            const message = `[sage-pi-adapter] Sage command error: ${commandText}${detail ? `\n${detail}` : ""}`;
-            if (failurePolicy === "throw")
-                throw new Error(message);
-            if (failurePolicy === "warn") {
-                this.logSoftFailure(commandText, message);
-            }
-            return null;
-        }
-    }
-}
-const SageDomainType = Type.Union([
-    Type.Literal("prompts"),
-    Type.Literal("behaviors"),
-    Type.Literal("skills"),
-    Type.Literal("builder"),
-    Type.Literal("governance"),
-    Type.Literal("chat"),
-    Type.Literal("social"),
-    Type.Literal("rlm"),
-    Type.Literal("library_sync"),
-    Type.Literal("security"),
-    Type.Literal("meta"),
-    Type.Literal("hub"),
-    Type.Literal("activation"),
-    Type.Literal("wallet"),
-    Type.Literal("library"),
-    Type.Literal("help"),
-    Type.Literal("external"),
-], { description: "Sage domain namespace" });
-export function createSageSearchTool(mcpBridge) {
-    return {
-        name: "sage_search",
-        label: "Sage: Search",
-        promptSnippet: "Route read-only Sage code-mode requests: discover domains/actions, inspect context, query hub/external tools, and search capabilities",
-        promptGuidelines: [
-            "Use sage_search (NOT bash sage commands) for Sage read/discovery flows such as help.list, prompts.search, behaviors.show, meta.get_project_context, meta.suggest, hub.list_servers/status, wallet.balance/address, and external.search",
-            "Use sage_search({ domain: 'help', action: 'list', params: {} }) before guessing unknown Sage domains or actions",
-            "Use sage_search({ domain: 'hub', action: 'list_servers', params: {} }) for MCP server inventory; use domain='external', action='list_servers' only to inspect running external servers and tool exposure",
-            "If Sage says an action is a mutation or non-search inspect action, retry with sage_execute instead of falling back to bash",
-        ],
-        description: "Route read-only Sage code-mode requests across prompts, behaviors, skills, builder, governance, chat, social, RLM, security, meta, hub, activation, wallet, library, help, and external services. " +
-            "Start with domain='help', action='list' when you do not know the route. " +
-            "Use domain='meta', action='get_project_context' for local Sage state and domain='meta', action='suggest' with params={goal:'...'} when you need route suggestions. " +
-            "Use domain='hub' for MCP hub inventory/status and domain='external' for external tool discovery/search. " +
-            "Some heavy inspect actions such as prompts.get and skills.get are classified by Sage as non-search and should use sage_execute.",
-        parameters: Type.Object({
-            domain: Type.Optional(SageDomainType),
-            action: Type.Optional(Type.String()),
-            params: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
-        }),
-        renderCall: (args, theme) => renderSageToolCall("search", args, theme),
-        renderResult: (result, options, theme, context) => renderSageToolResult("search", result, options, theme, context),
-        execute: async (_toolCallId, params) => {
-            try {
-                const normalized = normalizeCodeModeRequest("search", params);
-                const domain = normalized.domain;
-                const action = normalized.action;
-                const payload = normalized.params;
-                if (domain === "external" &&
-                    !["list_servers", "search"].includes(action)) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "For external domain, sage_search only supports actions: list_servers, search",
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                const result = await callCodeModeWithWebResilience(mcpBridge, "search", {
-                    domain,
-                    action,
-                    params: payload,
-                });
-                return toToolResultText(result);
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `sage_search failed: ${error instanceof Error ? error.message : String(error)}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        },
-    };
-}
-export function createSageExecuteTool(mcpBridge) {
-    return {
-        name: "sage_execute",
-        label: "Sage: Execute",
-        promptSnippet: "Execute Sage mutations and non-search inspect actions: activate skills, fetch full prompt/skill bodies, manage hub servers, and call external tools",
-        promptGuidelines: [
-            "Use sage_execute (NOT bash sage commands) for Sage mutations and for Sage actions that the code-mode router classifies as non-search, including prompts.get, skills.get/use, behaviors.run, activation.activate/deactivate, library writes, hub.start/stop, and external.call/execute",
-            "After starting an MCP server with sage_execute({ domain: 'hub', action: 'start', params: { server_id: '...' } }), call its tools through domain='external' with params { tool_name, tool_params } instead of invoking sage via bash",
-            "To fetch a URL: sage_execute({ domain: 'external', action: 'call', params: { tool_name: 'fetch', tool_params: { url: 'https://...' } } })",
-        ],
-        description: "Execute Sage mutations and non-search inspect actions across prompts, behaviors, skills, builder, chat, library, activation, hub, and external tool surfaces. " +
-            "Use this for prompts.get, skills.get/use, behaviors.run, activation.activate, library.prompt_add/skill_add, hub.start/stop, and external.call/execute. " +
-            "Use domain='external', action='call' with params={tool_name:'fetch', tool_params:{url:'https://example.com'}} for URL fetches, and use domain='hub' to start or stop MCP servers before calling their tools.",
-        parameters: Type.Object({
-            domain: Type.Optional(SageDomainType),
-            action: Type.Optional(Type.String()),
-            params: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
-        }),
-        renderCall: (args, theme) => renderSageToolCall("execute", args, theme),
-        renderResult: (result, options, theme, context) => renderSageToolResult("execute", result, options, theme, context),
-        execute: async (_toolCallId, params) => {
-            try {
-                const normalized = normalizeCodeModeRequest("execute", params);
-                const domain = normalized.domain;
-                const action = normalized.action;
-                const payload = normalized.params;
-                if (domain === "external" && !["execute", "call"].includes(action)) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "For external domain, sage_execute only supports actions: execute, call",
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                const result = await callCodeModeWithWebResilience(mcpBridge, "execute", {
-                    domain,
-                    action,
-                    params: payload,
-                });
-                return toToolResultText(result);
-            }
-            catch (error) {
-                const errorMsg = augmentHubStartErrorMessage(params, error instanceof Error ? error.message : String(error));
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `sage_execute failed: ${errorMsg}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        },
-    };
-}
-const SAGE_CLI_REFERENCE = `
-## Sage Code-Mode Reference
-
-### Route Discovery
-- List domains/actions: sage_search({ domain: "help", action: "list", params: {} })
-- Suggest the right route: sage_search({ domain: "meta", action: "suggest", params: { goal: "..." } })
-- Inspect local Sage state: sage_search({ domain: "meta", action: "get_project_context", params: {} })
-
-### Skills / Prompts / Behaviors
-- Search skills: sage_search({ domain: "skills", action: "search", params: { query: "..." } })
-- Inspect skill body: sage_execute({ domain: "skills", action: "get", params: { key: "..." } })
-- Activate skill: sage_execute({ domain: "skills", action: "use", params: { key: "..." } })
-- Search prompts: sage_search({ domain: "prompts", action: "search", params: { query: "..." } })
-- Inspect prompt body: sage_execute({ domain: "prompts", action: "get", params: { key: "..." } })
-- Inspect behavior: sage_search({ domain: "behaviors", action: "show", params: { key: "..." } })
-
-### Hub / External Tools
-- List MCP servers: sage_search({ domain: "hub", action: "list_servers", params: {} })
-- Hub status: sage_search({ domain: "hub", action: "status", params: {} })
-- Start server: sage_execute({ domain: "hub", action: "start", params: { server_id: "github" } })
-- Running external servers/tools: sage_search({ domain: "external", action: "list_servers", params: {} })
-- Web search: sage_search({ domain: "external", action: "search", params: { tool_name: "web_search", tool_params: { query: "..." } } })
-- URL fetch: sage_execute({ domain: "external", action: "call", params: { tool_name: "fetch", tool_params: { url: "https://..." } } })
-`.trim();
-function buildHubRenderContext(action, params, context) {
-    return {
-        ...(context && typeof context === "object" ? context : {}),
-        args: {
-            domain: "hub",
-            action,
-            params,
-        },
-    };
-}
-function augmentHubStartErrorMessage(params, errorMsg) {
-    try {
-        const normalized = normalizeCodeModeRequest("execute", params);
-        if (normalized.domain === "hub" &&
-            normalized.action === "start" &&
-            /EOF|empty|parse|unexpected end/i.test(errorMsg)) {
-            const serverId = String(normalized.params.server_id ?? "unknown");
-            const knownKeyRequirements = {
-                "brave-search": "BRAVE_API_KEY",
-                github: "GITHUB_TOKEN",
-            };
-            const requiredKey = knownKeyRequirements[serverId];
-            if (requiredKey) {
-                return (errorMsg +
-                    `. Server '${serverId}' likely failed because ${requiredKey} is not configured. ` +
-                    `Set it with: sage mcp hub env set ${serverId} ${requiredKey}=<your-key>`);
-            }
-            return (errorMsg +
-                `. Server '${serverId}' may require environment variables (API keys). ` +
-                `Check with: sage mcp hub env list ${serverId}`);
-        }
-    }
-    catch {
-        // Keep original error text if normalization fails.
-    }
-    return errorMsg;
-}
-export function createHubListServersTool(mcpBridge) {
-    return {
-        name: "hub_list_servers",
-        label: "Hub: List Servers",
-        promptSnippet: "List Sage MCP servers directly when you need inventory/status without composing a generic sage_search call",
-        promptGuidelines: [
-            "Prefer hub_list_servers() for simple MCP server inventory in Pi; it is the direct convenience wrapper over domain='hub', action='list_servers'",
-            "Use sage_search({ domain: 'external', action: 'list_servers', params: {} }) only when you specifically need running external servers/tools rather than the full Sage hub inventory",
-        ],
-        description: "List all Sage MCP servers with running/available state. This is a Pi-native convenience wrapper for sage_search({ domain:'hub', action:'list_servers', params:{} }).",
-        parameters: Type.Object({}),
-        renderCall: (_args, theme) => renderSageToolCall("search", { domain: "hub", action: "list_servers", params: {} }, theme),
-        renderResult: (result, options, theme, context) => renderSageToolResult("search", result, options, theme, buildHubRenderContext("list_servers", {}, context)),
-        execute: async () => {
-            try {
-                const result = await callCodeModeWithWebResilience(mcpBridge, "search", {
-                    domain: "hub",
-                    action: "list_servers",
-                    params: {},
-                });
-                return toToolResultText(result);
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `hub_list_servers failed: ${error instanceof Error ? error.message : String(error)}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        },
-    };
-}
-export function createHubStatusTool(mcpBridge) {
-    return {
-        name: "hub_status",
-        label: "Hub: Status",
-        promptSnippet: "Inspect Sage MCP hub runtime status directly when you want running server state without composing a generic sage_search call",
-        promptGuidelines: [
-            "Prefer hub_status() for simple MCP runtime status in Pi; it is the direct convenience wrapper over domain='hub', action='status'",
-            "Use sage_status() when you need full adapter health plus Sage context, not just hub runtime state",
-        ],
-        description: "Inspect Sage MCP hub runtime status. This is a Pi-native convenience wrapper for sage_search({ domain:'hub', action:'status', params:{} }).",
-        parameters: Type.Object({}),
-        renderCall: (_args, theme) => renderSageToolCall("search", { domain: "hub", action: "status", params: {} }, theme),
-        renderResult: (result, options, theme, context) => renderSageToolResult("search", result, options, theme, buildHubRenderContext("status", {}, context)),
-        execute: async () => {
-            try {
-                const result = await callCodeModeWithWebResilience(mcpBridge, "search", {
-                    domain: "hub",
-                    action: "status",
-                    params: {},
-                });
-                return toToolResultText(result);
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `hub_status failed: ${error instanceof Error ? error.message : String(error)}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        },
-    };
-}
-export function createHubSessionListTool(mcpBridge) {
-    return {
-        name: "hub_session_list",
-        label: "Hub: Session List",
-        promptSnippet: "List active Sage MCP hub sessions directly when you need isolated instance visibility without composing a generic sage_search call",
-        promptGuidelines: [
-            "Prefer hub_session_list() for simple hub session inspection in Pi; it wraps domain='hub', action='session_list'",
-            "Pass server_id when you want to filter sessions for one server, and use hub_stop_server with server_id plus session_id to stop a specific isolated session",
-        ],
-        description: "List active Sage MCP hub sessions, optionally filtered by server_id. This is a Pi-native convenience wrapper for sage_search({ domain:'hub', action:'session_list', params:{ server_id? } }).",
-        parameters: Type.Object({
-            server_id: Type.Optional(Type.String({
-                description: "Optional hub server identifier to filter sessions",
-            })),
-        }),
-        renderCall: (args, theme) => renderSageToolCall("search", {
-            domain: "hub",
-            action: "session_list",
-            params: normalizeParams(args),
-        }, theme),
-        renderResult: (result, options, theme, context) => renderSageToolResult("search", result, options, theme, buildHubRenderContext("session_list", normalizeParams(context?.args), context)),
-        execute: async (_toolCallId, params) => {
-            try {
-                const payload = normalizeParams(params);
-                const result = await callCodeModeWithWebResilience(mcpBridge, "search", {
-                    domain: "hub",
-                    action: "session_list",
-                    params: payload,
-                });
-                return toToolResultText(result);
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `hub_session_list failed: ${error instanceof Error ? error.message : String(error)}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        },
-    };
-}
-export function createHubStopServerTool(mcpBridge) {
-    return {
-        name: "hub_stop_server",
-        label: "Hub: Stop Server",
-        promptSnippet: "Stop a Sage MCP server directly when you know the server_id and want to end its runtime cleanly",
-        promptGuidelines: [
-            "Prefer hub_stop_server({ server_id: '...' }) for simple MCP server shutdown in Pi; it wraps domain='hub', action='stop'",
-            "Use hub_status() or hub_list_servers() after stopping a server if you need to confirm the resulting hub state",
-        ],
-        description: "Stop a Sage MCP server by server_id. This is a Pi-native convenience wrapper for sage_execute({ domain:'hub', action:'stop', params:{ server_id:'...' } }).",
-        parameters: Type.Object({
-            server_id: Type.String({
-                description: "Hub server identifier to stop, such as github or brave-search",
-            }),
-            session_id: Type.Optional(Type.String({
-                description: "Optional hub session identifier for isolated instances",
-            })),
-        }),
-        renderCall: (args, theme) => renderSageToolCall("execute", { domain: "hub", action: "stop", params: normalizeParams(args) }, theme),
-        renderResult: (result, options, theme, context) => renderSageToolResult("execute", result, options, theme, buildHubRenderContext("stop", normalizeParams(context?.args), context)),
-        execute: async (_toolCallId, params) => {
-            try {
-                const payload = normalizeParams(params);
-                const result = await callCodeModeWithWebResilience(mcpBridge, "execute", {
-                    domain: "hub",
-                    action: "stop",
-                    params: payload,
-                });
-                return toToolResultText(result);
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `hub_stop_server failed: ${error instanceof Error ? error.message : String(error)}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        },
-    };
-}
-export function createHubStartServerTool(mcpBridge) {
-    return {
-        name: "hub_start_server",
-        label: "Hub: Start Server",
-        promptSnippet: "Start a Sage MCP server directly when you already know the server_id and want Pi to expose its tools",
-        promptGuidelines: [
-            "Prefer hub_start_server({ server_id: '...' }) for simple MCP server startup in Pi; it wraps domain='hub', action='start'",
-            "After starting an external MCP server, call its tools through sage_execute/sage_search with domain='external' and params { tool_name, tool_params }",
-        ],
-        description: "Start a Sage MCP server by server_id. This is a Pi-native convenience wrapper for sage_execute({ domain:'hub', action:'start', params:{ server_id:'...' } }).",
-        parameters: Type.Object({
-            server_id: Type.String({
-                description: "Hub server identifier to start, such as github or brave-search",
-            }),
-            session_id: Type.Optional(Type.String({
-                description: "Optional hub session identifier for isolated instances",
-            })),
-        }),
-        renderCall: (args, theme) => renderSageToolCall("execute", { domain: "hub", action: "start", params: normalizeParams(args) }, theme),
-        renderResult: (result, options, theme, context) => renderSageToolResult("execute", result, options, theme, buildHubRenderContext("start", normalizeParams(context?.args), context)),
-        execute: async (_toolCallId, params) => {
-            try {
-                const payload = normalizeParams(params);
-                const result = await callCodeModeWithWebResilience(mcpBridge, "execute", {
-                    domain: "hub",
-                    action: "start",
-                    params: payload,
-                });
-                return toToolResultText(result);
-            }
-            catch (error) {
-                const errorMsg = augmentHubStartErrorMessage({ domain: "hub", action: "start", params }, error instanceof Error ? error.message : String(error));
-                return {
-                    content: [
-                        { type: "text", text: `hub_start_server failed: ${errorMsg}` },
-                    ],
-                    isError: true,
-                };
-            }
-        },
-    };
-}
-export function createSageStatusTool(mcpBridge) {
-    return {
-        name: "sage_status",
-        label: "Sage: Status",
-        promptSnippet: "Check Sage connectivity, list available MCP servers and external tools",
-        description: "Check Sage adapter health, list available MCP servers and tools, and verify connectivity. " +
-            "Call this to see what external tools (web search, GitHub, fetch, browser automation, etc.) are available.",
-        parameters: Type.Object({}),
-        execute: async () => {
-            const health = mcpBridge.getHealthSnapshot();
-            const bridgeConnected = health.bridgeConnected && !health.degraded;
-            if (bridgeConnected) {
-                try {
-                    const context = await mcpBridge.callCodeModeSearch({
-                        domain: "meta",
-                        action: "get_project_context",
-                        params: {},
-                    });
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: JSON.stringify({
-                                    bridgeConnected,
-                                    degraded: false,
-                                    sageAdapterVersion: "0.3.1",
-                                    availableToolCount: health.availableToolCount,
-                                    availableToolNames: health.availableToolNames,
-                                    context: extractJsonFromMcpResult(context) ?? context,
-                                }, null, 2),
-                            },
-                            {
-                                type: "text",
-                                text: SAGE_CLI_REFERENCE,
-                            },
-                        ],
-                    };
-                }
-                catch (error) {
-                    // Tool call failed even though the bridge claims ready; surface as
-                    // degraded rather than falling back silently.
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: JSON.stringify({
-                                    bridgeConnected,
-                                    degraded: true,
-                                    sageAdapterVersion: "0.3.1",
-                                    lastHealthError: error instanceof Error ? error.message : String(error),
-                                }, null, 2),
-                            },
-                            {
-                                type: "text",
-                                text: SAGE_CLI_REFERENCE,
-                            },
-                        ],
-                        details: { bridgeConnected, degraded: true },
-                    };
-                }
-            }
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            bridgeConnected,
-                            degraded: health.degraded,
-                            sageAdapterVersion: "0.3.1",
-                            lastHealthError: health.lastHealthError,
-                            lastHealthCheckedAt: health.lastHealthCheckedAt,
-                            availableToolCount: health.availableToolCount,
-                            availableToolNames: health.availableToolNames,
-                        }, null, 2),
-                    },
-                    {
-                        type: "text",
-                        text: SAGE_CLI_REFERENCE,
-                    },
-                ],
-                details: {
-                    bridgeConnected,
-                    degraded: health.degraded,
-                    lastHealthError: health.lastHealthError,
-                },
-            };
-        },
-    };
-}
-export function wrapToolsWithSageSecurity(tools, options) {
-    return tools.map((tool) => {
-        const originalExecute = tool.execute;
-        return {
-            ...tool,
-            execute: async (toolCallId, params, signal, onUpdate, ctx) => {
-                const sessionId = options.getSessionId?.();
-                const pre = await options.hookRuntime.scanPreTool(tool.name, params, sessionId);
-                if (pre?.decision === "block") {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: `Sage security blocked ${tool.name}: ${pre.reason ?? "high-risk payload detected"}`,
-                            },
-                        ],
-                        details: {
-                            blockedBySageSecurity: true,
-                            reason: pre.reason,
-                            tool: tool.name,
-                        },
-                        isError: true,
-                    };
-                }
-                const result = await originalExecute(toolCallId, params, signal, onUpdate, ctx);
-                const post = await options.hookRuntime.scanPostTool(tool.name, params, result, sessionId);
-                if (post?.decision === "warn" || post?.decision === "block") {
-                    return appendText(result, `Sage security ${post.decision}: ${post.reason ?? "treat this output as untrusted content."}`);
-                }
-                return result;
-            },
-        };
-    });
-}
-async function injectHookMessage(session, customType, content, display = false) {
-    const trimmed = content.trim();
-    if (!trimmed)
-        return;
-    if (typeof session.sendHookMessage === "function") {
-        await session.sendHookMessage({
-            customType,
-            content: trimmed,
-            display,
-        }, false);
-        return;
-    }
-    console.log(`\n[${customType}]\n${trimmed}\n`);
-}
-export function createSageExtensions(options) {
-    const { mcpBridge } = options;
-    const hookRuntime = options.hookRuntime ??
-        new SageHookRuntime({
-            sageBin: options.config.sageBin ?? "sage",
-            timeoutMs: options.config.timeoutMs ?? 20_000,
-            ...options.config,
-        });
-    mcpBridge.start().catch((error) => {
-        console.error("[sage-pi-adapter] failed to start MCP bridge:", error);
-    });
-    const sageTools = [
-        createHubListServersTool(mcpBridge),
-        createHubStatusTool(mcpBridge),
-        createHubSessionListTool(mcpBridge),
-        createHubStartServerTool(mcpBridge),
-        createHubStopServerTool(mcpBridge),
-        createSageSearchTool(mcpBridge),
-        createSageExecuteTool(mcpBridge),
-        createSageStatusTool(mcpBridge),
-    ];
-    const customTools = wrapToolsWithSageSecurity(sageTools, {
-        hookRuntime,
-        getSessionId: options.getSessionId,
-    });
-    return {
-        customTools,
-        // Preserved for one compatibility release. Pi's native skill surface owns
-        // discovery/loading now, so adapter-side prompt injection must stay inert.
-        sageInjectSuggestion: async (_userPrompt, _session, _sessionId) => { },
-        sageClearSuggestions: () => { },
-        sageGetSuggestions: () => "",
-    };
-}
-export async function createSageSessionConfig(config = {}) {
-    const normalized = {
-        sageBin: config.sageBin ?? "sage",
-        timeoutMs: config.timeoutMs ?? 20_000,
-        suggestLimit: config.suggestLimit ?? 3,
-        suggestDebounceMs: config.suggestDebounceMs ?? 800,
-        enableProvision: config.enableProvision ?? true,
-        enableRlmFeedback: config.enableRlmFeedback ?? true,
-        enableSecurityHooks: config.enableSecurityHooks ?? true,
-        source: config.source ?? "pi",
-        ...config,
-    };
-    const sageEnv = {
-        HOME: process.env.HOME ?? "",
-        PATH: process.env.PATH ?? "",
-        SAGE_FILTER_EXECUTION: "1", // enable execution multiplier in routing
-        ...(normalized.env ?? {}),
-    };
-    if (normalized.sageProfile) {
-        sageEnv.SAGE_PROFILE = normalized.sageProfile;
-    }
-    const hookRuntime = new SageHookRuntime(normalized);
-    let activeSessionId;
-    const mcpBridge = new SageMcpBridge(normalized.sageBin, ["mcp", "start"], sageEnv, normalized.timeoutMs);
-    const extension = createSageExtensions({
-        config: normalized,
-        mcpBridge,
-        hookRuntime,
-        getSessionId: () => activeSessionId,
-        debounceMs: normalized.suggestDebounceMs,
-    });
-    const wrapTools = (tools) => wrapToolsWithSageSecurity(tools, {
-        hookRuntime,
-        getSessionId: () => activeSessionId,
-    });
-    return {
-        customTools: extension.customTools,
-        mcpBridge,
-        wrapToolsWithSecurity: wrapTools,
-        setupHooks: (session) => {
-            activeSessionId = session.sessionId;
-            // Inject Sage session context (skill context from CLI).
-            hookRuntime
-                .getSessionContext(activeSessionId)
-                .then(async (context) => {
-                if (!context)
-                    return;
-                await injectHookMessage(session, "sage-session-context", context, false);
-            })
-                .catch((error) => {
-                console.error("[sage-pi-adapter] failed to inject session context:", error);
-            });
-            // Show loaded skills/libraries summary to the user.
-            hookRuntime
-                .getSkillVisibilitySummary()
-                .then(async (vis) => {
-                if (!vis.summary)
-                    return;
-                await injectHookMessage(session, "sage-loaded", vis.summary, true);
-            })
-                .catch((error) => {
-                console.error("[sage-pi-adapter] failed to get skill summary:", error);
-            });
-            const unsubscribe = session.subscribe((event) => {
-                const parsed = parseMessageEndEvent(event);
-                if (!parsed)
-                    return;
-                if (parsed.role === "user") {
-                    const content = parsed.content.trim();
-                    if (!content)
-                        return;
-                    void hookRuntime
-                        .capturePrompt(content, activeSessionId)
-                        .catch((error) => {
-                        console.error("[sage-pi-adapter] prompt capture failed:", error);
-                    });
-                    return;
-                }
-                if (parsed.role === "assistant") {
-                    const response = parsed.content.trim();
-                    if (!response)
-                        return;
-                    const usage = extractUsage(parsed.usage);
-                    void hookRuntime
-                        .captureResponse(response, usage, activeSessionId)
-                        .catch((error) => {
-                        console.error("[sage-pi-adapter] response capture failed:", error);
-                    });
-                }
-            });
-            return () => {
-                unsubscribe();
-            };
-        },
-    };
-}
-export default {
-    createSageExtensions,
-    createSageSessionConfig,
-    wrapToolsWithSageSecurity,
-    SageMcpBridge,
-    SageHookRuntime,
-};
-//# sourceMappingURL=sage-pi-adapter.js.map