@elaraai/east-plugin 0.0.0-stage → 1.0.85

package/dist/lib/search.d.ts

@@ -0,0 +1,108 @@
+import MiniSearch from "minisearch";
+export declare const MIN_SCORE = 5;
+export type Language = "typescript" | "python";
+export type Format = "summary" | "full";
+export interface IndexEntry {
+    id: string;
+    skill: string;
+    package: string;
+    file: string;
+    suite: string;
+    test: string;
+    keywords: string[];
+    imports: string[];
+    /** `["typescript", "python"]` (a program, printed from IR), `["tsx"]` (JSX-authored UI), `["typescript"]` (authored, not a program). */
+    languages: Array<"typescript" | "python" | "tsx">;
+    /** Authored TypeScript (UI and static entries). */
+    source?: string;
+    /** The example's IR as JSON (program entries). */
+    ir?: string;
+    /** The TypeScript printed from the IR (program entries). */
+    ts?: string;
+    /** The python printed from the IR, or null when the index was built without python (program entries). */
+    python?: string | null;
+    signature?: {
+        inputs: string[];
+        output: string;
+        async: boolean;
+    };
+    inputs?: string | null;
+    returns?: string | null;
+    builtins?: string[];
+}
+/** The fields MiniSearch scores — derived text, not stored twice. */
+interface SearchDocument extends IndexEntry {
+    keywordsText: string;
+    builtinsText: string;
+    typesText: string;
+    code: string;
+}
+export type ExampleIndex = MiniSearch<SearchDocument>;
+/** The loaded index: the search over it and the package names it holds. */
+export interface LoadedIndex {
+    search: ExampleIndex;
+    /** Every indexed package name, sorted — the values the `package` filter accepts. */
+    packages: string[];
+}
+/** The searchable index over `indexPath` (loaded once per process). */
+export declare function buildSearchIndex(indexPath: string): Promise<ExampleIndex>;
+/** The index over `indexPath`, with its package names. */
+export declare function loadIndex(indexPath: string): Promise<LoadedIndex>;
+/**
+ * One search over several index files: a plugin that builds on East's serves
+ * East's corpus and its own together, the package filter knowing both. An id
+ * is the example's package, file and export, so two corpora never share one;
+ * an id found in two files is refused, naming both, rather than one shadowing
+ * the other.
+ *
+ * @param indexPaths - The `index.json` files, East's (`EAST_INDEX_PATH`) among them to answer its corpus too
+ * @returns The index over every file's entries, with their package names
+ */
+export declare function loadIndexes(indexPaths: readonly string[]): Promise<LoadedIndex>;
+/** A package filter as the index names packages: `@elaraai/east-node-io` and `east-node-io` are the same package. */
+export declare function normalizePackage(filter: string): string;
+export interface SearchRequest {
+    query: string;
+    limit: number;
+    /** A package or skill name; the `@elaraai/` scope is accepted and ignored. */
+    package?: string | undefined;
+}
+export interface SearchResult {
+    entries: IndexEntry[];
+    /** Set when the package filter names no indexed package — the caller should say so, with `known`. */
+    unknownPackage?: string;
+    known: string[];
+}
+/**
+ * The search the tool runs: scored hits above `MIN_SCORE`, the package
+ * filter applied INSIDE the search so `limit` counts filtered hits (a filter
+ * applied after a capped result list starves), and an unknown package
+ * reported rather than returned as an empty list.
+ */
+export declare function searchExamples(index: LoadedIndex, request: SearchRequest): SearchResult;
+/** Whether an entry has something to show for a requested language: `typescript` covers authored TSX too. */
+export declare function speaks(entry: IndexEntry, language: Language): boolean;
+/** The code of an entry in `language` and the fence it takes, or null when the entry has none in it. */
+export declare function codeOf(entry: IndexEntry, language: Language): {
+    code: string;
+    fence: string;
+} | null;
+/** What the tools' words call the corpus and its fetch tool. */
+export interface CorpusNames {
+    /** The corpus, as in "East example(s)". */
+    corpus: string;
+    /** The tool that fetches one example in full. */
+    getTool: string;
+}
+/** East's names. */
+export declare const EAST_CORPUS: CorpusNames;
+/** One line per hit: id, description, signature, keywords, the example's inputs and result. */
+export declare function formatSummary(entries: IndexEntry[], language: Language, names?: CorpusNames): string;
+/** An entry in full: its description, signature, code in `language`, and the example inputs and result. */
+export declare function formatFull(entries: IndexEntry[], language: Language): string;
+/** Search results as the tool renders them. */
+export declare function formatResults(entries: IndexEntry[], language: Language, format: Format, names?: CorpusNames): string;
+/** The index entry with `id`, or null. */
+export declare function getEntry(index: ExampleIndex, id: string): IndexEntry | null;
+export {};
+//# sourceMappingURL=search.d.ts.map

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

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

