@caelo-cms/mcp-server 0.1.0 → 0.1.1

package/dist/chat-bridge.d.ts

@@ -0,0 +1,31 @@
+/**
+ * HTTP bridge — translates a `caelo_chat` MCP call into a single POST
+ * against the admin install's `/api/mcp/chat` endpoint. The endpoint
+ * dispatches `mcp.send_chat` (system-only op) which resolves the
+ * bearer to a Caelo actor and drives `runChatTurn`.
+ *
+ * 30-second client-side timeout — chat-runner turns longer than that
+ * are likely stuck (the runner has its own provider-call timeouts).
+ * MCP clients see a clean error instead of a hung connection.
+ */
+export interface SendChatOpts {
+    readonly adminUrl: string;
+    readonly token: string;
+    readonly message: string;
+    readonly chatSessionId?: string;
+    readonly pageId?: string;
+}
+export interface SendChatResult {
+    readonly chatSessionId: string;
+    readonly requestId: string;
+    readonly assistant: string;
+    readonly toolCalls: ReadonlyArray<{
+        name: string;
+        summary: string;
+        succeeded: boolean;
+    }>;
+    readonly pendingProposals: number;
+    readonly costMicrocents: number;
+}
+export declare function sendChat(opts: SendChatOpts): Promise<SendChatResult>;
+//# sourceMappingURL=chat-bridge.d.ts.map

package/dist/chat-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-bridge.d.ts","sourceRoot":"","sources":["../src/chat-bridge.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAID,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAgC1E"}

package/dist/chat-bridge.js

