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

package/README.md

@@ -32,13 +32,15 @@
 | **Remote endpoint** | Live | `https://mcp.frihet.io/mcp` (zero install, OAuth or API key) |
 | **Smithery** | Live | [smithery.ai/server/frihet/frihet-mcp](https://smithery.ai/server/frihet/frihet-mcp) |
 | **MCP Registry** | Live | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/?q=io.frihet) |
-| **Glama** | Pending submission | [glama.ai/mcp/servers](https://glama.ai/mcp/servers) — `glama.json` ready |
-| **mcp.so** | Pending submission | [mcp.so](https://mcp.so) — indexed from npm + GitHub |
-| **PulseMCP** | Pending submission | [pulsemcp.com](https://pulsemcp.com) — indexed from npm + GitHub |
+| **Glama** | Live | [glama.ai/mcp/servers/@Frihet-io/frihet-mcp](https://glama.ai/mcp/servers/@Frihet-io/frihet-mcp) |
+| **mcp.so** | Auto-index (unverified) | [mcp.so](https://mcp.so) — indexes from npm + GitHub |
+| **PulseMCP** | Auto-index (unverified) | [pulsemcp.com](https://pulsemcp.com) — indexes from npm + GitHub |
 | **Cursor Marketplace** | Coming soon | [cursor.com/marketplace](https://cursor.com/marketplace) |
 | **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.13.0) ships all 151 tools, same as the remote endpoint (`mcp.frihet.io`).
+
 ---
 
 ## What is this
@@ -50,9 +52,9 @@ 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 = 152 raw → deduped ticketbai_status → 151 tools -->
+<!-- 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 -->
 
 ---
 
@@ -547,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.
 
@@ -560,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):
 
@@ -568,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.
 
@@ -583,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?` |
 
 ---
@@ -621,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`).
 
 ---
 
@@ -722,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__/openai-profile.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for the OpenAI-safe MCP profile.
+ *
+ * The public ChatGPT app intentionally exposes a narrower tool surface than
+ * the full MCP server. This prevents regulated or sensitive workflows added
+ * to the general MCP server from becoming part of the OpenAI submission by
+ * accident.
+ */
+export {};
+//# sourceMappingURL=openai-profile.test.d.ts.map

package/dist/__tests__/openai-profile.test.d.ts.map

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

package/dist/__tests__/openai-profile.test.js

@@ -0,0 +1,132 @@
+/**
+ * Tests for the OpenAI-safe MCP profile.
+ *
+ * The public ChatGPT app intentionally exposes a narrower tool surface than
+ * the full MCP server. This prevents regulated or sensitive workflows added
+ * to the general MCP server from becoming part of the OpenAI submission by
+ * accident.
+ */
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+import { applyOpenAIProfile } from "../openai-profile.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: (_target, prop) => async (input) => {
+            if (prop === "createClient") {
+                return {
+                    id: "cli_openai",
+                    name: "OpenAI Test Corp",
+                    email: "test@example.com",
+                    taxId: "B12345678",
+                    secret: "should-not-leak",
+                };
+            }
+            return {
+                data: [],
+                total: 0,
+                limit: 10,
+                offset: 0,
+                input,
+            };
+        },
+    });
+}
+function makeOpenAIServer() {
+    const server = new StubMcpServer();
+    applyOpenAIProfile(server);
+    registerAllTools(server, makeClient());
+    registerAllPrompts(server);
+    return server;
+}
+describe("OpenAI profile", () => {
+    test("exposes exactly the reviewed 53-tool surface", () => {
+        const server = makeOpenAIServer();
+        assert.equal(server.tools.size, 53);
+        assert.equal(server.prompts.length, 0);
+        for (const hiddenTool of [
+            "get_quarterly_taxes",
+            "get_invoice_einvoice",
+            "send_einvoice",
+            "validate_einvoice_xml",
+            "frihet_tax_id_vies_lookup",
+            "create_reservation",
+            "payroll_export",
+            "invite_team_member",
+        ]) {
+            assert.equal(server.tools.has(hiddenTool), false, `${hiddenTool} must not be exposed in OpenAI mode`);
+        }
+    });
+    test("keeps only reviewed open-world tools marked openWorldHint=true", () => {
+        const server = makeOpenAIServer();
+        const openWorldTools = [...server.tools.values()]
+            .filter((tool) => tool.config.annotations?.["openWorldHint"] === true)
+            .map((tool) => tool.name)
+            .sort();
+        assert.deepEqual(openWorldTools, [
+            "create_webhook",
+            "send_invoice",
+            "send_quote",
+            "update_webhook",
+        ]);
+    });
+    test("removes restricted input fields from OpenAI-visible schemas", () => {
+        const server = makeOpenAIServer();
+        for (const name of ["create_client", "update_client", "create_vendor", "update_vendor"]) {
+            const tool = server.tools.get(name);
+            assert.ok(tool, `${name} should be visible`);
+            assert.equal("taxId" in (tool.config.inputSchema ?? {}), false);
+        }
+        for (const name of ["send_invoice", "send_quote"]) {
+            const tool = server.tools.get(name);
+            assert.ok(tool, `${name} should be visible`);
+            assert.equal("to" in (tool.config.inputSchema ?? {}), false);
+        }
+        for (const name of ["create_webhook", "update_webhook"]) {
+            const tool = server.tools.get(name);
+            assert.ok(tool, `${name} should be visible`);
+            assert.equal("secret" in (tool.config.inputSchema ?? {}), false);
+        }
+    });
+    test("every reviewed tool states an explicit openWorldHint rationale", () => {
+        const server = makeOpenAIServer();
+        for (const tool of server.tools.values()) {
+            // OpenAI review: openWorldHint must be explicit (not null) AND justified per tool.
+            assert.equal(typeof tool.config.annotations?.["openWorldHint"], "boolean", `${tool.name} must have an explicit boolean openWorldHint`);
+            assert.ok(tool.config.description.includes("openWorldHint"), `${tool.name} description must state an openWorldHint rationale`);
+        }
+        // Closed-world read tool carries the closed-world rationale.
+        assert.match(server.tools.get("list_invoices").config.description, /openWorldHint: false/);
+        // Open-world tool keeps its bespoke true rationale (not double-appended).
+        const sendInvoiceDesc = server.tools.get("send_invoice").config.description;
+        assert.match(sendInvoiceDesc, /openWorldHint: true/);
+        assert.doesNotMatch(sendInvoiceDesc, /openWorldHint: false/);
+    });
+    test("redacts restricted output fields from structured content and text", async () => {
+        const server = makeOpenAIServer();
+        const tool = server.tools.get("create_client");
+        assert.ok(tool, "create_client should be visible");
+        const result = await tool.handler({ name: "OpenAI Test Corp" });
+        const serialized = JSON.stringify(result);
+        assert.equal(serialized.includes("taxId"), false);
+        assert.equal(serialized.includes("B12345678"), false);
+        assert.equal(serialized.includes("secret"), false);
+        assert.equal(serialized.includes("should-not-leak"), false);
+    });
+});
+//# sourceMappingURL=openai-profile.test.js.map