package/dist/lib/search.js

@@ -0,0 +1,167 @@
+import { readFile } from "node:fs/promises";
+import MiniSearch from "minisearch";
+// The example index (#654): every East program example stored as its IR with
+// the TypeScript and python printed from it, UI and hand-written examples as
+// their authored TypeScript. Searched by what an example IS — its keywords,
+// description, the builtins it calls, its types — and rendered in the
+// language the caller asks for, as a summary or in full.
+export const MIN_SCORE = 5;
+/** The searchable index over `indexPath` (loaded once per process). */
+export async function buildSearchIndex(indexPath) {
+    return (await loadIndex(indexPath)).search;
+}
+/** The index over `indexPath`, with its package names. */
+export async function loadIndex(indexPath) {
+    return loadIndexes([indexPath]);
+}
+/**
+ * One search over several index files: a plugin that builds on East's serves
+ * East's corpus and its own together, the package filter knowing both. An id
+ * is the example's package, file and export, so two corpora never share one;
+ * an id found in two files is refused, naming both, rather than one shadowing
+ * the other.
+ *
+ * @param indexPaths - The `index.json` files, East's (`EAST_INDEX_PATH`) among them to answer its corpus too
+ * @returns The index over every file's entries, with their package names
+ */
+export async function loadIndexes(indexPaths) {
+    const entries = [];
+    const fileOf = new Map();
+    for (const indexPath of indexPaths) {
+        const data = JSON.parse(await readFile(indexPath, "utf-8"));
+        for (const entry of data.entries) {
+            const first = fileOf.get(entry.id);
+            if (first !== undefined)
+                throw new Error(`example id "${entry.id}" is in both ${first} and ${indexPath}`);
+            fileOf.set(entry.id, indexPath);
+            entries.push(entry);
+        }
+    }
+    const data = { entries };
+    const miniSearch = new MiniSearch({
+        idField: "id",
+        fields: ["keywordsText", "test", "builtinsText", "suite", "typesText", "code"],
+        storeFields: ["id", "skill", "package", "suite", "test", "keywords", "imports", "languages", "source", "ts", "python", "signature", "inputs", "returns", "builtins"],
+        searchOptions: {
+            boost: { keywordsText: 3, test: 2, builtinsText: 2, suite: 1.5, typesText: 1, code: 1 },
+            fuzzy: 0.2,
+            prefix: true,
+        },
+    });
+    const documents = data.entries.map((entry) => ({
+        ...entry,
+        keywordsText: entry.keywords.join(" "),
+        builtinsText: (entry.builtins ?? []).join(" "),
+        typesText: entry.signature ? [...entry.signature.inputs, entry.signature.output].join(" ") : "",
+        code: entry.source ?? entry.ts ?? "",
+    }));
+    miniSearch.addAll(documents);
+    return { search: miniSearch, packages: [...new Set(data.entries.map((e) => e.package))].sort() };
+}
+/** A package filter as the index names packages: `@elaraai/east-node-io` and `east-node-io` are the same package. */
+export function normalizePackage(filter) {
+    return filter.trim().toLowerCase().replace(/^@elaraai\//, "");
+}
+/**
+ * The search the tool runs: scored hits above `MIN_SCORE`, the package
+ * filter applied INSIDE the search so `limit` counts filtered hits (a filter
+ * applied after a capped result list starves), and an unknown package
+ * reported rather than returned as an empty list.
+ */
+export function searchExamples(index, request) {
+    const known = index.packages;
+    const filter = request.package;
+    const pkg = typeof filter === "string" && filter.trim() !== "" ? normalizePackage(filter) : undefined;
+    if (pkg !== undefined && typeof filter === "string" && !known.includes(pkg)) {
+        return { entries: [], unknownPackage: filter, known };
+    }
+    const options = {
+        limit: request.limit,
+        ...(pkg === undefined ? {} : { filter: (r) => r.package === pkg || r.skill === pkg }),
+    };
+    const hits = index.search.search(request.query, options);
+    return { entries: hits.filter((r) => r.score >= MIN_SCORE).slice(0, request.limit), known };
+}
+/** `(inputs) -> output`, or the kind of a non-program entry. */
+function signatureOf(entry) {
+    if (entry.signature === undefined)
+        return entry.languages.includes("tsx") ? "tsx (a UI component, authored as JSX)" : "typescript (authored)";
+    const arrow = entry.signature.async ? "~>" : "->";
+    return `(${entry.signature.inputs.join(", ")}) ${arrow} ${entry.signature.output}`;
+}
+function clip(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+}
+/** Whether an entry has something to show for a requested language: `typescript` covers authored TSX too. */
+export function speaks(entry, language) {
+    return language === "python" ? entry.languages.includes("python") : entry.languages.some((l) => l === "typescript" || l === "tsx");
+}
+/** The code of an entry in `language` and the fence it takes, or null when the entry has none in it. */
+export function codeOf(entry, language) {
+    if (language === "python")
+        return entry.python ? { code: entry.python, fence: "python" } : null;
+    if (entry.ts !== undefined)
+        return { code: entry.ts, fence: "typescript" };
+    if (entry.source !== undefined) {
+        return { code: [...entry.imports, "", entry.source].join("\n"), fence: entry.languages.includes("tsx") ? "tsx" : "typescript" };
+    }
+    return null;
+}
+/** East's names. */
+export const EAST_CORPUS = { corpus: "East", getTool: "get_east_example" };
+/** One line per hit: id, description, signature, keywords, the example's inputs and result. */
+export function formatSummary(entries, language, names = EAST_CORPUS) {
+    const lines = entries.map((e) => {
+        const parts = [`- \`${e.id}\` — ${e.test}`, `  ${signatureOf(e)}`];
+        if (e.keywords.length > 0)
+            parts.push(`  keywords: ${clip(e.keywords.join(", "), 160)}`);
+        if (e.inputs !== undefined && e.inputs !== null)
+            parts.push(`  e.g. ${clip(e.inputs, 100)} → ${e.returns === null || e.returns === undefined ? "(see the example)" : clip(e.returns, 100)}`);
+        if (language === "python" && !speaks(e, "python"))
+            parts.push(`  (${e.languages.join("/")} only)`);
+        else if (language === "python" && !e.python)
+            parts.push("  (no python rendering in this index build)");
+        return parts.join("\n");
+    });
+    return [
+        "<east-examples>",
+        `## ${entries.length} ${names.corpus} example(s) — fetch one in full with ${names.getTool}(id, language: "${language}")`,
+        "",
+        ...lines,
+        "</east-examples>",
+    ].join("\n");
+}
+/** An entry in full: its description, signature, code in `language`, and the example inputs and result. */
+export function formatFull(entries, language) {
+    const sections = entries.map((e) => {
+        const code = codeOf(e, language);
+        const body = code === null
+            ? (!speaks(e, language)
+                ? `_${e.languages.join("/")} only: request language: "typescript"._`
+                : "_No python rendering in this index build._")
+            : ["```" + code.fence, code.code, "```"].join("\n");
+        const io = e.inputs !== undefined && e.inputs !== null
+            ? `Inputs: \`${clip(e.inputs, 300)}\`${e.returns === null || e.returns === undefined ? "" : ` → returns \`${clip(e.returns, 300)}\``}`
+            : "";
+        return [
+            `### \`${e.id}\``,
+            `${e.test} · Suite: ${e.suite} · Package: ${e.package}`,
+            `Signature: ${signatureOf(e)}`,
+            e.keywords.length > 0 ? `Keywords: ${e.keywords.join(", ")}` : "",
+            "",
+            body,
+            io,
+        ].filter((l) => l !== "").join("\n");
+    });
+    return ["<east-examples>", ...sections, "</east-examples>"].join("\n\n");
+}
+/** Search results as the tool renders them. */
+export function formatResults(entries, language, format, names = EAST_CORPUS) {
+    return format === "full" ? formatFull(entries, language) : formatSummary(entries, language, names);
+}
+/** The index entry with `id`, or null. */
+export function getEntry(index, id) {
+    const stored = index.getStoredFields(id);
+    return stored === undefined ? null : stored;
+}
+//# sourceMappingURL=search.js.map

