@icure/cardinal-mcp-server 1.0.0

package/dist/helpers/docs-loader.d.ts

@@ -0,0 +1,56 @@
+export interface ParamDoc {
+    name: string;
+    type: string;
+    description: string;
+    optional: boolean;
+}
+export interface MethodDoc {
+    name: string;
+    description: string;
+    params: ParamDoc[];
+    returnType: string;
+    throws?: string[];
+    flavours: string[];
+}
+export interface ApiDoc {
+    name: string;
+    description: string;
+    isEncryptable: boolean;
+    methods: MethodDoc[];
+}
+export interface ModelField {
+    name: string;
+    type: string;
+    description: string;
+}
+export interface ModelDoc {
+    name: string;
+    variants?: string[];
+    implements?: string[];
+    fields: ModelField[];
+}
+export interface FilterMethodDoc {
+    name: string;
+    description: string;
+    params: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+export interface FilterDoc {
+    entityName: string;
+    methods: FilterMethodDoc[];
+}
+export interface TutorialDoc {
+    slug: string;
+    title: string;
+    content: string;
+}
+export interface DocsManifest {
+    apis: Record<string, ApiDoc>;
+    models: Record<string, ModelDoc>;
+    filters: Record<string, FilterDoc>;
+    tutorials: TutorialDoc[];
+}
+export declare function getManifest(): DocsManifest;
+//# sourceMappingURL=docs-loader.d.ts.map

package/dist/helpers/docs-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-loader.d.ts","sourceRoot":"","sources":["../../src/helpers/docs-loader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,SAAS;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,SAAS,EAAE,WAAW,EAAE,CAAC;CACzB;AAID,wBAAgB,WAAW,IAAI,YAAY,CAO1C"}

package/dist/helpers/docs-loader.js

@@ -0,0 +1,14 @@
+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 cachedManifest = null;
+export function getManifest() {
+    if (!cachedManifest) {
+        const manifestPath = path.resolve(__dirname, "..", "..", "generated", "docs-manifest.json");
+        const raw = fs.readFileSync(manifestPath, "utf-8");
+        cachedManifest = JSON.parse(raw);
+    }
+    return cachedManifest;
+}
+//# sourceMappingURL=docs-loader.js.map

package/dist/helpers/docs-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-loader.js","sourceRoot":"","sources":["../../src/helpers/docs-loader.ts"],"names":[],"mappings":"AAAA,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;AA8D/D,IAAI,cAAc,GAAwB,IAAI,CAAC;AAE/C,MAAM,UAAU,WAAW;IAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;QAC5F,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAClD,CAAC;IACD,OAAO,cAAc,CAAC;AACvB,CAAC"}

package/dist/helpers/filter-builder.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build a filter from a JSON description.
+ * If the input has a _factory property, it's resolved to a filter factory function.
+ * Otherwise, the object is returned as-is (may already be a filter instance).
+ */
+export declare function buildFilter(filterDesc: Record<string, unknown>): unknown;
+//# sourceMappingURL=filter-builder.d.ts.map

package/dist/helpers/filter-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-builder.d.ts","sourceRoot":"","sources":["../../src/helpers/filter-builder.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA+BxE"}

package/dist/helpers/filter-builder.js

@@ -0,0 +1,53 @@
+/**
+ * Constructs filter objects from JSON descriptions.
+ * Input format: { "_factory": "PatientFilters.bySsinsForSelf", "ssins": ["123456"] }
+ * Maps to actual SDK filter factory calls.
+ */
+import * as cardinalSdk from "@icure/cardinal-sdk";
+const filters = cardinalSdk.filters;
+/**
+ * Build a filter from a JSON description.
+ * If the input has a _factory property, it's resolved to a filter factory function.
+ * Otherwise, the object is returned as-is (may already be a filter instance).
+ */
+export function buildFilter(filterDesc) {
+    const factory = filterDesc._factory;
+    if (typeof factory !== "string") {
+        return filterDesc;
+    }
+    // Parse "EntityFilters.methodName" format
+    const [factoryObject, methodName] = factory.split(".");
+    if (!factoryObject || !methodName) {
+        throw new Error(`Invalid filter factory format: "${factory}". Expected "EntityFilters.methodName".`);
+    }
+    // Resolve the filter factory object
+    const factoryObj = resolveFilterFactory(factoryObject);
+    if (!factoryObj) {
+        throw new Error(`Filter factory "${factoryObject}" not found in SDK.`);
+    }
+    const factoryFn = factoryObj[methodName];
+    if (typeof factoryFn !== "function") {
+        throw new Error(`Method "${methodName}" not found on "${factoryObject}".`);
+    }
+    // Extract params (everything except _factory)
+    const params = { ...filterDesc };
+    delete params._factory;
+    // Call the factory function with the params spread as arguments
+    // Most filter factories use positional args matching param names
+    const paramValues = Object.values(params);
+    return factoryFn(...paramValues);
+}
+function resolveFilterFactory(name) {
+    // Try in filters namespace
+    if (filters) {
+        const factory = filters[name];
+        if (factory)
+            return factory;
+    }
+    // Try in top-level exports
+    const topLevel = cardinalSdk[name];
+    if (topLevel)
+        return topLevel;
+    return null;
+}
+//# sourceMappingURL=filter-builder.js.map

package/dist/helpers/filter-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-builder.js","sourceRoot":"","sources":["../../src/helpers/filter-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,GAAI,WAAuC,CAAC,OAA8C,CAAC;AAExG;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,UAAmC;IAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC;IACpC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,CAAC,aAAa,IAAI,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,yCAAyC,CAAC,CAAC;IACtG,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,aAAa,qBAAqB,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,SAAS,GAAI,UAAsC,CAAC,UAAU,CAAC,CAAC;IACtE,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,mBAAmB,aAAa,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,8CAA8C;IAC9C,MAAM,MAAM,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC;IAEvB,gEAAgE;IAChE,iEAAiE;IACjE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAQ,SAA6C,CAAC,GAAG,WAAW,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACzC,2BAA2B;IAC3B,IAAI,OAAO,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC7B,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAI,WAAuC,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/helpers/model-builder.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tries to construct a model instance from a plain JSON object.
+ * Falls back to returning the plain object if no constructor is found.
+ */
+export declare function buildModel(typeName: string, data: Record<string, unknown>): unknown;
+/**
+ * Resolves a type name with "Decrypted" or "Encrypted" prefix.
+ */
+export declare function buildEntityModel(typeName: string, data: Record<string, unknown>, flavour?: string): unknown;
+//# sourceMappingURL=model-builder.d.ts.map

package/dist/helpers/model-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-builder.d.ts","sourceRoot":"","sources":["../../src/helpers/model-builder.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAcnF;AA8BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAS3G"}

package/dist/helpers/model-builder.js

@@ -0,0 +1,64 @@
+/**
+ * Constructs SDK model instances from plain JSON objects.
+ * Most TypeScript model classes accept Partial<T> in constructors.
+ */
+import * as cardinalSdk from "@icure/cardinal-sdk";
+// Access model namespace
+const model = cardinalSdk.model;
+/**
+ * Tries to construct a model instance from a plain JSON object.
+ * Falls back to returning the plain object if no constructor is found.
+ */
+export function buildModel(typeName, data) {
+    // Try to find the class in the SDK exports
+    const Constructor = resolveConstructor(typeName);
+    if (Constructor) {
+        try {
+            return new Constructor(data);
+        }
+        catch {
+            // Some constructors may have different signatures, fall back to plain object
+            return data;
+        }
+    }
+    return data;
+}
+function resolveConstructor(typeName) {
+    // Try direct lookup in top-level exports
+    const directExport = cardinalSdk[typeName];
+    if (typeof directExport === "function") {
+        return directExport;
+    }
+    // Try in model namespace
+    if (model) {
+        const modelExport = model[typeName];
+        if (typeof modelExport === "function") {
+            return modelExport;
+        }
+        // Try nested namespaces (e.g., model.embed, model.base)
+        for (const ns of Object.values(model)) {
+            if (ns && typeof ns === "object") {
+                const nested = ns[typeName];
+                if (typeof nested === "function") {
+                    return nested;
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Resolves a type name with "Decrypted" or "Encrypted" prefix.
+ */
+export function buildEntityModel(typeName, data, flavour) {
+    if (flavour === "encrypted") {
+        return buildModel("Encrypted" + typeName, data);
+    }
+    // Default to Decrypted for encryptable entities
+    const decrypted = buildModel("Decrypted" + typeName, data);
+    if (decrypted !== data)
+        return decrypted;
+    // Fallback to plain type name
+    return buildModel(typeName, data);
+}
+//# sourceMappingURL=model-builder.js.map

package/dist/helpers/model-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-builder.js","sourceRoot":"","sources":["../../src/helpers/model-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,yBAAyB;AACzB,MAAM,KAAK,GAAI,WAAuC,CAAC,KAA4C,CAAC;AAEpG;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAA6B;IACzE,2CAA2C;IAC3C,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAEjD,IAAI,WAAW,EAAE,CAAC;QACjB,IAAI,CAAC;YACJ,OAAO,IAAK,WAAiE,CAAC,IAAI,CAAC,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC;YACR,6EAA6E;YAC7E,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC3C,yCAAyC;IACzC,MAAM,YAAY,GAAI,WAAuC,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO,YAAmD,CAAC;IAC5D,CAAC;IAED,yBAAyB;IACzB,IAAI,KAAK,EAAE,CAAC;QACX,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;YACvC,OAAO,WAAkD,CAAC;QAC3D,CAAC;QAED,wDAAwD;QACxD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAI,EAA8B,CAAC,QAAQ,CAAC,CAAC;gBACzD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;oBAClC,OAAO,MAA6C,CAAC;gBACtD,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAA6B,EAAE,OAAgB;IACjG,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,WAAW,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,gDAAgD;IAChD,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3D,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACzC,8BAA8B;IAC9B,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/helpers/pagination.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface PaginatedListIterator<T> {
+    hasNext(): Promise<boolean>;
+    next(limit: number): Promise<Array<T>>;
+}
+export declare function storeIterator(iterator: PaginatedListIterator<unknown>): string;
+export declare function collectFirstPage<T>(iterator: PaginatedListIterator<T>, pageSize?: number): Promise<{
+    items: T[];
+    hasMore: boolean;
+    iteratorId?: string;
+}>;
+export declare function registerContinueIterationTool(server: McpServer): void;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/helpers/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/helpers/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACvC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CACvC;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,MAAM,CAK9E;AAWD,wBAAsB,gBAAgB,CAAC,CAAC,EACvC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAClC,QAAQ,SAAM,GACZ,OAAO,CAAC;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUhE;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,QAmC9D"}

package/dist/helpers/pagination.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { randomUUID } from "node:crypto";
+const iteratorStore = new Map();
+const ITERATOR_TTL_MS = 10 * 60 * 1000; // 10 minutes
+export function storeIterator(iterator) {
+    const id = randomUUID();
+    iteratorStore.set(id, { iterator, createdAt: Date.now() });
+    cleanupExpired();
+    return id;
+}
+function cleanupExpired() {
+    const now = Date.now();
+    for (const [id, entry] of iteratorStore) {
+        if (now - entry.createdAt > ITERATOR_TTL_MS) {
+            iteratorStore.delete(id);
+        }
+    }
+}
+export async function collectFirstPage(iterator, pageSize = 100) {
+    const items = await iterator.next(pageSize);
+    const hasMore = await iterator.hasNext();
+    if (hasMore) {
+        const iteratorId = storeIterator(iterator);
+        return { items, hasMore: true, iteratorId };
+    }
+    return { items, hasMore: false };
+}
+export function registerContinueIterationTool(server) {
+    server.tool("cardinal_continue_iteration", "Fetch the next page of results from a paginated query. Use the iteratorId returned by a previous call.", {
+        iteratorId: z.string().describe("The iterator ID from a previous paginated response"),
+        pageSize: z.number().optional().default(100).describe("Number of items to fetch (default 100)"),
+    }, async ({ iteratorId, pageSize }) => {
+        const entry = iteratorStore.get(iteratorId);
+        if (!entry) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ error: "Iterator not found or expired. Start a new query." }),
+                    }],
+                isError: true,
+            };
+        }
+        const items = await entry.iterator.next(pageSize);
+        const hasMore = await entry.iterator.hasNext();
+        if (!hasMore) {
+            iteratorStore.delete(iteratorId);
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ items, hasMore, iteratorId: hasMore ? iteratorId : undefined }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=pagination.js.map

package/dist/helpers/pagination.js.map

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

package/dist/helpers/serialization.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Serializes SDK results to JSON-safe objects.
+ * Handles special types and strips internal properties.
+ */
+export declare function serializeResult(value: unknown): unknown;
+export declare function formatResponse(data: unknown): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/helpers/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/helpers/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/helpers/serialization.js

@@ -0,0 +1,36 @@
+/**
+ * Serializes SDK results to JSON-safe objects.
+ * Handles special types and strips internal properties.
+ */
+export function serializeResult(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (Array.isArray(value)) {
+        return value.map(serializeResult);
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === "object") {
+        // If the object has a toJSON method, use it
+        if ("toJSON" in value && typeof value.toJSON === "function") {
+            return value.toJSON();
+        }
+        // Otherwise serialize each property
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            // Skip internal properties
+            if (key.startsWith("__") || key.startsWith("$"))
+                continue;
+            result[key] = serializeResult(val);
+        }
+        return result;
+    }
+    return String(value);
+}
+export function formatResponse(data) {
+    return JSON.stringify(serializeResult(data), null, 2);
+}
+//# sourceMappingURL=serialization.js.map

package/dist/helpers/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/helpers/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEvG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,4CAA4C;QAC5C,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAQ,KAA6B,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACtF,OAAQ,KAAmC,CAAC,MAAM,EAAE,CAAC;QACtD,CAAC;QAED,oCAAoC;QACpC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,2BAA2B;YAC3B,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACtB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/resources/api-docs.js

@@ -0,0 +1,63 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getManifest } from "../helpers/docs-loader.js";
+export function registerApiDocs(server) {
+    server.resource("api-docs", new ResourceTemplate("cardinal://docs/api/{apiName}", {
+        list: async () => {
+            const manifest = getManifest();
+            return {
+                resources: Object.keys(manifest.apis).sort().map(name => ({
+                    uri: `cardinal://docs/api/${name}`,
+                    name: `${name}Api`,
+                    description: manifest.apis[name].description,
+                })),
+            };
+        },
+    }), {
+        title: "API Documentation",
+        description: "Full reference for a Cardinal SDK API",
+        mimeType: "text/markdown",
+    }, async (uri, variables) => {
+        const apiName = variables.apiName;
+        const manifest = getManifest();
+        const api = manifest.apis[apiName];
+        if (!api) {
+            const available = Object.keys(manifest.apis).sort().join(", ");
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "text/markdown",
+                        text: `# API Not Found: ${apiName}\n\nAvailable APIs: ${available}`,
+                    }],
+            };
+        }
+        let md = `# ${api.name}\n\n${api.description}\n\n`;
+        if (api.isEncryptable) {
+            md += `> **Encryptable Entity** — Supports flavours: decrypted (default), encrypted, tryAndRecover\n\n`;
+        }
+        md += `## Methods (${api.methods.length})\n\n`;
+        for (const method of api.methods) {
+            md += `### ${method.name}\n\n`;
+            if (method.description) {
+                md += `${method.description}\n\n`;
+            }
+            if (method.params.length > 0) {
+                md += `**Parameters:**\n`;
+                for (const param of method.params) {
+                    const opt = param.optional ? " *(optional)*" : "";
+                    const desc = param.description ? ` — ${param.description}` : "";
+                    md += `- \`${param.name}\`: \`${param.type}\`${opt}${desc}\n`;
+                }
+                md += "\n";
+            }
+            md += `**Returns:** \`${method.returnType}\`\n\n`;
+            if (method.throws && method.throws.length > 0) {
+                md += `**Throws:** ${method.throws.join(", ")}\n\n`;
+            }
+            md += "---\n\n";
+        }
+        return {
+            contents: [{ uri: uri.href, mimeType: "text/markdown", text: md }],
+        };
+    });
+}
+//# sourceMappingURL=api-docs.js.map

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

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

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

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

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

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

