@code-yeongyu/senpi 2026.8.11-2 → 2026.8.11-3

package/dist/core/extensions/builtin/mcp/expose/lazy-activate.d.ts

@@ -1,15 +0,0 @@
-export interface LazySearchableTool {
-    readonly name: string;
-}
-export interface LazyActivationState {
-    readonly searchable: readonly LazySearchableTool[];
-    readonly active: readonly string[];
-}
-export interface LazyToolActivatorDeps {
-    readonly getSearchable: () => readonly LazySearchableTool[];
-    readonly getActiveTools: () => readonly string[];
-    readonly activate: (names: readonly string[]) => void;
-}
-export declare function resolveLazyActivationTargets(requested: readonly string[], state: LazyActivationState): readonly string[];
-export declare function createLazyToolActivator(deps: LazyToolActivatorDeps): (toolName: string) => boolean;
-//# sourceMappingURL=lazy-activate.d.ts.map

package/dist/core/extensions/builtin/mcp/expose/lazy-activate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazy-activate.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/mcp/expose/lazy-activate.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,SAAS,kBAAkB,EAAE,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;CACtD;AAED,wBAAgB,4BAA4B,CAC3C,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,KAAK,EAAE,mBAAmB,GACxB,SAAS,MAAM,EAAE,CASnB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAUlG"}

package/dist/core/extensions/builtin/mcp/expose/lazy-activate.js

@@ -1,33 +0,0 @@
-// Lazy tool activation for code-mode (eval) callers.
-//
-// An eval cell that names an MCP tool held inactive by SEARCH-mode exposure used
-// to fail with `inactive_tool`, even though tool_search may promote that exact
-// tool. Eligibility is therefore the tier-B searchable catalog and nothing else:
-// permission-denied tools, `list_changed` rug-pull additions, removed-tool
-// tombstones, and model-gated tools (look_at / read_video) are never eligible.
-// Activation is delegated to the tier-B `activate()` path so stub-swap, name
-// filtering, and active-set ordering keep their existing semantics.
-export function resolveLazyActivationTargets(requested, state) {
-    const eligible = new Set(state.searchable.map((tool) => tool.name));
-    const active = new Set(state.active);
-    const targets = [];
-    for (const name of requested) {
-        if (!eligible.has(name) || active.has(name) || targets.includes(name))
-            continue;
-        targets.push(name);
-    }
-    return targets;
-}
-export function createLazyToolActivator(deps) {
-    return (toolName) => {
-        const targets = resolveLazyActivationTargets([toolName], {
-            searchable: deps.getSearchable(),
-            active: deps.getActiveTools(),
-        });
-        if (targets.length === 0)
-            return false;
-        deps.activate(targets);
-        return true;
-    };
-}
-//# sourceMappingURL=lazy-activate.js.map

