@icure/cardinal-mcp-server 1.0.0

package/dist/resources/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../src/resources/overview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAgFjD"}

package/dist/resources/overview.js

@@ -0,0 +1,76 @@
+import { getManifest } from "../helpers/docs-loader.js";
+export function registerOverview(server) {
+    server.resource("overview", "cardinal://docs/overview", {
+        title: "Cardinal SDK Overview",
+        description: "SDK architecture, available APIs, and initialization guide",
+        mimeType: "text/markdown",
+    }, async (uri) => {
+        const manifest = getManifest();
+        const apiNames = Object.keys(manifest.apis).sort();
+        const encryptable = apiNames.filter(n => manifest.apis[n].isEncryptable);
+        const nonEncryptable = apiNames.filter(n => !manifest.apis[n].isEncryptable);
+        const content = `# Cardinal SDK Overview
+
+## What is Cardinal SDK?
+Cardinal SDK is a healthcare platform SDK with built-in end-to-end encryption.
+It provides APIs for managing healthcare data including patients, appointments, documents, and more.
+
+## Initialization
+\`\`\`typescript
+import { CardinalSdk } from "@icure/cardinal-sdk/sdk/CardinalSdk.mjs";
+import { AuthenticationMethod } from "@icure/cardinal-sdk/options/AuthenticationMethod.mjs";
+import { StorageFacade } from "@icure/cardinal-sdk/storage/StorageFacade.mjs";
+
+const sdk = await CardinalSdk.initialize(
+  undefined,  // projectId
+  "https://api.icure.cloud",
+  new AuthenticationMethod.UsingCredentials.UsernamePassword(username, password),
+  StorageFacade.usingFileSystem("./storage")
+);
+\`\`\`
+
+Or via MCP: use the \`cardinal_init\` tool with baseUrl, username, and password.
+
+## Available APIs (${apiNames.length} total)
+
+### Encryptable Entity APIs (${encryptable.length})
+These support encryption flavours (decrypted/encrypted/tryAndRecover):
+${encryptable.map(n => `- **${n}Api** — ${manifest.apis[n].description}`).join("\n")}
+
+### Non-Encryptable APIs (${nonEncryptable.length})
+${nonEncryptable.map(n => `- **${n}Api** — ${manifest.apis[n].description}`).join("\n")}
+
+## MCP Tools
+- **cardinal_init** — Initialize SDK with credentials
+- **cardinal_admin** — Group, User, Role, Permission, System operations
+- **cardinal_data_owner** — Healthcare entity CRUD, filtering, sharing
+- **cardinal_crypto** — Cryptography, key recovery, data owner management
+- **cardinal_continue_iteration** — Fetch next page from paginated queries
+- **search_documentation** — Search API methods, models, and filters
+
+## MCP Resources
+- \`cardinal://docs/api/{apiName}\` — API reference for each API
+- \`cardinal://docs/model/{modelName}\` — Model field documentation
+- \`cardinal://docs/filter/{entityName}\` — Filter factory methods
+- \`cardinal://docs/tutorial/{slug}\` — Tutorial sections
+
+## Encryptable Entity Pattern
+Healthcare entities with sensitive data use sealed types:
+- \`Patient\` (sealed) → \`DecryptedPatient\` + \`EncryptedPatient\`
+- Each API has flavours: \`sdk.patient\` (decrypted), \`sdk.patient.encrypted\`, \`sdk.patient.tryAndRecover\`
+- Creating requires: \`withEncryptionMetadata(base, patient)\` then \`createEntity(entity)\`
+
+## Filters
+Query entities using filter builders:
+\`\`\`typescript
+const patients = await sdk.patient.filterPatientsBy(
+  PatientFilters.bySsinsForSelf(["123456789"])
+);
+\`\`\`
+`;
+        return {
+            contents: [{ uri: uri.href, mimeType: "text/markdown", text: content }],
+        };
+    });
+}
+//# sourceMappingURL=overview.js.map

package/dist/resources/overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.js","sourceRoot":"","sources":["../../src/resources/overview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IACjD,MAAM,CAAC,QAAQ,CACd,UAAU,EACV,0BAA0B,EAC1B;QACC,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,eAAe;KACzB,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QACzE,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAE7E,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;qBAsBE,QAAQ,CAAC,MAAM;;+BAEL,WAAW,CAAC,MAAM;;EAE/C,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;4BAExD,cAAc,CAAC,MAAM;EAC/C,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BtF,CAAC;QAEC,OAAO;YACN,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SACvE,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/resources/search.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchTool(server: McpServer): void;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAkInD"}

