n8n-mcp/dist/mappers/docs-mapper.js

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.DocsMapper = void 0;
const fs_1 = require("fs");
const path_1 = __importDefault(require("path"));
class DocsMapper {
    constructor() {
        this.docsPath = path_1.default.join(process.cwd(), 'n8n-docs');
        this.KNOWN_FIXES = {
            'httpRequest': 'httprequest',
            'code': 'code',
            'webhook': 'webhook',
            'respondToWebhook': 'respondtowebhook',
            'n8n-nodes-base.httpRequest': 'httprequest',
            'n8n-nodes-base.code': 'code',
            'n8n-nodes-base.webhook': 'webhook',
            'n8n-nodes-base.respondToWebhook': 'respondtowebhook'
        };
    }
    async fetchDocumentation(nodeType) {
        const fixedType = this.KNOWN_FIXES[nodeType] || nodeType;
        const nodeName = fixedType.split('.').pop()?.toLowerCase();
        if (!nodeName) {
            console.log(`⚠️  Could not extract node name from: ${nodeType}`);
            return null;
        }
        console.log(`📄 Looking for docs for: ${nodeType} -> ${nodeName}`);
        const possiblePaths = [
            `docs/integrations/builtin/core-nodes/n8n-nodes-base.${nodeName}.md`,
            `docs/integrations/builtin/app-nodes/n8n-nodes-base.${nodeName}.md`,
            `docs/integrations/builtin/trigger-nodes/n8n-nodes-base.${nodeName}.md`,
            `docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.${nodeName}.md`,
            `docs/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.${nodeName}.md`,
            `docs/integrations/builtin/core-nodes/n8n-nodes-base.${nodeName}/index.md`,
            `docs/integrations/builtin/app-nodes/n8n-nodes-base.${nodeName}/index.md`,
            `docs/integrations/builtin/trigger-nodes/n8n-nodes-base.${nodeName}/index.md`,
            `docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.${nodeName}/index.md`,
            `docs/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.${nodeName}/index.md`
        ];
        for (const relativePath of possiblePaths) {
            try {
                const fullPath = path_1.default.join(this.docsPath, relativePath);
                let content = await fs_1.promises.readFile(fullPath, 'utf-8');
                console.log(`  ✓ Found docs at: ${relativePath}`);
                content = this.enhanceLoopNodeDocumentation(nodeType, content);
                return content;
            }
            catch (error) {
                continue;
            }
        }
        console.log(`  ✗ No docs found for ${nodeName}`);
        return null;
    }
    enhanceLoopNodeDocumentation(nodeType, content) {
        if (nodeType.includes('splitInBatches')) {
            const outputGuidance = `

## CRITICAL OUTPUT CONNECTION INFORMATION

**⚠️ OUTPUT INDICES ARE COUNTERINTUITIVE ⚠️**

The SplitInBatches node has TWO outputs with specific indices:
- **Output 0 (index 0) = "done"**: Receives final processed data when loop completes
- **Output 1 (index 1) = "loop"**: Receives current batch data during iteration

### Correct Connection Pattern:
1. Connect nodes that PROCESS items inside the loop to **Output 1 ("loop")**
2. Connect nodes that run AFTER the loop completes to **Output 0 ("done")**
3. The last processing node in the loop must connect back to the SplitInBatches node

### Common Mistake:
AI assistants often connect these backwards because the logical flow (loop first, then done) doesn't match the technical indices (done=0, loop=1).

`;
            const insertPoint = content.indexOf('## When to use');
            if (insertPoint > -1) {
                content = content.slice(0, insertPoint) + outputGuidance + content.slice(insertPoint);
            }
            else {
                content = outputGuidance + '\n' + content;
            }
        }
        if (nodeType.includes('.if')) {
            const outputGuidance = `

## Output Connection Information

The IF node has TWO outputs:
- **Output 0 (index 0) = "true"**: Items that match the condition
- **Output 1 (index 1) = "false"**: Items that do not match the condition

`;
            const insertPoint = content.indexOf('## Node parameters');
            if (insertPoint > -1) {
                content = content.slice(0, insertPoint) + outputGuidance + content.slice(insertPoint);
            }
        }
        return content;
    }
}
exports.DocsMapper = DocsMapper;
//# sourceMappingURL=docs-mapper.js.map