package/dist/core/extensions/builtin/mcp/expose/lazy-activate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazy-activate.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/mcp/expose/lazy-activate.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,2EAA2E;AAC3E,+EAA+E;AAC/E,6EAA6E;AAC7E,oEAAoE;AAiBpE,MAAM,UAAU,4BAA4B,CAC3C,SAA4B,EAC5B,KAA0B;IAE1B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAChF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAA2B;IAClE,OAAO,CAAC,QAAgB,EAAW,EAAE;QACpC,MAAM,OAAO,GAAG,4BAA4B,CAAC,CAAC,QAAQ,CAAC,EAAE;YACxD,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE;YAChC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE;SAC7B,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;AACH,CAAC","sourcesContent":["// Lazy tool activation for code-mode (eval) callers.\n//\n// An eval cell that names an MCP tool held inactive by SEARCH-mode exposure used\n// to fail with `inactive_tool`, even though tool_search may promote that exact\n// tool. Eligibility is therefore the tier-B searchable catalog and nothing else:\n// permission-denied tools, `list_changed` rug-pull additions, removed-tool\n// tombstones, and model-gated tools (look_at / read_video) are never eligible.\n// Activation is delegated to the tier-B `activate()` path so stub-swap, name\n// filtering, and active-set ordering keep their existing semantics.\n\nexport interface LazySearchableTool {\n\treadonly name: string;\n}\n\nexport interface LazyActivationState {\n\treadonly searchable: readonly LazySearchableTool[];\n\treadonly active: readonly string[];\n}\n\nexport interface LazyToolActivatorDeps {\n\treadonly getSearchable: () => readonly LazySearchableTool[];\n\treadonly getActiveTools: () => readonly string[];\n\treadonly activate: (names: readonly string[]) => void;\n}\n\nexport function resolveLazyActivationTargets(\n\trequested: readonly string[],\n\tstate: LazyActivationState,\n): readonly string[] {\n\tconst eligible = new Set(state.searchable.map((tool) => tool.name));\n\tconst active = new Set(state.active);\n\tconst targets: string[] = [];\n\tfor (const name of requested) {\n\t\tif (!eligible.has(name) || active.has(name) || targets.includes(name)) continue;\n\t\ttargets.push(name);\n\t}\n\treturn targets;\n}\n\nexport function createLazyToolActivator(deps: LazyToolActivatorDeps): (toolName: string) => boolean {\n\treturn (toolName: string): boolean => {\n\t\tconst targets = resolveLazyActivationTargets([toolName], {\n\t\t\tsearchable: deps.getSearchable(),\n\t\t\tactive: deps.getActiveTools(),\n\t\t});\n\t\tif (targets.length === 0) return false;\n\t\tdeps.activate(targets);\n\t\treturn true;\n\t};\n}\n"]}

package/dist/core/extensions/builtin/mcp/expose/tool-search.d.ts

@@ -1,43 +0,0 @@
-import { Type } from "typebox";
-import type { ToolDefinition } from "../../../types.ts";
-import { type Bm25Doc } from "./bm25.ts";
-export declare const TOOL_SEARCH_TOOL_NAME = "tool_search";
-/** Stable, machine-parseable marker embedded in every activating result so
- * activations survive compaction/restart. Kept human-readable on purpose. */
-export declare const TOOL_SEARCH_ACTIVATION_MARKER = "[tool_search:activated]";
-export type SearchableMcpTool = Bm25Doc;
-export interface McpSearchDeps {
-    /** Full current catalog (all MCP tools, active or not) to rank over. */
-    getSearchableTools(): readonly SearchableMcpTool[];
-    /** Current active tool names (includes non-MCP tools). */
-    getActiveTools(): string[];
-    /** Replace the active set. Implementations should preserve registration. */
-    setActiveTools(names: readonly string[]): void;
-}
-export interface McpSearchDetails {
-    query: string;
-    activated: string[];
-}
-declare const ParamsSchema: Type.TObject<{
-    query: Type.TString;
-    server: Type.TOptional<Type.TString>;
-}>;
-type McpSearchTool = ToolDefinition<typeof ParamsSchema, McpSearchDetails, unknown>;
-export declare function createMcpSearchTool(deps: McpSearchDeps): McpSearchTool;
-interface RankedMatch {
-    readonly name: string;
-    readonly doc: SearchableMcpTool;
-}
-export declare function buildMcpSearchResultText(query: string, matches: readonly RankedMatch[], server: string | undefined): string;
-/**
- * Replay tool_search activations recorded in prior history so a
- * compacted/restarted session restores its active tool set without re-searching.
- * Only names still present in `validNames` are restored (removed tools stay
- * dropped). Deterministic: returns a de-duplicated, sorted list.
- */
-export declare function rehydrateActiveToolsFromHistory(messages: readonly unknown[], validNames: ReadonlySet<string>): string[];
-/** Stable union: dedupe and sort so the active-tools array is byte-stable
- * across turns (prompt-cache friendly). */
-export declare function unionStable(current: readonly string[], added: readonly string[]): string[];
-export {};
-//# sourceMappingURL=tool-search.d.ts.map