package/dist/resources/search.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { getManifest } from "../helpers/docs-loader.js";
+export function registerSearchTool(server) {
+    server.tool("search_documentation", "Search Cardinal SDK documentation: API methods, models, and filters. No SDK initialization required.", {
+        query: z.string().describe("Search term (e.g., 'patient', 'createCalendarItem', 'filter by date')"),
+        category: z.enum(["all", "apis", "models", "filters", "tutorials"]).optional().default("all")
+            .describe("Limit search to a category"),
+        limit: z.number().optional().default(20).describe("Max results to return"),
+    }, async ({ query, category, limit }) => {
+        const manifest = getManifest();
+        const queryLower = query.toLowerCase();
+        const results = [];
+        // Search APIs
+        if (category === "all" || category === "apis") {
+            for (const [key, api] of Object.entries(manifest.apis)) {
+                // Match API name
+                if (key.toLowerCase().includes(queryLower) || api.description.toLowerCase().includes(queryLower)) {
+                    results.push({
+                        type: "api",
+                        name: api.name,
+                        description: api.description,
+                        uri: `cardinal://docs/api/${key}`,
+                    });
+                }
+                // Match methods
+                for (const method of api.methods) {
+                    if (method.name.toLowerCase().includes(queryLower) || method.description.toLowerCase().includes(queryLower)) {
+                        results.push({
+                            type: "method",
+                            name: `${api.name}.${method.name}`,
+                            description: method.description || `${method.name}(${method.params.map(p => p.name).join(", ")}): ${method.returnType}`,
+                            uri: `cardinal://docs/api/${key}`,
+                        });
+                    }
+                }
+            }
+        }
+        // Search models
+        if (category === "all" || category === "models") {
+            for (const [key, model] of Object.entries(manifest.models)) {
+                if (key.toLowerCase().includes(queryLower)) {
+                    results.push({
+                        type: "model",
+                        name: model.name,
+                        description: model.variants ? `Encryptable: ${model.variants.join(", ")}` : `${model.fields.length} fields`,
+                        uri: `cardinal://docs/model/${key}`,
+                    });
+                }
+                // Also search field names
+                for (const field of model.fields) {
+                    if (field.name.toLowerCase().includes(queryLower)) {
+                        results.push({
+                            type: "model_field",
+                            name: `${model.name}.${field.name}`,
+                            description: `${field.type}${field.description ? " — " + field.description : ""}`,
+                            uri: `cardinal://docs/model/${key}`,
+                        });
+                    }
+                }
+            }
+        }
+        // Search filters
+        if (category === "all" || category === "filters") {
+            for (const [key, filter] of Object.entries(manifest.filters)) {
+                if (key.toLowerCase().includes(queryLower)) {
+                    results.push({
+                        type: "filter",
+                        name: `${key}Filters`,
+                        description: `${filter.methods.length} filter methods`,
+                        uri: `cardinal://docs/filter/${key}`,
+                    });
+                }
+                for (const method of filter.methods) {
+                    if (method.name.toLowerCase().includes(queryLower)) {
+                        results.push({
+                            type: "filter_method",
+                            name: `${key}Filters.${method.name}`,
+                            description: `(${method.params.map(p => `${p.name}: ${p.type}`).join(", ")})`,
+                            uri: `cardinal://docs/filter/${key}`,
+                        });
+                    }
+                }
+            }
+        }
+        // Search tutorials
+        if (category === "all" || category === "tutorials") {
+            for (const tutorial of manifest.tutorials) {
+                if (tutorial.title.toLowerCase().includes(queryLower) ||
+                    tutorial.slug.toLowerCase().includes(queryLower) ||
+                    tutorial.content.toLowerCase().includes(queryLower)) {
+                    results.push({
+                        type: "tutorial",
+                        name: tutorial.title,
+                        description: `Tutorial: ${tutorial.slug}`,
+                        uri: `cardinal://docs/tutorial/${tutorial.slug}`,
+                    });
+                }
+            }
+        }
+        // Deduplicate and limit
+        const seen = new Set();
+        const unique = results.filter(r => {
+            const key = `${r.type}:${r.name}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        }).slice(0, limit);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        query,
+                        resultCount: unique.length,
+                        results: unique,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/resources/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACV,sBAAsB,EACtB,sGAAsG,EACtG;QACC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;QACnG,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;aAC3F,QAAQ,CAAC,4BAA4B,CAAC;QACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KAC1E,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACpC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,OAAO,GAA4E,EAAE,CAAC;QAE5F,cAAc;QACd,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,iBAAiB;gBACjB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAClG,OAAO,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,KAAK;wBACX,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,WAAW,EAAE,GAAG,CAAC,WAAW;wBAC5B,GAAG,EAAE,uBAAuB,GAAG,EAAE;qBACjC,CAAC,CAAC;gBACJ,CAAC;gBAED,gBAAgB;gBAChB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAClC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC7G,OAAO,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;4BAClC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,UAAU,EAAE;4BACvH,GAAG,EAAE,uBAAuB,GAAG,EAAE;yBACjC,CAAC,CAAC;oBACJ,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,gBAAgB;QAChB,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC5C,OAAO,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,SAAS;wBAC3G,GAAG,EAAE,yBAAyB,GAAG,EAAE;qBACnC,CAAC,CAAC;gBACJ,CAAC;gBAED,0BAA0B;gBAC1B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBAClC,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;wBACnD,OAAO,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,aAAa;4BACnB,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE;4BACnC,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;4BACjF,GAAG,EAAE,yBAAyB,GAAG,EAAE;yBACnC,CAAC,CAAC;oBACJ,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,iBAAiB;QACjB,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC5C,OAAO,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,GAAG,GAAG,SAAS;wBACrB,WAAW,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,iBAAiB;wBACtD,GAAG,EAAE,0BAA0B,GAAG,EAAE;qBACpC,CAAC,CAAC;gBACJ,CAAC;gBAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACrC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;wBACpD,OAAO,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,eAAe;4BACrB,IAAI,EAAE,GAAG,GAAG,WAAW,MAAM,CAAC,IAAI,EAAE;4BACpC,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;4BAC7E,GAAG,EAAE,0BAA0B,GAAG,EAAE;yBACpC,CAAC,CAAC;oBACJ,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,mBAAmB;QACnB,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpD,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC3C,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;oBACpD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAChD,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBACtD,OAAO,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,QAAQ,CAAC,KAAK;wBACpB,WAAW,EAAE,aAAa,QAAQ,CAAC,IAAI,EAAE;wBACzC,GAAG,EAAE,4BAA4B,QAAQ,CAAC,IAAI,EAAE;qBAChD,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;QACF,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACjC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,IAAI,CAAC;QACb,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAEnB,OAAO;YACN,OAAO,EAAE,CAAC;oBACT,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACpB,KAAK;wBACL,WAAW,EAAE,MAAM,CAAC,MAAM;wBAC1B,OAAO,EAAE,MAAM;qBACf,EAAE,IAAI,EAAE,CAAC,CAAC;iBACX,CAAC;SACF,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/resources/tutorial-docs.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTutorialDocs(server: McpServer): void;
+//# sourceMappingURL=tutorial-docs.d.ts.map

package/dist/resources/tutorial-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tutorial-docs.d.ts","sourceRoot":"","sources":["../../src/resources/tutorial-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAGtF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QA6CrD"}

package/dist/resources/tutorial-docs.js

@@ -0,0 +1,42 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getManifest } from "../helpers/docs-loader.js";
+export function registerTutorialDocs(server) {
+    server.resource("tutorial-docs", new ResourceTemplate("cardinal://docs/tutorial/{slug}", {
+        list: async () => {
+            const manifest = getManifest();
+            return {
+                resources: manifest.tutorials.map(t => ({
+                    uri: `cardinal://docs/tutorial/${t.slug}`,
+                    name: t.title,
+                    description: `Tutorial: ${t.title}`,
+                })),
+            };
+        },
+    }), {
+        title: "Tutorial Documentation",
+        description: "Step-by-step tutorial sections from DOCUMENTATION.md",
+        mimeType: "text/markdown",
+    }, async (uri, variables) => {
+        const slug = variables.slug;
+        const manifest = getManifest();
+        const tutorial = manifest.tutorials.find(t => t.slug === slug);
+        if (!tutorial) {
+            const available = manifest.tutorials.map(t => `- ${t.slug}: ${t.title}`).join("\n");
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "text/markdown",
+                        text: `# Tutorial Not Found: ${slug}\n\nAvailable tutorials:\n${available}`,
+                    }],
+            };
+        }
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: `# ${tutorial.title}\n\n${tutorial.content}`,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=tutorial-docs.js.map

