@bluelibs/runner-dev 4.0.0

package/dist/mcp/http.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callGraphQL = callGraphQL;
+exports.toVariables = toVariables;
+const env_1 = require("./env");
+async function callGraphQL(params) {
+    const endpoint = (0, env_1.assertEndpoint)();
+    const headers = {
+        "content-type": "application/json",
+        ...(0, env_1.parseHeadersFromEnv)(),
+    };
+    const body = { query: params.query };
+    if (params.variables)
+        body.variables = params.variables;
+    if (params.operationName)
+        body.operationName = params.operationName;
+    const res = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`GraphQL HTTP error ${res.status}: ${text}`);
+    }
+    return (await res.json());
+}
+function toVariables(input) {
+    if (input == null)
+        return undefined;
+    if (typeof input === "string" && input.trim().length > 0) {
+        try {
+            const parsed = JSON.parse(input);
+            if (parsed && typeof parsed === "object") {
+                return parsed;
+            }
+        }
+        catch (e) {
+            throw new Error(`Failed to parse variables JSON: ${e.message}`);
+        }
+    }
+    if (typeof input === "object") {
+        return input;
+    }
+    return undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/mcp/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/mcp/http.ts"],"names":[],"mappings":";;AAEA,kCA0BC;AAED,kCAoBC;AAlDD,+BAA4D;AAErD,KAAK,UAAU,WAAW,CAAC,MAIjC;IACC,MAAM,QAAQ,GAAG,IAAA,oBAAc,GAAE,CAAC;IAClC,MAAM,OAAO,GAAG;QACd,cAAc,EAAE,kBAAkB;QAClC,GAAG,IAAA,yBAAmB,GAAE;KACzB,CAAC;IACF,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9D,IAAI,MAAM,CAAC,SAAS;QAAE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACxD,IAAI,MAAM,CAAC,aAAa;QAAE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAEpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;AACvC,CAAC;AAED,SAAgB,WAAW,CACzB,KAAc;IAEd,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzC,OAAO,MAAiC,CAAC;YAC3C,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,mCAAoC,CAAW,CAAC,OAAO,EAAE,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/mcp/projectOverview.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerProjectOverview(server: McpServer): void;

package/dist/mcp/projectOverview.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProjectOverview = registerProjectOverview;
+const zod_1 = require("zod");
+const env_1 = require("./env");
+const http_1 = require("./http");
+function safeString(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function asString(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
+}
+function formatSchemaBlock(title, schemaReadable) {
+    if (!schemaReadable || schemaReadable.trim().length === 0)
+        return [];
+    const lines = [];
+    lines.push(`  - ${title}:`);
+    lines.push("    ```");
+    lines.push(...schemaReadable.split("\n").map((l) => (l.length ? `    ${l}` : "    ")));
+    lines.push("    ```");
+    return lines;
+}
+function formatItem(params) {
+    const { id, meta, filePath, schemaReadable, schemaLabel, extra } = params;
+    const title = asString(meta?.title) || id;
+    const description = asString(meta?.description);
+    const out = [];
+    out.push(`- ${title} {${id}}`);
+    if (description)
+        out.push(`  - description: ${description}`);
+    if (filePath)
+        out.push(`  - file: ${filePath}`);
+    if (Array.isArray(extra) && extra.length)
+        out.push(...extra);
+    if (schemaReadable) {
+        out.push(...formatSchemaBlock(schemaLabel || "schema", schemaReadable || undefined));
+    }
+    return out.join("\n");
+}
+function registerProjectOverview(server) {
+    server.registerTool("project_overview", {
+        title: "Project Overview (Markdown)",
+        description: "Builds a dynamic Markdown overview by querying the GraphQL endpoint for tasks, resources, events, middleware, diagnostics and recent live telemetry.",
+        inputSchema: {
+            details: zod_1.z.number().int().min(1).max(100).optional(),
+            includeLive: zod_1.z.boolean().optional(),
+            last: zod_1.z.number().int().min(1).max(200).optional(),
+        },
+    }, async ({ details, includeLive, last }) => {
+        const endpoint = env_1.ENDPOINT ?? "<set ENDPOINT>";
+        const sampleSize = typeof details === "number" ? details : 10;
+        const liveLast = typeof last === "number" ? last : 20;
+        const query = `query Overview($liveLast: Int) {
+  tasks { id meta { title description } filePath inputSchemaReadable }
+  hooks { id meta { title description } event filePath inputSchemaReadable }
+  resources { id meta { title description } filePath configSchemaReadable }
+  middlewares { id meta { title description } filePath configSchemaReadable }
+  events { id meta { title description } filePath payloadSchemaReadable emittedBy listenedToBy }
+  diagnostics { severity code message nodeId nodeKind }
+  live { 
+    logs(last: $liveLast) { timestampMs level message correlationId }
+    emissions(last: $liveLast) { timestampMs eventId emitterId correlationId }
+    errors(last: $liveLast) { timestampMs sourceKind message correlationId }
+    runs(last: $liveLast) { timestampMs nodeId nodeKind ok correlationId }
+  }
+}`;
+        const result = (await (0, http_1.callGraphQL)({
+            query,
+            variables: { liveLast },
+        }));
+        const data = result?.data ?? {};
+        const tasks = Array.isArray(data.tasks) ? data.tasks : [];
+        const hooks = Array.isArray(data.hooks) ? data.hooks : [];
+        const resources = Array.isArray(data.resources) ? data.resources : [];
+        const middlewares = Array.isArray(data.middlewares)
+            ? data.middlewares
+            : [];
+        const events = Array.isArray(data.events) ? data.events : [];
+        const diagnostics = Array.isArray(data.diagnostics)
+            ? data.diagnostics
+            : [];
+        const live = data.live ?? {};
+        const diagBySeverity = {};
+        for (const d of diagnostics) {
+            const sev = String(d?.severity ?? "UNKNOWN");
+            diagBySeverity[sev] = (diagBySeverity[sev] ?? 0) + 1;
+        }
+        const lines = [];
+        lines.push(`# Runner Dev Project Overview`);
+        lines.push("");
+        lines.push(`Endpoint: ${endpoint}`);
+        lines.push("");
+        lines.push(`## Topology Summary`);
+        lines.push(`- Tasks: ${tasks.length}`);
+        lines.push(`- Hooks: ${hooks.length}`);
+        lines.push(`- Resources: ${resources.length}`);
+        lines.push(`- Middleware: ${middlewares.length}`);
+        lines.push(`- Events: ${events.length}`);
+        lines.push(`- Diagnostics: ${diagnostics.length}`);
+        if (Object.keys(diagBySeverity).length) {
+            const sevStr = Object.entries(diagBySeverity)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(", ");
+            lines.push(`  - By severity: ${sevStr}`);
+        }
+        lines.push("");
+        lines.push(`## Sample Nodes (first ${sampleSize})`);
+        if (tasks.length) {
+            lines.push(`### Tasks`);
+            for (const t of tasks.slice(0, sampleSize)) {
+                lines.push(formatItem({
+                    id: String(t.id),
+                    meta: t.meta,
+                    filePath: safeString(t.filePath),
+                    schemaReadable: asString(t.inputSchemaReadable),
+                    schemaLabel: "input schema",
+                }));
+            }
+            lines.push("");
+        }
+        if (hooks.length) {
+            lines.push(`### Hooks`);
+            for (const l of hooks.slice(0, sampleSize)) {
+                const extra = [];
+                if (l.event)
+                    extra.push(`  - event: ${String(l.event)}`);
+                lines.push(formatItem({
+                    id: String(l.id),
+                    meta: l.meta,
+                    filePath: safeString(l.filePath),
+                    schemaReadable: asString(l.inputSchemaReadable),
+                    schemaLabel: "input schema",
+                    extra,
+                }));
+            }
+            lines.push("");
+        }
+        if (resources.length) {
+            lines.push(`### Resources`);
+            for (const r of resources.slice(0, sampleSize)) {
+                lines.push(formatItem({
+                    id: String(r.id),
+                    meta: r.meta,
+                    filePath: safeString(r.filePath),
+                    schemaReadable: asString(r.configSchemaReadable),
+                    schemaLabel: "config schema",
+                }));
+            }
+            lines.push("");
+        }
+        if (middlewares.length) {
+            lines.push(`### Middleware`);
+            for (const m of middlewares.slice(0, sampleSize)) {
+                lines.push(formatItem({
+                    id: String(m.id),
+                    meta: m.meta,
+                    filePath: safeString(m.filePath),
+                    schemaReadable: asString(m.configSchemaReadable),
+                    schemaLabel: "config schema",
+                }));
+            }
+            lines.push("");
+        }
+        if (events.length) {
+            lines.push(`### Events`);
+            for (const e of events.slice(0, sampleSize)) {
+                const extra = [];
+                const emittedBy = Array.isArray(e.emittedBy) ? e.emittedBy.length : 0;
+                const listenedToBy = Array.isArray(e.listenedToBy)
+                    ? e.listenedToBy.length
+                    : 0;
+                extra.push(`  - relations: emittedBy=${emittedBy}, listenedToBy=${listenedToBy}`);
+                lines.push(formatItem({
+                    id: String(e.id),
+                    meta: e.meta,
+                    filePath: safeString(e.filePath),
+                    schemaReadable: asString(e.payloadSchemaReadable),
+                    schemaLabel: "payload schema",
+                    extra,
+                }));
+            }
+            lines.push("");
+        }
+        if (includeLive) {
+            const logs = Array.isArray(live.logs) ? live.logs : [];
+            const emissions = Array.isArray(live.emissions) ? live.emissions : [];
+            const errors = Array.isArray(live.errors) ? live.errors : [];
+            const runs = Array.isArray(live.runs) ? live.runs : [];
+            lines.push(`## Live (last ${liveLast})`);
+            lines.push(`- Logs: ${logs.length}`);
+            lines.push(`- Emissions: ${emissions.length}`);
+            lines.push(`- Errors: ${errors.length}`);
+            lines.push(`- Runs: ${runs.length}`);
+            lines.push("");
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+}
+//# sourceMappingURL=projectOverview.js.map

package/dist/mcp/projectOverview.js.map

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

package/dist/mcp/schema.d.ts

@@ -0,0 +1 @@
+export declare function fetchSchemaSDL(): Promise<string>;

package/dist/mcp/schema.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSchemaSDL = fetchSchemaSDL;
+const graphql_1 = require("graphql");
+const http_1 = require("./http");
+async function fetchSchemaSDL() {
+    const introspectionQuery = (0, graphql_1.getIntrospectionQuery)();
+    const result = (await (0, http_1.callGraphQL)({
+        query: introspectionQuery,
+    }));
+    if (!result || !result.data) {
+        throw new Error(`Introspection failed. Response: ${JSON.stringify(result ?? {}, null, 2)}`);
+    }
+    const schema = (0, graphql_1.buildClientSchema)(result.data);
+    return (0, graphql_1.printSchema)(schema);
+}
+//# sourceMappingURL=schema.js.map

package/dist/mcp/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/mcp/schema.ts"],"names":[],"mappings":";;AAQA,wCAcC;AAtBD,qCAKiB;AACjB,iCAAqC;AAE9B,KAAK,UAAU,cAAc;IAClC,MAAM,kBAAkB,GAAG,IAAA,+BAAqB,GAAE,CAAC;IACnD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAA,kBAAW,EAAC;QAChC,KAAK,EAAE,kBAAkB;KAC1B,CAAC,CAAgE,CAAC;IAEnE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,2BAAiB,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAA,qBAAW,EAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/mcp/tools/graphql.introspect.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGraphQLIntrospect(server: McpServer): void;

package/dist/mcp/tools/graphql.introspect.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGraphQLIntrospect = registerGraphQLIntrospect;
+const graphql_1 = require("graphql");
+const http_1 = require("../http");
+function registerGraphQLIntrospect(server) {
+    server.registerTool("graphql_introspect", {
+        title: "GraphQL Introspection",
+        description: "Fetch GraphQL schema via standard introspection query",
+        inputSchema: {},
+    }, async () => {
+        const introspectionQuery = (0, graphql_1.getIntrospectionQuery)();
+        const result = await (0, http_1.callGraphQL)({ query: introspectionQuery });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=graphql.introspect.js.map

package/dist/mcp/tools/graphql.introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.introspect.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.introspect.ts"],"names":[],"mappings":";;AAIA,8DAgBC;AAnBD,qCAAgD;AAChD,kCAAsC;AAEtC,SAAgB,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,uDAAuD;QACpE,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,kBAAkB,GAAG,IAAA,+BAAqB,GAAE,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAW,EAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAChE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/graphql.mutation.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGraphQLMutation(server: McpServer): void;

package/dist/mcp/tools/graphql.mutation.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGraphQLMutation = registerGraphQLMutation;
+const zod_1 = require("zod");
+const env_1 = require("../env");
+const http_1 = require("../http");
+const format_1 = require("../format");
+function registerGraphQLMutation(server) {
+    server.registerTool("graphql_mutation", {
+        title: "GraphQL Mutation",
+        description: "Execute a GraphQL mutation against the configured ENDPOINT. Requires ALLOW_MUTATIONS=true",
+        inputSchema: {
+            mutation: zod_1.z.string(),
+            variables: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.unknown())]).optional(),
+            operationName: zod_1.z.string().optional(),
+            format: zod_1.z.enum(["json", "markdown"]).optional(),
+            markdownStyle: zod_1.z.enum(["summary", "story"]).optional(),
+            maxItems: zod_1.z.number().int().min(1).max(100).optional(),
+            title: zod_1.z.string().optional(),
+        },
+    }, async ({ mutation, variables, operationName, format, markdownStyle, maxItems, title, }) => {
+        if (!env_1.ALLOW_MUTATIONS) {
+            throw new Error("Mutations are disabled. Set ALLOW_MUTATIONS=true to enable.");
+        }
+        const result = await (0, http_1.callGraphQL)({
+            query: mutation,
+            variables: (0, http_1.toVariables)(variables),
+            operationName,
+        });
+        if (format === "markdown") {
+            const md = (0, format_1.formatGraphQLResultAsMarkdown)(result, {
+                style: markdownStyle === "story" ? "story" : "summary",
+                maxItems: typeof maxItems === "number" ? maxItems : 10,
+                title: title || "GraphQL Mutation Result",
+            });
+            return { content: [{ type: "text", text: md }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=graphql.mutation.js.map

package/dist/mcp/tools/graphql.mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.mutation.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.mutation.ts"],"names":[],"mappings":";;AAMA,0DAiDC;AAvDD,6BAAwB;AAExB,gCAAyC;AACzC,kCAAmD;AACnD,sCAA0D;AAE1D,SAAgB,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,2FAA2F;QAC7F,WAAW,EAAE;YACX,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAClE,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC/C,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACrD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B;KACF,EACD,KAAK,EAAE,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,MAAM,EACN,aAAa,EACb,QAAQ,EACR,KAAK,GACN,EAAE,EAAE;QACH,IAAI,CAAC,qBAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAW,EAAC;YAC/B,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,IAAA,kBAAW,EAAC,SAAS,CAAC;YACjC,aAAa;SACd,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAG,IAAA,sCAA6B,EAAC,MAAM,EAAE;gBAC/C,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACtD,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACtD,KAAK,EAAE,KAAK,IAAI,yBAAyB;aAC1C,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/graphql.ping.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGraphQLPing(server: McpServer): void;

package/dist/mcp/tools/graphql.ping.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGraphQLPing = registerGraphQLPing;
+const http_1 = require("../http");
+const env_1 = require("../env");
+function registerGraphQLPing(server) {
+    server.registerTool("graphql_ping", {
+        title: "GraphQL Ping",
+        description: "Verify the GraphQL endpoint is reachable",
+        inputSchema: {},
+    }, async () => {
+        const result = await (0, http_1.callGraphQL)({ query: "query { __typename }" });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ ok: true, result, endpoint: (0, env_1.assertEndpoint)() }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=graphql.ping.js.map

package/dist/mcp/tools/graphql.ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.ping.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.ping.ts"],"names":[],"mappings":";;AAIA,kDAwBC;AA3BD,kCAAsC;AACtC,gCAAwC;AAExC,SAAgB,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAW,EAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAA,oBAAc,GAAE,EAAE,EAChD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/graphql.query.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGraphQLQuery(server: McpServer): void;

package/dist/mcp/tools/graphql.query.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGraphQLQuery = registerGraphQLQuery;
+const zod_1 = require("zod");
+const http_1 = require("../http");
+const format_1 = require("../format");
+function registerGraphQLQuery(server) {
+    server.registerTool("graphql_query", {
+        title: "GraphQL Query",
+        description: "Execute a GraphQL query against the configured ENDPOINT",
+        inputSchema: {
+            query: zod_1.z.string(),
+            variables: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.unknown())]).optional(),
+            operationName: zod_1.z.string().optional(),
+            format: zod_1.z.enum(["json", "markdown"]).optional(),
+            markdownStyle: zod_1.z.enum(["summary", "story"]).optional(),
+            maxItems: zod_1.z.number().int().min(1).max(100).optional(),
+            title: zod_1.z.string().optional(),
+        },
+    }, async ({ query, variables, operationName, format, markdownStyle, maxItems, title, }) => {
+        if (/\bmutation\b/i.test(query)) {
+            throw new Error("Use graphql.mutation tool for mutations");
+        }
+        const result = await (0, http_1.callGraphQL)({
+            query,
+            variables: (0, http_1.toVariables)(variables),
+            operationName,
+        });
+        if (format === "markdown") {
+            const md = (0, format_1.formatGraphQLResultAsMarkdown)(result, {
+                style: markdownStyle === "story" ? "story" : "summary",
+                maxItems: typeof maxItems === "number" ? maxItems : 10,
+                title: title || "GraphQL Query Result",
+            });
+            return { content: [{ type: "text", text: md }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=graphql.query.js.map

package/dist/mcp/tools/graphql.query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.query.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.query.ts"],"names":[],"mappings":";;AAKA,oDA8CC;AAnDD,6BAAwB;AAExB,kCAAmD;AACnD,sCAA0D;AAE1D,SAAgB,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE;YACX,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAClE,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC/C,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACrD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B;KACF,EACD,KAAK,EAAE,EACL,KAAK,EACL,SAAS,EACT,aAAa,EACb,MAAM,EACN,aAAa,EACb,QAAQ,EACR,KAAK,GACN,EAAE,EAAE;QACH,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAW,EAAC;YAC/B,KAAK;YACL,SAAS,EAAE,IAAA,kBAAW,EAAC,SAAS,CAAC;YACjC,aAAa;SACd,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAG,IAAA,sCAA6B,EAAC,MAAM,EAAE;gBAC/C,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACtD,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACtD,KAAK,EAAE,KAAK,IAAI,sBAAsB;aACvC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/graphql.schemaSdl.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGraphQLSchemaSDL(server: McpServer): void;

package/dist/mcp/tools/graphql.schemaSdl.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGraphQLSchemaSDL = registerGraphQLSchemaSDL;
+const schema_1 = require("../schema");
+function registerGraphQLSchemaSDL(server) {
+    server.registerTool("graphql_schema_sdl", {
+        title: "GraphQL Schema (SDL)",
+        description: "Return the GraphQL schema as SDL string (compact, fewer tokens than JSON introspection)",
+        inputSchema: {},
+    }, async () => {
+        const sdl = await (0, schema_1.fetchSchemaSDL)();
+        return { content: [{ type: "text", text: sdl }] };
+    });
+}
+//# sourceMappingURL=graphql.schemaSdl.js.map

package/dist/mcp/tools/graphql.schemaSdl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.schemaSdl.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.schemaSdl.ts"],"names":[],"mappings":";;AAGA,4DAcC;AAhBD,sCAA2C;AAE3C,SAAgB,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,yFAAyF;QAC3F,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,MAAM,IAAA,uBAAc,GAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/help.read.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerHelpRead(server: McpServer): void;

package/dist/mcp/tools/help.read.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHelpRead = registerHelpRead;
+const zod_1 = require("zod");
+const help_1 = require("../help");
+function registerHelpRead(server) {
+    server.registerTool("help_read", {
+        title: "Help Documentation",
+        description: "Read documentation: 'runner-dev' (this app's docs), 'runner' (framework docs), or custom package docs. Supports filtering by heading and TOC generation.",
+        inputSchema: {
+            doc: zod_1.z.enum(["runner-dev", "runner"]).optional(),
+            packageName: zod_1.z.string().optional(),
+            packageDocPath: zod_1.z.string().optional(),
+            headingIncludes: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
+            toc: zod_1.z.boolean().optional(),
+        },
+    }, async ({ doc, packageName, packageDocPath, headingIncludes, toc }) => {
+        let content = "";
+        let filePath = "";
+        if (packageName) {
+            const pkg = await (0, help_1.readPackageDoc)(packageName, packageDocPath || "README.md");
+            content = pkg.content;
+            filePath = pkg.filePath;
+        }
+        else if (doc === "runner") {
+            const pkg = await (0, help_1.readPackageDoc)("@bluelibs/runner", "README.md");
+            content = pkg.content;
+            filePath = pkg.filePath;
+        }
+        else {
+            const readmeRes = await (0, help_1.readDocContent)("readme");
+            const aiRes = await (0, help_1.readDocContent)("ai");
+            const sections = [];
+            if (readmeRes.content) {
+                sections.push(`# Runner-Dev Application\n\n${readmeRes.content}`);
+            }
+            if (aiRes.content) {
+                sections.push(`# AI Assistant Guide\n\n${aiRes.content}`);
+            }
+            content = sections.join("\n\n---\n\n");
+            filePath = `${readmeRes.filePath} + ${aiRes.filePath}`;
+        }
+        if (!content) {
+            return {
+                content: [
+                    { type: "text", text: `Document not found or empty: ${filePath}` },
+                ],
+            };
+        }
+        if (toc) {
+            const lines = [`# Table of Contents`, "", ...(0, help_1.buildTOC)(content)];
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        if (headingIncludes) {
+            const headingQueries = Array.isArray(headingIncludes)
+                ? headingIncludes
+                : [headingIncludes];
+            const validQueries = headingQueries.filter((q) => typeof q === "string" && q.trim().length > 0);
+            if (validQueries.length > 0) {
+                const section = (0, help_1.extractSectionsByHeadings)(content, validQueries);
+                return { content: [{ type: "text", text: section || "" }] };
+            }
+        }
+        return { content: [{ type: "text", text: content }] };
+    });
+}
+//# sourceMappingURL=help.read.js.map

package/dist/mcp/tools/help.read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.read.js","sourceRoot":"","sources":["../../../src/mcp/tools/help.read.ts"],"names":[],"mappings":";;AASA,4CA6EC;AAtFD,6BAAwB;AAExB,kCAKiB;AAEjB,SAAgB,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,0JAA0J;QAC5J,WAAW,EAAE;YACX,GAAG,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;YAChD,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,eAAe,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtE,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC5B;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,EAAE,EAAE,EAAE;QACnE,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAc,EAC9B,WAAW,EACX,cAAc,IAAI,WAAW,CAC9B,CAAC;YACF,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YACtB,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1B,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAc,EAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;YAClE,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YACtB,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,MAAM,IAAA,qBAAc,EAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,IAAA,qBAAc,EAAC,IAAI,CAAC,CAAC;YAEzC,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,QAAQ,CAAC,IAAI,CAAC,+BAA+B,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;YAED,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACvC,QAAQ,GAAG,GAAG,SAAS,CAAC,QAAQ,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,QAAQ,EAAE,EAAE;iBACnE;aACF,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,KAAK,GAAG,CAAC,qBAAqB,EAAE,EAAE,EAAE,GAAG,IAAA,eAAQ,EAAC,OAAO,CAAC,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;gBACnD,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YAEtB,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACpD,CAAC;YAEF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAA,gCAAyB,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/help.runner.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerHelpRunner(server: McpServer): void;

package/dist/mcp/tools/help.runner.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHelpRunner = registerHelpRunner;
+const zod_1 = require("zod");
+const help_1 = require("../help");
+function registerHelpRunner(server) {
+    server.registerTool("help_runner", {
+        title: "Runner Framework Documentation",
+        description: "Read the official @bluelibs/runner framework documentation. Use 'toc: true' for table of contents or 'headingIncludes' to filter sections.",
+        inputSchema: {
+            headingIncludes: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
+            toc: zod_1.z.boolean().optional(),
+        },
+    }, async ({ headingIncludes, toc }) => {
+        const pkg = await (0, help_1.readPackageDoc)("@bluelibs/runner", "AI.md");
+        let content = pkg.content;
+        if (!content) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Runner framework documentation not found: ${pkg.filePath}`,
+                    },
+                ],
+            };
+        }
+        if (toc) {
+            const lines = [
+                `# Runner Framework - Table of Contents`,
+                "",
+                ...(0, help_1.buildTOC)(content),
+            ];
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        if (headingIncludes) {
+            const headingQueries = Array.isArray(headingIncludes)
+                ? headingIncludes
+                : [headingIncludes];
+            const validQueries = headingQueries.filter((q) => typeof q === "string" && q.trim().length > 0);
+            if (validQueries.length > 0) {
+                const section = (0, help_1.extractSectionsByHeadings)(content, validQueries);
+                content = section || content;
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `# Runner Framework Documentation\n\n${content}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=help.runner.js.map