package/dist/core/extensions/builtin/mcp/expose/tool-search.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/mcp/expose/tool-search.ts"],"names":[],"mappings":"AAYA,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,KAAK,OAAO,EAAkB,MAAM,WAAW,CAAC;AAEzD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD;6EAC6E;AAC7E,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AAGvE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,WAAW,aAAa;IAC7B,wEAAwE;IACxE,kBAAkB,IAAI,SAAS,iBAAiB,EAAE,CAAC;IACnD,0DAA0D;IAC1D,cAAc,IAAI,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,QAAA,MAAM,YAAY;;;EAGhB,CAAC;AAGH,KAAK,aAAa,GAAG,cAAc,CAAC,OAAO,YAAY,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAEpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAmCtE;AAED,UAAU,WAAW;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;CAChC;AAED,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC9C,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,MAAM,EAAE,CAUV;AAsBD;2CAC2C;AAC3C,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE1F"}

package/dist/core/extensions/builtin/mcp/expose/tool-search.js

@@ -1,125 +0,0 @@
-// tool_search tool + promotion engine (todo 31).
-//
-// `tool_search` is an always-active tool that ranks the full MCP catalog with
-// the local BM25 engine and PROMOTES matched tools into the active set via
-// setActiveTools (effective the NEXT turn — senpi semantics). Promotion state
-// is derivable from history: each result embeds a stable activation marker so a
-// compaction/restart can replay activations at session_start
-// (rehydrateActiveToolsFromHistory). Activated tools persist for the session;
-// there is no auto-eviction in v1. Every setActiveTools call is stable-sorted.
-import { Text } from "@earendil-works/pi-tui";
-import { Type } from "typebox";
-import { buildBm25Index } from "./bm25.js";
-export const TOOL_SEARCH_TOOL_NAME = "tool_search";
-/** Stable, machine-parseable marker embedded in every activating result so
- * activations survive compaction/restart. Kept human-readable on purpose. */
-export const TOOL_SEARCH_ACTIVATION_MARKER = "[tool_search:activated]";
-const MAX_RESULTS = 10;
-const ParamsSchema = Type.Object({
-    query: Type.String({ description: "Natural-language description of the capability you need." }),
-    server: Type.Optional(Type.String({ description: "Optional: restrict the search to a single MCP server name." })),
-});
-export function createMcpSearchTool(deps) {
-    return {
-        name: TOOL_SEARCH_TOOL_NAME,
-        label: "MCP tool search",
-        description: "Search the catalog of available MCP tools by capability. Matched tools are activated and become callable on your NEXT turn. Use this before calling an MCP tool that is not already active.",
-        promptSnippet: "Search MCP servers for a tool by capability; matched tools activate next turn.",
-        parameters: ParamsSchema,
-        executionMode: "parallel",
-        async execute(_toolCallId, params) {
-            const searchable = deps.getSearchableTools();
-            const index = buildBm25Index(searchable);
-            const matches = index.search(params.query, MAX_RESULTS, params.server ? { server: params.server } : {});
-            const activated = matches.map((match) => match.name);
-            if (activated.length > 0) {
-                deps.setActiveTools(unionStable(deps.getActiveTools(), activated));
-            }
-            const text = buildMcpSearchResultText(params.query, matches, params.server);
-            return {
-                content: [{ type: "text", text }],
-                details: { activated, query: params.query },
-            };
-        },
-        renderCall(args, theme) {
-            const filter = args.server ? ` @${args.server}` : "";
-            return new Text(theme.fg("toolTitle", theme.bold(`${TOOL_SEARCH_TOOL_NAME} "${args.query}"${filter}`)), 0, 0);
-        },
-        renderResult(result, options, theme) {
-            const count = result.details?.activated.length ?? 0;
-            const title = options.isPartial
-                ? `${TOOL_SEARCH_TOOL_NAME}: searching`
-                : `${TOOL_SEARCH_TOOL_NAME}: ${count} tool(s) activated`;
-            return new Text(theme.fg("toolOutput", title), 0, 0);
-        },
-    };
-}
-export function buildMcpSearchResultText(query, matches, server) {
-    const scope = server ? ` on server "${server}"` : "";
-    if (matches.length === 0) {
-        return `No MCP tools matched "${query}"${scope}. No tools were activated; try different keywords or run tool_search with a broader query. Your active tool set is unchanged.`;
-    }
-    const bullets = matches
-        .map((match) => `- ${match.name} — ${oneLine(match.doc.description) ?? "(no description)"}`)
-        .join("\n");
-    const names = matches.map((match) => match.name).join(" ");
-    return [
-        `Found ${matches.length} MCP tool(s) matching "${query}"${scope}. They are now active and callable from your NEXT turn:`,
-        "",
-        bullets,
-        "",
-        `${TOOL_SEARCH_ACTIVATION_MARKER} ${names}`,
-    ].join("\n");
-}
-/**
- * Replay tool_search activations recorded in prior history so a
- * compacted/restarted session restores its active tool set without re-searching.
- * Only names still present in `validNames` are restored (removed tools stay
- * dropped). Deterministic: returns a de-duplicated, sorted list.
- */
-export function rehydrateActiveToolsFromHistory(messages, validNames) {
-    const restored = new Set();
-    for (const message of messages) {
-        for (const segment of extractActivationSegments(message)) {
-            for (const name of segment.trim().split(/\s+/)) {
-                if (name.length > 0 && validNames.has(name))
-                    restored.add(name);
-            }
-        }
-    }
-    return [...restored].sort();
-}
-function extractActivationSegments(message) {
-    let blob;
-    try {
-        blob = JSON.stringify(message) ?? "";
-    }
-    catch {
-        return [];
-    }
-    const segments = [];
-    let cursor = blob.indexOf(TOOL_SEARCH_ACTIVATION_MARKER);
-    while (cursor >= 0) {
-        const rest = blob.slice(cursor + TOOL_SEARCH_ACTIVATION_MARKER.length);
-        // Tool names are [a-zA-Z0-9_-]; stop at the first JSON string terminator
-        // (quote / escape) or newline so we never swallow the rest of the blob.
-        const end = rest.search(/["\\\n]/);
-        segments.push(end < 0 ? rest : rest.slice(0, end));
-        cursor = blob.indexOf(TOOL_SEARCH_ACTIVATION_MARKER, cursor + TOOL_SEARCH_ACTIVATION_MARKER.length);
-    }
-    return segments;
-}
-/** Stable union: dedupe and sort so the active-tools array is byte-stable
- * across turns (prompt-cache friendly). */
-export function unionStable(current, added) {
-    return [...new Set([...current, ...added])].sort();
-}
-function oneLine(text) {
-    if (text === undefined)
-        return undefined;
-    const collapsed = text.replace(/\s+/g, " ").trim();
-    if (collapsed.length === 0)
-        return undefined;
-    return collapsed.length <= 100 ? collapsed : `${collapsed.slice(0, 97)}...`;
-}
-//# sourceMappingURL=tool-search.js.map

package/dist/core/extensions/builtin/mcp/expose/tool-search.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/mcp/expose/tool-search.ts"],"names":[],"mappings":"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","sourcesContent":["// tool_search tool + promotion engine (todo 31).\n//\n// `tool_search` is an always-active tool that ranks the full MCP catalog with\n// the local BM25 engine and PROMOTES matched tools into the active set via\n// setActiveTools (effective the NEXT turn — senpi semantics). Promotion state\n// is derivable from history: each result embeds a stable activation marker so a\n// compaction/restart can replay activations at session_start\n// (rehydrateActiveToolsFromHistory). Activated tools persist for the session;\n// there is no auto-eviction in v1. Every setActiveTools call is stable-sorted.\n\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport { type Static, Type } from \"typebox\";\nimport type { ToolDefinition } from \"../../../types.ts\";\nimport { type Bm25Doc, buildBm25Index } from \"./bm25.ts\";\n\nexport const TOOL_SEARCH_TOOL_NAME = \"tool_search\";\n/** Stable, machine-parseable marker embedded in every activating result so\n * activations survive compaction/restart. Kept human-readable on purpose. */\nexport const TOOL_SEARCH_ACTIVATION_MARKER = \"[tool_search:activated]\";\nconst MAX_RESULTS = 10;\n\nexport type SearchableMcpTool = Bm25Doc;\n\nexport interface McpSearchDeps {\n\t/** Full current catalog (all MCP tools, active or not) to rank over. */\n\tgetSearchableTools(): readonly SearchableMcpTool[];\n\t/** Current active tool names (includes non-MCP tools). */\n\tgetActiveTools(): string[];\n\t/** Replace the active set. Implementations should preserve registration. */\n\tsetActiveTools(names: readonly string[]): void;\n}\n\nexport interface McpSearchDetails {\n\tquery: string;\n\tactivated: string[];\n}\n\nconst ParamsSchema = Type.Object({\n\tquery: Type.String({ description: \"Natural-language description of the capability you need.\" }),\n\tserver: Type.Optional(Type.String({ description: \"Optional: restrict the search to a single MCP server name.\" })),\n});\ntype Params = Static<typeof ParamsSchema>;\n\ntype McpSearchTool = ToolDefinition<typeof ParamsSchema, McpSearchDetails, unknown>;\n\nexport function createMcpSearchTool(deps: McpSearchDeps): McpSearchTool {\n\treturn {\n\t\tname: TOOL_SEARCH_TOOL_NAME,\n\t\tlabel: \"MCP tool search\",\n\t\tdescription:\n\t\t\t\"Search the catalog of available MCP tools by capability. Matched tools are activated and become callable on your NEXT turn. Use this before calling an MCP tool that is not already active.\",\n\t\tpromptSnippet: \"Search MCP servers for a tool by capability; matched tools activate next turn.\",\n\t\tparameters: ParamsSchema,\n\t\texecutionMode: \"parallel\",\n\t\tasync execute(_toolCallId, params: Params): Promise<AgentToolResult<McpSearchDetails>> {\n\t\t\tconst searchable = deps.getSearchableTools();\n\t\t\tconst index = buildBm25Index(searchable);\n\t\t\tconst matches = index.search(params.query, MAX_RESULTS, params.server ? { server: params.server } : {});\n\t\t\tconst activated = matches.map((match) => match.name);\n\t\t\tif (activated.length > 0) {\n\t\t\t\tdeps.setActiveTools(unionStable(deps.getActiveTools(), activated));\n\t\t\t}\n\t\t\tconst text = buildMcpSearchResultText(params.query, matches, params.server);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\tdetails: { activated, query: params.query },\n\t\t\t};\n\t\t},\n\t\trenderCall(args, theme) {\n\t\t\tconst filter = args.server ? ` @${args.server}` : \"\";\n\t\t\treturn new Text(theme.fg(\"toolTitle\", theme.bold(`${TOOL_SEARCH_TOOL_NAME} \"${args.query}\"${filter}`)), 0, 0);\n\t\t},\n\t\trenderResult(result, options, theme) {\n\t\t\tconst count = result.details?.activated.length ?? 0;\n\t\t\tconst title = options.isPartial\n\t\t\t\t? `${TOOL_SEARCH_TOOL_NAME}: searching`\n\t\t\t\t: `${TOOL_SEARCH_TOOL_NAME}: ${count} tool(s) activated`;\n\t\t\treturn new Text(theme.fg(\"toolOutput\", title), 0, 0);\n\t\t},\n\t};\n}\n\ninterface RankedMatch {\n\treadonly name: string;\n\treadonly doc: SearchableMcpTool;\n}\n\nexport function buildMcpSearchResultText(\n\tquery: string,\n\tmatches: readonly RankedMatch[],\n\tserver: string | undefined,\n): string {\n\tconst scope = server ? ` on server \"${server}\"` : \"\";\n\tif (matches.length === 0) {\n\t\treturn `No MCP tools matched \"${query}\"${scope}. No tools were activated; try different keywords or run tool_search with a broader query. Your active tool set is unchanged.`;\n\t}\n\tconst bullets = matches\n\t\t.map((match) => `- ${match.name} — ${oneLine(match.doc.description) ?? \"(no description)\"}`)\n\t\t.join(\"\\n\");\n\tconst names = matches.map((match) => match.name).join(\" \");\n\treturn [\n\t\t`Found ${matches.length} MCP tool(s) matching \"${query}\"${scope}. They are now active and callable from your NEXT turn:`,\n\t\t\"\",\n\t\tbullets,\n\t\t\"\",\n\t\t`${TOOL_SEARCH_ACTIVATION_MARKER} ${names}`,\n\t].join(\"\\n\");\n}\n\n/**\n * Replay tool_search activations recorded in prior history so a\n * compacted/restarted session restores its active tool set without re-searching.\n * Only names still present in `validNames` are restored (removed tools stay\n * dropped). Deterministic: returns a de-duplicated, sorted list.\n */\nexport function rehydrateActiveToolsFromHistory(\n\tmessages: readonly unknown[],\n\tvalidNames: ReadonlySet<string>,\n): string[] {\n\tconst restored = new Set<string>();\n\tfor (const message of messages) {\n\t\tfor (const segment of extractActivationSegments(message)) {\n\t\t\tfor (const name of segment.trim().split(/\\s+/)) {\n\t\t\t\tif (name.length > 0 && validNames.has(name)) restored.add(name);\n\t\t\t}\n\t\t}\n\t}\n\treturn [...restored].sort();\n}\n\nfunction extractActivationSegments(message: unknown): string[] {\n\tlet blob: string;\n\ttry {\n\t\tblob = JSON.stringify(message) ?? \"\";\n\t} catch {\n\t\treturn [];\n\t}\n\tconst segments: string[] = [];\n\tlet cursor = blob.indexOf(TOOL_SEARCH_ACTIVATION_MARKER);\n\twhile (cursor >= 0) {\n\t\tconst rest = blob.slice(cursor + TOOL_SEARCH_ACTIVATION_MARKER.length);\n\t\t// Tool names are [a-zA-Z0-9_-]; stop at the first JSON string terminator\n\t\t// (quote / escape) or newline so we never swallow the rest of the blob.\n\t\tconst end = rest.search(/[\"\\\\\\n]/);\n\t\tsegments.push(end < 0 ? rest : rest.slice(0, end));\n\t\tcursor = blob.indexOf(TOOL_SEARCH_ACTIVATION_MARKER, cursor + TOOL_SEARCH_ACTIVATION_MARKER.length);\n\t}\n\treturn segments;\n}\n\n/** Stable union: dedupe and sort so the active-tools array is byte-stable\n * across turns (prompt-cache friendly). */\nexport function unionStable(current: readonly string[], added: readonly string[]): string[] {\n\treturn [...new Set([...current, ...added])].sort();\n}\n\nfunction oneLine(text: string | undefined): string | undefined {\n\tif (text === undefined) return undefined;\n\tconst collapsed = text.replace(/\\s+/g, \" \").trim();\n\tif (collapsed.length === 0) return undefined;\n\treturn collapsed.length <= 100 ? collapsed : `${collapsed.slice(0, 97)}...`;\n}\n"]}