@frihet/mcp-server 1.12.0-beta.1 → 1.13.0

package/dist/tool-exposure.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Tool-exposure profile for the Frihet MCP server — progressive disclosure.
+ *
+ * Activated by FRIHET_TOOL_MODE=grouped (env var or Worker binding).
+ * Default (unset, or FRIHET_TOOL_MODE=full) leaves the server BYTE-IDENTICAL
+ * to today: all 151 tools registered with their full descriptions/schemas.
+ *
+ * ── Why ──────────────────────────────────────────────────────────────────
+ * Context rot is the 2026 problem: a flat list of 151 tool descriptions,
+ * each a multi-paragraph bilingual blob, eats the agent's context window and
+ * degrades tool selection before any work begins. Leaders cut flat lists.
+ *
+ * Frihet's differentiator is DEPTH (full ES/EU fiscal + native compliance —
+ * VeriFactu / TicketBAI / Facturae — plus banking, CRM, HR/payroll, stay/PMS,
+ * POS) — but depth should be SERVED ON DEMAND, not dumped up front.
+ *
+ * ── How ──────────────────────────────────────────────────────────────────
+ * In `grouped` mode this module intercepts `registerTool` (reusing the exact
+ * pattern of `openai-profile.ts`) and:
+ *
+ *   1. Records every tool into an in-memory CATALOG (name → group, title,
+ *      one-line summary, full description, input field list) before it reaches
+ *      the server.
+ *   2. Still registers every tool so it stays INVOCABLE (nothing breaks; tool
+ *      logic, names and behavior are untouched) — but COLLAPSES its registered
+ *      description to a single terse "[group] summary — full schema via
+ *      describe_tool('name')" line. That is the context saving.
+ *   3. Adds three lightweight META-TOOLS as the entry point for discovery:
+ *        • list_tool_groups()      — the 9-domain map with per-group counts
+ *        • search_tools(query)     — fuzzy match → matching tool summaries
+ *        • describe_tool(name)     — full original description + input fields
+ *
+ * The agent loads ~3 meta-tool descriptions + 151 terse one-liners instead of
+ * 151 full bilingual blobs, then pulls full depth only for the handful of
+ * tools it actually needs. Progressive disclosure, zero behavior change.
+ *
+ * IMPORTANT: this is purely an EXPOSURE layer. It does NOT live in
+ * src/tools/*.ts, so the audited tool count stays 151 (+ meta). The meta-tools
+ * are added only in grouped mode and are NOT counted as ERP tools.
+ *
+ * @see ./openai-profile.ts — the sibling interceptor this mirrors.
+ */
+/** Stable domain identifiers used by the group router. */
+export type ToolGroupId = "invoicing" | "expenses" | "fiscal" | "banking" | "crm" | "hr" | "stay" | "pos" | "intelligence" | "catalog" | "platform";
+interface GroupMeta {
+    /** Human label, bilingual. */
+    label: string;
+    /** One-line domain blurb shown in list_tool_groups. */
+    blurb: string;
+}
+/**
+ * Domain metadata. Keep these terse — they are the only group-level prose the
+ * agent loads up front. Depth lives in the per-tool descriptions, fetched via
+ * describe_tool / search_tools.
+ */
+export declare const GROUPS: Record<ToolGroupId, GroupMeta>;
+/**
+ * Map a tool's source file (basename, no extension) to its domain group.
+ *
+ * Driving the mapping off the SOURCE FILE — not a hand-maintained per-tool
+ * list — means new tools added to an existing file inherit the right group
+ * automatically, so the taxonomy never drifts from the registration sites.
+ */
+export declare const FILE_TO_GROUP: Record<string, ToolGroupId>;
+/**
+ * Assign a group by tool NAME. The name-based mapping reproduces the
+ * source-file grouping exactly for all 151 current tools (verified), with the
+ * eight cross-file cases pinned via NAME_OVERRIDES. Driven off the name (not a
+ * hand-kept list) so a future tool lands somewhere sensible automatically.
+ *
+ * Order matters: e-invoicing ("einvoice") is checked before generic "invoice".
+ */
+export declare function groupForTool(name: string): ToolGroupId;
+interface CatalogEntry {
+    name: string;
+    group: ToolGroupId;
+    title: string;
+    /** First sentence of the description, single line (for terse listings). */
+    summary: string;
+    /** Full original description (served by describe_tool). */
+    description: string;
+    /** Whether the tool mutates state (from annotations.readOnlyHint). */
+    readOnly: boolean;
+    /** Input field names, for quick schema shape without dumping zod. */
+    inputFields: string[];
+}
+/** Returned for visibility/tests; the live catalog after registration. */
+export interface ToolExposureHandle {
+    /** All registered tools, keyed by name. */
+    catalog: Map<string, CatalogEntry>;
+    /** Group → tool names. */
+    groups: Map<ToolGroupId, string[]>;
+}
+/**
+ * Resolve the active tool mode from an env-like bag.
+ * Default is "full" — current behavior, untouched.
+ */
+export declare function resolveToolMode(env?: Record<string, string | undefined>): "full" | "grouped";
+/**
+ * Apply the grouped tool-exposure profile to an MCP server.
+ *
+ * Must be called BEFORE registerAllTools(). Intercepts registerTool to record
+ * a catalog + collapse descriptions, then (after tools are registered) adds the
+ * meta-tools. Because registration is synchronous and ordered, the caller wires
+ * it as:
+ *
+ * ```ts
+ * if (resolveToolMode() === "grouped") applyToolExposureProfile(server);
+ * registerAllTools(server, client);   // tools recorded + collapsed here
+ * // applyToolExposureProfile already queued the meta-tools to register last
+ * ```
+ *
+ * The meta-tools are registered immediately (eagerly) so they appear in
+ * tools/list; they read from the catalog object, which is populated lazily as
+ * the real tools register. This is safe: tool HANDLERS run long after all
+ * registration completes.
+ *
+ * @param server  The McpServer (typed loosely to match the openai-profile shim).
+ * @returns a handle exposing the live catalog (useful for tests/logging).
+ */
+export declare function applyToolExposureProfile(server: any): ToolExposureHandle;
+/** Number of meta-tools added in grouped mode (for logging). */
+export declare const GROUPED_META_TOOL_COUNT: number;
+/** Exposed for logging/tests. */
+export declare const TOOL_GROUP_IDS: ToolGroupId[];
+export {};
+//# sourceMappingURL=tool-exposure.d.ts.map

