@frihet/mcp-server 1.12.0 → 1.13.0

package/README.md

@@ -39,7 +39,7 @@
 | **ChatGPT Apps** | Coming soon | [chatgpt.com](https://chatgpt.com) |
 | **Anthropic Claude Directory** | Coming soon | [claude.ai/settings/connectors](https://claude.ai/settings/connectors) |
 
-> **Tool count:** npm `latest` (1.12.0) ships all 151 tools, same as the remote endpoint (`mcp.frihet.io`).
+> **Tool count:** npm `latest` (1.13.0) ships all 151 tools, same as the remote endpoint (`mcp.frihet.io`).
 
 ---
 
@@ -52,7 +52,7 @@ You:     "Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/h
 Claude:  Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,630.00 EUR.
 ```
 
-151 tools. 8 resources. 7 prompts. Structured output on every tool. Zero boilerplate.
+151 tools. 11 resources. 10 prompts. Structured output on every tool. Zero boilerplate.
 
 <!-- v1.12.0-beta.1 — D4-B megasprint: HR (9), payroll (2), onboarding (2), permissions (2), period close (3), webhook test (1) = +19 = 151 tools total -->
 
@@ -549,7 +549,7 @@ All 151 tools return **structured output** via `outputSchema` -- typed JSON, not
 
 ---
 
-## Resources (8)
+## Resources (11)
 
 Context the AI can read to make smarter decisions.
 
@@ -562,6 +562,8 @@ Context the AI can read to make smarter decisions.
 | Tax Calendar | `frihet://tax/calendar` | Quarterly filing deadlines: Modelo 303, 130, 390, 420, VeriFactu timeline |
 | Expense Categories | `frihet://config/expense-categories` | 8 categories with deductibility rules, IVA treatment, amortization |
 | Invoice Statuses | `frihet://config/invoice-statuses` | Status flow (draft > sent > paid/overdue > cancelled), transition rules, webhook events |
+| Currencies | `frihet://config/currencies` | 40 supported currencies with ISO codes, symbols, decimal places, locale formatting |
+| Countries | `frihet://config/countries` | 61 supported countries with fiscal zones, default tax rates, currencies, invoice prefixes |
 
 **Dynamic** (live data from your account):
 
@@ -570,10 +572,11 @@ Context the AI can read to make smarter decisions.
 | Business Profile | `frihet://business-profile` | Your business info, plan, defaults, recent activity, top clients |
 | Monthly Snapshot | `frihet://monthly-snapshot` | Current month P&L, revenue, expenses, tax liability |
 | Overdue Invoices | `frihet://overdue-invoices` | All invoices past due date (up to 100) |
+| Plan Limits | `frihet://status/plan-limits` | Live plan tier, usage counters, invoices/month, API rate limits |
 
 ---
 
-## Prompts (7)
+## Prompts (10)
 
 Pre-built workflows the AI can execute as guided multi-step operations.
 
@@ -585,6 +588,9 @@ Pre-built workflows the AI can execute as guided multi-step operations.
 | `overdue-followup` | Find overdue invoices, draft follow-up messages, suggest payment reminders | -- |
 | `new-client-invoice` | Create a client + first invoice in one workflow with tax rate lookup | `clientName`, `country?` |
 | `expense-report` | Generate expense report grouped by category with deductible totals | `month?` (YYYY-MM) |
+| `year-end-close` | Full annual closing: quarterly review, pending invoices, uncategorized expenses, year-end checklist | `year` (YYYY) |
+| `cash-flow-forecast` | Project cash flow for coming months: recurring income, expenses, overdue receivables, tax deadlines | `months?` (default: 3) |
+| `invoice-aging-review` | AR aging analysis: group unpaid invoices by bucket (0-30/31-60/61-90/90+ days), top debtors, collection actions | -- |
 | `expense-batch` | Process expenses in bulk: categorize, apply tax rates, flag missing receipts | `fiscalZone?` |
 
 ---
@@ -623,6 +629,44 @@ Two transports:
 |----------|----------|---------|
 | `FRIHET_API_KEY` | Yes (stdio) | -- |
 | `FRIHET_API_URL` | No | `https://api.frihet.io/v1` |
+| `FRIHET_TOOL_MODE` | No | `full` |
+
+---
+
+## Tool exposure: depth served on demand
+
+Frihet's differentiator is **depth** — full ES/EU fiscal coverage plus native compliance (VeriFactu, TicketBAI, Facturae/FACe/KSeF), banking, CRM, HR/payroll, stay/PMS and POS. But a flat list of every tool, loaded into an agent's context up front, is the 2026 context-rot problem: it crowds out the task and degrades tool selection before any work begins.
+
+`FRIHET_TOOL_MODE` lets you choose how that depth is exposed.
+
+| Mode | Behavior |
+|------|----------|
+| `full` (default) | All tools are exposed with their full descriptions and schemas. **Unchanged from previous releases** — existing setups are unaffected. |
+| `grouped` | **Progressive disclosure.** Each tool's description collapses to a one-line `[group] summary — full schema via describe_tool('name')`, and three lightweight discovery tools are added. The agent loads depth only for the tools it actually needs. |
+
+In `grouped` mode the tools are unchanged — same names, same input schemas, same behavior. Only the *up-front context cost* changes. Discovery flows through three meta-tools:
+
+- **`list_tool_groups()`** — the domain map (invoicing, expenses, fiscal/compliance, banking, CRM, HR/payroll, stay/PMS, POS, intelligence, products, platform) with a one-line blurb and tool count for each.
+- **`search_tools(query)`** — free-text search across tool name, title, summary and group; returns matching tools with their group, summary, read-only flag and input fields. Optional `group` filter and `limit`.
+- **`describe_tool(name)`** — the full original description and input fields for one tool, on demand, before you call it.
+
+```jsonc
+// claude_desktop_config.json — opt in to grouped mode
+{
+  "mcpServers": {
+    "frihet": {
+      "command": "npx",
+      "args": ["@frihet/mcp-server"],
+      "env": {
+        "FRIHET_API_KEY": "fri_...",
+        "FRIHET_TOOL_MODE": "grouped"
+      }
+    }
+  }
+}
+```
+
+> This is an opt-in exposure layer only — it never changes a tool's logic, name or behavior, and `full` mode is byte-identical to before. The same interceptor pattern powers the OpenAI-safe profile (`FRIHET_OPENAI_MODE`).
 
 ---
 
@@ -724,7 +768,7 @@ npm run build   # must pass before submitting
 
 | Package | What it is |
 |---------|-----------|
-| [`@frihet/mcp-server`](https://www.npmjs.com/package/@frihet/mcp-server) | This MCP server (151 tools, 8 resources, 7 prompts) |
+| [`@frihet/mcp-server`](https://www.npmjs.com/package/@frihet/mcp-server) | This MCP server (151 tools, 11 resources, 10 prompts) |
 | [`@frihet/sdk`](https://github.com/Frihet-io/frihet-sdk) | TypeScript SDK (`frihet.invoices.create()`) |
 | [`frihet`](https://www.npmjs.com/package/frihet) | CLI (`frihet invoices list --status overdue`) |
 | [`n8n-nodes-frihet`](https://www.npmjs.com/package/n8n-nodes-frihet) | n8n community node for workflow automation |

package/dist/__tests__/tool-exposure.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for the grouped tool-exposure profile (progressive disclosure).
+ *
+ * The default ("full") mode must stay BYTE-IDENTICAL to the un-profiled server
+ * so existing users are unaffected. The opt-in "grouped" mode collapses the 151
+ * full tool descriptions into terse one-liners and adds three discovery
+ * meta-tools (list_tool_groups, search_tools, describe_tool) so agents load
+ * depth on demand instead of a flat 151-tool wall of context.
+ */
+export {};
+//# sourceMappingURL=tool-exposure.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-exposure.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-exposure.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/tool-exposure.test.js

@@ -0,0 +1,249 @@
+/**
+ * Tests for the grouped tool-exposure profile (progressive disclosure).
+ *
+ * The default ("full") mode must stay BYTE-IDENTICAL to the un-profiled server
+ * so existing users are unaffected. The opt-in "grouped" mode collapses the 151
+ * full tool descriptions into terse one-liners and adds three discovery
+ * meta-tools (list_tool_groups, search_tools, describe_tool) so agents load
+ * depth on demand instead of a flat 151-tool wall of context.
+ */
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+import { readdirSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { applyToolExposureProfile, resolveToolMode, groupForTool, GROUPS, FILE_TO_GROUP, GROUPED_META_TOOL_COUNT, } from "../tool-exposure.js";
+import { registerAllTools } from "../tools/register-all.js";
+import { registerAllPrompts } from "../prompts/register-all.js";
+class StubMcpServer {
+    tools = new Map();
+    prompts = [];
+    resources = [];
+    registerTool(name, config, handler) {
+        this.tools.set(name, { name, config, handler });
+    }
+    registerPrompt(name) {
+        this.prompts.push(name);
+    }
+    registerResource(name) {
+        this.resources.push(name);
+    }
+}
+function makeClient() {
+    return new Proxy({}, {
+        get: () => async (input) => ({
+            data: [],
+            total: 0,
+            limit: 10,
+            offset: 0,
+            input,
+        }),
+    });
+}
+const asMcp = (s) => s;
+/** Build a server with NO profile (current/full behavior). */
+function makeFullServer() {
+    const server = new StubMcpServer();
+    registerAllTools(asMcp(server), makeClient());
+    registerAllPrompts(asMcp(server));
+    return server;
+}
+/** Build a server with the grouped tool-exposure profile applied. */
+function makeGroupedServer() {
+    const server = new StubMcpServer();
+    const handle = applyToolExposureProfile(server);
+    registerAllTools(asMcp(server), makeClient());
+    registerAllPrompts(asMcp(server));
+    return { server, handle };
+}
+const META_TOOLS = ["list_tool_groups", "search_tools", "describe_tool"];
+describe("tool-exposure: mode resolution", () => {
+    test("default and 'full' resolve to full; only 'grouped' opts in", () => {
+        assert.equal(resolveToolMode({}), "full");
+        assert.equal(resolveToolMode({ FRIHET_TOOL_MODE: undefined }), "full");
+        assert.equal(resolveToolMode({ FRIHET_TOOL_MODE: "full" }), "full");
+        assert.equal(resolveToolMode({ FRIHET_TOOL_MODE: "anything-else" }), "full");
+        assert.equal(resolveToolMode({ FRIHET_TOOL_MODE: "grouped" }), "grouped");
+    });
+});
+describe("tool-exposure: full mode is byte-identical", () => {
+    test("registers exactly 151 tools, no meta-tools, descriptions untouched", () => {
+        const full = makeFullServer();
+        assert.equal(full.tools.size, 151);
+        for (const meta of META_TOOLS) {
+            assert.equal(full.tools.has(meta), false, `${meta} must NOT exist in full mode`);
+        }
+    });
+    test("grouped mode does not mutate the un-profiled tool descriptions", () => {
+        // Capture the full-mode description of a representative tool, then confirm
+        // the grouped server's collapse did not leak back into the base registration.
+        const full = makeFullServer();
+        const fullDesc = full.tools.get("list_invoices").config.description;
+        // Full description is the rich, multi-sentence original (not a collapsed line).
+        assert.ok(fullDesc.length > 117, "full description should be the rich original");
+        assert.equal(fullDesc.includes("describe_tool"), false);
+    });
+});
+describe("tool-exposure: grouped mode", () => {
+    test("registers 151 tools + 3 meta-tools and a complete catalog", () => {
+        const { server, handle } = makeGroupedServer();
+        assert.equal(server.tools.size, 151 + GROUPED_META_TOOL_COUNT);
+        assert.equal(GROUPED_META_TOOL_COUNT, 3);
+        for (const meta of META_TOOLS) {
+            assert.equal(server.tools.has(meta), true, `${meta} must exist in grouped mode`);
+        }
+        // Catalog holds every real tool (meta-tools excluded).
+        assert.equal(handle.catalog.size, 151);
+        for (const meta of META_TOOLS) {
+            assert.equal(handle.catalog.has(meta), false);
+        }
+    });
+    test("collapses each real tool's description to a terse pointer line", () => {
+        const { server } = makeGroupedServer();
+        const li = server.tools.get("list_invoices");
+        assert.match(li.config.description, /^\[invoicing\] /);
+        assert.match(li.config.description, /describe_tool\('list_invoices'\)/);
+        // Terse: collapsed lines are far shorter than the rich originals.
+        assert.ok(li.config.description.length < 200);
+        // Every collapsed description names its group and the describe_tool pointer.
+        for (const [name, tool] of server.tools) {
+            if (META_TOOLS.includes(name))
+                continue;
+            assert.match(tool.config.description, /^\[[a-z]+\] /, `${name} description must start with [group]`);
+            assert.ok(tool.config.description.includes(`describe_tool('${name}')`), `${name} description must point to describe_tool`);
+        }
+    });
+    test("does NOT change tool names, annotations, or input schemas", () => {
+        const full = makeFullServer();
+        const { server: grouped } = makeGroupedServer();
+        // Same set of real tool names (grouped adds only the 3 meta-tools).
+        const realGrouped = [...grouped.tools.keys()].filter((n) => !META_TOOLS.includes(n));
+        assert.deepEqual([...full.tools.keys()].sort(), realGrouped.sort());
+        // Annotations + input schema identity preserved for a mutating tool.
+        const ci = "create_invoice";
+        assert.deepEqual(grouped.tools.get(ci).config.annotations, full.tools.get(ci).config.annotations);
+        assert.deepEqual(Object.keys(grouped.tools.get(ci).config.inputSchema ?? {}), Object.keys(full.tools.get(ci).config.inputSchema ?? {}));
+    });
+    test("tool logic is unchanged — collapsed tool still invokes its handler", async () => {
+        const { server } = makeGroupedServer();
+        const result = await server.tools.get("list_invoices").handler({});
+        assert.ok(Array.isArray(result.content));
+        // The real handler ran (returns content), proving behavior is untouched.
+        assert.ok(result.content.length >= 1);
+    });
+});
+describe("tool-exposure: group taxonomy", () => {
+    test("groupForTool reproduces the source-file grouping for all 151 tools", () => {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const toolsDir = join(here, "..", "..", "src", "tools");
+        let checked = 0;
+        const mismatches = [];
+        for (const f of readdirSync(toolsDir)) {
+            if (!f.endsWith(".ts"))
+                continue;
+            const base = f.replace(/\.ts$/, "");
+            if (base === "register-all" || base === "shared")
+                continue;
+            const fileGroup = FILE_TO_GROUP[base];
+            assert.ok(fileGroup, `source file ${base}.ts must be mapped in FILE_TO_GROUP`);
+            const txt = readFileSync(join(toolsDir, f), "utf8");
+            for (const m of txt.matchAll(/registerTool\(\s*"([a-z_0-9]+)"/g)) {
+                const name = m[1];
+                checked += 1;
+                const ng = groupForTool(name);
+                if (ng !== fileGroup)
+                    mismatches.push(`${name}: name=${ng} file=${fileGroup}`);
+            }
+        }
+        assert.equal(checked, 151, "should have scanned all 151 registration sites");
+        assert.deepEqual(mismatches, [], "groupForTool must match the source-file group");
+    });
+    test("every group used by a tool has metadata", () => {
+        const { handle } = makeGroupedServer();
+        for (const group of handle.groups.keys()) {
+            assert.ok(GROUPS[group], `group ${group} must have metadata`);
+        }
+    });
+    test("group ids are stable and cover the brief's 9 domains", () => {
+        for (const id of [
+            "invoicing",
+            "expenses",
+            "fiscal",
+            "banking",
+            "crm",
+            "hr",
+            "stay",
+            "pos",
+            "intelligence",
+        ]) {
+            assert.ok(GROUPS[id], `${id} must be a defined group`);
+        }
+    });
+});
+describe("tool-exposure: meta-tools", () => {
+    test("list_tool_groups returns non-empty groups with counts summing to 151", async () => {
+        const { server } = makeGroupedServer();
+        const res = await server.tools.get("list_tool_groups").handler({});
+        const payload = JSON.parse(res.content[0].text);
+        assert.equal(payload.totalTools, 151);
+        const sum = payload.groups.reduce((acc, g) => acc + g.toolCount, 0);
+        assert.equal(sum, 151);
+        // No empty groups are listed.
+        assert.ok(payload.groups.every((g) => g.toolCount > 0));
+        // Fiscal is a headline group (compliance depth).
+        assert.ok(payload.groups.some((g) => g.group === "fiscal" && g.toolCount > 0));
+    });
+    test("search_tools finds fiscal tools by free-text and ranks the exact name top", async () => {
+        const { server } = makeGroupedServer();
+        const res = await server.tools.get("search_tools").handler({
+            query: "modelo 303",
+        });
+        const payload = JSON.parse(res.content[0].text);
+        assert.ok(payload.count > 0);
+        assert.equal(payload.tools[0].name, "get_modelo_303_summary");
+        assert.equal(payload.tools[0].group, "fiscal");
+    });
+    test("search_tools honors the group filter", async () => {
+        const { server } = makeGroupedServer();
+        const res = await server.tools.get("search_tools").handler({
+            query: "",
+            group: "banking",
+            limit: 50,
+        });
+        const payload = JSON.parse(res.content[0].text);
+        assert.ok(payload.tools.length > 0);
+        assert.ok(payload.tools.every((t) => t.group === "banking"));
+    });
+    test("describe_tool returns the full original description on demand", async () => {
+        const full = makeFullServer();
+        const fullDesc = full.tools.get("get_modelo_303_summary").config.description;
+        const { server } = makeGroupedServer();
+        const res = await server.tools.get("describe_tool").handler({
+            name: "get_modelo_303_summary",
+        });
+        const payload = JSON.parse(res.content[0].text);
+        assert.equal(payload.name, "get_modelo_303_summary");
+        assert.equal(payload.group, "fiscal");
+        // describe_tool serves the FULL original description (depth on demand).
+        assert.equal(payload.description, fullDesc);
+    });
+    test("describe_tool errors with suggestions for an unknown name", async () => {
+        const { server } = makeGroupedServer();
+        const res = await server.tools.get("describe_tool").handler({ name: "modelo" });
+        assert.equal(res.isError, true);
+        const payload = JSON.parse(res.content[0].text);
+        assert.ok(payload.error.length > 0);
+        // 'modelo' is a substring of several real tool names → suggestions offered.
+        assert.ok(payload.suggestions.length > 0);
+        assert.ok(payload.suggestions.every((s) => s.includes("modelo")));
+    });
+    test("meta-tools are read-only and closed-world", () => {
+        const { server } = makeGroupedServer();
+        for (const meta of META_TOOLS) {
+            const ann = server.tools.get(meta).config.annotations;
+            assert.equal(ann?.readOnlyHint, true, `${meta} must be read-only`);
+            assert.equal(ann?.openWorldHint, false, `${meta} must be closed-world`);
+        }
+    });
+});
+//# sourceMappingURL=tool-exposure.test.js.map

package/dist/__tests__/tool-exposure.test.js.map

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

package/dist/index.js

@@ -15,6 +15,7 @@ import { registerAllTools } from "./tools/register-all.js";
 import { registerAllResources } from "./resources/register-all.js";
 import { registerAllPrompts } from "./prompts/register-all.js";
 import { applyOpenAIProfile, OPENAI_ALLOWED_TOOL_COUNT, OPENAI_EXCLUDED_COUNT, OPENAI_EXCLUDED_RESOURCE_COUNT } from "./openai-profile.js";
+import { resolveToolMode, applyToolExposureProfile, GROUPED_META_TOOL_COUNT } from "./tool-exposure.js";
 import { log } from "./logger.js";
 import { registerShutdownHook } from "./metrics.js";
 import { setTraceContext } from "./observability.js";
@@ -59,7 +60,7 @@ function main() {
     });
     const server = new McpServer({
         name: "frihet-erp",
-        version: "1.12.0",
+        version: "1.13.0",
         description: "AI-native MCP server for Frihet ERP — invoices, expenses, clients, products, quotes, webhooks, and deposits. " +
             "Provides 151 tools (including business context, monthly summaries, quarterly taxes, invoice duplication, CRM subcollections, and deposit management), " +
             "11 resources (8 static + 3 live), and 10 workflow prompts for business management " +
@@ -75,6 +76,22 @@ function main() {
             operation: "startup",
         });
     }
+    // Apply grouped tool-exposure profile if enabled (progressive disclosure).
+    // FRIHET_TOOL_MODE=grouped collapses the 151 full tool descriptions into terse
+    // one-liners + adds list_tool_groups / search_tools / describe_tool meta-tools,
+    // so agents load depth on demand instead of a flat 151-tool wall of context.
+    // Default (unset / "full") is byte-identical to current behavior. Independent
+    // of OpenAI mode; if both are set, OpenAI's allowlist runs first, then this
+    // collapses whatever survived.
+    const toolMode = resolveToolMode();
+    if (toolMode === "grouped") {
+        applyToolExposureProfile(server);
+        log({
+            level: "info",
+            message: `Grouped tool-exposure active — 151 tools collapsed to terse summaries, ${GROUPED_META_TOOL_COUNT} discovery meta-tools added (list_tool_groups, search_tools, describe_tool); full depth served on demand`,
+            operation: "startup",
+        });
+    }
     // Register tools (62 full / 60 in OpenAI mode)
     registerAllTools(server, client);
     // Register 11 resources (8 static + 3 dynamic via API)
@@ -86,12 +103,12 @@ function main() {
     // Connect via stdio transport
     const transport = new StdioServerTransport();
     server.connect(transport).then(() => {
-        console.error("[frihet-mcp] v1.12.0 | 151 tools | https://github.com/Frihet-io/frihet-mcp");
+        console.error("[frihet-mcp] v1.13.0 | 151 tools | https://github.com/Frihet-io/frihet-mcp");
         log({
             level: "info",
             message: "Frihet MCP server running on stdio",
             operation: "startup",
-            metadata: { version: "1.12.0", transport: "stdio" },
+            metadata: { version: "1.13.0", transport: "stdio" },
         });
     }).catch((error) => {
         log({

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAC3I,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,SAAS,IAAI;IACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,6DAA6D;YAC3D,qBAAqB;YACrB,uDAAuD;YACvD,+CAA+C;YAC/C,4DAA4D;YAC5D,oEAAoE,CACvE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CACX,8CAA8C,OAAO,KAAK;gBACxD,8DAA8D,CACjE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CACX,iDAAiD,MAAM,CAAC,QAAQ,OAAO,CACxE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CACX,gEAAgE,MAAM,CAAC,QAAQ,OAAO;gBACpF,mDAAmD,CACtD,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjD,oFAAoF;IACpF,+EAA+E;IAC/E,eAAe,CAAC;QACd,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;KAC3C,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,QAAQ;QACjB,WAAW,EACT,+GAA+G;YAC/G,wJAAwJ;YACxJ,oFAAoF;YACpF,qDAAqD;KACxD,CAAC,CAAC;IAEH,oFAAoF;IACpF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;IAC7D,IAAI,UAAU,EAAE,CAAC;QACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,GAAG,CAAC;YACF,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,kCAAkC,yBAAyB,mCAAmC,qBAAqB,iCAAiC,8BAA8B,qDAAqD;YAChP,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,uDAAuD;IACvD,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,+BAA+B;IAC/B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,sDAAsD;IACtD,oBAAoB,EAAE,CAAC;IAEvB,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QAClC,OAAO,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAC5F,GAAG,CAAC;YACF,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,oCAAoC;YAC7C,SAAS,EAAE,SAAS;YACpB,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE;SACpD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1B,GAAG,CAAC;YACF,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,mCAAmC;YAC5C,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC3E,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAC3I,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,SAAS,IAAI;IACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,6DAA6D;YAC3D,qBAAqB;YACrB,uDAAuD;YACvD,+CAA+C;YAC/C,4DAA4D;YAC5D,oEAAoE,CACvE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CACX,8CAA8C,OAAO,KAAK;gBACxD,8DAA8D,CACjE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CACX,iDAAiD,MAAM,CAAC,QAAQ,OAAO,CACxE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CACX,gEAAgE,MAAM,CAAC,QAAQ,OAAO;gBACpF,mDAAmD,CACtD,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjD,oFAAoF;IACpF,+EAA+E;IAC/E,eAAe,CAAC;QACd,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;KAC3C,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,QAAQ;QACjB,WAAW,EACT,+GAA+G;YAC/G,wJAAwJ;YACxJ,oFAAoF;YACpF,qDAAqD;KACxD,CAAC,CAAC;IAEH,oFAAoF;IACpF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;IAC7D,IAAI,UAAU,EAAE,CAAC;QACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,GAAG,CAAC;YACF,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,kCAAkC,yBAAyB,mCAAmC,qBAAqB,iCAAiC,8BAA8B,qDAAqD;YAChP,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,+EAA+E;IAC/E,gFAAgF;IAChF,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACjC,GAAG,CAAC;YACF,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,0EAA0E,uBAAuB,0GAA0G;YACpN,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,uDAAuD;IACvD,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,+BAA+B;IAC/B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,sDAAsD;IACtD,oBAAoB,EAAE,CAAC;IAEvB,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QAClC,OAAO,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAC5F,GAAG,CAAC;YACF,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,oCAAoC;YAC7C,SAAS,EAAE,SAAS;YACpB,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE;SACpD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1B,GAAG,CAAC;YACF,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,mCAAmC;YAC5C,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC3E,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

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",
+  "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",