mcpico 0.1.0

package/dist/discoverer.test.js.map

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

package/dist/grouper.d.ts

@@ -0,0 +1,22 @@
+import type { GroupOverrides } from "./config.js";
+import type { UpstreamTool } from "./discoverer.js";
+/**
+ * A group of related tools from an upstream server.
+ */
+export interface ToolGroup {
+    /** Group name (e.g., "filesystem") */
+    groupName: string;
+    /** Source server name */
+    serverName: string;
+    /** Tools in this group */
+    tools: UpstreamTool[];
+}
+/**
+ * Group tools from an upstream server by prefix.
+ *
+ * Strategy:
+ * 1. If explicit group overrides exist, apply them first.
+ * 2. For remaining tools, extract prefix using separator.
+ * 3. Tools without a prefix go into the server's default group.
+ */
+export declare function groupTools(serverName: string, tools: UpstreamTool[], separator?: string, overrides?: GroupOverrides): ToolGroup[];

package/dist/grouper.js

@@ -0,0 +1,70 @@
+/**
+ * Extract the prefix from a tool name using the given separator.
+ * Returns null if no prefix detected.
+ */
+function extractPrefix(toolName, separator) {
+    const idx = toolName.indexOf(separator);
+    if (idx <= 0)
+        return null;
+    const prefix = toolName.slice(0, idx);
+    // Must have a non-empty suffix too
+    if (idx >= toolName.length - 1)
+        return null;
+    return prefix;
+}
+/**
+ * Group tools from an upstream server by prefix.
+ *
+ * Strategy:
+ * 1. If explicit group overrides exist, apply them first.
+ * 2. For remaining tools, extract prefix using separator.
+ * 3. Tools without a prefix go into the server's default group.
+ */
+export function groupTools(serverName, tools, separator = "_", overrides) {
+    const groups = new Map();
+    const ungrouped = [];
+    // Build override lookup: toolName → forcedGroupName
+    const overrideMap = new Map();
+    if (overrides) {
+        for (const [group, toolNames] of Object.entries(overrides)) {
+            for (const tn of toolNames) {
+                overrideMap.set(tn, group);
+            }
+        }
+    }
+    for (const tool of tools) {
+        // Check explicit override
+        const forcedGroup = overrideMap.get(tool.name);
+        if (forcedGroup) {
+            const existing = groups.get(forcedGroup) || [];
+            existing.push(tool);
+            groups.set(forcedGroup, existing);
+            continue;
+        }
+        // Try prefix extraction
+        const prefix = extractPrefix(tool.name, separator);
+        if (prefix) {
+            const existing = groups.get(prefix) || [];
+            existing.push(tool);
+            groups.set(prefix, existing);
+        }
+        else {
+            ungrouped.push(tool);
+        }
+    }
+    // Tools without a prefix or override go into their own group per server
+    const result = [];
+    for (const [groupName, groupTools] of groups) {
+        result.push({ groupName, serverName, tools: groupTools });
+    }
+    if (ungrouped.length > 0) {
+        // Put ungrouped tools in a group named after the server
+        result.push({
+            groupName: serverName,
+            serverName,
+            tools: ungrouped,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=grouper.js.map

package/dist/grouper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouper.js","sourceRoot":"","sources":["../src/grouper.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,SAAS,aAAa,CACpB,QAAgB,EAChB,SAAiB;IAEjB,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtC,mCAAmC;IACnC,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,UAAkB,EAClB,KAAqB,EACrB,YAAoB,GAAG,EACvB,SAA0B;IAE1B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,oDAAoD;IACpD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3D,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;gBAC3B,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,0BAA0B;QAC1B,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,wDAAwD;QACxD,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,UAAU;YACrB,UAAU;YACV,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/grouper.test.d.ts

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

package/dist/grouper.test.js

@@ -0,0 +1,169 @@
+import { describe, it, expect } from "vitest";
+import { groupTools } from "./grouper.js";
+function makeTool(name, description) {
+    return { name, description, inputSchema: {} };
+}
+function groupNames(groups) {
+    return groups.map((g) => g.groupName);
+}
+function toolNames(group) {
+    return group.tools.map((t) => t.name);
+}
+describe("groupTools", () => {
+    describe("prefix-based grouping", () => {
+        it("groups tools by underscore prefix", () => {
+            const tools = [
+                makeTool("filesystem_read_file"),
+                makeTool("filesystem_write_file"),
+                makeTool("filesystem_list_dir"),
+            ];
+            const groups = groupTools("test-server", tools);
+            expect(groups).toHaveLength(1);
+            expect(groups[0].groupName).toBe("filesystem");
+            expect(toolNames(groups[0])).toEqual([
+                "filesystem_read_file",
+                "filesystem_write_file",
+                "filesystem_list_dir",
+            ]);
+        });
+        it("groups tools with different prefixes into separate groups", () => {
+            const tools = [
+                makeTool("fs_read"),
+                makeTool("fs_write"),
+                makeTool("db_query"),
+                makeTool("db_insert"),
+            ];
+            const groups = groupTools("test-server", tools);
+            expect(groups).toHaveLength(2);
+            expect(groupNames(groups)).toEqual(expect.arrayContaining(["fs", "db"]));
+        });
+        it("uses custom separator", () => {
+            const tools = [
+                makeTool("github.create_issue"),
+                makeTool("github.list_repos"),
+            ];
+            const groups = groupTools("test-server", tools, ".");
+            expect(groups).toHaveLength(1);
+            expect(groups[0].groupName).toBe("github");
+        });
+        it("puts tools without prefix into server-named group", () => {
+            const tools = [
+                makeTool("read"),
+                makeTool("write"),
+                makeTool("filesystem_list"),
+            ];
+            const groups = groupTools("my-server", tools);
+            const defaultGroup = groups.find((g) => g.groupName === "my-server");
+            expect(defaultGroup).toBeDefined();
+            expect(toolNames(defaultGroup)).toEqual(["read", "write"]);
+        });
+        it("handles mixed prefixed and unprefixed tools", () => {
+            const tools = [
+                makeTool("help"),
+                makeTool("status"),
+                makeTool("fs_read"),
+            ];
+            const groups = groupTools("test-server", tools);
+            expect(groups).toHaveLength(2);
+            const fsGroup = groups.find((g) => g.groupName === "fs");
+            const defaultGroup = groups.find((g) => g.groupName === "test-server");
+            expect(fsGroup).toBeDefined();
+            expect(defaultGroup).toBeDefined();
+            expect(toolNames(defaultGroup)).toEqual(["help", "status"]);
+        });
+    });
+    describe("explicit overrides", () => {
+        it("applies group overrides", () => {
+            const tools = [
+                makeTool("custom_tool_a"),
+                makeTool("custom_tool_b"),
+            ];
+            const groups = groupTools("test-server", tools, "_", {
+                my_group: ["custom_tool_a", "custom_tool_b"],
+            });
+            expect(groups).toHaveLength(1);
+            expect(groups[0].groupName).toBe("my_group");
+            expect(toolNames(groups[0])).toEqual([
+                "custom_tool_a",
+                "custom_tool_b",
+            ]);
+        });
+        it("mixes overrides with prefix-based grouping", () => {
+            const tools = [
+                makeTool("special_tool"),
+                makeTool("fs_read"),
+                makeTool("fs_write"),
+            ];
+            const groups = groupTools("test-server", tools, "_", {
+                special: ["special_tool"],
+            });
+            expect(groups).toHaveLength(2);
+            const specialGroup = groups.find((g) => g.groupName === "special");
+            const fsGroup = groups.find((g) => g.groupName === "fs");
+            expect(specialGroup).toBeDefined();
+            expect(fsGroup).toBeDefined();
+            expect(toolNames(specialGroup)).toEqual(["special_tool"]);
+        });
+        it("overridden tools are removed from prefix groups", () => {
+            // "special_fs_read" would normally go in "special" prefix group,
+            // but override puts it in "custom" instead
+            const tools = [
+                makeTool("special_fs_read"),
+                makeTool("special_fs_write"),
+            ];
+            const groups = groupTools("test-server", tools, "_", {
+                custom: ["special_fs_read"],
+            });
+            const customGroup = groups.find((g) => g.groupName === "custom");
+            const specialGroup = groups.find((g) => g.groupName === "special");
+            expect(customGroup).toBeDefined();
+            expect(specialGroup).toBeDefined();
+            expect(toolNames(customGroup)).toEqual(["special_fs_read"]);
+            expect(toolNames(specialGroup)).toEqual(["special_fs_write"]);
+        });
+    });
+    describe("edge cases", () => {
+        it("returns empty array for no tools", () => {
+            const groups = groupTools("test-server", []);
+            expect(groups).toEqual([]);
+        });
+        it("handles tools with separator at start (no prefix)", () => {
+            const tools = [makeTool("_read")];
+            const groups = groupTools("test-server", tools);
+            // Prefix index is 0, which is <= 0, so no prefix
+            expect(groups).toHaveLength(1);
+            expect(groups[0].groupName).toBe("test-server");
+        });
+        it("handles tools with separator at end (no suffix)", () => {
+            const tools = [makeTool("read_")];
+            const groups = groupTools("test-server", tools);
+            // Separator index is at last char, so no valid suffix
+            expect(groups).toHaveLength(1);
+            expect(groups[0].groupName).toBe("test-server");
+        });
+        it("sets serverName on all groups", () => {
+            const tools = [
+                makeTool("fs_read"),
+                makeTool("unprefixed"),
+            ];
+            const groups = groupTools("my-server", tools);
+            for (const g of groups) {
+                expect(g.serverName).toBe("my-server");
+            }
+        });
+        it("handles multiple separators in tool name (takes first)", () => {
+            const tools = [makeTool("prefix_sub_sub")];
+            const groups = groupTools("test-server", tools);
+            expect(groups).toHaveLength(1);
+            expect(groups[0].groupName).toBe("prefix");
+        });
+        it("groups single-tool prefix correctly", () => {
+            const tools = [makeTool("solo_tool")];
+            const groups = groupTools("test-server", tools);
+            expect(groups).toHaveLength(1);
+            expect(groups[0].groupName).toBe("solo");
+            expect(groups[0].tools).toHaveLength(1);
+        });
+    });
+});
+//# sourceMappingURL=grouper.test.js.map

package/dist/grouper.test.js.map

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

package/dist/help.d.ts

@@ -0,0 +1,5 @@
+import type { ToolGroup } from "./grouper.js";
+/**
+ * Generate a complete help text for a tool group.
+ */
+export declare function generateHelpText(group: ToolGroup): string;

package/dist/help.js

@@ -0,0 +1,115 @@
+/**
+ * Generate a human-readable property description from a JSON Schema property definition.
+ */
+function describeProperty(name, schema) {
+    const type = schema.type || "any";
+    const description = schema.description ? ` — ${schema.description}` : "";
+    const isRequired = schema._required ? " (required)" : " (optional)";
+    return `\`${name}\` (${type}${isRequired})${description}`;
+}
+/**
+ * Extract property definitions from a JSON Schema object.
+ * Handles both flat and nested properties structures.
+ */
+function extractProperties(inputSchema) {
+    const properties = inputSchema.properties;
+    if (!properties)
+        return [];
+    const required = inputSchema.required || [];
+    return Object.entries(properties).map(([name, schema]) => ({
+        name,
+        schema: { ...schema, _required: required.includes(name) },
+    }));
+}
+/**
+ * Generate a human-readable type string from a JSON Schema type.
+ */
+function schemaType(schema) {
+    const t = schema.type;
+    if (Array.isArray(t))
+        return t.join(" | ");
+    if (typeof t === "string")
+        return t;
+    return "any";
+}
+/**
+ * Generate an example value for a property based on its schema type.
+ */
+function exampleValue(name, schema) {
+    const t = schemaType(schema);
+    if (t === "number" || t === "integer")
+        return "42";
+    if (t === "boolean")
+        return "true";
+    // For strings, use the property name as a hint
+    const lower = name.toLowerCase();
+    if (lower.includes("path"))
+        return '"/tmp/example.txt"';
+    if (lower.includes("name"))
+        return '"example-name"';
+    if (lower.includes("id"))
+        return '"abc-123"';
+    if (lower.includes("url") || lower.includes("uri"))
+        return '"https://example.com"';
+    if (lower.includes("content") || lower.includes("text"))
+        return '"Hello, world!"';
+    if (lower.includes("query") || lower.includes("search"))
+        return '"search terms"';
+    return '"value"';
+}
+/**
+ * Generate an example command string for a tool.
+ */
+function generateExample(tool) {
+    const props = extractProperties(tool.inputSchema);
+    if (props.length === 0)
+        return tool.name;
+    const required = props.filter((p) => p.schema._required);
+    const args = {};
+    for (const p of required.slice(0, 3)) {
+        args[p.name] = exampleValue(p.name, p.schema);
+    }
+    const argsStr = JSON.stringify(args);
+    // Keep examples compact
+    if (argsStr.length < 80) {
+        return `${tool.name} ${argsStr}`;
+    }
+    return tool.name;
+}
+/**
+ * Generate a complete help text for a tool group.
+ */
+export function generateHelpText(group) {
+    const lines = [];
+    lines.push(`⚡ MCPico — ${group.groupName}`);
+    lines.push("");
+    lines.push(`Source: ${group.serverName} (${group.tools.length} tool${group.tools.length === 1 ? "" : "s"})`);
+    lines.push("");
+    lines.push("Usage:  <subcommand> {" + '"}key{"}": {"}value{"}' + "}");
+    lines.push("        Send just 'help' to see this reference again.");
+    lines.push("");
+    lines.push("─".repeat(50));
+    lines.push("");
+    for (const tool of group.tools) {
+        lines.push(`  ${tool.name}`);
+        if (tool.description) {
+            lines.push(`    ${tool.description}`);
+        }
+        lines.push("");
+        const props = extractProperties(tool.inputSchema);
+        if (props.length > 0) {
+            lines.push("    Parameters:");
+            for (const p of props) {
+                lines.push(`      ${describeProperty(p.name, p.schema)}`);
+            }
+            lines.push("");
+        }
+        const example = generateExample(tool);
+        lines.push(`    Example: ${example}`);
+        lines.push("");
+    }
+    lines.push("─".repeat(50));
+    lines.push("Generated by MCPico — auto-updates when upstream tools change.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

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

package/dist/help.test.d.ts

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

package/dist/help.test.js

@@ -0,0 +1,173 @@
+import { describe, it, expect } from "vitest";
+import { generateHelpText } from "./help.js";
+function makeTool(overrides = {}) {
+    return {
+        name: "test_tool",
+        description: "A test tool",
+        inputSchema: {
+            type: "object",
+            properties: {
+                param1: { type: "string", description: "First parameter" },
+            },
+            required: ["param1"],
+        },
+        ...overrides,
+    };
+}
+function makeGroup(overrides = {}) {
+    return {
+        groupName: "test",
+        serverName: "test-server",
+        tools: [makeTool()],
+        ...overrides,
+    };
+}
+describe("generateHelpText", () => {
+    it("includes group name in header", () => {
+        const text = generateHelpText(makeGroup({ groupName: "filesystem" }));
+        expect(text).toContain("MCPico — filesystem");
+    });
+    it("includes server name", () => {
+        const text = generateHelpText(makeGroup({ serverName: "my-server" }));
+        expect(text).toContain("my-server");
+    });
+    it("shows correct tool count", () => {
+        const text = generateHelpText(makeGroup());
+        expect(text).toContain("1 tool");
+    });
+    it("shows plural for multiple tools", () => {
+        const group = makeGroup({
+            tools: [makeTool({ name: "tool_a" }), makeTool({ name: "tool_b" })],
+        });
+        const text = generateHelpText(group);
+        expect(text).toContain("2 tools");
+    });
+    it("includes usage instructions", () => {
+        const text = generateHelpText(makeGroup());
+        expect(text).toContain("Usage:");
+        expect(text).toContain("<subcommand>");
+        expect(text).toContain("Send just 'help'");
+    });
+    it("lists each tool by name", () => {
+        const group = makeGroup({
+            tools: [
+                makeTool({ name: "read_file", description: "Read a file" }),
+                makeTool({ name: "write_file", description: "Write a file" }),
+            ],
+        });
+        const text = generateHelpText(group);
+        expect(text).toContain("read_file");
+        expect(text).toContain("Read a file");
+        expect(text).toContain("write_file");
+        expect(text).toContain("Write a file");
+    });
+    it("shows tool description", () => {
+        const text = generateHelpText(makeGroup({
+            tools: [makeTool({ description: "Does something useful" })],
+        }));
+        expect(text).toContain("Does something useful");
+    });
+    it("shows parameters section for tools with properties", () => {
+        const text = generateHelpText(makeGroup());
+        expect(text).toContain("Parameters:");
+        expect(text).toContain("param1");
+        expect(text).toContain("(string");
+        expect(text).toContain("(required)");
+        expect(text).toContain("First parameter");
+    });
+    it("marks optional parameters", () => {
+        const tool = makeTool({
+            inputSchema: {
+                type: "object",
+                properties: {
+                    optional_param: { type: "string", description: "Not required" },
+                },
+                required: [],
+            },
+        });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        expect(text).toContain("(optional)");
+    });
+    it("does not show Parameters section for tools without properties", () => {
+        const tool = makeTool({
+            inputSchema: { type: "object", properties: {} },
+        });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        expect(text).not.toContain("Parameters:");
+    });
+    it("generates examples for tools with parameters", () => {
+        const tool = makeTool({
+            inputSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string", description: "File path" },
+                },
+                required: ["path"],
+            },
+        });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        expect(text).toContain("Example:");
+        expect(text).toContain("/tmp/example.txt");
+    });
+    it("shows bare subcommand for parameterless tools", () => {
+        const tool = makeTool({
+            inputSchema: { type: "object", properties: {} },
+        });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        expect(text).toContain("Example:");
+        expect(text).toContain(tool.name);
+    });
+    it("includes footer", () => {
+        const text = generateHelpText(makeGroup());
+        expect(text).toContain("Generated by MCPico");
+    });
+    it("handles tools without descriptions", () => {
+        const tool = makeTool({ description: undefined });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        expect(text).toContain(tool.name);
+        // Should not crash — tool is still listed
+    });
+    it("generates smart example values for known parameter names", () => {
+        const tool = makeTool({
+            name: "search",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search query" },
+                    limit: { type: "integer", description: "Max results" },
+                    url: { type: "string", description: "Target URL" },
+                },
+                required: ["query", "limit", "url"],
+            },
+        });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        expect(text).toContain("search terms");
+        expect(text).toContain("42");
+        expect(text).toContain("https://example.com");
+    });
+    it("handles tools with a mix of required and optional params in example", () => {
+        const tool = makeTool({
+            name: "write",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    content: { type: "string" },
+                    encoding: { type: "string" },
+                },
+                required: ["path"],
+            },
+        });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        // Example should show the required param
+        expect(text).toContain("path");
+        expect(text).toContain("/tmp/example.txt");
+    });
+    it("handles tools with no inputSchema", () => {
+        const tool = makeTool({ inputSchema: {} });
+        const text = generateHelpText(makeGroup({ tools: [tool] }));
+        expect(text).toContain(tool.name);
+        // Should not crash
+    });
+});
+//# sourceMappingURL=help.test.js.map

package/dist/help.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * MCPico — MCP proxy that bundles flat tool lists into hierarchical subcommand groups.
+ *
+ * Usage:
+ *   mcpico [--config <path>]
+ *
+ * Configuration is read from mcpico.json in the current directory by default.
+ */
+export {};