@@ -0,0 +1,46 @@
+// SPDX-License-Identifier: MPL-2.0
+const TIMEOUT_MS = 30_000;
+export async function sendChat(opts) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        const url = `${opts.adminUrl.replace(/\/+$/, "")}/api/mcp/chat`;
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                "x-caelo-mcp-token": opts.token,
+            },
+            body: JSON.stringify({
+                message: opts.message,
+                chatSessionId: opts.chatSessionId,
+                pageId: opts.pageId,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const body = await safeText(res);
+            throw new Error(`HTTP ${res.status}: ${body || res.statusText}`);
+        }
+        const json = (await res.json());
+        return json;
+    }
+    catch (e) {
+        if (e instanceof Error && e.name === "AbortError") {
+            throw new Error(`timeout after ${TIMEOUT_MS / 1000}s`);
+        }
+        throw e;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function safeText(res) {
+    try {
+        return (await res.text()).slice(0, 500);
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=chat-bridge.js.map

package/dist/chat-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-bridge.js","sourceRoot":"","sources":["../src/chat-bridge.ts"],"names":[],"mappings":"AAAA,mCAAmC;AA8BnC,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB;IAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,mBAAmB,EAAE,IAAI,CAAC,KAAK;aAChC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;YACF,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,iBAAiB,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+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/{src/index.ts → dist/index.js}

@@ -1,6 +1,5 @@
 #!/usr/bin/env bun
 // SPDX-License-Identifier: MPL-2.0
-
 /**
  * @caelo-cms/mcp-server — entrypoint.
  *
@@ -15,19 +14,16 @@
  * database directly — it just translates between MCP semantics and
  * the admin's HTTP surface.
  */
-
 import { startMcpServer } from "./server.js";
-
 const adminUrl = process.env["CAELO_ADMIN_URL"];
 const token = process.env["CAELO_MCP_TOKEN"];
-
 if (!adminUrl) {
-  console.error("CAELO_ADMIN_URL not set — point me at your admin install (e.g. https://admin.example.com)");
-  process.exit(2);
+    console.error("CAELO_ADMIN_URL not set — point me at your admin install (e.g. https://admin.example.com)");
+    process.exit(2);
 }
 if (!token) {
-  console.error("CAELO_MCP_TOKEN not set — mint one at /security/mcp on your admin install");
-  process.exit(2);
+    console.error("CAELO_MCP_TOKEN not set — mint one at /security/mcp on your admin install");
+    process.exit(2);
 }
-
 await startMcpServer({ adminUrl, token });
+//# 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,mCAAmC;AAEnC;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;IACd,OAAO,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;IAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+export interface StartOpts {
+    readonly adminUrl: string;
+    readonly token: string;
+}
+export declare function startMcpServer(opts: StartOpts): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAUD,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGnE"}

package/dist/server.js

@@ -0,0 +1,112 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * MCP server construction. Registers exactly one tool — `caelo_chat` —
+ * and binds it to a stdio transport. The single-tool design is
+ * deliberate: the remote agent talks to Caelo's chat-runner the same
+ * way a human in the browser does. Browse / publish / propose actions
+ * happen through the chat ("which pages exist?" → agent calls
+ * pages.list internally → text response). Same auth surface, same
+ * actor scope, same audit trail.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { sendChat } from "./chat-bridge.js";
+const caeloChatInputSchema = z
+    .object({
+    message: z.string().min(1).max(50_000),
+    chatSessionId: z.string().uuid().optional(),
+    pageId: z.string().uuid().optional(),
+})
+    .strict();
+export async function startMcpServer(opts) {
+    const server = new Server({
+        name: "caelo-mcp-server",
+        version: "0.1.0",
+    }, {
+        capabilities: { tools: {} },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "caelo_chat",
+                description: "Talk to your Caelo CMS install's AI agent. Same agent that powers the live-edit chat overlay — it can read pages, propose edits, queue Owner-approval proposals, summarise plugin data. Continues an existing chat session (when chatSessionId is supplied) or starts a fresh one. Returns the agent's reply text plus structured tool-call summaries.",
+                inputSchema: {
+                    type: "object",
+                    required: ["message"],
+                    properties: {
+                        message: {
+                            type: "string",
+                            description: "What you want to say to the Caelo agent.",
+                        },
+                        chatSessionId: {
+                            type: "string",
+                            description: "Optional. Chat session UUID to continue. Omit to start a fresh page-unbound chat.",
+                        },
+                        pageId: {
+                            type: "string",
+                            description: "Optional. Bind a NEW chat to one page so the agent's page-context block is populated. Same shape as /edit?page=<id>.",
+                        },
+                    },
+                },
+            },
+        ],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        if (req.params.name !== "caelo_chat") {
+            return {
+                isError: true,
+                content: [
+                    { type: "text", text: `unknown tool: ${req.params.name}` },
+                ],
+            };
+        }
+        const parsed = caeloChatInputSchema.safeParse(req.params.arguments ?? {});
+        if (!parsed.success) {
+            return {
+                isError: true,
+                content: [
+                    { type: "text", text: `invalid arguments: ${parsed.error.message}` },
+                ],
+            };
+        }
+        try {
+            const result = await sendChat({
+                adminUrl: opts.adminUrl,
+                token: opts.token,
+                message: parsed.data.message,
+                ...(parsed.data.chatSessionId ? { chatSessionId: parsed.data.chatSessionId } : {}),
+                ...(parsed.data.pageId ? { pageId: parsed.data.pageId } : {}),
+            });
+            // Two content blocks: human-readable assistant text + a JSON
+            // structured block the calling agent can parse for the
+            // requestId, tool calls, cost, pending proposals.
+            return {
+                content: [
+                    { type: "text", text: result.assistant },
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            chatSessionId: result.chatSessionId,
+                            requestId: result.requestId,
+                            toolCalls: result.toolCalls,
+                            pendingProposals: result.pendingProposals,
+                            costMicrocents: result.costMicrocents,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                isError: true,
+                content: [{ type: "text", text: `caelo_chat failed: ${msg}` }],
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -1,23 +1,37 @@
 {
   "name": "@caelo-cms/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "license": "MPL-2.0",
   "description": "MCP server exposing the Caelo CMS chat-runner as a `caelo_chat` tool. Lets Claude Code (or any MCP-aware client) drive a Caelo install from outside the browser.",
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "bin": {
-    "caelo-mcp-server": "./src/index.ts"
+    "caelo-mcp-server": "./dist/index.js"
   },
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
+  "files": [
+    "dist/",
+    "README.md",
+    "package.json"
+  ],
   "scripts": {
-    "typecheck": "tsc -b"
+    "typecheck": "tsc -b",
+    "build": "tsc -b --force",
+    "prepublishOnly": "tsc -b --force"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
     "zod": "4.3.6"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/src/chat-bridge.ts

@@ -1,73 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-
-/**
- * HTTP bridge — translates a `caelo_chat` MCP call into a single POST
- * against the admin install's `/api/mcp/chat` endpoint. The endpoint
- * dispatches `mcp.send_chat` (system-only op) which resolves the
- * bearer to a Caelo actor and drives `runChatTurn`.
- *
- * 30-second client-side timeout — chat-runner turns longer than that
- * are likely stuck (the runner has its own provider-call timeouts).
- * MCP clients see a clean error instead of a hung connection.
- */
-
-export interface SendChatOpts {
-  readonly adminUrl: string;
-  readonly token: string;
-  readonly message: string;
-  readonly chatSessionId?: string;
-  readonly pageId?: string;
-}
-
-export interface SendChatResult {
-  readonly chatSessionId: string;
-  readonly requestId: string;
-  readonly assistant: string;
-  readonly toolCalls: ReadonlyArray<{ name: string; summary: string; succeeded: boolean }>;
-  readonly pendingProposals: number;
-  readonly costMicrocents: number;
-}
-
-const TIMEOUT_MS = 30_000;
-
-export async function sendChat(opts: SendChatOpts): Promise<SendChatResult> {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
-  try {
-    const url = `${opts.adminUrl.replace(/\/+$/, "")}/api/mcp/chat`;
-    const res = await fetch(url, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        "x-caelo-mcp-token": opts.token,
-      },
-      body: JSON.stringify({
-        message: opts.message,
-        chatSessionId: opts.chatSessionId,
-        pageId: opts.pageId,
-      }),
-      signal: controller.signal,
-    });
-    if (!res.ok) {
-      const body = await safeText(res);
-      throw new Error(`HTTP ${res.status}: ${body || res.statusText}`);
-    }
-    const json = (await res.json()) as SendChatResult;
-    return json;
-  } catch (e) {
-    if (e instanceof Error && e.name === "AbortError") {
-      throw new Error(`timeout after ${TIMEOUT_MS / 1000}s`);
-    }
-    throw e;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-async function safeText(res: Response): Promise<string> {
-  try {
-    return (await res.text()).slice(0, 500);
-  } catch {
-    return "";
-  }
-}

package/src/server.ts

@@ -1,135 +0,0 @@
-// SPDX-License-Identifier: MPL-2.0
-
-/**
- * MCP server construction. Registers exactly one tool — `caelo_chat` —
- * and binds it to a stdio transport. The single-tool design is
- * deliberate: the remote agent talks to Caelo's chat-runner the same
- * way a human in the browser does. Browse / publish / propose actions
- * happen through the chat ("which pages exist?" → agent calls
- * pages.list internally → text response). Same auth surface, same
- * actor scope, same audit trail.
- */
-
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-import { z } from "zod";
-import { sendChat } from "./chat-bridge.js";
-
-export interface StartOpts {
-  readonly adminUrl: string;
-  readonly token: string;
-}
-
-const caeloChatInputSchema = z
-  .object({
-    message: z.string().min(1).max(50_000),
-    chatSessionId: z.string().uuid().optional(),
-    pageId: z.string().uuid().optional(),
-  })
-  .strict();
-
-export async function startMcpServer(opts: StartOpts): Promise<void> {
-  const server = new Server(
-    {
-      name: "caelo-mcp-server",
-      version: "0.1.0",
-    },
-    {
-      capabilities: { tools: {} },
-    },
-  );
-
-  server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: [
-      {
-        name: "caelo_chat",
-        description:
-          "Talk to your Caelo CMS install's AI agent. Same agent that powers the live-edit chat overlay — it can read pages, propose edits, queue Owner-approval proposals, summarise plugin data. Continues an existing chat session (when chatSessionId is supplied) or starts a fresh one. Returns the agent's reply text plus structured tool-call summaries.",
-        inputSchema: {
-          type: "object",
-          required: ["message"],
-          properties: {
-            message: {
-              type: "string",
-              description: "What you want to say to the Caelo agent.",
-            },
-            chatSessionId: {
-              type: "string",
-              description:
-                "Optional. Chat session UUID to continue. Omit to start a fresh page-unbound chat.",
-            },
-            pageId: {
-              type: "string",
-              description:
-                "Optional. Bind a NEW chat to one page so the agent's page-context block is populated. Same shape as /edit?page=<id>.",
-            },
-          },
-        },
-      },
-    ],
-  }));
-
-  server.setRequestHandler(CallToolRequestSchema, async (req) => {
-    if (req.params.name !== "caelo_chat") {
-      return {
-        isError: true,
-        content: [
-          { type: "text", text: `unknown tool: ${req.params.name}` },
-        ],
-      };
-    }
-    const parsed = caeloChatInputSchema.safeParse(req.params.arguments ?? {});
-    if (!parsed.success) {
-      return {
-        isError: true,
-        content: [
-          { type: "text", text: `invalid arguments: ${parsed.error.message}` },
-        ],
-      };
-    }
-    try {
-      const result = await sendChat({
-        adminUrl: opts.adminUrl,
-        token: opts.token,
-        message: parsed.data.message,
-        ...(parsed.data.chatSessionId ? { chatSessionId: parsed.data.chatSessionId } : {}),
-        ...(parsed.data.pageId ? { pageId: parsed.data.pageId } : {}),
-      });
-      // Two content blocks: human-readable assistant text + a JSON
-      // structured block the calling agent can parse for the
-      // requestId, tool calls, cost, pending proposals.
-      return {
-        content: [
-          { type: "text", text: result.assistant },
-          {
-            type: "text",
-            text: JSON.stringify(
-              {
-                chatSessionId: result.chatSessionId,
-                requestId: result.requestId,
-                toolCalls: result.toolCalls,
-                pendingProposals: result.pendingProposals,
-                costMicrocents: result.costMicrocents,
-              },
-              null,
-              2,
-            ),
-          },
-        ],
-      };
-    } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
-      return {
-        isError: true,
-        content: [{ type: "text", text: `caelo_chat failed: ${msg}` }],
-      };
-    }
-  });
-
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}

package/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "./src",
-    "outDir": "./dist",
-    "noEmit": false
-  },
-  "include": ["src/**/*"],
-  "exclude": ["**/*.test.ts", "**/dist", "**/node_modules"]
-}