package/dist/resources/filter-docs.js

@@ -0,0 +1,56 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getManifest } from "../helpers/docs-loader.js";
+export function registerFilterDocs(server) {
+    server.resource("filter-docs", new ResourceTemplate("cardinal://docs/filter/{entityName}", {
+        list: async () => {
+            const manifest = getManifest();
+            return {
+                resources: Object.keys(manifest.filters).sort().map(name => ({
+                    uri: `cardinal://docs/filter/${name}`,
+                    name: `${name}Filters`,
+                    description: `${manifest.filters[name].methods.length} filter methods for ${name}`,
+                })),
+            };
+        },
+    }), {
+        title: "Filter Documentation",
+        description: "Available filter factory methods for an entity type",
+        mimeType: "text/markdown",
+    }, async (uri, variables) => {
+        const entityName = variables.entityName;
+        const manifest = getManifest();
+        const filter = manifest.filters[entityName];
+        if (!filter) {
+            const available = Object.keys(manifest.filters).sort().join(", ");
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "text/markdown",
+                        text: `# Filters Not Found: ${entityName}\n\nAvailable: ${available}`,
+                    }],
+            };
+        }
+        let md = `# ${entityName}Filters\n\n`;
+        md += `Filter factory methods for querying ${entityName} entities.\n\n`;
+        md += `## Usage with MCP tools\n\n`;
+        md += `Pass filters as the \`filter\` parameter using the \`_factory\` format:\n`;
+        md += `\`\`\`json\n`;
+        md += `{\n`;
+        md += `  "filter": {\n`;
+        md += `    "_factory": "${entityName}Filters.methodName",\n`;
+        md += `    "param1": "value1"\n`;
+        md += `  }\n`;
+        md += `}\n`;
+        md += `\`\`\`\n\n`;
+        md += `## Methods (${filter.methods.length})\n\n`;
+        for (const method of filter.methods) {
+            const paramStr = method.params.map(p => `${p.name}: ${p.type}`).join(", ");
+            md += `### ${method.name}\n`;
+            md += `\`\`\`typescript\n${entityName}Filters.${method.name}(${paramStr})\n\`\`\`\n\n`;
+        }
+        return {
+            contents: [{ uri: uri.href, mimeType: "text/markdown", text: md }],
+        };
+    });
+}
+//# sourceMappingURL=filter-docs.js.map

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

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

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

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

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

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

