@neurynae/toolcairn-mcp 0.1.0

package/dist/tools/check-issue.js

@@ -0,0 +1,248 @@
+/**
+ * check_issue — Checks GitHub directly for known issues matching an error.
+ *
+ * IMPORTANT: This is a last-resort tool. The agent should:
+ *   1. Try to fix the error itself (2 retries)
+ *   2. Consult the tool's documentation (2 more retries)
+ *   3. ONLY THEN call check_issue (pass retry_count≥4, docs_consulted=true)
+ *
+ * This prevents spamming the GitHub API for errors that are config issues,
+ * environment problems, or things the docs would explain.
+ *
+ * Flow:
+ *   1. Gate: enforce retry + docs requirements
+ *   2. Look up tool's github_url in Memgraph
+ *   3. Search GitHub Issues API directly (no local DB — live data)
+ *   4. Also search for PRs that may fix the issue
+ *   5. Return one of four statuses:
+ *      - not_found:           no matching issue on GitHub → agent handles it
+ *      - fix_in_progress:     open issue + open PR exists → track PR
+ *      - known_issue_no_fix:  open issue, no PR → gist + ask user intent
+ *      - fixed_in_version:    closed issue → which version fixed it
+ *   6. In real-issue cases (3/4): add 👍 reaction to the issue via GitHub API
+ */
+import { config } from '@toolpilot/config';
+import { MemgraphToolRepository } from '@toolpilot/graph';
+import pino from 'pino';
+import { errResult, okResult } from '../utils.js';
+const logger = pino({ name: '@toolpilot/mcp-server:check-issue' });
+const repo = new MemgraphToolRepository();
+const DOCS_RETRY_THRESHOLD = 4; // total retries before check_issue is appropriate
+function githubHeaders() {
+    const headers = {
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+    };
+    if (config.GITHUB_TOKEN) {
+        headers.Authorization = `Bearer ${config.GITHUB_TOKEN}`;
+    }
+    return headers;
+}
+async function searchGitHubIssues(owner, repoName, query, type) {
+    const q = encodeURIComponent(`${query} repo:${owner}/${repoName} type:${type}`);
+    const url = `https://api.github.com/search/issues?q=${q}&sort=relevance&per_page=5`;
+    const res = await fetch(url, { headers: githubHeaders() });
+    if (!res.ok) {
+        if (res.status === 422 || res.status === 403)
+            return []; // rate limit or bad query
+        throw new Error(`GitHub Search API error: ${res.status}`);
+    }
+    const data = (await res.json());
+    return data.items ?? [];
+}
+async function addReaction(owner, repoName, issueNumber) {
+    if (!config.GITHUB_TOKEN)
+        return false; // reactions require auth
+    try {
+        const res = await fetch(`https://api.github.com/repos/${owner}/${repoName}/issues/${issueNumber}/reactions`, {
+            method: 'POST',
+            headers: { ...githubHeaders(), 'Content-Type': 'application/json' },
+            body: JSON.stringify({ content: '+1' }),
+        });
+        return res.ok || res.status === 200;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extract a concise gist from an issue (title + key labels + first 500 chars of body).
+ */
+function buildIssueGist(issue) {
+    const labels = issue.labels.map((l) => l.name).join(', ');
+    const bodySnippet = (issue.body ?? '').slice(0, 500).replace(/\r?\n/g, ' ');
+    return [
+        `Title: ${issue.title}`,
+        labels ? `Labels: ${labels}` : null,
+        bodySnippet
+            ? `Description: ${bodySnippet}${issue.body && issue.body.length > 500 ? '...' : ''}`
+            : null,
+        `State: ${issue.state}`,
+        `Comments: ${issue.comments}`,
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+/**
+ * Parse owner/repo from a GitHub URL.
+ */
+function parseGitHubRepo(githubUrl) {
+    const match = githubUrl.match(/github\.com\/([^/]+)\/([^/]+)/i);
+    if (!match)
+        return null;
+    return { owner: match[1], repo: (match[2] ?? '').replace(/\.git$/, '') };
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handleCheckIssue(args) {
+    try {
+        const retryCount = args.retry_count ?? 0;
+        const docsConsulted = args.docs_consulted ?? false;
+        logger.info({ tool_name: args.tool_name, issue_title: args.issue_title, retryCount, docsConsulted }, 'check_issue called');
+        // ── Gate: enforce "docs first, then issues" protocol ─────────────────────
+        if (retryCount < DOCS_RETRY_THRESHOLD || !docsConsulted) {
+            const nextStep = !docsConsulted
+                ? "Consult the documentation link in the tool's prompt_hint before calling check_issue. Read the changelog and README carefully — most errors are config or version issues."
+                : `Retry at least ${DOCS_RETRY_THRESHOLD} times total before checking GitHub issues. You have tried ${retryCount} time(s).`;
+            return okResult({
+                status: 'too_early',
+                message: 'check_issue is a last resort. Exhaust documentation and retries first.',
+                retry_count: retryCount,
+                docs_consulted: docsConsulted,
+                next_step: nextStep,
+                agent_instructions: [
+                    '1. Try to fix the error yourself (up to 2 retries).',
+                    "2. Read the tool's documentation — use the docs_url/readme_url from search_tools results.",
+                    '3. Apply documentation guidance and retry (up to 2 more retries).',
+                    '4. Only call check_issue after 4+ total retries AND docs_consulted=true.',
+                ].join(' '),
+            });
+        }
+        // ── Look up tool in Memgraph to get github_url ────────────────────────────
+        const toolResult = await repo.findByName(args.tool_name);
+        if (!toolResult.ok) {
+            return errResult('db_error', toolResult.error.message);
+        }
+        if (!toolResult.data) {
+            return errResult('tool_not_found', `Tool '${args.tool_name}' is not in the ToolPilot index. Try search_tools to find the correct tool name.`);
+        }
+        const tool = toolResult.data;
+        const parsed = parseGitHubRepo(tool.github_url);
+        if (!parsed) {
+            return errResult('parse_error', `Cannot parse GitHub repo from: ${tool.github_url}`);
+        }
+        const { owner, repo: repoName } = parsed;
+        // ── Search GitHub Issues + PRs directly ──────────────────────────────────
+        logger.info({ owner, repo: repoName, query: args.issue_title }, 'Searching GitHub issues');
+        const [issues, prs] = await Promise.all([
+            searchGitHubIssues(owner, repoName, args.issue_title, 'issue'),
+            searchGitHubIssues(owner, repoName, args.issue_title, 'pr'),
+        ]);
+        // ── CASE 1: Nothing found ─────────────────────────────────────────────────
+        if (issues.length === 0 && prs.length === 0) {
+            return okResult({
+                status: 'not_found',
+                tool: args.tool_name,
+                message: `No matching issue found on GitHub for '${args.tool_name}'. The problem may be specific to your environment or configuration.`,
+                github_issues_url: `${tool.github_url}/issues`,
+                agent_instructions: [
+                    'No known GitHub issue matches this error.',
+                    'Investigate: (1) environment/config differences, (2) version mismatch, (3) incorrect usage pattern.',
+                    'Re-read the documentation section relevant to this error.',
+                    'Consider searching GitHub manually with different keywords.',
+                ].join(' '),
+            });
+        }
+        // Find the most relevant open issue
+        const openIssues = issues.filter((i) => i.state === 'open');
+        const closedIssues = issues.filter((i) => i.state === 'closed');
+        const topIssue = openIssues[0] ?? closedIssues[0];
+        // Find related open PRs (not merged yet)
+        const openPrs = prs.filter((pr) => pr.state === 'open');
+        const mergedPrs = prs.filter((pr) => pr.pull_request?.merged_at != null);
+        const topPr = openPrs[0] ?? mergedPrs[0];
+        // ── CASE 4: Fixed in a closed issue + merged PR ───────────────────────────
+        if (!topIssue || topIssue.state === 'closed') {
+            const fixInfo = mergedPrs[0]
+                ? `PR #${mergedPrs[0].number} was merged: ${mergedPrs[0].html_url}`
+                : `Issue was closed: ${topIssue?.html_url ?? `${tool.github_url}/issues`}`;
+            return okResult({
+                status: 'fixed_in_version',
+                tool: args.tool_name,
+                issue: topIssue
+                    ? {
+                        number: topIssue.number,
+                        title: topIssue.title,
+                        github_url: topIssue.html_url,
+                        closed_at: topIssue.closed_at,
+                    }
+                    : null,
+                fix_info: fixInfo,
+                message: `This issue appears to have been fixed. ${fixInfo}`,
+                agent_instructions: 'Update the tool to the latest version to get this fix. Check the PR/release notes for the specific version.',
+            });
+        }
+        // ── Add 👍 reaction to the issue (signal that others have hit this too) ───
+        const reactionAdded = await addReaction(owner, repoName, topIssue.number);
+        logger.info({ issue: topIssue.number, reactionAdded }, 'Attempted to add 👍 reaction to issue');
+        // ── CASE 2: Open issue + open PR exists ───────────────────────────────────
+        if (topPr && topPr.state === 'open') {
+            return okResult({
+                status: 'fix_in_progress',
+                tool: args.tool_name,
+                issue: {
+                    number: topIssue.number,
+                    title: topIssue.title,
+                    github_url: topIssue.html_url,
+                    gist: buildIssueGist(topIssue),
+                },
+                pr: {
+                    number: topPr.number,
+                    title: topPr.title,
+                    github_url: topPr.html_url,
+                    state: 'open',
+                },
+                reaction_added: reactionAdded,
+                message: `Known issue — a fix is in progress (PR #${topPr.number}). Your 👍 reaction was ${reactionAdded ? 'added' : 'not added (no GitHub token)'} to signal impact.`,
+                agent_instructions: 'A fix is in progress. Consider: (1) checking if a pre-release/nightly build has the fix, (2) applying a temporary workaround, (3) tracking the PR for a stable release.',
+            });
+        }
+        // ── CASE 3: Open issue, no PR ─────────────────────────────────────────────
+        return okResult({
+            status: 'known_issue_no_fix',
+            tool: args.tool_name,
+            issue: {
+                number: topIssue.number,
+                title: topIssue.title,
+                github_url: topIssue.html_url,
+                state: topIssue.state,
+                comments: topIssue.comments,
+                created_at: topIssue.created_at,
+                gist: buildIssueGist(topIssue),
+            },
+            reaction_added: reactionAdded,
+            other_matching_issues: openIssues.slice(1, 3).map((i) => ({
+                number: i.number,
+                title: i.title,
+                github_url: i.html_url,
+            })),
+            message: `Known open issue (#${topIssue.number}): "${topIssue.title}". Your 👍 reaction was ${reactionAdded ? 'added' : 'not added'} to signal impact.`,
+            user_action_required: {
+                question: 'What would you like to do? Options: (a) Create a new issue report if your case has additional detail, (b) Handle it later, (c) Ignore.',
+                if_create_issue: "Ask the agent to generate an issue template — you can copy and paste it to GitHub manually. The agent will follow the repo's issue template format.",
+                github_new_issue_url: `${tool.github_url}/issues/new`,
+            },
+            agent_instructions: [
+                `Issue #${topIssue.number} is open with no fix yet.`,
+                'Ask the user whether they want to: (a) create a new issue, (b) handle it later, (c) ignore.',
+                "If user wants to create an issue: generate a detailed issue template using the repo's issue format, present it for the user to copy-paste manually.",
+                'Do NOT auto-submit any GitHub issue — always require explicit user action.',
+                'In the meantime, explore workarounds: different config, version pinning, or alternative approaches.',
+            ].join(' '),
+        });
+    }
+    catch (e) {
+        logger.error({ err: e, tool_name: args.tool_name }, 'check_issue failed');
+        return errResult('internal_error', e instanceof Error ? e.message : String(e));
+    }
+}
+//# sourceMappingURL=check-issue.js.map

package/dist/tools/check-issue.js.map

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

package/dist/tools/classify-prompt.d.ts

@@ -0,0 +1,101 @@
+export type PromptClassification = 'tool_discovery' | 'stack_building' | 'tool_configuration' | 'tool_comparison' | 'debugging' | 'general_coding';
+export declare function handleClassifyPrompt(args: {
+    prompt: string;
+    project_tools?: string[];
+}): Promise<{
+    [x: string]: unknown;
+    content: ({
+        type: "text";
+        text: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "audio";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        uri: string;
+        name: string;
+        type: "resource_link";
+        description?: string | undefined;
+        mimeType?: string | undefined;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+            theme?: "light" | "dark" | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    } | {
+        type: "resource";
+        resource: {
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        };
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    })[];
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+    structuredContent?: {
+        [x: string]: unknown;
+    } | undefined;
+    isError?: boolean | undefined;
+}>;
+//# sourceMappingURL=classify-prompt.d.ts.map

package/dist/tools/classify-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-prompt.d.ts","sourceRoot":"","sources":["../../src/tools/classify-prompt.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,iBAAiB,GACjB,WAAW,GACX,gBAAgB,CAAC;AASrB,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DA"}

package/dist/tools/classify-prompt.js

@@ -0,0 +1,64 @@
+import pino from 'pino';
+import { errResult, okResult } from '../utils.js';
+const logger = pino({ name: '@toolpilot/mcp-server:classify-prompt' });
+// Categories where ToolPilot search is useful
+const TOOL_REQUIRED_CLASSIFICATIONS = [
+    'tool_discovery',
+    'stack_building',
+    'tool_comparison',
+];
+export async function handleClassifyPrompt(args) {
+    try {
+        logger.info({ promptLen: args.prompt.length }, 'classify_prompt called');
+        const projectToolsContext = args.project_tools && args.project_tools.length > 0
+            ? `\n\nThe project already uses: ${args.project_tools.join(', ')}. Consider whether the prompt relates to tools already confirmed in the project.`
+            : '';
+        // Build a structured prompt the agent uses to classify
+        const classification_prompt = `Classify the following developer prompt into exactly ONE of these categories:
+
+Categories:
+- tool_discovery: The developer needs to find, select, or identify a tool, library, framework, or service
+- stack_building: The developer needs to compose multiple tools together to build a complete system
+- tool_comparison: The developer wants to compare two or more specific tools
+- tool_configuration: The developer already has a tool chosen and needs help configuring or using it
+- debugging: The developer is encountering an error, bug, or unexpected behavior
+- general_coding: Architecture, business logic, algorithms — no new tool selection is needed
+
+Rules:
+1. If the prompt involves building something "from scratch" or asks for tech stack recommendations, classify as stack_building
+2. If the prompt mentions a specific tool and asks "should I use X or Y", classify as tool_comparison
+3. If the prompt is about implementing features WITHOUT mentioning specific tools, classify as tool_discovery
+4. If the prompt mentions an error message, traceback, or "not working", classify as debugging
+5. Respond with ONLY the category name, nothing else
+
+Prompt to classify:
+"""
+${args.prompt}
+"""${projectToolsContext}
+
+Your response (one category name only):`;
+        const needs_tool_search_prompt = `Based on this classification, determine if ToolPilot tool search should be invoked.
+Respond with 1 if the classification is one of: tool_discovery, stack_building, tool_comparison
+Respond with 0 if the classification is: tool_configuration, debugging, general_coding
+Respond with ONLY 0 or 1.`;
+        return okResult({
+            classification_prompt,
+            needs_tool_search_prompt,
+            valid_classifications: [
+                'tool_discovery',
+                'stack_building',
+                'tool_comparison',
+                'tool_configuration',
+                'debugging',
+                'general_coding',
+            ],
+            tool_required_if: TOOL_REQUIRED_CLASSIFICATIONS,
+            instructions: 'Step 1: Send classification_prompt to the LLM and get a classification. Step 2: If classification is in tool_required_if, call refine_requirement with the classification. Otherwise, proceed without ToolPilot search.',
+        });
+    }
+    catch (e) {
+        logger.error({ err: e }, 'classify_prompt failed');
+        return errResult('classify_error', e instanceof Error ? e.message : String(e));
+    }
+}
+//# sourceMappingURL=classify-prompt.js.map

package/dist/tools/classify-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-prompt.js","sourceRoot":"","sources":["../../src/tools/classify-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,uCAAuC,EAAE,CAAC,CAAC;AAWvE,8CAA8C;AAC9C,MAAM,6BAA6B,GAA2B;IAC5D,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;CAClB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAG1C;IACC,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAEzE,MAAM,mBAAmB,GACvB,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;YACjD,CAAC,CAAC,iCAAiC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,kFAAkF;YAClJ,CAAC,CAAC,EAAE,CAAC;QAET,uDAAuD;QACvD,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;EAmBhC,IAAI,CAAC,MAAM;KACR,mBAAmB;;wCAEgB,CAAC;QAErC,MAAM,wBAAwB,GAAG;;;0BAGX,CAAC;QAEvB,OAAO,QAAQ,CAAC;YACd,qBAAqB;YACrB,wBAAwB;YACxB,qBAAqB,EAAE;gBACrB,gBAAgB;gBAChB,gBAAgB;gBAChB,iBAAiB;gBACjB,oBAAoB;gBACpB,WAAW;gBACX,gBAAgB;aACS;YAC3B,gBAAgB,EAAE,6BAA6B;YAC/C,YAAY,EACV,yNAAyN;SAC5N,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,wBAAwB,CAAC,CAAC;QACnD,OAAO,SAAS,CAAC,gBAAgB,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}

package/dist/tools/compare-tools.d.ts

@@ -0,0 +1,102 @@
+export declare function handleCompareTools(args: {
+    tool_a: string;
+    tool_b: string;
+    use_case?: string;
+    project_config?: string;
+}): Promise<{
+    [x: string]: unknown;
+    content: ({
+        type: "text";
+        text: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "audio";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        uri: string;
+        name: string;
+        type: "resource_link";
+        description?: string | undefined;
+        mimeType?: string | undefined;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+            theme?: "light" | "dark" | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    } | {
+        type: "resource";
+        resource: {
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        };
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    })[];
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+    structuredContent?: {
+        [x: string]: unknown;
+    } | undefined;
+    isError?: boolean | undefined;
+}>;
+//# sourceMappingURL=compare-tools.d.ts.map

package/dist/tools/compare-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-tools.d.ts","sourceRoot":"","sources":["../../src/tools/compare-tools.ts"],"names":[],"mappings":"AAgEA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4JA"}