package/dist/__tests__/openai-profile.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-profile.test.js","sourceRoot":"","sources":["../../src/__tests__/openai-profile.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAuBhE,MAAM,aAAa;IACjB,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAC/C,OAAO,GAAa,EAAE,CAAC;IACvB,SAAS,GAAa,EAAE,CAAC;IAEzB,YAAY,CAAC,IAAY,EAAE,MAAkB,EAAE,OAAoB;QACjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,gBAAgB,CAAC,IAAY;QAC3B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;QACnB,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,KAAe,EAAE,EAAE;YAChD,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC5B,OAAO;oBACL,EAAE,EAAE,YAAY;oBAChB,IAAI,EAAE,kBAAkB;oBACxB,KAAK,EAAE,kBAAkB;oBACzB,KAAK,EAAE,WAAW;oBAClB,MAAM,EAAE,iBAAiB;iBAC1B,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,EAAE;gBACR,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,CAAC;gBACT,KAAK;aACN,CAAC;QACJ,CAAC;KACF,CAAkB,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;IACnC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,gBAAgB,CACd,MAAgF,EAChF,UAAU,EAAE,CACb,CAAC;IACF,kBAAkB,CAAC,MAAgF,CAAC,CAAC;IACrG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAElC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEvC,KAAK,MAAM,UAAU,IAAI;YACvB,qBAAqB;YACrB,sBAAsB;YACtB,eAAe;YACf,uBAAuB;YACvB,2BAA2B;YAC3B,oBAAoB;YACpB,gBAAgB;YAChB,oBAAoB;SACrB,EAAE,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,UAAU,qCAAqC,CAAC,CAAC;QACxG,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAC9C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;aACrE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aACxB,IAAI,EAAE,CAAC;QAEV,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE;YAC/B,gBAAgB;YAChB,cAAc;YACd,YAAY;YACZ,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACvE,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAClE,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,mFAAmF;YACnF,MAAM,CAAC,KAAK,CACV,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,EACjD,SAAS,EACT,GAAG,IAAI,CAAC,IAAI,8CAA8C,CAC3D,CAAC;YACF,MAAM,CAAC,EAAE,CACP,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,eAAe,CAAC,EACjD,GAAG,IAAI,CAAC,IAAI,oDAAoD,CACjE,CAAC;QACJ,CAAC;QAED,6DAA6D;QAC7D,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAE,CAAC,MAAM,CAAC,WAAW,EACrD,sBAAsB,CACvB,CAAC;QACF,0EAA0E;QAC1E,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAE,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;QACrD,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE1C,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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/client.d.ts

@@ -9,10 +9,18 @@ export declare class FrihetApiError extends Error {
     readonly errorCode: string;
     constructor(statusCode: number, errorCode: string, message?: string);
 }
+export interface FrihetClientOptions {
+    /**
+     * Per-request timeout in milliseconds. Defaults to 30000.
+     * Cloudflare Workers should pass ≤25000 to leave margin under the ~30s limit.
+     */
+    timeoutMs?: number;
+}
 export declare class FrihetClient {
     private readonly apiKey;
     private readonly baseUrl;
-    constructor(apiKey: string, baseUrl?: string);
+    private readonly timeoutMs;
+    constructor(apiKey: string, baseUrl?: string, options?: FrihetClientOptions);
     private request;
     private sleep;
     /** Wrapper for paginated endpoints — validates response shape has `data` array. */