package/dist/resources/model-docs.js

@@ -0,0 +1,59 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getManifest } from "../helpers/docs-loader.js";
+export function registerModelDocs(server) {
+    server.resource("model-docs", new ResourceTemplate("cardinal://docs/model/{modelName}", {
+        list: async () => {
+            const manifest = getManifest();
+            return {
+                resources: Object.keys(manifest.models).sort().map(name => ({
+                    uri: `cardinal://docs/model/${name}`,
+                    name,
+                    description: manifest.models[name].variants
+                        ? `Encryptable: ${manifest.models[name].variants.join(", ")}`
+                        : `Model with ${manifest.models[name].fields.length} fields`,
+                })),
+            };
+        },
+    }), {
+        title: "Model Documentation",
+        description: "Model fields, types, variants, and parent interfaces",
+        mimeType: "text/markdown",
+    }, async (uri, variables) => {
+        const modelName = variables.modelName;
+        const manifest = getManifest();
+        const model = manifest.models[modelName];
+        if (!model) {
+            const available = Object.keys(manifest.models).sort().join(", ");
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "text/markdown",
+                        text: `# Model Not Found: ${modelName}\n\nAvailable models: ${available}`,
+                    }],
+            };
+        }
+        let md = `# ${model.name}\n\n`;
+        if (model.variants) {
+            md += `**Encryptable entity** with variants: ${model.variants.map(v => `\`${v}\``).join(", ")}\n\n`;
+        }
+        if (model.implements && model.implements.length > 0) {
+            md += `**Implements:** ${model.implements.map(i => `\`${i}\``).join(", ")}\n\n`;
+        }
+        if (model.fields.length > 0) {
+            md += `## Fields (${model.fields.length})\n\n`;
+            md += "| Field | Type | Description |\n";
+            md += "|-------|------|-------------|\n";
+            for (const field of model.fields) {
+                const desc = field.description || "";
+                md += `| \`${field.name}\` | \`${field.type}\` | ${desc} |\n`;
+            }
+        }
+        else {
+            md += "*No fields documented.*\n";
+        }
+        return {
+            contents: [{ uri: uri.href, mimeType: "text/markdown", text: md }],
+        };
+    });
+}
+//# sourceMappingURL=model-docs.js.map

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

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

package/dist/resources/overview.d.ts

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