@paca-ai/paca-mcp 0.2.0-rc.2 → 0.2.0

package/build/plugin-loader.js

@@ -0,0 +1,362 @@
+/**
+ * Plugin MCP loader.
+ *
+ * At MCP server startup this module:
+ * 1. Fetches the list of enabled plugins from `GET /api/v1/plugins`.
+ * 2. For each plugin that declares `manifest.mcp.remoteEntryUrl`, dynamically
+ *    imports the remote entry module.
+ * 3. Validates the module's default export against the PluginMCPEntry contract.
+ * 4. Collects all tool definitions and registers dispatch mappings.
+ *
+ * The resulting {@link PluginRegistry} is consumed by `server.ts` to merge
+ * plugin tools with core tools and route tool calls.
+ */
+import { resolve4, resolve6 } from "node:dns/promises";
+import { isIPv4, isIPv6 } from "node:net";
+// ── Registry ──────────────────────────────────────────────────────────────────
+/**
+ * Holds all successfully loaded plugin MCP entries and their merged tool list.
+ * Constructed by {@link loadPlugins}.
+ */
+export class PluginRegistry {
+    loaded;
+    /** Map from tool name → plugin ID (for fast dispatch). */
+    toolOwner;
+    /** Deduplicated tool definitions contributed by loaded plugins. */
+    tools;
+    constructor(loaded) {
+        this.loaded = loaded;
+        this.toolOwner = new Map();
+        this.tools = [];
+        for (const p of loaded) {
+            for (const tool of p.entry.tools) {
+                if (this.toolOwner.has(tool.name)) {
+                    const existingPluginId = this.toolOwner.get(tool.name);
+                    console.warn(`Duplicate plugin MCP tool name "${tool.name}" declared by plugin "${p.pluginId}"; already registered by plugin "${existingPluginId}". Skipping duplicate.`);
+                    continue;
+                }
+                this.toolOwner.set(tool.name, p.pluginId);
+                this.tools.push(tool);
+            }
+        }
+    }
+    /** All unique tool definitions contributed by loaded plugins. */
+    getAllTools() {
+        return this.tools;
+    }
+    /**
+     * Dispatch a tool call to the owning plugin.
+     * Returns `null` if no loaded plugin owns the given tool name.
+     */
+    async handleToolCall(toolName, args, config) {
+        const pluginId = this.toolOwner.get(toolName);
+        if (!pluginId)
+            return null;
+        const plugin = this.loaded.find((p) => p.pluginId === pluginId);
+        if (!plugin)
+            return null;
+        const context = {
+            pluginId,
+            baseURL: config.baseURL,
+            apiKey: config.apiKey,
+        };
+        try {
+            return await plugin.entry.handleToolCall(toolName, args, context);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown plugin tool error";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Plugin tool "${toolName}" failed: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+}
+// ── Loader ────────────────────────────────────────────────────────────────────
+/**
+ * Fetch all enabled plugins from the Paca API and load any that declare an
+ * `mcp.remoteEntryUrl` in their manifest.
+ *
+ * Failures for individual plugins are logged and skipped so that a broken
+ * third-party plugin does not prevent the server from starting.
+ */
+export async function loadPlugins(config) {
+    let plugins = [];
+    try {
+        plugins = await fetchInstalledPlugins(config);
+    }
+    catch (err) {
+        console.error("[plugin-loader] Failed to fetch plugin list — starting without plugins:", err);
+        return new PluginRegistry([]);
+    }
+    const mcpPlugins = plugins.filter((p) => p.enabled && p.manifest?.mcp?.remoteEntryUrl);
+    if (mcpPlugins.length === 0) {
+        return new PluginRegistry([]);
+    }
+    console.error(`[plugin-loader] Loading ${mcpPlugins.length} plugin(s) with MCP tools...`);
+    const loaded = [];
+    for (const plugin of mcpPlugins) {
+        // biome-ignore lint/style/noNonNullAssertion: filtered above
+        const url = plugin.manifest.mcp.remoteEntryUrl;
+        try {
+            const entry = await loadPluginEntry(plugin.name, url, config.baseURL);
+            loaded.push({ pluginId: plugin.name, entry });
+            console.error(`[plugin-loader] Loaded "${plugin.name}" (${entry.tools.length} tool(s))`);
+        }
+        catch (err) {
+            console.error(`[plugin-loader] Failed to load plugin "${plugin.name}" from ${url}:`, err);
+        }
+    }
+    return new PluginRegistry(loaded);
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+async function fetchInstalledPlugins(config) {
+    const url = `${config.baseURL}/api/v1/plugins`;
+    const response = await fetch(url, {
+        headers: {
+            "Content-Type": "application/json",
+            "X-API-Key": config.apiKey,
+        },
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`GET /api/v1/plugins failed: ${response.status} ${response.statusText} — ${text}`);
+    }
+    const body = await response.json();
+    // Handle SuccessEnvelope wrapper
+    if (body && typeof body === "object" && "success" in body && body.success) {
+        const data = body.data;
+        return data.plugins ?? [];
+    }
+    // Direct array fallback
+    if (Array.isArray(body))
+        return body;
+    return [];
+}
+async function loadPluginEntry(pluginId, url, baseURL) {
+    // Dynamic import works for both file:// and https:// URLs in Node 18+.
+    // For http:// URLs (common in local dev), we fetch the source first and
+    // evaluate it via a data: URL import.
+    const importUrl = await resolveImportUrl(url, baseURL);
+    const mod = await import(importUrl);
+    const entry = mod.default ?? mod;
+    assertPluginMCPEntry(pluginId, entry);
+    return entry;
+}
+/**
+ * Resolve a plugin entry URL to a form that Node.js `import()` can consume,
+ * while enforcing URL safety rules:
+ *
+ * - Relative / path-only URLs (e.g. `/plugins-mcp/<id>/mcp.js`) are resolved
+ *   against `baseURL` so that Node's `import()` receives an absolute URL.
+ * - Only `https://`, `file://`, and `http://` (localhost-only) URLs are
+ *   accepted.  Any other scheme is rejected.
+ * - For `https://` URLs the hostname is resolved via DNS and the function
+ *   throws if any resolved address falls inside a private / internal IP range
+ *   (SSRF protection, similar to the API marketplace URL validator).
+ * - For `http://` URLs the hostname must be localhost or a loopback address.
+ *   The source is fetched and re-exposed as a `data:` URL because Node.js
+ *   cannot `import()` plain `http://` URLs.
+ */
+async function resolveImportUrl(url, baseURL) {
+    // Always resolve against baseURL so the URL constructor handles absolute,
+    // relative, and protocol-relative URLs correctly without fragile heuristics:
+    //   "/plugins-mcp/id/mcp.js" → "<baseURL>/plugins-mcp/id/mcp.js"
+    //   "//cdn.example.com/mcp.js" → inherits baseURL's scheme
+    //   "https://cdn.example.com/mcp.js" → unchanged (base ignored for absolute URLs)
+    let resolved;
+    try {
+        resolved = new URL(url, baseURL);
+    }
+    catch {
+        throw new Error(`Plugin entry URL is invalid: "${url}"`);
+    }
+    const scheme = resolved.protocol; // includes trailing ':', e.g. "https:"
+    if (scheme === "file:") {
+        return resolved.href;
+    }
+    if (scheme === "https:") {
+        // Guard against SSRF: reject hostnames that resolve to private IPs.
+        await assertNotPrivateHost(resolved.hostname);
+        return resolved.href;
+    }
+    if (scheme === "http:") {
+        // http:// is allowed only for local development (localhost / loopback).
+        if (!isLocalhostHostname(resolved.hostname)) {
+            throw new Error(`http:// plugin URLs are only allowed for localhost. ` +
+                `Got "${resolved.hostname}" — use https:// for remote plugins.`);
+        }
+        // Node.js cannot import() http:// URLs — fetch source and wrap in a
+        // data: URL so import() can evaluate it without network restrictions.
+        const response = await fetch(resolved.href);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch plugin module from ${resolved.href}: ${response.status} ${response.statusText}`);
+        }
+        const source = await response.text();
+        // Use base64 to avoid issues with special characters in the source
+        const b64 = Buffer.from(source, "utf8").toString("base64");
+        return `data:text/javascript;base64,${b64}`;
+    }
+    throw new Error(`Plugin entry URL scheme "${scheme.replace(":", "")}" is not allowed. ` +
+        `Only https://, http:// (localhost only), and file:// are permitted.`);
+}
+/** Returns true if the hostname is a loopback / localhost address. */
+function isLocalhostHostname(hostname) {
+    const lower = hostname.toLowerCase();
+    // Plain loopback names and addresses
+    if (lower === "localhost" || lower === "127.0.0.1" || lower === "::1") {
+        return true;
+    }
+    // IPv4-mapped IPv6 loopback (e.g. ::ffff:127.0.0.1)
+    if (lower.startsWith("::ffff:")) {
+        const ipv4Part = lower.slice(7);
+        return ipv4Part.startsWith("127.");
+    }
+    return false;
+}
+/**
+ * Throws if `hostname` is an IP in a private / internal range, or if it
+ * resolves via DNS to such an IP.  Mirrors the Go `isPrivateOrInternalIP`
+ * helper used by the API marketplace URL validator.
+ *
+ * Note: like the Go implementation this is susceptible to DNS rebinding.
+ * For production deployments consider an egress proxy with allowlist filtering.
+ */
+async function assertNotPrivateHost(hostname) {
+    // If the hostname is already a bare IP, check it directly.
+    if (isIPv4(hostname) || isIPv6(hostname)) {
+        if (isPrivateIP(hostname)) {
+            throw new Error(`Plugin entry URL hostname "${hostname}" is a private/internal IP address`);
+        }
+        return;
+    }
+    // Resolve the hostname and check every resulting IP.
+    const ips = [];
+    const [v4Result, v6Result] = await Promise.allSettled([
+        resolve4(hostname),
+        resolve6(hostname),
+    ]);
+    if (v4Result.status === "fulfilled")
+        ips.push(...v4Result.value);
+    if (v6Result.status === "fulfilled")
+        ips.push(...v6Result.value);
+    if (ips.length === 0) {
+        throw new Error(`Failed to resolve plugin entry URL hostname "${hostname}"`);
+    }
+    for (const ip of ips) {
+        if (isPrivateIP(ip)) {
+            throw new Error(`Plugin entry URL hostname "${hostname}" resolves to private/internal IP "${ip}"`);
+        }
+    }
+}
+/**
+ * Returns true if `ip` falls within a private / internal IPv4 or IPv6 range.
+ * Covers: loopback, link-local, RFC-1918, and IPv6 unique-local / link-local.
+ */
+function isPrivateIP(ip) {
+    if (isIPv4(ip)) {
+        const parts = ip.split(".").map(Number);
+        const [a, b] = parts;
+        // 127.0.0.0/8 — loopback
+        if (a === 127)
+            return true;
+        // 10.0.0.0/8 — RFC 1918
+        if (a === 10)
+            return true;
+        // 172.16.0.0/12 — RFC 1918
+        if (a === 172 && b >= 16 && b <= 31)
+            return true;
+        // 192.168.0.0/16 — RFC 1918
+        if (a === 192 && b === 168)
+            return true;
+        // 169.254.0.0/16 — link-local
+        if (a === 169 && b === 254)
+            return true;
+        return false;
+    }
+    if (isIPv6(ip)) {
+        const bytes = parseIPv6Bytes(ip);
+        if (!bytes)
+            return false;
+        const b0 = bytes[0];
+        const b1 = bytes[1];
+        // ::1 — loopback (128-bit all-zeros except last bit)
+        if (bytes.slice(0, 15).every((b) => b === 0) && bytes[15] === 1)
+            return true;
+        // fc00::/7 — unique local: first 7 bits are 1111110x  (b0 & 0xfe === 0xfc)
+        if ((b0 & 0xfe) === 0xfc)
+            return true;
+        // fe80::/10 — link-local: first 10 bits are 1111111010 (b0 === 0xfe, b1 high 2 bits === 10)
+        if (b0 === 0xfe && (b1 & 0xc0) === 0x80)
+            return true;
+        // ::ffff:0:0/96 — IPv4-mapped: delegate to IPv4 check
+        const isIPv4Mapped = bytes.slice(0, 10).every((b) => b === 0) &&
+            bytes[10] === 0xff &&
+            bytes[11] === 0xff;
+        if (isIPv4Mapped) {
+            const ipv4 = `${bytes[12]}.${bytes[13]}.${bytes[14]}.${bytes[15]}`;
+            return isPrivateIP(ipv4);
+        }
+        return false;
+    }
+    return false;
+}
+/**
+ * Parse an IPv6 address string into a 16-byte Uint8Array.
+ * Handles compressed (::) notation by expanding it first via the URL API,
+ * which gives us reliable normalization without manual parsing.
+ * Returns null if parsing fails.
+ */
+function parseIPv6Bytes(ip) {
+    try {
+        // Wrap in a URL to let the browser/Node URL parser normalize the address.
+        const u = new URL(`http://[${ip}]/`);
+        // hostname strips the brackets; the URL spec normalises IPv6 to lowercase.
+        const normalized = u.hostname;
+        // Expand :: shorthand.
+        const halves = normalized.split("::");
+        let groups;
+        if (halves.length === 2) {
+            const left = halves[0] ? halves[0].split(":") : [];
+            const right = halves[1] ? halves[1].split(":") : [];
+            const missing = 8 - left.length - right.length;
+            const fill = Array(missing).fill("0");
+            groups = [...left, ...fill, ...right];
+        }
+        else {
+            groups = normalized.split(":");
+        }
+        if (groups.length !== 8)
+            return null;
+        const bytes = new Uint8Array(16);
+        for (let i = 0; i < 8; i++) {
+            const val = Number.parseInt(groups[i], 16);
+            if (Number.isNaN(val) || val < 0 || val > 0xffff)
+                return null;
+            bytes[i * 2] = (val >> 8) & 0xff;
+            bytes[i * 2 + 1] = val & 0xff;
+        }
+        return bytes;
+    }
+    catch {
+        return null;
+    }
+}
+function assertPluginMCPEntry(pluginId, value) {
+    if (!value || typeof value !== "object") {
+        throw new Error(`Plugin "${pluginId}": default export is not an object`);
+    }
+    const entry = value;
+    if (!Array.isArray(entry.tools)) {
+        throw new Error(`Plugin "${pluginId}": default export must have a "tools" array`);
+    }
+    if (typeof entry.handleToolCall !== "function") {
+        throw new Error(`Plugin "${pluginId}": default export must have a "handleToolCall" function`);
+    }
+}
+//# sourceMappingURL=plugin-loader.js.map

package/build/plugin-loader.js.map

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

package/build/server.d.ts

@@ -2,8 +2,10 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import type { PacaConfig } from "./types/index.js";
 /**
  * Creates and configures the Paca MCP server.
+ * Loads plugin MCP modules from the Paca API before returning.
+ *
  * @param config - Paca configuration
  * @returns Configured MCP server
  */
-export declare function createServer(config: PacaConfig): Server;
+export declare function createServer(config: PacaConfig): Promise<Server>;
 //# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAcnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA2CvD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAcnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA4DtE"}

package/build/server.js

@@ -1,28 +1,32 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { PacaAPIClient, PacaAPIDocClient, PacaAPIExtendedClient, PacaAPIGitHubClient, PacaAPITaskExtendedClient, PacaAPIViewsClient, } from "./api/index.js";
+import { PacaAPIClient, PacaAPIDocClient, PacaAPIExtendedClient, PacaAPITaskExtendedClient, PacaAPIViewsClient, } from "./api/index.js";
+import { loadPlugins } from "./plugin-loader.js";
 import { getAllTools, handleToolCall } from "./tools/index.js";
 /**
  * Creates and configures the Paca MCP server.
+ * Loads plugin MCP modules from the Paca API before returning.
+ *
  * @param config - Paca configuration
  * @returns Configured MCP server
  */
-export function createServer(config) {
+export async function createServer(config) {
     // Initialize all API clients
     const apiClient = new PacaAPIClient(config);
     const extendedClient = new PacaAPIExtendedClient(config);
     const viewsClient = new PacaAPIViewsClient(config);
     const taskExtendedClient = new PacaAPITaskExtendedClient(config);
     const docClient = new PacaAPIDocClient(config);
-    const githubClient = new PacaAPIGitHubClient(config);
     const clients = {
         apiClient,
         extendedClient,
         viewsClient,
         taskExtendedClient,
         docClient,
-        githubClient,
     };
+    // Load plugin MCP modules from the Paca API.
+    // Failures for individual plugins are logged and skipped.
+    const pluginRegistry = await loadPlugins(config);
     const server = new Server({
         name: "paca",
         version: "0.1.0",
@@ -31,14 +35,23 @@ export function createServer(config) {
             tools: {},
         },
     });
-    // Handler for listing available tools
+    // Handler for listing available tools (core + plugins)
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         return {
-            tools: getAllTools(),
+            tools: [...getAllTools(), ...pluginRegistry.getAllTools()],
         };
     });
     // Handler for executing tool calls
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        // Try plugin registry first (plugin tool names are chosen by developers,
+        // so we check plugins before falling through to core tools to make
+        // routing explicit).
+        const pluginResult = await pluginRegistry.handleToolCall(name, (args ?? {}), config);
+        if (pluginResult !== null) {
+            return pluginResult;
+        }
+        // Fall through to core tool handlers
         return handleToolCall(request, clients);
     });
     return server;

package/build/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACN,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACN,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG/D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC9C,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,kBAAkB,GAAG,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG;QACf,SAAS;QACT,cAAc;QACd,WAAW;QACX,kBAAkB;QAClB,SAAS;QACT,YAAY;KACZ,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,MAAM,CACxB;QACC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO;KAChB,EACD;QACC,YAAY,EAAE;YACb,KAAK,EAAE,EAAE;SACT;KACD,CACD,CAAC;IAEF,sCAAsC;IACtC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC3D,OAAO;YACN,KAAK,EAAE,WAAW,EAAE;SACpB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACN,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACN,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAkB;IACpD,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,kBAAkB,GAAG,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG;QACf,SAAS;QACT,cAAc;QACd,WAAW;QACX,kBAAkB;QAClB,SAAS;KACT,CAAC;IAEF,6CAA6C;IAC7C,0DAA0D;IAC1D,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAI,MAAM,CACxB;QACC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO;KAChB,EACD;QACC,YAAY,EAAE;YACb,KAAK,EAAE,EAAE;SACT;KACD,CACD,CAAC;IAEF,uDAAuD;IACvD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC3D,OAAO;YACN,KAAK,EAAE,CAAC,GAAG,WAAW,EAAE,EAAE,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;SAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,yEAAyE;QACzE,mEAAmE;QACnE,qBAAqB;QACrB,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,cAAc,CACvD,IAAI,EACJ,CAAC,IAAI,IAAI,EAAE,CAA4B,EACvC,MAAM,CACN,CAAC;QACF,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,YAAY,CAAC;QACrB,CAAC;QAED,qCAAqC;QACrC,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC"}

package/build/tools/attachment-tools.d.ts

@@ -1,15 +1,11 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import type { PacaAPITaskExtendedClient, PacaAPIViewsClient } from "../api/index.js";
+import type { PacaAPIViewsClient } from "../api/index.js";
 /**
  * Returns all attachment-related MCP tools.
  */
 export declare function getAttachmentTools(): Tool[];
 /**
- * Returns all BDD scenario-related MCP tools.
+ * Handles attachment tool calls.
  */
-export declare function getBDDScenarioTools(): Tool[];
-/**
- * Handles attachment and BDD scenario tool calls.
- */
-export declare function handleAttachmentTool(toolName: string, args: any, viewsClient: PacaAPIViewsClient, taskClient: PacaAPITaskExtendedClient): Promise<any>;
+export declare function handleAttachmentTool(toolName: string, args: any, viewsClient: PacaAPIViewsClient): Promise<any>;
 //# sourceMappingURL=attachment-tools.d.ts.map

package/build/tools/attachment-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-tools.d.ts","sourceRoot":"","sources":["../../src/tools/attachment-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EACX,yBAAyB,EACzB,kBAAkB,EAClB,MAAM,iBAAiB,CAAC;AA0DzB;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAiE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,EAAE,CA2I5C;AA2BD;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,WAAW,EAAE,kBAAkB,EAC/B,UAAU,EAAE,yBAAyB,GACnC,OAAO,CAAC,GAAG,CAAC,CA+Id"}
+{"version":3,"file":"attachment-tools.d.ts","sourceRoot":"","sources":["../../src/tools/attachment-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAoB1D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAyE3C;AAWD;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,WAAW,EAAE,kBAAkB,GAC7B,OAAO,CAAC,GAAG,CAAC,CAsDd"}