package/dist/resources/tutorial-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tutorial-docs.js","sourceRoot":"","sources":["../../src/resources/tutorial-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACrD,MAAM,CAAC,QAAQ,CACd,eAAe,EACf,IAAI,gBAAgB,CAAC,iCAAiC,EAAE;QACvD,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC/B,OAAO;gBACN,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACvC,GAAG,EAAE,4BAA4B,CAAC,CAAC,IAAI,EAAE;oBACzC,IAAI,EAAE,CAAC,CAAC,KAAK;oBACb,WAAW,EAAE,aAAa,CAAC,CAAC,KAAK,EAAE;iBACnC,CAAC,CAAC;aACH,CAAC;QACH,CAAC;KACD,CAAC,EACF;QACC,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,sDAAsD;QACnE,QAAQ,EAAE,eAAe;KACzB,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAc,CAAC;QACtC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAE/D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpF,OAAO;gBACN,QAAQ,EAAE,CAAC;wBACV,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,eAAe;wBACzB,IAAI,EAAE,yBAAyB,IAAI,6BAA6B,SAAS,EAAE;qBAC3E,CAAC;aACF,CAAC;QACH,CAAC;QAED,OAAO;YACN,QAAQ,EAAE,CAAC;oBACV,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,KAAK,QAAQ,CAAC,KAAK,OAAO,QAAQ,CAAC,OAAO,EAAE;iBAClD,CAAC;SACF,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,wBAAgB,YAAY,IAAI,SAAS,CA8BxC"}