package/dist/lib/search.js.map

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

package/dist/lib/transcript.d.ts

@@ -0,0 +1,29 @@
+/** The example-search tools, as the transcript records their use. */
+export declare const SEARCH_TOOLS: string[];
+/**
+ * Whether the session's transcript records a call of an example-search tool
+ * (the whole file, once).
+ *
+ * @param transcriptPath - The session's transcript
+ * @param tools - The tools whose call counts as a search (default East's)
+ * @returns Whether one of them was called
+ */
+export declare function searchedInTranscript(transcriptPath: string, tools?: readonly string[]): Promise<boolean>;
+interface ContentBlock {
+    type: string;
+    text?: string;
+    thinking?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+}
+interface TranscriptEntry {
+    type: string;
+    message?: {
+        content?: ContentBlock[] | string;
+    };
+}
+export declare function readRecentEntries(transcriptPath: string, maxEntries?: number): Promise<TranscriptEntry[]>;
+export declare function extractRecentContext(entries: TranscriptEntry[]): string;
+export declare function extractRecentFiles(entries: TranscriptEntry[], maxFiles?: number): string[];
+export {};
+//# sourceMappingURL=transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../lib/transcript.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,eAAO,MAAM,YAAY,UAA+J,CAAC;AAEzL;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5H;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;KACnC,CAAC;CACH;AAED,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA2B3G;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAmCvE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,SAAK,GAAG,MAAM,EAAE,CAqBtF"}

