@bluelibs/runner-dev 4.0.0

package/dist/generated/resolvers-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=resolvers-types.js.map

package/dist/generated/resolvers-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers-types.js","sourceRoot":"","sources":["../../src/generated/resolvers-types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import { dev } from "./resources/dev.resource";
+export declare const resources: {
+    server: import("@bluelibs/runner/dist/defs").IResource<import("./resources/server.resource").ServerConfig, Promise<{
+        apolloServer: import("@apollo/server").ApolloServer<import("@apollo/server").BaseContext>;
+        httpServer: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+    }>, {
+        store: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        logger: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Logger>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        introspector: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("./resources/introspector.resource").Introspector>, {
+            store: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        live: import("@bluelibs/runner/dist/defs").IResource<{
+            maxEntries?: number;
+        }, Promise<import("./resources/live.resource").Live>, {
+            liveService: import("@bluelibs/runner/dist/defs").IResource<{
+                maxEntries?: number;
+            }, Promise<import("./resources/live.resource").Live>, {}, any, any, import("@bluelibs/runner/dist/defs").ITag<{
+                metadata?: Record<string, any>;
+            }, void, void>[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+            logger: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Logger>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        swapManager: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("./resources/swap.resource").SwapManager>, {
+            store: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+            taskRunner: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").TaskRunner>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+            introspector: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("./resources/introspector.resource").Introspector>, {
+                store: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+            }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+            eventManager: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").EventManager>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        graphql: import("@bluelibs/runner/dist/defs").IResource<void, Promise<{
+            getSchema: () => import("graphql").GraphQLSchema;
+        }>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    introspector: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("./resources/introspector.resource").Introspector>, {
+        store: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    live: import("@bluelibs/runner/dist/defs").IResource<{
+        maxEntries?: number;
+    }, Promise<import("./resources/live.resource").Live>, {
+        liveService: import("@bluelibs/runner/dist/defs").IResource<{
+            maxEntries?: number;
+        }, Promise<import("./resources/live.resource").Live>, {}, any, any, import("@bluelibs/runner/dist/defs").ITag<{
+            metadata?: Record<string, any>;
+        }, void, void>[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        logger: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Logger>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    telemetry: import("@bluelibs/runner/dist/defs").IResource<void, Promise<void>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    swapManager: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("./resources/swap.resource").SwapManager>, {
+        store: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        taskRunner: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").TaskRunner>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        introspector: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("./resources/introspector.resource").Introspector>, {
+            store: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+        eventManager: import("@bluelibs/runner/dist/defs").IResource<void, Promise<import("@bluelibs/runner").EventManager>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    }, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    graphql: import("@bluelibs/runner/dist/defs").IResource<void, Promise<{
+        getSchema: () => import("graphql").GraphQLSchema;
+    }>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+    dev: import("@bluelibs/runner/dist/defs").IResource<import("./resources/dev.resource").DevConfig, Promise<any>, {}, any, any, import("@bluelibs/runner/dist/defs").TagType[], import("@bluelibs/runner/dist/defs").ResourceMiddlewareAttachmentType[]>;
+};
+export { dev };

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dev = exports.resources = void 0;
+const server_resource_1 = require("./resources/server.resource");
+const introspector_resource_1 = require("./resources/introspector.resource");
+const live_resource_1 = require("./resources/live.resource");
+const telemetry_resource_1 = require("./resources/telemetry.resource");
+const swap_resource_1 = require("./resources/swap.resource");
+const graphql_accumulator_resource_1 = require("./resources/graphql-accumulator.resource");
+const dev_resource_1 = require("./resources/dev.resource");
+Object.defineProperty(exports, "dev", { enumerable: true, get: function () { return dev_resource_1.dev; } });
+Error.stackTraceLimit = Infinity;
+exports.resources = {
+    server: server_resource_1.serverResource,
+    introspector: introspector_resource_1.introspector,
+    live: live_resource_1.live,
+    telemetry: telemetry_resource_1.telemetry,
+    swapManager: swap_resource_1.swapManager,
+    graphql: graphql_accumulator_resource_1.graphql,
+    dev: dev_resource_1.dev,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,iEAA6D;AAC7D,6EAAiE;AACjE,6DAAiD;AACjD,uEAA2D;AAC3D,6DAAwD;AACxD,2FAAmE;AACnE,2DAA+C;AActC,oFAdA,kBAAG,OAcA;AAZZ,KAAK,CAAC,eAAe,GAAG,QAAQ,CAAC;AAEpB,QAAA,SAAS,GAAG;IACvB,MAAM,EAAE,gCAAc;IACtB,YAAY,EAAZ,oCAAY;IACZ,IAAI,EAAJ,oBAAI;IACJ,SAAS,EAAT,8BAAS;IACT,WAAW,EAAX,2BAAW;IACX,OAAO,EAAP,sCAAO;IACP,GAAG,EAAH,kBAAG;CACJ,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/main.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/mcp/env.d.ts

@@ -0,0 +1,5 @@
+export declare const ENDPOINT: string | undefined;
+export declare const ALLOW_MUTATIONS: boolean;
+export declare function parseHeadersFromEnv(): Record<string, string>;
+export declare function getEndpoint(): string | undefined;
+export declare function assertEndpoint(): string;

package/dist/mcp/env.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALLOW_MUTATIONS = exports.ENDPOINT = void 0;
+exports.parseHeadersFromEnv = parseHeadersFromEnv;
+exports.getEndpoint = getEndpoint;
+exports.assertEndpoint = assertEndpoint;
+exports.ENDPOINT = process.env.ENDPOINT || process.env.GRAPHQL_ENDPOINT;
+exports.ALLOW_MUTATIONS = (process.env.ALLOW_MUTATIONS || "").toLowerCase() === "true";
+function parseHeadersFromEnv() {
+    const headersEnv = process.env.HEADERS;
+    if (!headersEnv)
+        return {};
+    try {
+        const parsed = JSON.parse(headersEnv);
+        const result = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value === "string") {
+                result[key] = value;
+            }
+            else {
+                result[key] = JSON.stringify(value);
+            }
+        }
+        return result;
+    }
+    catch (e) {
+        // eslint-disable-next-line no-console
+        console.warn("HEADERS env var is not valid JSON. Ignoring. Error:", e);
+        return {};
+    }
+}
+function getEndpoint() {
+    return process.env.ENDPOINT || process.env.GRAPHQL_ENDPOINT;
+}
+function assertEndpoint() {
+    const endpoint = getEndpoint();
+    if (!endpoint) {
+        throw new Error("ENDPOINT env variable is required to use the GraphQL MCP server");
+    }
+    return endpoint;
+}
+//# sourceMappingURL=env.js.map

package/dist/mcp/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/mcp/env.ts"],"names":[],"mappings":";;;AAKA,kDAmBC;AAED,kCAEC;AAED,wCAQC;AAtCY,QAAA,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAEhE,QAAA,eAAe,GAC1B,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;AAE/D,SAAgB,mBAAmB;IACjC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAA4B,CAAC;QACjE,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,qDAAqD,EAAE,CAAC,CAAC,CAAC;QACvE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAgB,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAC9D,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/mcp/format.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Type guard to check if a value is a plain object (Record).
+ * @param value - The value to check
+ * @returns True if the value is a plain object, false otherwise
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard to check if a value is a scalar (primitive) type.
+ * @param value - The value to check
+ * @returns True if the value is a scalar type (string, number, boolean, null, or undefined)
+ */
+export declare function isScalar(value: unknown): value is string | number | boolean | null;
+/**
+ * Generates a preview string for an object by finding the first available scalar value.
+ * Prioritizes common identifier fields like 'id', 'name', 'title', etc.
+ * @param obj - The object to generate a preview for
+ * @returns A preview string in the format "key=value" or undefined if no scalar found
+ */
+export declare function getFirstScalarPreview(obj: Record<string, unknown>): string | undefined;
+/**
+ * Creates a concise preview string for any value type.
+ * @param value - The value to create a preview for
+ * @returns A short string representation of the value
+ */
+export declare function valuePreview(value: unknown): string;
+/**
+ * Formats GraphQL query/mutation results as readable Markdown.
+ *
+ * Features:
+ * - Handles data, errors, and extensions sections
+ * - Supports configurable depth traversal for nested objects
+ * - Two presentation styles: "summary" (structured) and "story" (narrative)
+ * - Intelligent truncation with maxItems limit
+ * - Enhanced error formatting with path and location information
+ * - Type-safe implementation with comprehensive error handling
+ *
+ * @param result - The GraphQL result object to format
+ * @param options - Formatting options
+ * @param options.title - Custom title for the output (default: "GraphQL Result")
+ * @param options.maxItems - Maximum items to show per level (default: 10)
+ * @param options.maxDepth - Maximum nesting depth to traverse (default: 3)
+ * @param options.style - Output style: "summary" or "story" (default: "summary")
+ * @returns Formatted Markdown string
+ */
+export declare function formatGraphQLResultAsMarkdown(result: unknown, options?: {
+    title?: string;
+    maxItems?: number;
+    maxDepth?: number;
+    style?: "summary" | "story";
+}): string;

package/dist/mcp/format.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecord = isRecord;
+exports.isScalar = isScalar;
+exports.getFirstScalarPreview = getFirstScalarPreview;
+exports.valuePreview = valuePreview;
+exports.formatGraphQLResultAsMarkdown = formatGraphQLResultAsMarkdown;
+/**
+ * Type guard to check if a value is a plain object (Record).
+ * @param value - The value to check
+ * @returns True if the value is a plain object, false otherwise
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Type guard to check if a value is a scalar (primitive) type.
+ * @param value - The value to check
+ * @returns True if the value is a scalar type (string, number, boolean, null, or undefined)
+ */
+function isScalar(value) {
+    const t = typeof value;
+    return value == null || t === "string" || t === "number" || t === "boolean";
+}
+/**
+ * Generates a preview string for an object by finding the first available scalar value.
+ * Prioritizes common identifier fields like 'id', 'name', 'title', etc.
+ * @param obj - The object to generate a preview for
+ * @returns A preview string in the format "key=value" or undefined if no scalar found
+ */
+function getFirstScalarPreview(obj) {
+    const preferredKeys = ["id", "name", "title", "eventId", "nodeId"];
+    for (const key of preferredKeys) {
+        if (key in obj && isScalar(obj[key])) {
+            return `${key}=${String(obj[key])}`;
+        }
+    }
+    for (const [k, v] of Object.entries(obj)) {
+        if (isScalar(v)) {
+            return `${k}=${String(v)}`;
+        }
+    }
+    return undefined;
+}
+/**
+ * Creates a concise preview string for any value type.
+ * @param value - The value to create a preview for
+ * @returns A short string representation of the value
+ */
+function valuePreview(value) {
+    if (isScalar(value))
+        return String(value);
+    if (Array.isArray(value))
+        return `Array(${value.length})`;
+    if (isRecord(value))
+        return "Object";
+    return typeof value;
+}
+/**
+ * Enhanced object formatting with depth control and better nested structure display.
+ * @param obj - The object to format
+ * @param currentDepth - Current nesting depth
+ * @param maxDepth - Maximum allowed nesting depth
+ * @param maxItems - Maximum number of items to display per level
+ * @param indent - Current indentation string
+ * @returns Array of formatted strings representing the object structure
+ */
+function formatObjectWithDepth(obj, currentDepth, maxDepth, maxItems, indent = "") {
+    const parts = [];
+    if (currentDepth >= maxDepth) {
+        const preview = getFirstScalarPreview(obj);
+        parts.push(`${indent}{${preview ? preview : "..."}}`);
+        return parts;
+    }
+    const entries = Object.entries(obj).slice(0, maxItems);
+    for (const [key, value] of entries) {
+        if (isScalar(value)) {
+            parts.push(`${indent}- ${key}: ${String(value)}`);
+        }
+        else if (Array.isArray(value)) {
+            parts.push(`${indent}- ${key}: Array(${value.length})`);
+            if (value.length > 0 && currentDepth < maxDepth - 1) {
+                const sampleItems = value.slice(0, Math.min(3, maxItems));
+                for (let i = 0; i < sampleItems.length; i++) {
+                    const item = sampleItems[i];
+                    if (isRecord(item)) {
+                        parts.push(`${indent}  [${i}]:`);
+                        parts.push(...formatObjectWithDepth(item, currentDepth + 1, maxDepth, maxItems, indent + "    "));
+                    }
+                    else {
+                        parts.push(`${indent}  [${i}]: ${valuePreview(item)}`);
+                    }
+                }
+                if (value.length > sampleItems.length) {
+                    parts.push(`${indent}  ... and ${value.length - sampleItems.length} more items`);
+                }
+            }
+        }
+        else if (isRecord(value)) {
+            parts.push(`${indent}- ${key}: Object`);
+            parts.push(...formatObjectWithDepth(value, currentDepth + 1, maxDepth, maxItems, indent + "  "));
+        }
+        else {
+            parts.push(`${indent}- ${key}: ${valuePreview(value)}`);
+        }
+    }
+    if (Object.keys(obj).length > entries.length) {
+        parts.push(`${indent}... and ${Object.keys(obj).length - entries.length} more properties`);
+    }
+    return parts;
+}
+/**
+ * Type guard to check if a value is a GraphQL error object.
+ * @param value - The value to check
+ * @returns True if the value conforms to GraphQL error structure
+ */
+function isGraphQLError(value) {
+    return isRecord(value) && typeof value.message === "string";
+}
+/**
+ * Formats a GraphQL error with enhanced information including path and location.
+ * @param error - The error to format
+ * @returns A formatted error message string
+ */
+function formatGraphQLError(error) {
+    if (isGraphQLError(error)) {
+        let msg = error.message;
+        if (error.path) {
+            msg += ` (at path: ${error.path.join(".")})`;
+        }
+        if (error.locations && error.locations.length > 0) {
+            const loc = error.locations[0];
+            msg += ` (line ${loc.line}, column ${loc.column})`;
+        }
+        return msg;
+    }
+    return valuePreview(error);
+}
+/**
+ * Formats GraphQL query/mutation results as readable Markdown.
+ *
+ * Features:
+ * - Handles data, errors, and extensions sections
+ * - Supports configurable depth traversal for nested objects
+ * - Two presentation styles: "summary" (structured) and "story" (narrative)
+ * - Intelligent truncation with maxItems limit
+ * - Enhanced error formatting with path and location information
+ * - Type-safe implementation with comprehensive error handling
+ *
+ * @param result - The GraphQL result object to format
+ * @param options - Formatting options
+ * @param options.title - Custom title for the output (default: "GraphQL Result")
+ * @param options.maxItems - Maximum items to show per level (default: 10)
+ * @param options.maxDepth - Maximum nesting depth to traverse (default: 3)
+ * @param options.style - Output style: "summary" or "story" (default: "summary")
+ * @returns Formatted Markdown string
+ */
+function formatGraphQLResultAsMarkdown(result, options) {
+    const title = options?.title || "GraphQL Result";
+    const maxItems = options?.maxItems ?? 10;
+    const maxDepth = options?.maxDepth ?? 3;
+    const style = options?.style || "summary";
+    const parts = [];
+    parts.push(`# ${title}`);
+    const res = (result ?? {});
+    const data = isRecord(res.data)
+        ? res.data
+        : undefined;
+    const errors = Array.isArray(res.errors) ? res.errors : [];
+    const extensions = isRecord(res.extensions)
+        ? res.extensions
+        : undefined;
+    if (errors.length) {
+        parts.push("\n## Errors");
+        for (const e of errors.slice(0, maxItems)) {
+            const msg = formatGraphQLError(e);
+            parts.push(`- ${msg}`);
+        }
+        if (errors.length > maxItems) {
+            parts.push(`- ... and ${errors.length - maxItems} more errors`);
+        }
+    }
+    if (!data) {
+        parts.push("\n_No data returned._");
+        return parts.join("\n");
+    }
+    const topKeys = Object.keys(data);
+    if (style === "story") {
+        const sentences = [];
+        sentences.push("I queried the server and received the following top-level fields:");
+        const facts = [];
+        for (const key of topKeys) {
+            const val = data[key];
+            if (Array.isArray(val)) {
+                facts.push(`${key} (${val.length} item${val.length === 1 ? "" : "s"})`);
+            }
+            else if (isRecord(val)) {
+                facts.push(`${key} (object)`);
+            }
+            else {
+                facts.push(`${key}=${valuePreview(val)}`);
+            }
+        }
+        sentences.push(facts.join(", ") + ".");
+        if (errors.length) {
+            sentences.push(`There were ${errors.length} error${errors.length === 1 ? "" : "s"} included above.`);
+        }
+        parts.push("\n" + sentences.join(" ") + "\n");
+    }
+    else {
+        parts.push("\n## Data Summary");
+        for (const key of topKeys) {
+            const val = data[key];
+            if (Array.isArray(val)) {
+                parts.push(`- ${key}: ${val.length} item${val.length === 1 ? "" : "s"}`);
+                if (val.length > 0) {
+                    const items = val.slice(0, maxItems);
+                    for (let i = 0; i < items.length; i++) {
+                        const item = items[i];
+                        if (isRecord(item)) {
+                            parts.push(`  [${i}]:`);
+                            parts.push(...formatObjectWithDepth(item, 1, maxDepth, maxItems, "    "));
+                        }
+                        else {
+                            parts.push(`  [${i}]: ${valuePreview(item)}`);
+                        }
+                    }
+                    if (val.length > items.length) {
+                        parts.push(`  ... and ${val.length - items.length} more items`);
+                    }
+                }
+            }
+            else if (isRecord(val)) {
+                parts.push(`- ${key}: Object`);
+                parts.push(...formatObjectWithDepth(val, 1, maxDepth, maxItems, "  "));
+            }
+            else {
+                parts.push(`- ${key}: ${valuePreview(val)}`);
+            }
+        }
+    }
+    // Add extensions if present
+    if (extensions && Object.keys(extensions).length > 0) {
+        parts.push("\n## Extensions");
+        parts.push(...formatObjectWithDepth(extensions, 1, maxDepth, maxItems, ""));
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/mcp/format.js.map

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

package/dist/mcp/help.d.ts

@@ -0,0 +1,20 @@
+export type HelpDoc = "readme" | "ai";
+export declare function readDocContent(doc: HelpDoc): Promise<{
+    doc: HelpDoc;
+    filePath: string;
+    content: string;
+}>;
+export declare function readPackageDoc(packageName: string, docPath?: string): Promise<{
+    packageName: string;
+    filePath: string;
+    content: string;
+}>;
+export declare function extractSectionByHeading(markdown: string, headingQuery: string): string;
+/**
+ * Extract multiple sections by heading queries (supports array of headings).
+ * @param markdown - The markdown content to search
+ * @param headingQueries - Array of heading queries to search for
+ * @returns Combined sections with separators
+ */
+export declare function extractSectionsByHeadings(markdown: string, headingQueries: string[]): string;
+export declare function buildTOC(markdown: string): string[];

package/dist/mcp/help.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDocContent = readDocContent;
+exports.readPackageDoc = readPackageDoc;
+exports.extractSectionByHeading = extractSectionByHeading;
+exports.extractSectionsByHeadings = extractSectionsByHeadings;
+exports.buildTOC = buildTOC;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const path_1 = require("../utils/path");
+async function readDocContent(doc) {
+    const root = process.cwd();
+    const fileName = doc === "readme" ? "README.md" : "AI.md";
+    const filePath = path.join(root, fileName);
+    const content = await fs_1.promises.readFile(filePath, "utf8").catch(() => "");
+    return { doc, filePath: (0, path_1.sanitizePath)(filePath) ?? filePath, content };
+}
+async function readPackageDoc(packageName, docPath = "README.md") {
+    const root = process.cwd();
+    const filePath = path.join(root, "node_modules", packageName, docPath);
+    const content = await fs_1.promises.readFile(filePath, "utf8").catch(() => "");
+    return { packageName, filePath: (0, path_1.sanitizePath)(filePath) ?? filePath, content };
+}
+function extractSectionByHeading(markdown, headingQuery) {
+    if (!markdown || !headingQuery)
+        return "";
+    const lines = markdown.split(/\r?\n/);
+    const normalizedQuery = headingQuery.trim().toLowerCase();
+    let startIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (/^#{1,6}\s+/.test(line)) {
+            const title = line
+                .replace(/^#{1,6}\s+/, "")
+                .trim()
+                .toLowerCase();
+            if (title.includes(normalizedQuery)) {
+                startIndex = i;
+                break;
+            }
+        }
+    }
+    if (startIndex === -1)
+        return "";
+    let endIndex = lines.length;
+    const startLevel = lines[startIndex].match(/^#+/)?.[0].length ?? 1;
+    for (let j = startIndex + 1; j < lines.length; j++) {
+        const l = lines[j];
+        const m = l.match(/^#{1,6}\s+/);
+        if (m && m[0].trim().length <= startLevel) {
+            endIndex = j;
+            break;
+        }
+    }
+    return lines.slice(startIndex, endIndex).join("\n");
+}
+/**
+ * Extract multiple sections by heading queries (supports array of headings).
+ * @param markdown - The markdown content to search
+ * @param headingQueries - Array of heading queries to search for
+ * @returns Combined sections with separators
+ */
+function extractSectionsByHeadings(markdown, headingQueries) {
+    if (!markdown || !headingQueries || headingQueries.length === 0)
+        return "";
+    const sections = [];
+    const foundHeadings = [];
+    for (const query of headingQueries) {
+        const section = extractSectionByHeading(markdown, query);
+        if (section) {
+            sections.push(section);
+            foundHeadings.push(query);
+        }
+    }
+    if (sections.length === 0) {
+        return `No sections found matching: ${headingQueries.join(", ")}`;
+    }
+    const header = foundHeadings.length === headingQueries.length
+        ? `Found all ${sections.length} requested sections:`
+        : `Found ${sections.length} of ${headingQueries.length} requested sections:`;
+    return (`${header} ${foundHeadings.join(", ")}\n\n` + sections.join("\n\n---\n\n"));
+}
+function buildTOC(markdown) {
+    if (!markdown)
+        return [];
+    const lines = markdown.split(/\r?\n/);
+    const toc = [];
+    for (const line of lines) {
+        const m = line.match(/^(#{1,6})\s+(.*)$/);
+        if (m) {
+            const level = m[1].length;
+            const title = m[2].trim();
+            toc.push(`${"  ".repeat(level - 1)}- ${title}`);
+        }
+    }
+    return toc;
+}
+//# sourceMappingURL=help.js.map

package/dist/mcp/help.js.map

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

package/dist/mcp/http.d.ts

@@ -0,0 +1,6 @@
+export declare function callGraphQL(params: {
+    query: string;
+    variables?: Record<string, unknown>;
+    operationName?: string;
+}): Promise<unknown>;
+export declare function toVariables(input: unknown): Record<string, unknown> | undefined;