package/dist/server.js

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerInitTool } from "./tools/init.js";
+import { registerAdminTools } from "./tools/admin-tools.js";
+import { registerDataOwnerTools } from "./tools/data-owner-tools.js";
+import { registerCryptoTools } from "./tools/crypto-tools.js";
+import { registerContinueIterationTool } from "./helpers/pagination.js";
+import { registerSearchTool } from "./resources/search.js";
+import { registerApiDocs } from "./resources/api-docs.js";
+import { registerModelDocs } from "./resources/model-docs.js";
+import { registerFilterDocs } from "./resources/filter-docs.js";
+import { registerTutorialDocs } from "./resources/tutorial-docs.js";
+import { registerOverview } from "./resources/overview.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "cardinal-sdk",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // Register tools
+    registerInitTool(server);
+    registerAdminTools(server);
+    registerDataOwnerTools(server);
+    registerCryptoTools(server);
+    registerContinueIterationTool(server);
+    registerSearchTool(server);
+    // Register resources
+    registerOverview(server);
+    registerApiDocs(server);
+    registerModelDocs(server);
+    registerFilterDocs(server);
+    registerTutorialDocs(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,UAAU,YAAY;IAC3B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC3B;QACC,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KAChB,EACD;QACC,YAAY,EAAE;YACb,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACb;KACD,CACD,CAAC;IAEF,iBAAiB;IACjB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,qBAAqB;IACrB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/tools/admin-tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAdminTools(server: McpServer): void;
+//# sourceMappingURL=admin-tools.d.ts.map

package/dist/tools/admin-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-tools.d.ts","sourceRoot":"","sources":["../../src/tools/admin-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAanD"}

package/dist/tools/admin-tools.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import { dispatch } from "./dispatch.js";
+const ADMIN_APIS = ["Group", "User", "Role", "Permission", "System", "Auth", "ApplicationSettings"];
+export function registerAdminTools(server) {
+    server.tool("cardinal_admin", `Execute admin operations. Covers: ${ADMIN_APIS.join(", ")} APIs. Use search_documentation to discover available methods.`, {
+        api: z.enum(ADMIN_APIS).describe("Which admin API to use"),
+        method: z.string().describe("Method name (e.g., listGroups, getUser, createGroup)"),
+        params: z.record(z.unknown()).optional().default({}).describe("Method parameters as key-value pairs"),
+    }, async ({ api, method, params }) => {
+        return dispatch({ api, method, params });
+    });
+}
+//# sourceMappingURL=admin-tools.js.map

package/dist/tools/admin-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-tools.js","sourceRoot":"","sources":["../../src/tools/admin-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,CAAU,CAAC;AAE7G,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACV,gBAAgB,EAChB,qCAAqC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gEAAgE,EAC1H;QACC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QACnF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACrG,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,OAAO,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/crypto-tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCryptoTools(server: McpServer): void;
+//# sourceMappingURL=crypto-tools.d.ts.map

package/dist/tools/crypto-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-tools.d.ts","sourceRoot":"","sources":["../../src/tools/crypto-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAapD"}

package/dist/tools/crypto-tools.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import { dispatch } from "./dispatch.js";
+const CRYPTO_APIS = ["Crypto", "Recovery", "ShamirKeysManager", "DataOwner", "CardinalMaintenanceTask"];
+export function registerCryptoTools(server) {
+    server.tool("cardinal_crypto", `Execute cryptography and key management operations. Covers: ${CRYPTO_APIS.join(", ")} APIs. Use search_documentation to discover available methods.`, {
+        api: z.enum(CRYPTO_APIS).describe("Which crypto API to use"),
+        method: z.string().describe("Method name (e.g., getCurrentDataOwner, forceReload)"),
+        params: z.record(z.unknown()).optional().default({}).describe("Method parameters as key-value pairs"),
+    }, async ({ api, method, params }) => {
+        return dispatch({ api, method, params });
+    });
+}
+//# sourceMappingURL=crypto-tools.js.map

package/dist/tools/crypto-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-tools.js","sourceRoot":"","sources":["../../src/tools/crypto-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,yBAAyB,CAAU,CAAC;AAEjH,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACV,iBAAiB,EACjB,+DAA+D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gEAAgE,EACrJ;QACC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QACnF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACrG,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,OAAO,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/data-owner-tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDataOwnerTools(server: McpServer): void;
+//# sourceMappingURL=data-owner-tools.d.ts.map

package/dist/tools/data-owner-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-owner-tools.d.ts","sourceRoot":"","sources":["../../src/tools/data-owner-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAcvD"}

package/dist/tools/data-owner-tools.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { dispatch } from "./dispatch.js";
+const DATA_OWNER_APIS = [
+    "HealthcareParty", "Patient", "Device",
+    "AccessLog", "CalendarItem", "Classification", "Contact", "Document",
+    "Form", "HealthElement", "Invoice", "MaintenanceTask", "Message",
+    "Receipt", "TimeTable", "Topic",
+    "Agenda", "CalendarItemType", "Code", "DocumentTemplate",
+    "EntityReference", "EntityTemplate", "FrontEndMigration",
+    "Insurance", "Keyword", "MedicalLocation", "Place", "Tarification",
+    "FormTemplate",
+];
+const FLAVOUR_VALUES = ["decrypted", "encrypted", "tryAndRecover"];
+export function registerDataOwnerTools(server) {
+    server.tool("cardinal_data_owner", `Execute data operations on healthcare entities. Covers: ${DATA_OWNER_APIS.join(", ")} APIs. Encryptable entities support the 'flavour' parameter for encrypted/decrypted/tryAndRecover variants. Use search_documentation to discover available methods.`, {
+        api: z.enum(DATA_OWNER_APIS).describe("Which API to use"),
+        method: z.string().describe("Method name (e.g., getPatient, createCalendarItem, filterPatientsBy)"),
+        flavour: z.enum(FLAVOUR_VALUES).optional().describe("For encryptable entities: decrypted (default), encrypted, or tryAndRecover"),
+        params: z.record(z.unknown()).optional().default({}).describe("Method parameters as key-value pairs"),
+    }, async ({ api, method, flavour, params }) => {
+        return dispatch({ api, method, flavour, params });
+    });
+}
+//# sourceMappingURL=data-owner-tools.js.map

package/dist/tools/data-owner-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-owner-tools.js","sourceRoot":"","sources":["../../src/tools/data-owner-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,eAAe,GAAG;IACvB,iBAAiB,EAAE,SAAS,EAAE,QAAQ;IACtC,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU;IACpE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS;IAChE,SAAS,EAAE,WAAW,EAAE,OAAO;IAC/B,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB;IACxD,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB;IACxD,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc;IAClE,cAAc;CACL,CAAC;AAEX,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,CAAU,CAAC;AAE5E,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACV,qBAAqB,EACrB,2DAA2D,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,qKAAqK,EAC1P;QACC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACzD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;QACnG,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;QACjI,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACrG,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1C,OAAO,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/dispatch.d.ts

@@ -0,0 +1,16 @@
+export interface DispatchRequest {
+    api: string;
+    method: string;
+    flavour?: "decrypted" | "encrypted" | "tryAndRecover";
+    params: Record<string, unknown>;
+}
+export interface DispatchResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function dispatch(request: DispatchRequest): Promise<DispatchResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/tools/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/tools/dispatch.ts"],"names":[],"mappings":"AAiDA,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAuChF"}

package/dist/tools/dispatch.js

@@ -0,0 +1,141 @@
+import { getSdk } from "./sdk-state.js";
+import { collectFirstPage } from "../helpers/pagination.js";
+import { formatResponse } from "../helpers/serialization.js";
+import { buildFilter } from "../helpers/filter-builder.js";
+import { buildModel } from "../helpers/model-builder.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+let registryCache = null;
+function getRegistry() {
+    if (!registryCache) {
+        const registryPath = path.resolve(__dirname, "..", "..", "generated", "method-registry.ts");
+        const content = fs.readFileSync(registryPath, "utf-8");
+        // Extract the JSON from the generated TS file
+        const jsonMatch = content.match(/=\s*(\{[\s\S]*\})\s*;\s*$/);
+        if (!jsonMatch)
+            throw new Error("Could not parse method registry");
+        registryCache = JSON.parse(jsonMatch[1]);
+    }
+    return registryCache;
+}
+export async function dispatch(request) {
+    const sdk = getSdk();
+    const registry = getRegistry();
+    // Look up API info
+    const apiInfo = registry[request.api];
+    if (!apiInfo) {
+        return errorResult(`Unknown API: "${request.api}". Available: ${Object.keys(registry).join(", ")}`);
+    }
+    // Look up method info
+    const methodInfo = apiInfo.methods.find(m => m.name === request.method);
+    if (!methodInfo) {
+        const available = apiInfo.methods.map(m => m.name).join(", ");
+        return errorResult(`Unknown method "${request.method}" on ${request.api}Api. Available: ${available}`);
+    }
+    // Resolve API object from SDK
+    const apiObj = resolveApi(sdk, apiInfo.propertyName, request.flavour, apiInfo.isEncryptable);
+    if (!apiObj) {
+        return errorResult(`Could not resolve API "${apiInfo.propertyName}" on SDK instance.`);
+    }
+    // Resolve method function
+    const methodFn = apiObj[request.method];
+    if (typeof methodFn !== "function") {
+        return errorResult(`Method "${request.method}" is not a function on ${apiInfo.propertyName}${request.flavour ? "." + request.flavour : ""}.`);
+    }
+    // Build arguments in the correct order
+    const args = buildArgs(methodInfo.params, request.params);
+    try {
+        const result = await methodFn.apply(apiObj, args);
+        return handleResult(result);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Error calling ${request.api}.${request.method}: ${message}`);
+    }
+}
+function resolveApi(sdk, propertyName, flavour, isEncryptable) {
+    const baseApi = sdk[propertyName];
+    if (!baseApi)
+        return null;
+    if (isEncryptable && flavour && flavour !== "decrypted") {
+        const flavouredApi = baseApi[flavour];
+        return flavouredApi || baseApi;
+    }
+    return baseApi;
+}
+function buildArgs(paramDefs, params) {
+    return paramDefs.map(def => {
+        const value = params[def.name];
+        if (value === undefined) {
+            return undefined;
+        }
+        // Transform special parameter types
+        if (def.type.includes("FilterOptions")) {
+            if (value && typeof value === "object" && "_factory" in value) {
+                return buildFilter(value);
+            }
+        }
+        // Build model instances from plain objects
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            const typeName = extractTypeName(def.type);
+            if (typeName) {
+                return buildModel(typeName, value);
+            }
+        }
+        // Handle arrays of models
+        if (Array.isArray(value) && def.type.includes("Array<")) {
+            const innerType = extractArrayInnerType(def.type);
+            if (innerType) {
+                return value.map(item => {
+                    if (item && typeof item === "object" && !Array.isArray(item)) {
+                        return buildModel(innerType, item);
+                    }
+                    return item;
+                });
+            }
+        }
+        return value;
+    });
+}
+function extractTypeName(typeStr) {
+    // Match simple type names like "DecryptedPatient", "Group", etc.
+    const match = typeStr.match(/^(Decrypted|Encrypted)?(\w+)$/);
+    if (match)
+        return typeStr;
+    // Handle union types - take the first non-primitive
+    const parts = typeStr.split("|").map(s => s.trim());
+    for (const part of parts) {
+        if (part !== "undefined" && part !== "null" && part !== "string" && part !== "number" && part !== "boolean") {
+            const inner = part.match(/^(\w+)$/);
+            if (inner)
+                return inner[1];
+        }
+    }
+    return null;
+}
+function extractArrayInnerType(typeStr) {
+    const match = typeStr.match(/Array<(\w+)>/);
+    return match ? match[1] : null;
+}
+async function handleResult(result) {
+    // Handle PaginatedListIterator
+    if (result && typeof result === "object" && "hasNext" in result && "next" in result) {
+        const iterator = result;
+        const page = await collectFirstPage(iterator);
+        return {
+            content: [{ type: "text", text: formatResponse(page) }],
+        };
+    }
+    return {
+        content: [{ type: "text", text: formatResponse(result) }],
+    };
+}
+function errorResult(message) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/tools/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/tools/dispatch.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAA8B,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAqB/D,IAAI,aAAa,GAAmC,IAAI,CAAC;AAEzD,SAAS,WAAW;IACnB,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;QAC5F,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACvD,8CAA8C;QAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACnE,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAA4B,CAAC;IACrE,CAAC;IACD,OAAO,aAAa,CAAC;AACtB,CAAC;AAeD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACtD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,mBAAmB;IACnB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,WAAW,CAAC,iBAAiB,OAAO,CAAC,GAAG,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,sBAAsB;IACtB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,WAAW,CAAC,mBAAmB,OAAO,CAAC,MAAM,QAAQ,OAAO,CAAC,GAAG,mBAAmB,SAAS,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7F,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,0BAA0B,OAAO,CAAC,YAAY,oBAAoB,CAAC,CAAC;IACxF,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAI,MAAkC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,WAAW,OAAO,CAAC,MAAM,0BAA0B,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/I,CAAC;IAED,uCAAuC;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1D,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAO,QAAqD,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAChG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,iBAAiB,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;AACF,CAAC;AAED,SAAS,UAAU,CAClB,GAAgB,EAChB,YAAoB,EACpB,OAA2B,EAC3B,aAAsB;IAEtB,MAAM,OAAO,GAAI,GAA0C,CAAC,YAAY,CAAC,CAAC;IAC1E,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,aAAa,IAAI,OAAO,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QACzD,MAAM,YAAY,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,YAAY,IAAI,OAAO,CAAC;IAChC,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,SAAmE,EAAE,MAA+B;IACtH,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,oCAAoC;QACpC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACxC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAK,KAAiC,EAAE,CAAC;gBAC5F,OAAO,WAAW,CAAC,KAAgC,CAAC,CAAC;YACtD,CAAC;QACF,CAAC;QAED,2CAA2C;QAC3C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,QAAQ,EAAE,CAAC;gBACd,OAAO,UAAU,CAAC,QAAQ,EAAE,KAAgC,CAAC,CAAC;YAC/D,CAAC;QACF,CAAC;QAED,0BAA0B;QAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzD,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,SAAS,EAAE,CAAC;gBACf,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;oBACvB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC9D,OAAO,UAAU,CAAC,SAAS,EAAE,IAA+B,CAAC,CAAC;oBAC/D,CAAC;oBACD,OAAO,IAAI,CAAC;gBACb,CAAC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACvC,iEAAiE;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC7D,IAAI,KAAK;QAAE,OAAO,OAAO,CAAC;IAE1B,oDAAoD;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7G,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACpC,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAe;IAC1C,+BAA+B;IAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrF,MAAM,QAAQ,GAAG,MAAwC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;SACvD,CAAC;IACH,CAAC;IAED,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;KACzD,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IACnC,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,IAAI;KACb,CAAC;AACH,CAAC"}

package/dist/tools/init.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerInitTool(server: McpServer): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/tools/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/tools/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAsDjD"}