package/dist/lib/transcript.js

@@ -0,0 +1,109 @@
+import { readFile } from "node:fs/promises";
+const MAX_READ_BYTES = 200_000;
+/** The example-search tools, as the transcript records their use. */
+export const SEARCH_TOOLS = ["mcp__plugin_east_east__search_east_examples", "mcp__plugin_east_east__get_east_example", "mcp__east__search_east_examples", "mcp__east__get_east_example"];
+/**
+ * Whether the session's transcript records a call of an example-search tool
+ * (the whole file, once).
+ *
+ * @param transcriptPath - The session's transcript
+ * @param tools - The tools whose call counts as a search (default East's)
+ * @returns Whether one of them was called
+ */
+export async function searchedInTranscript(transcriptPath, tools = SEARCH_TOOLS) {
+    let raw;
+    try {
+        raw = await readFile(transcriptPath, "utf-8");
+    }
+    catch {
+        return false;
+    }
+    return tools.some((tool) => raw.includes(`"name":"${tool}"`) || raw.includes(`"name": "${tool}"`));
+}
+export async function readRecentEntries(transcriptPath, maxEntries = 30) {
+    let raw;
+    try {
+        const buf = await readFile(transcriptPath);
+        const slice = buf.length > MAX_READ_BYTES
+            ? buf.subarray(buf.length - MAX_READ_BYTES)
+            : buf;
+        raw = slice.toString("utf-8");
+    }
+    catch {
+        return [];
+    }
+    const lines = raw.trimEnd().split("\n");
+    const entries = [];
+    for (let i = lines.length - 1; i >= 0 && entries.length < maxEntries; i--) {
+        try {
+            const entry = JSON.parse(lines[i]);
+            if (entry.type === "assistant" || entry.type === "user") {
+                entries.push(entry);
+            }
+        }
+        catch {
+            // skip malformed lines (including partial first line from slice)
+        }
+    }
+    return entries;
+}
+export function extractRecentContext(entries) {
+    const texts = [];
+    const files = [];
+    let textCount = 0;
+    for (const entry of entries) {
+        if (entry.type !== "assistant")
+            continue;
+        const content = entry.message?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (block.type === "text" && block.text) {
+                texts.push(block.text);
+                textCount++;
+            }
+            else if (block.type === "thinking" && block.thinking) {
+                texts.push(block.thinking);
+                textCount++;
+            }
+            else if (block.type === "tool_use") {
+                const filePath = block.input?.file_path;
+                if (typeof filePath === "string" && !files.includes(filePath)) {
+                    files.push(filePath);
+                }
+                if (block.name === "Grep" && typeof block.input?.pattern === "string") {
+                    texts.push(block.input.pattern);
+                }
+            }
+        }
+        if (textCount >= 5)
+            break;
+    }
+    const fileContext = files.slice(0, 5).map((f) => f.split("/").pop()).join(" ");
+    const reasoning = texts.join("\n").slice(0, 2000);
+    return [reasoning, fileContext].filter(Boolean).join("\n");
+}
+export function extractRecentFiles(entries, maxFiles = 10) {
+    const files = [];
+    for (const entry of entries) {
+        if (entry.type !== "assistant")
+            continue;
+        const content = entry.message?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (block.type !== "tool_use")
+                continue;
+            if (!["Read", "Edit", "Write"].includes(block.name ?? ""))
+                continue;
+            const filePath = block.input?.file_path;
+            if (typeof filePath === "string" && !files.includes(filePath)) {
+                files.push(filePath);
+                if (files.length >= maxFiles)
+                    return files;
+            }
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=transcript.js.map

package/dist/lib/transcript.js.map

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

package/dist/mcp/example-tools.d.ts

@@ -0,0 +1,26 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type LoadedIndex } from "../lib/search.js";
+/** East's indexed packages, as the search tool's package filter names them. */
+export declare const EAST_PACKAGES: readonly string[];
+/** What the search and fetch tools answer from, and the names they go by. */
+export interface ExampleToolsOptions {
+    /** The `index.json` files the tools answer from, read once — East's (`EAST_INDEX_PATH`) among them to answer its corpus too — or an index already loaded. */
+    index: readonly string[] | Promise<LoadedIndex>;
+    /** The search tool's name (default `search_east_examples`). */
+    searchTool?: string;
+    /** The fetch tool's name (default `get_east_example`). */
+    getTool?: string;
+    /** What the tools call the corpus and its code (default `East`). */
+    corpus?: string;
+    /** The package names the package filter's description lists (default East's). */
+    packages?: readonly string[];
+}
+/**
+ * Registers the example search and fetch tools on `server`.
+ *
+ * @param server - The MCP server the tools join
+ * @param options - The index they answer from and the names they go by
+ * @returns The index, once loaded
+ */
+export declare function registerExampleTools(server: McpServer, options: ExampleToolsOptions): Promise<LoadedIndex>;
+//# sourceMappingURL=example-tools.d.ts.map

package/dist/mcp/example-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-tools.d.ts","sourceRoot":"","sources":["../../mcp/example-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAiF,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOnI,+EAA+E;AAC/E,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAyH,CAAC;AAErK,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,6JAA6J;IAC7J,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAChD,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2F1G"}

package/dist/mcp/example-tools.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { EAST_CORPUS, formatFull, formatResults, getEntry, loadIndexes, searchExamples } from "../lib/search.js";
+// The example search's two MCP tools (#654), for any server: East's own
+// registers them with East's names over East's index, and a plugin that builds
+// on East's registers them with its own names over its index — beside East's
+// to answer both corpora from one server, or alone beside the East plugin.
+/** East's indexed packages, as the search tool's package filter names them. */
+export const EAST_PACKAGES = ["east", "east-node-std", "east-node-io", "east-py-datascience", "east-ui", "e3-ui", "e3", "e3-ui-cli", "e3-create"];
+function isLoaded(index) {
+    return typeof index.then === "function";
+}
+/**
+ * Registers the example search and fetch tools on `server`.
+ *
+ * @param server - The MCP server the tools join
+ * @param options - The index they answer from and the names they go by
+ * @returns The index, once loaded
+ */
+export function registerExampleTools(server, options) {
+    const searchTool = options.searchTool ?? "search_east_examples";
+    const getTool = options.getTool ?? EAST_CORPUS.getTool;
+    const corpus = options.corpus ?? EAST_CORPUS.corpus;
+    const packages = options.packages ?? EAST_PACKAGES;
+    const names = { corpus, getTool };
+    const indexPromise = isLoaded(options.index) ? options.index : loadIndexes(options.index);
+    const languageArg = z
+        .enum(["typescript", "python"])
+        .default("typescript")
+        .describe('The language to render examples in: "typescript" (the East DSL) or "python" (east-py). Every core example is stored as IR and printed in either; UI examples are TypeScript only.');
+    server.tool(searchTool, `The mandatory first step before writing or changing ${corpus} code: search the tested example index for the capability you are about to use. Every ${corpus} API has an example here, stored as IR and rendered in TypeScript or python. Returns summaries by default (id, description, signature, keywords, the example inputs and result — a few hundred bytes each); pass format: "full" for the code, or fetch one with ${getTool}. Do not read node_modules/@elaraai or *.examples.ts files instead — this is the same corpus, exact and far cheaper.`, {
+        query: z.string().describe("What you need, in words: the operation, the types involved, the method name if you know it (e.g. \"group by key and sum\", \"dict merge\", \"parse csv blob\")"),
+        language: languageArg,
+        format: z
+            .enum(["summary", "full"])
+            .default("summary")
+            .describe('"summary" (default) lists the hits in one line each; "full" includes each hit\'s code in the requested language'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(5)
+            .describe("Maximum number of results to return (default 5, max 20)"),
+        package: z
+            .string()
+            .optional()
+            .describe(`Filter results to one package by its bare name — ${packages.join(", ")} — the \`@elaraai/\` scope is accepted and ignored; an unknown name is reported with the indexed names`),
+    }, async ({ query, language, format, limit, package: packageFilter }) => {
+        const index = await indexPromise;
+        const { entries, unknownPackage, known } = searchExamples(index, { query, limit, package: packageFilter });
+        if (unknownPackage !== undefined) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Package "${unknownPackage}" is not an indexed package name. Indexed packages: ${known.join(", ")} (bare names; \`@elaraai/east-node-io\` and \`east-node-io\` are the same). Retry with one of them, or without a package filter.`,
+                    },
+                ],
+            };
+        }
+        if (entries.length === 0) {
+            const scope = packageFilter ? ` in package "${packageFilter}"` : "";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No ${corpus} examples found for query: "${query}"${scope} — try the operation's plain-English name, the East method name, or the types involved${packageFilter ? ", or drop the package filter" : ""}.`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatResults(entries, language, format, names),
+                },
+            ],
+        };
+    });
+    server.tool(getTool, `One ${corpus} example in full, by the id a search returned: its code printed in the requested language from the example's IR (TypeScript or python), its signature, and the example inputs and expected result. The second step after ${searchTool}.`, {
+        id: z.string().describe("The example id from a search result, e.g. \"east:array.examples.ts:arrayMap\""),
+        language: languageArg,
+    }, async ({ id, language }) => {
+        const index = await indexPromise;
+        const entry = getEntry(index.search, id);
+        if (entry === null) {
+            return { content: [{ type: "text", text: `No ${corpus} example with id "${id}" — ids come from ${searchTool} results.` }] };
+        }
+        return { content: [{ type: "text", text: formatFull([entry], language) }] };
+    });
+    return indexPromise;
+}
+//# sourceMappingURL=example-tools.js.map

package/dist/mcp/example-tools.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../mcp/server.ts"],"names":[],"mappings":""}