package/dist/tool-exposure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-exposure.d.ts","sourceRoot":"","sources":["../src/tool-exposure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAQH,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,UAAU,GACV,QAAQ,GACR,SAAS,GACT,KAAK,GACL,IAAI,GACJ,MAAM,GACN,KAAK,GACL,cAAc,GACd,SAAS,GACT,UAAU,CAAC;AAEf,UAAU,SAAS;IACjB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,CAkDjD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAyCrD,CAAC;AAuBF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAkBtD;AAMD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAkBD,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnC,0BAA0B;IAC1B,MAAM,EAAE,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAYD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAgB,GACrD,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,wBAAgB,wBAAwB,CAEtC,MAAM,EAAE,GAAG,GACV,kBAAkB,CAqDpB;AA+LD,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,QAAuB,CAAC;AAE5D,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAA0B,WAAW,EAAE,CAAC"}

package/dist/tool-exposure.js

@@ -0,0 +1,453 @@
+/**
+ * Tool-exposure profile for the Frihet MCP server — progressive disclosure.
+ *
+ * Activated by FRIHET_TOOL_MODE=grouped (env var or Worker binding).
+ * Default (unset, or FRIHET_TOOL_MODE=full) leaves the server BYTE-IDENTICAL
+ * to today: all 151 tools registered with their full descriptions/schemas.
+ *
+ * ── Why ──────────────────────────────────────────────────────────────────
+ * Context rot is the 2026 problem: a flat list of 151 tool descriptions,
+ * each a multi-paragraph bilingual blob, eats the agent's context window and
+ * degrades tool selection before any work begins. Leaders cut flat lists.
+ *
+ * Frihet's differentiator is DEPTH (full ES/EU fiscal + native compliance —
+ * VeriFactu / TicketBAI / Facturae — plus banking, CRM, HR/payroll, stay/PMS,
+ * POS) — but depth should be SERVED ON DEMAND, not dumped up front.
+ *
+ * ── How ──────────────────────────────────────────────────────────────────
+ * In `grouped` mode this module intercepts `registerTool` (reusing the exact
+ * pattern of `openai-profile.ts`) and:
+ *
+ *   1. Records every tool into an in-memory CATALOG (name → group, title,
+ *      one-line summary, full description, input field list) before it reaches
+ *      the server.
+ *   2. Still registers every tool so it stays INVOCABLE (nothing breaks; tool
+ *      logic, names and behavior are untouched) — but COLLAPSES its registered
+ *      description to a single terse "[group] summary — full schema via
+ *      describe_tool('name')" line. That is the context saving.
+ *   3. Adds three lightweight META-TOOLS as the entry point for discovery:
+ *        • list_tool_groups()      — the 9-domain map with per-group counts
+ *        • search_tools(query)     — fuzzy match → matching tool summaries
+ *        • describe_tool(name)     — full original description + input fields
+ *
+ * The agent loads ~3 meta-tool descriptions + 151 terse one-liners instead of
+ * 151 full bilingual blobs, then pulls full depth only for the handful of
+ * tools it actually needs. Progressive disclosure, zero behavior change.
+ *
+ * IMPORTANT: this is purely an EXPOSURE layer. It does NOT live in
+ * src/tools/*.ts, so the audited tool count stays 151 (+ meta). The meta-tools
+ * are added only in grouped mode and are NOT counted as ERP tools.
+ *
+ * @see ./openai-profile.ts — the sibling interceptor this mirrors.
+ */
+/**
+ * Domain metadata. Keep these terse — they are the only group-level prose the
+ * agent loads up front. Depth lives in the per-tool descriptions, fetched via
+ * describe_tool / search_tools.
+ */
+export const GROUPS = {
+    invoicing: {
+        label: "Invoicing & receivables / Facturación y cobros",
+        blurb: "Invoices, credit notes, quotes, recurring invoices, deposits — create, send, pay, PDF.",
+    },
+    expenses: {
+        label: "Expenses & vendors / Gastos y proveedores",
+        blurb: "Expenses (with OCR) and vendor/supplier records.",
+    },
+    fiscal: {
+        label: "Fiscal & compliance / Fiscal y cumplimiento",
+        blurb: "Spanish/EU fiscal depth served on demand: Modelo 303/130/390/180/347/200/202/415/425/418, " +
+            "VeriFactu, TicketBAI, Facturae/FACe/KSeF e-invoicing, IGIC/AIEM, GL audit, period close, VIES.",
+    },
+    banking: {
+        label: "Banking / Banca",
+        blurb: "Bank accounts, transactions, categorization, reconciliation, bank rules.",
+    },
+    crm: {
+        label: "CRM & clients / CRM y clientes",
+        blurb: "Clients/customers plus contacts, activities and notes.",
+    },
+    hr: {
+        label: "HR & payroll / RRHH y nóminas",
+        blurb: "Leave, attendance, overtime, time tracking, payroll export, team, onboarding, permissions.",
+    },
+    stay: {
+        label: "Stay / PMS / Alojamientos",
+        blurb: "Vacation-rental reservations, properties and channel sync.",
+    },
+    pos: {
+        label: "POS / TPV",
+        blurb: "Point-of-sale terminals, sales and refunds.",
+    },
+    intelligence: {
+        label: "Intelligence / Inteligencia",
+        blurb: "Business context, monthly/quarterly summaries and gestoría collaboration — call first in a session.",
+    },
+    catalog: {
+        label: "Products / Productos",
+        blurb: "Product/service catalog with pricing.",
+    },
+    platform: {
+        label: "Platform / Plataforma",
+        blurb: "Webhooks and white-label portal domain configuration.",
+    },
+};
+/**
+ * Map a tool's source file (basename, no extension) to its domain group.
+ *
+ * Driving the mapping off the SOURCE FILE — not a hand-maintained per-tool
+ * list — means new tools added to an existing file inherit the right group
+ * automatically, so the taxonomy never drifts from the registration sites.
+ */
+export const FILE_TO_GROUP = {
+    invoices: "invoicing",
+    quotes: "invoicing",
+    recurring: "invoicing",
+    deposits: "invoicing",
+    expenses: "expenses",
+    vendors: "expenses",
+    fiscal: "fiscal",
+    igic: "fiscal",
+    impuesto_sociedades: "fiscal",
+    einvoice: "fiscal",
+    audit_gl: "fiscal",
+    accountingClose: "fiscal",
+    onboard_vies: "fiscal",
+    banking: "banking",
+    bank_rules: "banking",
+    clients: "crm",
+    crm: "crm",
+    hr: "hr",
+    payroll: "hr",
+    time: "hr",
+    team: "hr",
+    onboarding: "hr",
+    permissions: "hr",
+    stay: "stay",
+    pos: "pos",
+    intelligence: "intelligence",
+    gestoria: "intelligence",
+    products: "catalog",
+    webhooks: "platform",
+    portal_domain: "platform",
+};
+/**
+ * Per-tool overrides where the source FILE places a tool in a different group
+ * than a naive name match would (verified against the 151 registration sites).
+ * These eight names live in a file whose domain differs from their name prefix
+ * (e.g. e-invoicing tools say "invoice" but belong to fiscal/compliance).
+ */
+const NAME_OVERRIDES = {
+    send_einvoice: "fiscal",
+    get_einvoice_status: "fiscal",
+    validate_einvoice_xml: "fiscal",
+    einvoice_export: "fiscal",
+    export_datev: "fiscal",
+    match_transaction_to_invoice: "banking",
+    get_quarterly_taxes: "intelligence",
+    duplicate_invoice: "intelligence",
+    frihet_portal_onboard_link_generate: "fiscal",
+    // Lives in invoices.ts (an invoice action that returns its e-invoice XML),
+    // so it stays in the "invoicing" group with its sibling invoice tools.
+    get_invoice_einvoice: "invoicing",
+};
+/**
+ * Assign a group by tool NAME. The name-based mapping reproduces the
+ * source-file grouping exactly for all 151 current tools (verified), with the
+ * eight cross-file cases pinned via NAME_OVERRIDES. Driven off the name (not a
+ * hand-kept list) so a future tool lands somewhere sensible automatically.
+ *
+ * Order matters: e-invoicing ("einvoice") is checked before generic "invoice".
+ */
+export function groupForTool(name) {
+    if (NAME_OVERRIDES[name])
+        return NAME_OVERRIDES[name];
+    const n = name.toLowerCase();
+    // Fiscal/compliance FIRST so "einvoice"/"modelo" never fall into invoicing.
+    if (/(modelo|verifactu|ticketbai|einvoice|datev|face_|ksef|igic|aiem|gl_entry|period_close|period_reopen|vies|portal_onboard)/.test(n))
+        return "fiscal";
+    if (/(invoice|quote|credit_note|late_fee|recurring|deposit)/.test(n))
+        return "invoicing";
+    if (/(expense|vendor)/.test(n))
+        return "expenses";
+    if (/(bank|transaction)/.test(n))
+        return "banking";
+    if (/(client|contact|activit|note)/.test(n))
+        return "crm";
+    if (/(leave|attendance|overtime|anomaly|payroll|time_entr|time_summary|team|onboarding|permission)/.test(n))
+        return "hr";
+    if (/(reservation|propert|channel)/.test(n))
+        return "stay";
+    if (/(terminal|sale)/.test(n))
+        return "pos";
+    if (/(business_context|monthly_summary|gestoria)/.test(n))
+        return "intelligence";
+    if (/(product)/.test(n))
+        return "catalog";
+    if (/(webhook|portal_domain)/.test(n))
+        return "platform";
+    return "platform";
+}
+/** Collapse a long bilingual description to its first English sentence. */
+function firstSentence(desc) {
+    if (!desc)
+        return "";
+    // English half comes before the " / " language separator the repo uses.
+    const englishHalf = desc.split(" / ")[0];
+    // First sentence: up to the first ". " that ends a clause.
+    const match = englishHalf.match(/^(.*?[.!?])(\s|$)/);
+    const sentence = (match ? match[1] : englishHalf).trim();
+    // Hard cap so a runaway description can't reintroduce context bloat.
+    return sentence.length > 160 ? sentence.slice(0, 157).trimEnd() + "…" : sentence;
+}
+/**
+ * Read process.env without referencing the `process` global type — keeps this
+ * module compilable in environments without @types/node (e.g. the Cloudflare
+ * Worker build, which passes its own env bag explicitly instead).
+ */
+function defaultEnv() {
+    const g = globalThis;
+    return g.process?.env ?? {};
+}
+/**
+ * Resolve the active tool mode from an env-like bag.
+ * Default is "full" — current behavior, untouched.
+ */
+export function resolveToolMode(env = defaultEnv()) {
+    return env.FRIHET_TOOL_MODE === "grouped" ? "grouped" : "full";
+}
+/**
+ * Apply the grouped tool-exposure profile to an MCP server.
+ *
+ * Must be called BEFORE registerAllTools(). Intercepts registerTool to record
+ * a catalog + collapse descriptions, then (after tools are registered) adds the
+ * meta-tools. Because registration is synchronous and ordered, the caller wires
+ * it as:
+ *
+ * ```ts
+ * if (resolveToolMode() === "grouped") applyToolExposureProfile(server);
+ * registerAllTools(server, client);   // tools recorded + collapsed here
+ * // applyToolExposureProfile already queued the meta-tools to register last
+ * ```
+ *
+ * The meta-tools are registered immediately (eagerly) so they appear in
+ * tools/list; they read from the catalog object, which is populated lazily as
+ * the real tools register. This is safe: tool HANDLERS run long after all
+ * registration completes.
+ *
+ * @param server  The McpServer (typed loosely to match the openai-profile shim).
+ * @returns a handle exposing the live catalog (useful for tests/logging).
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function applyToolExposureProfile(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+server) {
+    const catalog = new Map();
+    const groups = new Map();
+    const handle = { catalog, groups };
+    const originalRegisterTool = server.registerTool.bind(server);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    server.registerTool = (name, config, handler) => {
+        // Never re-process our own meta-tools (they are registered via the original
+        // bound fn below, so they won't hit this interceptor — but guard anyway).
+        if (META_TOOL_NAMES.has(name)) {
+            return originalRegisterTool(name, config, handler);
+        }
+        const group = groupForTool(name);
+        const fullDescription = typeof config?.description === "string" ? config.description : "";
+        const inputFields = config?.inputSchema
+            ? Object.keys(config.inputSchema)
+            : [];
+        const readOnly = config?.annotations?.readOnlyHint === true;
+        const entry = {
+            name,
+            group,
+            title: typeof config?.title === "string" ? config.title : name,
+            summary: firstSentence(fullDescription),
+            description: fullDescription,
+            readOnly,
+            inputFields,
+        };
+        catalog.set(name, entry);
+        const list = groups.get(group);
+        if (list)
+            list.push(name);
+        else
+            groups.set(group, [name]);
+        // Collapse the registered description to a single terse pointer line. The
+        // tool stays fully invocable with its original handler, schema, and
+        // annotations — only the description string the agent loads is trimmed.
+        config.description =
+            `[${group}] ${entry.summary} ` +
+                `— full schema via describe_tool('${name}').`;
+        return originalRegisterTool(name, config, handler);
+    };
+    // Register the meta-tools eagerly. Their handlers close over `catalog`/`groups`
+    // which finish populating as the real tools register right after this call.
+    registerMetaTools(originalRegisterTool, handle);
+    return handle;
+}
+/* ------------------------------------------------------------------ */
+/*  Meta-tools                                                         */
+/* ------------------------------------------------------------------ */
+const META_TOOL_NAMES = new Set([
+    "list_tool_groups",
+    "search_tools",
+    "describe_tool",
+]);
+/** Closed-world read annotation for the meta-tools. */
+const META_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+function textResult(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
+    };
+}
+/**
+ * Register the three progressive-disclosure meta-tools against the ORIGINAL
+ * (un-intercepted) registerTool so they don't get collapsed/catalogued.
+ */
+function registerMetaTools(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+originalRegisterTool, handle) {
+    const { catalog, groups } = handle;
+    // -- list_tool_groups --
+    originalRegisterTool("list_tool_groups", {
+        title: "List tool groups",
+        description: "List the Frihet ERP tool domains (invoicing, expenses, fiscal/compliance, banking, CRM, " +
+            "HR/payroll, stay/PMS, POS, intelligence, products, platform) with a one-line blurb and tool " +
+            "count for each. Start here, then use search_tools(query) to find tools and describe_tool(name) " +
+            "for a tool's full schema. Frihet serves deep ES/EU fiscal + native compliance on demand. " +
+            "[openWorldHint: false — reads the in-process tool catalog only.] " +
+            "/ Lista los dominios de herramientas de Frihet ERP con descripción y recuento. Empieza aquí.",
+        annotations: META_ANNOTATIONS,
+        inputSchema: {},
+    }, async () => {
+        const out = Object.keys(GROUPS)
+            .map((id) => ({
+            group: id,
+            label: GROUPS[id].label,
+            blurb: GROUPS[id].blurb,
+            toolCount: groups.get(id)?.length ?? 0,
+        }))
+            .filter((g) => g.toolCount > 0);
+        return textResult({
+            groups: out,
+            totalGroups: out.length,
+            totalTools: catalog.size,
+            next: "search_tools(query) to find tools; describe_tool(name) for full schema.",
+        });
+    });
+    // -- search_tools --
+    originalRegisterTool("search_tools", {
+        title: "Search tools",
+        description: "Find Frihet ERP tools by free-text query (matches tool name, title, summary and group). " +
+            "Returns matching tools with their group, one-line summary, read-only flag and input field names — " +
+            "progressive disclosure so you load only what you need. Optionally filter by group. " +
+            "Then call describe_tool(name) for a tool's full description and call it by its real name. " +
+            "[openWorldHint: false — reads the in-process tool catalog only.] " +
+            "/ Busca herramientas por texto libre. Devuelve coincidencias con grupo, resumen y campos.",
+        annotations: META_ANNOTATIONS,
+        inputSchema: {
+        // Plain JSON-schema-ish shape; the SDK accepts a raw shape object here.
+        // Kept dependency-free (no zod import) so this layer stays minimal.
+        },
+    }, 
+    // The SDK passes parsed args; we read defensively to stay schema-light.
+    async (args = {}) => {
+        const query = typeof args.query === "string" ? args.query.trim().toLowerCase() : "";
+        const groupFilter = typeof args.group === "string" ? args.group : undefined;
+        const limit = typeof args.limit === "number" && args.limit > 0 ? Math.floor(args.limit) : 25;
+        const terms = query.split(/\s+/).filter(Boolean);
+        const scored = [...catalog.values()]
+            .filter((e) => !groupFilter || e.group === groupFilter)
+            .map((e) => {
+            const haystack = `${e.name} ${e.title} ${e.summary} ${e.group}`.toLowerCase();
+            // Score = number of query terms present; name/title hits weighted up.
+            let score = 0;
+            for (const t of terms) {
+                if (!haystack.includes(t))
+                    continue;
+                score += 1;
+                if (e.name.toLowerCase().includes(t))
+                    score += 2;
+                if (e.title.toLowerCase().includes(t))
+                    score += 1;
+            }
+            return { e, score };
+        })
+            // With no terms, return everything (lets agents browse a group).
+            .filter(({ score }) => terms.length === 0 || score > 0)
+            .sort((a, b) => b.score - a.score || a.e.name.localeCompare(b.e.name))
+            .slice(0, limit)
+            .map(({ e, score }) => ({
+            name: e.name,
+            group: e.group,
+            title: e.title,
+            summary: e.summary,
+            readOnly: e.readOnly,
+            inputFields: e.inputFields,
+            score,
+        }));
+        return textResult({
+            query: query || null,
+            group: groupFilter ?? null,
+            count: scored.length,
+            tools: scored,
+            next: "describe_tool(name) for full schema, then call the tool by its real name.",
+        });
+    });
+    // -- describe_tool --
+    originalRegisterTool("describe_tool", {
+        title: "Describe tool",
+        description: "Return the full original description, group, read-only flag and input field names for a specific " +
+            "Frihet ERP tool by its exact name (as returned by search_tools). Use this to load a tool's full " +
+            "depth on demand before calling it. " +
+            "[openWorldHint: false — reads the in-process tool catalog only.] " +
+            "/ Devuelve la descripción completa de una herramienta por su nombre exacto.",
+        annotations: META_ANNOTATIONS,
+        inputSchema: {},
+    }, async (args = {}) => {
+        const name = typeof args.name === "string" ? args.name.trim() : "";
+        const entry = catalog.get(name);
+        if (!entry) {
+            // Suggest near matches to keep the agent unstuck.
+            const suggestions = [...catalog.keys()]
+                .filter((k) => name && k.includes(name.toLowerCase()))
+                .slice(0, 5);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: name
+                                ? `No tool named '${name}'.`
+                                : "Provide { name } — the exact tool name from search_tools.",
+                            suggestions,
+                            next: "Call search_tools(query) to find the right name.",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return textResult({
+            name: entry.name,
+            group: entry.group,
+            title: entry.title,
+            readOnly: entry.readOnly,
+            inputFields: entry.inputFields,
+            description: entry.description,
+        });
+    });
+}
+/** Number of meta-tools added in grouped mode (for logging). */
+export const GROUPED_META_TOOL_COUNT = META_TOOL_NAMES.size;
+/** Exposed for logging/tests. */
+export const TOOL_GROUP_IDS = Object.keys(GROUPS);
+//# sourceMappingURL=tool-exposure.js.map

package/dist/tool-exposure.js.map

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

package/dist/tools/register-all.d.ts

@@ -1,12 +1,12 @@
 /**
- * Barrel module that registers all 152 Frihet ERP tools on an McpServer.
+ * Barrel module that registers all 151 Frihet ERP tools on an McpServer.
  *
  * Used by both the local (stdio) and remote (Cloudflare Workers) servers
  * so tool definitions stay in sync — one source of truth.
  *
  * Langfuse observability is injected by patching server.registerTool once
  * before any tool registration. This wraps every tool callback with
- * traceMCPTool so all 152 tools are instrumented at zero per-tool cost.
+ * traceMCPTool so all 151 tools are instrumented at zero per-tool cost.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { IFrihetClient } from "../client-interface.js";

package/dist/tools/register-all.js

@@ -1,12 +1,12 @@
 /**
- * Barrel module that registers all 152 Frihet ERP tools on an McpServer.
+ * Barrel module that registers all 151 Frihet ERP tools on an McpServer.
  *
  * Used by both the local (stdio) and remote (Cloudflare Workers) servers
  * so tool definitions stay in sync — one source of truth.
  *
  * Langfuse observability is injected by patching server.registerTool once
  * before any tool registration. This wraps every tool callback with
- * traceMCPTool so all 152 tools are instrumented at zero per-tool cost.
+ * traceMCPTool so all 151 tools are instrumented at zero per-tool cost.
  */
 import { traceMCPTool } from "../observability.js";
 import { registerInvoiceTools } from "./invoices.js";
@@ -42,7 +42,7 @@ import { registerAccountingCloseTools } from "./accountingClose.js";
 /**
  * Patches server.registerTool to wrap every tool callback with Langfuse tracing.
  *
- * The patch is applied once before tool registration so all 152 tools are
+ * The patch is applied once before tool registration so all 151 tools are
  * instrumented without per-tool edits. Tool call signatures are unchanged —
  * existing MCP clients continue to work identically.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frihet/mcp-server",
-  "version": "1.12.0-beta.1",
+  "version": "1.13.0",
   "description": "AI-native MCP server for business management — invoices, expenses, deposits, clients, products, quotes, webhooks, CRM, e-invoicing (Facturae/XRechnung/Factur-X/FatturaPA/PEPPOL + FACe Spain B2G + TicketBAI Basque Country + KSeF Poland), vacation rentals, POS, banking, fiscal (Modelo 303/130/390/180/347/415/425/418, VeriFactu, TicketBAI, IS M200/M202), IGIC, AIEM, GL audit approval, white-label portal domain, VIES EU VAT lookup, bank rules, time tracking, recurring invoices, team management, gestoria. 151 tools. Remote endpoint at mcp.frihet.io (zero install). Works with Claude, Cursor, Windsurf, Cline.",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,7 +9,7 @@
   },
   "scripts": {
     "build": "tsc",
-    "test": "npm run build && node --test dist/__tests__/einvoice-tools.test.js dist/__tests__/einvoice-day4-tools.test.js dist/__tests__/stay-tools.test.js dist/__tests__/pos-tools.test.js dist/__tests__/banking-tools.test.js dist/__tests__/fiscal-tools.test.js dist/__tests__/time-tools.test.js dist/__tests__/recurring-tools.test.js dist/__tests__/team-tools.test.js dist/__tests__/d4b-hr-payroll-onboarding-tools.test.js",
+    "test": "npm run build && node --test dist/__tests__/openai-profile.test.js dist/__tests__/tool-exposure.test.js dist/__tests__/einvoice-tools.test.js dist/__tests__/einvoice-day4-tools.test.js dist/__tests__/stay-tools.test.js dist/__tests__/pos-tools.test.js dist/__tests__/banking-tools.test.js dist/__tests__/fiscal-tools.test.js dist/__tests__/time-tools.test.js dist/__tests__/recurring-tools.test.js dist/__tests__/team-tools.test.js dist/__tests__/d4b-hr-payroll-onboarding-tools.test.js",
     "start": "node dist/index.js",
     "postinstall": "node scripts/postinstall.js || true",
     "prepublishOnly": "npm run build && npm run audit:mcp-refs -- --repo frihet-mcp",