frontmcp 0.3.0 → 0.4.0

package/src/commands/inspector.d.ts

@@ -0,0 +1 @@
+export declare function runInspector(): Promise<void>;

package/src/commands/inspector.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInspector = runInspector;
+const colors_1 = require("../colors");
+const fs_1 = require("../utils/fs");
+async function runInspector() {
+    console.log(`${(0, colors_1.c)('cyan', '[inspector]')} launching MCP Inspector...`);
+    await (0, fs_1.runCmd)('npx', ['-y', '@modelcontextprotocol/inspector']);
+}
+//# sourceMappingURL=inspector.js.map

package/src/commands/inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.js","sourceRoot":"","sources":["../../../src/commands/inspector.ts"],"names":[],"mappings":";;AAGA,oCAGC;AAND,sCAA8B;AAC9B,oCAAqC;AAE9B,KAAK,UAAU,YAAY;IAChC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAA,UAAC,EAAC,MAAM,EAAE,aAAa,CAAC,6BAA6B,CAAC,CAAC;IACtE,MAAM,IAAA,WAAM,EAAC,KAAK,EAAE,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC,CAAC;AACjE,CAAC","sourcesContent":["import { c } from '../colors';\nimport { runCmd } from '../utils/fs';\n\nexport async function runInspector(): Promise<void> {\n  console.log(`${c('cyan', '[inspector]')} launching MCP Inspector...`);\n  await runCmd('npx', ['-y', '@modelcontextprotocol/inspector']);\n}\n"]}

package/src/commands/template.d.ts

@@ -0,0 +1,13 @@
+/**
+ * frontmcp template <templateName>
+ *
+ * Example:
+ *   npx frontmcp template 3rd-party-integration
+ *
+ * This will look for templates in:
+ *   src/templates/<templateName>   (built to dist/templates/<templateName>)
+ * and copy them into:
+ *   integrations/<owner>/<service>
+ * with __OWNER__, __SERVICE__, __AUTH_TYPE__ replaced.
+ */
+export declare function runTemplate(templateName?: string): Promise<void>;

package/src/commands/template.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTemplate = runTemplate;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const readline = tslib_1.__importStar(require("readline"));
+const colors_1 = require("../colors");
+const fs_1 = require("../utils/fs");
+/**
+ * frontmcp template <templateName>
+ *
+ * Example:
+ *   npx frontmcp template 3rd-party-integration
+ *
+ * This will look for templates in:
+ *   src/templates/<templateName>   (built to dist/templates/<templateName>)
+ * and copy them into:
+ *   integrations/<owner>/<service>
+ * with __OWNER__, __SERVICE__, __AUTH_TYPE__ replaced.
+ */
+async function runTemplate(templateName) {
+    const name = (templateName || '').trim();
+    if (!name) {
+        console.log((0, colors_1.c)('red', 'Template name is required (e.g. 3rd-party-integration).'));
+        return;
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const ask = (q) => new Promise((resolve) => rl.question(q, (ans) => resolve(ans.trim())));
+    try {
+        const templatesRoot = path.resolve(__dirname, '..', 'templates');
+        // 1) Collect available templates up-front
+        const available = await listAvailableTemplates(templatesRoot);
+        if (!available.length) {
+            console.log((0, colors_1.c)('red', `No templates found under ${path.relative(process.cwd(), templatesRoot)}.`));
+            return;
+        }
+        // 2) Sanitize the name and choose the actual template folder
+        const sanitized = sanitizeTemplateName(name);
+        let selected = null;
+        if (available.includes(name)) {
+            selected = name;
+        }
+        else if (available.includes(sanitized)) {
+            selected = sanitized;
+            if (sanitized !== name) {
+                console.log((0, colors_1.c)('yellow', `[template] Template "${name}" not found, using sanitized "${sanitized}"`));
+            }
+        }
+        if (!selected) {
+            console.log((0, colors_1.c)('red', `Template "${name}" not found under ${path.relative(process.cwd(), templatesRoot)}.`));
+            console.log((0, colors_1.c)('gray', '\nAvailable templates:'));
+            for (const t of available) {
+                console.log('  -', t);
+            }
+            return;
+        }
+        const templateRoot = path.resolve(templatesRoot, selected);
+        console.log((0, colors_1.c)('cyan', '[template]') + ` Using template "${selected}" from src/templates/${selected}`);
+        // Ask for owner & service
+        let owner = await ask(`Third-party owner (e.g. google, github, slack): `);
+        if (!owner) {
+            console.log((0, colors_1.c)('red', 'Owner is required.'));
+            return;
+        }
+        owner = sanitizeSlug(owner);
+        let service = await ask(`Third-party service (e.g. gmail, slack-bot): `);
+        if (!service) {
+            console.log((0, colors_1.c)('red', 'Service is required.'));
+            return;
+        }
+        service = sanitizeSlug(service);
+        // Auth type (for placeholders only – you can use or ignore in templates)
+        let authRaw = await ask(`Default auth type (oauth2/bearer/apiKey) [oauth2]: `);
+        if (!authRaw)
+            authRaw = 'oauth2';
+        const authType = authRaw;
+        if (!['oauth2', 'bearer', 'apiKey'].includes(authType)) {
+            console.log((0, colors_1.c)('red', `Invalid auth type: ${authRaw}`));
+            return;
+        }
+        const ctx = { owner, service, authType };
+        const cwd = process.cwd();
+        const destRoot = path.resolve(cwd, 'integrations', owner, service);
+        await (0, fs_1.ensureDir)(destRoot);
+        console.log((0, colors_1.c)('gray', `[template] Scaffolding into ${path.relative(cwd, destRoot)}`));
+        await copyTemplateTree(templateRoot, destRoot, ctx);
+        console.log('');
+        console.log((0, colors_1.c)('green', '✔ Template hydrated into: ') +
+            path.relative(cwd, destRoot));
+        console.log((0, colors_1.c)('gray', 'You can now edit or delete the generated example files and create your own tools.'));
+    }
+    finally {
+        rl.close();
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Helpers                                                                    */
+/* -------------------------------------------------------------------------- */
+function sanitizeSlug(val) {
+    return (val
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '') || 'service');
+}
+// More permissive for template folder names (allow . _ -)
+function sanitizeTemplateName(val) {
+    return (val
+        .trim()
+        .replace(/[^a-zA-Z0-9._-]/g, '-') // replace weird chars
+        .replace(/-+/g, '-') // collapse multiple dashes
+        .replace(/^-|-$/g, '') || 'template');
+}
+async function dirExists(p) {
+    try {
+        const st = await fs_1.fsp.stat(p);
+        return st.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function listAvailableTemplates(templatesRoot) {
+    try {
+        const entries = await fs_1.fsp.readdir(templatesRoot, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Replace placeholders in both filenames and file contents.
+ *
+ * Supported placeholders:
+ *   __OWNER__
+ *   __SERVICE__
+ *   __AUTH_TYPE__
+ */
+function applyPlaceholders(input, ctx) {
+    return input
+        .replaceAll('__OWNER__', ctx.owner)
+        .replaceAll('__SERVICE__', ctx.service)
+        .replaceAll('__AUTH_TYPE__', ctx.authType);
+}
+async function copyTemplateTree(templateRoot, destRoot, ctx) {
+    const walk = async (srcDir) => {
+        const entries = await fs_1.fsp.readdir(srcDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(srcDir, entry.name);
+            const relFromRoot = path.relative(templateRoot, srcPath);
+            // Apply placeholders in path segments too
+            const relWithPlaceholders = applyPlaceholders(relFromRoot, ctx);
+            const destPath = path.join(destRoot, relWithPlaceholders);
+            if (entry.isDirectory()) {
+                await (0, fs_1.ensureDir)(destPath);
+                await walk(srcPath);
+            }
+            else if (entry.isFile()) {
+                // Read template file, apply placeholders, write if not existing
+                const content = await fs_1.fsp.readFile(srcPath, 'utf8');
+                const processed = applyPlaceholders(content, ctx);
+                if (await (0, fs_1.fileExists)(destPath)) {
+                    console.log((0, colors_1.c)('gray', `skip: ${path.relative(process.cwd(), destPath)} already exists`));
+                    continue;
+                }
+                await (0, fs_1.ensureDir)(path.dirname(destPath));
+                await fs_1.fsp.writeFile(destPath, processed, 'utf8');
+                console.log((0, colors_1.c)('green', `✓ created ${path.relative(process.cwd(), destPath)}`));
+            }
+        }
+    };
+    await walk(templateRoot);
+}
+//# sourceMappingURL=template.js.map

package/src/commands/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/commands/template.ts"],"names":[],"mappings":";;AAyBA,kCAiHC;;AA1ID,mDAA6B;AAC7B,2DAAqC;AACrC,sCAA8B;AAC9B,oCAAyD;AAUzD;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,WAAW,CAAC,YAAqB;IACrD,MAAM,IAAI,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,KAAK,EAAE,yDAAyD,CAAC,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAmB,EAAE,CACzC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAEjE,0CAA0C;QAC1C,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,KAAK,EAAE,4BAA4B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,CACrF,CAAC;YACF,OAAO;QACT,CAAC;QAED,6DAA6D;QAC7D,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,QAAQ,GAAkB,IAAI,CAAC;QAEnC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,QAAQ,GAAG,SAAS,CAAC;YACrB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,QAAQ,EAAE,wBAAwB,IAAI,iCAAiC,SAAS,GAAG,CAAC,CACvF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,KAAK,EAAE,aAAa,IAAI,qBAAqB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,CAC/F,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACxB,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAE3D,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,MAAM,EAAE,YAAY,CAAC,GAAG,oBAAoB,QAAQ,wBAAwB,QAAQ,EAAE,CACzF,CAAC;QAEF,0BAA0B;QAC1B,IAAI,KAAK,GAAG,MAAM,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAE5B,IAAI,OAAO,GAAG,MAAM,GAAG,CACrB,+CAA+C,CAChD,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAEhC,yEAAyE;QACzE,IAAI,OAAO,GAAG,MAAM,GAAG,CACrB,qDAAqD,CACtD,CAAC;QACF,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,QAAQ,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAmB,CAAC;QACrC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,KAAK,EAAE,sBAAsB,OAAO,EAAE,CAAC,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAE1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,IAAA,cAAS,EAAC,QAAQ,CAAC,CAAC;QAE1B,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,MAAM,EAAE,+BAA+B,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CACzE,CAAC;QAEF,MAAM,gBAAgB,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAEpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,OAAO,EAAE,4BAA4B,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAC7B,CAAC;QACF,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EACC,MAAM,EACN,mFAAmF,CACpF,CACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,CACL,GAAG;SACA,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,SAAS,CACtC,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,SAAS,oBAAoB,CAAC,GAAW;IACvC,OAAO,CACL,GAAG;SACA,IAAI,EAAE;SACN,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,sBAAsB;SACvD,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAc,2BAA2B;SAC5D,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,UAAU,CACvC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,CAAS;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,QAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IACzD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,KAAa,EAAE,GAAoB;IAC5D,OAAO,KAAK;SACT,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC;SAClC,UAAU,CAAC,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC;SACtC,UAAU,CAAC,eAAe,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,YAAoB,EACpB,QAAgB,EAChB,GAAoB;IAEpB,MAAM,IAAI,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,MAAM,QAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAEzD,0CAA0C;YAC1C,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;YAE1D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAA,cAAS,EAAC,QAAQ,CAAC,CAAC;gBAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,gEAAgE;gBAChE,MAAM,OAAO,GAAG,MAAM,QAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACpD,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAElD,IAAI,MAAM,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/B,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,MAAM,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAC5E,CAAC;oBACF,SAAS;gBACX,CAAC;gBAED,MAAM,IAAA,cAAS,EAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACxC,MAAM,QAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CACT,IAAA,UAAC,EAAC,OAAO,EAAE,aAAa,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAClE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["import * as path from 'path';\nimport * as readline from 'readline';\nimport { c } from '../colors';\nimport { ensureDir, fileExists, fsp } from '../utils/fs';\n\ntype AuthType = 'oauth2' | 'bearer' | 'apiKey';\n\ninterface TemplateContext {\n  owner: string;\n  service: string;\n  authType: AuthType;\n}\n\n/**\n * frontmcp template <templateName>\n *\n * Example:\n *   npx frontmcp template 3rd-party-integration\n *\n * This will look for templates in:\n *   src/templates/<templateName>   (built to dist/templates/<templateName>)\n * and copy them into:\n *   integrations/<owner>/<service>\n * with __OWNER__, __SERVICE__, __AUTH_TYPE__ replaced.\n */\nexport async function runTemplate(templateName?: string): Promise<void> {\n  const name = (templateName || '').trim();\n  if (!name) {\n    console.log(c('red', 'Template name is required (e.g. 3rd-party-integration).'));\n    return;\n  }\n\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  const ask = (q: string): Promise<string> =>\n    new Promise((resolve) => rl.question(q, (ans) => resolve(ans.trim())));\n\n  try {\n    const templatesRoot = path.resolve(__dirname, '..', 'templates');\n\n    // 1) Collect available templates up-front\n    const available = await listAvailableTemplates(templatesRoot);\n    if (!available.length) {\n      console.log(\n        c('red', `No templates found under ${path.relative(process.cwd(), templatesRoot)}.`),\n      );\n      return;\n    }\n\n    // 2) Sanitize the name and choose the actual template folder\n    const sanitized = sanitizeTemplateName(name);\n    let selected: string | null = null;\n\n    if (available.includes(name)) {\n      selected = name;\n    } else if (available.includes(sanitized)) {\n      selected = sanitized;\n      if (sanitized !== name) {\n        console.log(\n          c('yellow', `[template] Template \"${name}\" not found, using sanitized \"${sanitized}\"`),\n        );\n      }\n    }\n\n    if (!selected) {\n      console.log(\n        c('red', `Template \"${name}\" not found under ${path.relative(process.cwd(), templatesRoot)}.`),\n      );\n      console.log(c('gray', '\\nAvailable templates:'));\n      for (const t of available) {\n        console.log('  -', t);\n      }\n      return;\n    }\n\n    const templateRoot = path.resolve(templatesRoot, selected);\n\n    console.log(\n      c('cyan', '[template]') + ` Using template \"${selected}\" from src/templates/${selected}`,\n    );\n\n    // Ask for owner & service\n    let owner = await ask(`Third-party owner (e.g. google, github, slack): `);\n    if (!owner) {\n      console.log(c('red', 'Owner is required.'));\n      return;\n    }\n    owner = sanitizeSlug(owner);\n\n    let service = await ask(\n      `Third-party service (e.g. gmail, slack-bot): `,\n    );\n    if (!service) {\n      console.log(c('red', 'Service is required.'));\n      return;\n    }\n    service = sanitizeSlug(service);\n\n    // Auth type (for placeholders only – you can use or ignore in templates)\n    let authRaw = await ask(\n      `Default auth type (oauth2/bearer/apiKey) [oauth2]: `,\n    );\n    if (!authRaw) authRaw = 'oauth2';\n    const authType = authRaw as AuthType;\n    if (!['oauth2', 'bearer', 'apiKey'].includes(authType)) {\n      console.log(c('red', `Invalid auth type: ${authRaw}`));\n      return;\n    }\n\n    const ctx: TemplateContext = { owner, service, authType };\n\n    const cwd = process.cwd();\n    const destRoot = path.resolve(cwd, 'integrations', owner, service);\n    await ensureDir(destRoot);\n\n    console.log(\n      c('gray', `[template] Scaffolding into ${path.relative(cwd, destRoot)}`),\n    );\n\n    await copyTemplateTree(templateRoot, destRoot, ctx);\n\n    console.log('');\n    console.log(\n      c('green', '✔ Template hydrated into: ') +\n      path.relative(cwd, destRoot),\n    );\n    console.log(\n      c(\n        'gray',\n        'You can now edit or delete the generated example files and create your own tools.',\n      ),\n    );\n  } finally {\n    rl.close();\n  }\n}\n\n/* -------------------------------------------------------------------------- */\n/* Helpers                                                                    */\n/* -------------------------------------------------------------------------- */\n\nfunction sanitizeSlug(val: string): string {\n  return (\n    val\n      .trim()\n      .toLowerCase()\n      .replace(/[^a-z0-9-]/g, '-')\n      .replace(/-+/g, '-')\n      .replace(/^-|-$/g, '') || 'service'\n  );\n}\n\n// More permissive for template folder names (allow . _ -)\nfunction sanitizeTemplateName(val: string): string {\n  return (\n    val\n      .trim()\n      .replace(/[^a-zA-Z0-9._-]/g, '-') // replace weird chars\n      .replace(/-+/g, '-')              // collapse multiple dashes\n      .replace(/^-|-$/g, '') || 'template'\n  );\n}\n\nasync function dirExists(p: string): Promise<boolean> {\n  try {\n    const st = await fsp.stat(p);\n    return st.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nasync function listAvailableTemplates(templatesRoot: string): Promise<string[]> {\n  try {\n    const entries = await fsp.readdir(templatesRoot, { withFileTypes: true });\n    return entries.filter((e) => e.isDirectory()).map((e) => e.name);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Replace placeholders in both filenames and file contents.\n *\n * Supported placeholders:\n *   __OWNER__\n *   __SERVICE__\n *   __AUTH_TYPE__\n */\nfunction applyPlaceholders(input: string, ctx: TemplateContext): string {\n  return input\n    .replaceAll('__OWNER__', ctx.owner)\n    .replaceAll('__SERVICE__', ctx.service)\n    .replaceAll('__AUTH_TYPE__', ctx.authType);\n}\n\nasync function copyTemplateTree(\n  templateRoot: string,\n  destRoot: string,\n  ctx: TemplateContext,\n): Promise<void> {\n  const walk = async (srcDir: string) => {\n    const entries = await fsp.readdir(srcDir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const srcPath = path.join(srcDir, entry.name);\n      const relFromRoot = path.relative(templateRoot, srcPath);\n\n      // Apply placeholders in path segments too\n      const relWithPlaceholders = applyPlaceholders(relFromRoot, ctx);\n      const destPath = path.join(destRoot, relWithPlaceholders);\n\n      if (entry.isDirectory()) {\n        await ensureDir(destPath);\n        await walk(srcPath);\n      } else if (entry.isFile()) {\n        // Read template file, apply placeholders, write if not existing\n        const content = await fsp.readFile(srcPath, 'utf8');\n        const processed = applyPlaceholders(content, ctx);\n\n        if (await fileExists(destPath)) {\n          console.log(\n            c('gray', `skip: ${path.relative(process.cwd(), destPath)} already exists`),\n          );\n          continue;\n        }\n\n        await ensureDir(path.dirname(destPath));\n        await fsp.writeFile(destPath, processed, 'utf8');\n        console.log(\n          c('green', `✓ created ${path.relative(process.cwd(), destPath)}`),\n        );\n      }\n    }\n  };\n\n  await walk(templateRoot);\n}\n"]}

package/src/templates/3rd-party-integration/src/http-client.d.ts

@@ -0,0 +1,20 @@
+import { ExecuteContext } from "./mcp-http-types";
+export interface HttpRequestOptions {
+    method: string;
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+    bodyJson?: unknown;
+}
+export interface HttpResponseRaw {
+    status: number;
+    headers: Record<string, string>;
+    json?: any;
+    text?: string;
+}
+export declare class HttpClient {
+    private ctx;
+    constructor(ctx: ExecuteContext);
+    private resolveAuthHeader;
+    request(options: HttpRequestOptions): Promise<HttpResponseRaw>;
+}

package/src/templates/3rd-party-integration/src/http-client.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+class HttpClient {
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    resolveAuthHeader() {
+        const { auth } = this.ctx;
+        if (auth.oauth2?.accessToken) {
+            return { Authorization: `Bearer ${auth.oauth2.accessToken}` };
+        }
+        if (auth.bearer?.token) {
+            return { Authorization: `Bearer ${auth.bearer.token}` };
+        }
+        if (auth.apiKey?.value) {
+            const headerName = auth.apiKey.name ?? "X-API-Key";
+            return { [headerName]: auth.apiKey.value };
+        }
+        return {};
+    }
+    async request(options) {
+        const fetchImpl = this.ctx.fetch ?? fetch;
+        const url = new URL(options.path, this.ctx.baseUrl);
+        if (options.query) {
+            for (const [k, v] of Object.entries(options.query)) {
+                if (v === undefined)
+                    continue;
+                url.searchParams.set(k, String(v));
+            }
+        }
+        const baseHeaders = {
+            Accept: "application/json",
+            ...(this.ctx.requestId ? { "X-Request-Id": this.ctx.requestId } : {}),
+            ...this.resolveAuthHeader(),
+            ...(options.headers ?? {})
+        };
+        const controller = new AbortController();
+        const timeoutMs = this.ctx.timeoutMs ?? 15000;
+        const t = setTimeout(() => controller.abort(), timeoutMs);
+        const init = {
+            method: options.method,
+            headers: baseHeaders,
+            signal: controller.signal
+        };
+        if (options.bodyJson !== undefined) {
+            init.body = JSON.stringify(options.bodyJson);
+            baseHeaders["Content-Type"] = baseHeaders["Content-Type"] ?? "application/json";
+        }
+        if (this.ctx.logDebug) {
+            console.debug("[HttpClient] Request", {
+                url: url.toString(),
+                method: options.method,
+                headers: baseHeaders,
+                body: options.bodyJson
+            });
+        }
+        try {
+            const res = await fetchImpl(url.toString(), init);
+            const headersObj = Object.fromEntries(res.headers.entries());
+            let json;
+            let text;
+            const contentType = res.headers.get("content-type") || "";
+            if (contentType.includes("application/json")) {
+                try {
+                    json = await res.json();
+                }
+                catch {
+                    json = undefined;
+                }
+            }
+            else {
+                try {
+                    text = await res.text();
+                }
+                catch {
+                    text = undefined;
+                }
+            }
+            if (this.ctx.logDebug) {
+                console.debug("[HttpClient] Response", {
+                    status: res.status,
+                    headers: headersObj,
+                    json,
+                    text
+                });
+            }
+            return {
+                status: res.status,
+                headers: headersObj,
+                json,
+                text
+            };
+        }
+        finally {
+            clearTimeout(t);
+        }
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=http-client.js.map

package/src/templates/3rd-party-integration/src/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../../../../src/templates/3rd-party-integration/src/http-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { ExecuteContext } from \"./mcp-http-types\";\n\nexport interface HttpRequestOptions {\n  method: string;\n  path: string; // already resolved (including path params)\n  query?: Record<string, string | number | boolean | undefined>;\n  headers?: Record<string, string>;\n  bodyJson?: unknown;\n}\n\nexport interface HttpResponseRaw {\n  status: number;\n  headers: Record<string, string>;\n  json?: any;\n  text?: string;\n}\n\nexport class HttpClient {\n  constructor(private ctx: ExecuteContext) {}\n\n  private resolveAuthHeader(): Record<string, string> {\n    const { auth } = this.ctx;\n    if (auth.oauth2?.accessToken) {\n      return { Authorization: `Bearer ${auth.oauth2.accessToken}` };\n    }\n    if (auth.bearer?.token) {\n      return { Authorization: `Bearer ${auth.bearer.token}` };\n    }\n    if (auth.apiKey?.value) {\n      const headerName = auth.apiKey.name ?? \"X-API-Key\";\n      return { [headerName]: auth.apiKey.value };\n    }\n    return {};\n  }\n\n  async request(options: HttpRequestOptions): Promise<HttpResponseRaw> {\n    const fetchImpl = this.ctx.fetch ?? fetch;\n    const url = new URL(options.path, this.ctx.baseUrl);\n\n    if (options.query) {\n      for (const [k, v] of Object.entries(options.query)) {\n        if (v === undefined) continue;\n        url.searchParams.set(k, String(v));\n      }\n    }\n\n    const baseHeaders: Record<string, string> = {\n      Accept: \"application/json\",\n      ...(this.ctx.requestId ? { \"X-Request-Id\": this.ctx.requestId } : {}),\n      ...this.resolveAuthHeader(),\n      ...(options.headers ?? {})\n    };\n\n    const controller = new AbortController();\n    const timeoutMs = this.ctx.timeoutMs ?? 15000;\n    const t = setTimeout(() => controller.abort(), timeoutMs);\n\n    const init: RequestInit = {\n      method: options.method,\n      headers: baseHeaders,\n      signal: controller.signal\n    };\n\n    if (options.bodyJson !== undefined) {\n      init.body = JSON.stringify(options.bodyJson);\n      baseHeaders[\"Content-Type\"] = baseHeaders[\"Content-Type\"] ?? \"application/json\";\n    }\n\n    if (this.ctx.logDebug) {\n      console.debug(\"[HttpClient] Request\", {\n        url: url.toString(),\n        method: options.method,\n        headers: baseHeaders,\n        body: options.bodyJson\n      });\n    }\n\n    try {\n      const res = await fetchImpl(url.toString(), init);\n      const headersObj = Object.fromEntries(res.headers.entries());\n\n      let json: any | undefined;\n      let text: string | undefined;\n      const contentType = res.headers.get(\"content-type\") || \"\";\n\n      if (contentType.includes(\"application/json\")) {\n        try {\n          json = await res.json();\n        } catch {\n          json = undefined;\n        }\n      } else {\n        try {\n          text = await res.text();\n        } catch {\n          text = undefined;\n        }\n      }\n\n      if (this.ctx.logDebug) {\n        console.debug(\"[HttpClient] Response\", {\n          status: res.status,\n          headers: headersObj,\n          json,\n          text\n        });\n      }\n\n      return {\n        status: res.status,\n        headers: headersObj,\n        json,\n        text\n      };\n    } finally {\n      clearTimeout(t);\n    }\n  }\n}\n"]}

package/src/templates/3rd-party-integration/src/mcp-http-types.d.ts

@@ -0,0 +1,199 @@
+import { z } from "zod";
+/**
+ * Shared output wrapper: all HTTP tools must return { status, headers, body }.
+ */
+export declare const HttpStatusSchema: z.ZodNumber;
+export declare const HttpHeadersSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export declare const makeHttpOutputSchema: <TBody extends z.ZodTypeAny>(bodySchema: TBody) => z.ZodObject<{
+    status: z.ZodNumber;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: TBody;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    status: z.ZodNumber;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: TBody;
+}>, any> extends infer T ? { [k in keyof T]: T[k]; } : never, z.baseObjectInputType<{
+    status: z.ZodNumber;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: TBody;
+}> extends infer T_1 ? { [k_1 in keyof T_1]: T_1[k_1]; } : never>;
+export type HttpOutput<TBody> = {
+    status: number;
+    headers?: Record<string, string>;
+    body: TBody;
+};
+/**
+ * Shared auth/context types for TS tools.
+ */
+export declare const AuthContextSchema: z.ZodObject<{
+    oauth2: z.ZodOptional<z.ZodObject<{
+        accessToken: z.ZodString;
+        idToken: z.ZodOptional<z.ZodString>;
+        claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        accessToken: string;
+        idToken?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    }, {
+        accessToken: string;
+        idToken?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    }>>;
+    bearer: z.ZodOptional<z.ZodObject<{
+        token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        token: string;
+    }, {
+        token: string;
+    }>>;
+    apiKey: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        name?: string | undefined;
+    }, {
+        value: string;
+        name?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    oauth2?: {
+        accessToken: string;
+        idToken?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    } | undefined;
+    bearer?: {
+        token: string;
+    } | undefined;
+    apiKey?: {
+        value: string;
+        name?: string | undefined;
+    } | undefined;
+}, {
+    oauth2?: {
+        accessToken: string;
+        idToken?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    } | undefined;
+    bearer?: {
+        token: string;
+    } | undefined;
+    apiKey?: {
+        value: string;
+        name?: string | undefined;
+    } | undefined;
+}>;
+export type AuthContext = z.infer<typeof AuthContextSchema>;
+export declare const ExecuteContextSchema: z.ZodObject<{
+    baseUrl: z.ZodString;
+    auth: z.ZodObject<{
+        oauth2: z.ZodOptional<z.ZodObject<{
+            accessToken: z.ZodString;
+            idToken: z.ZodOptional<z.ZodString>;
+            claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, "strip", z.ZodTypeAny, {
+            accessToken: string;
+            idToken?: string | undefined;
+            claims?: Record<string, any> | undefined;
+        }, {
+            accessToken: string;
+            idToken?: string | undefined;
+            claims?: Record<string, any> | undefined;
+        }>>;
+        bearer: z.ZodOptional<z.ZodObject<{
+            token: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            token: string;
+        }, {
+            token: string;
+        }>>;
+        apiKey: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name?: string | undefined;
+        }, {
+            value: string;
+            name?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        oauth2?: {
+            accessToken: string;
+            idToken?: string | undefined;
+            claims?: Record<string, any> | undefined;
+        } | undefined;
+        bearer?: {
+            token: string;
+        } | undefined;
+        apiKey?: {
+            value: string;
+            name?: string | undefined;
+        } | undefined;
+    }, {
+        oauth2?: {
+            accessToken: string;
+            idToken?: string | undefined;
+            claims?: Record<string, any> | undefined;
+        } | undefined;
+        bearer?: {
+            token: string;
+        } | undefined;
+        apiKey?: {
+            value: string;
+            name?: string | undefined;
+        } | undefined;
+    }>;
+    fetch: z.ZodOptional<z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodAny], z.ZodUnknown>, z.ZodPromise<z.ZodAny>>>;
+    requestId: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    logDebug: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    baseUrl: string;
+    auth: {
+        oauth2?: {
+            accessToken: string;
+            idToken?: string | undefined;
+            claims?: Record<string, any> | undefined;
+        } | undefined;
+        bearer?: {
+            token: string;
+        } | undefined;
+        apiKey?: {
+            value: string;
+            name?: string | undefined;
+        } | undefined;
+    };
+    fetch?: ((args_0: string, args_1: any, ...args: unknown[]) => Promise<any>) | undefined;
+    requestId?: string | undefined;
+    timeoutMs?: number | undefined;
+    logDebug?: boolean | undefined;
+}, {
+    baseUrl: string;
+    auth: {
+        oauth2?: {
+            accessToken: string;
+            idToken?: string | undefined;
+            claims?: Record<string, any> | undefined;
+        } | undefined;
+        bearer?: {
+            token: string;
+        } | undefined;
+        apiKey?: {
+            value: string;
+            name?: string | undefined;
+        } | undefined;
+    };
+    fetch?: ((args_0: string, args_1: any, ...args: unknown[]) => Promise<any>) | undefined;
+    requestId?: string | undefined;
+    timeoutMs?: number | undefined;
+    logDebug?: boolean | undefined;
+}>;
+export type ExecuteContext = z.infer<typeof ExecuteContextSchema>;
+/**
+ * Generic execute signature for TS tools.
+ */
+export type ToolExecute<I, B> = (args: {
+    input: I;
+    ctx: ExecuteContext;
+}) => Promise<HttpOutput<B>>;

package/src/templates/3rd-party-integration/src/mcp-http-types.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecuteContextSchema = exports.AuthContextSchema = exports.makeHttpOutputSchema = exports.HttpHeadersSchema = exports.HttpStatusSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Shared output wrapper: all HTTP tools must return { status, headers, body }.
+ */
+exports.HttpStatusSchema = zod_1.z.number().int().min(100).max(599);
+exports.HttpHeadersSchema = zod_1.z.record(zod_1.z.string());
+const makeHttpOutputSchema = (bodySchema) => zod_1.z.object({
+    status: exports.HttpStatusSchema,
+    headers: exports.HttpHeadersSchema.optional(),
+    body: bodySchema
+});
+exports.makeHttpOutputSchema = makeHttpOutputSchema;
+/**
+ * Shared auth/context types for TS tools.
+ */
+exports.AuthContextSchema = zod_1.z.object({
+    oauth2: zod_1.z
+        .object({
+        accessToken: zod_1.z.string(),
+        idToken: zod_1.z.string().optional(),
+        claims: zod_1.z.record(zod_1.z.any()).optional()
+    })
+        .optional(),
+    bearer: zod_1.z
+        .object({
+        token: zod_1.z.string()
+    })
+        .optional(),
+    apiKey: zod_1.z
+        .object({
+        name: zod_1.z.string().optional(),
+        value: zod_1.z.string()
+    })
+        .optional()
+});
+exports.ExecuteContextSchema = zod_1.z.object({
+    baseUrl: zod_1.z.string().url(),
+    auth: exports.AuthContextSchema,
+    fetch: zod_1.z
+        .function()
+        .args(zod_1.z.string(), zod_1.z.any())
+        .returns(zod_1.z.promise(zod_1.z.any()))
+        .optional(),
+    requestId: zod_1.z.string().optional(),
+    timeoutMs: zod_1.z.number().int().positive().optional(),
+    logDebug: zod_1.z.boolean().optional()
+});
+//# sourceMappingURL=mcp-http-types.js.map

package/src/templates/3rd-party-integration/src/mcp-http-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http-types.js","sourceRoot":"","sources":["../../../../../src/templates/3rd-party-integration/src/mcp-http-types.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;GAEG;AAEU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACtD,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAE/C,MAAM,oBAAoB,GAAG,CAA6B,UAAiB,EAAE,EAAE,CACpF,OAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,wBAAgB;IACxB,OAAO,EAAE,yBAAiB,CAAC,QAAQ,EAAE;IACrC,IAAI,EAAE,UAAU;CACjB,CAAC,CAAC;AALQ,QAAA,oBAAoB,wBAK5B;AAQL;;GAEG;AAEU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;KACrC,CAAC;SACD,QAAQ,EAAE;IACb,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;KAClB,CAAC;SACD,QAAQ,EAAE;IACb,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;KAClB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAIU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,IAAI,EAAE,yBAAiB;IACvB,KAAK,EAAE,OAAC;SACL,QAAQ,EAAE;SACV,IAAI,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC;SACzB,OAAO,CAAC,OAAC,CAAC,OAAO,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC;SAC3B,QAAQ,EAAE;IACb,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\n/**\n * Shared output wrapper: all HTTP tools must return { status, headers, body }.\n */\n\nexport const HttpStatusSchema = z.number().int().min(100).max(599);\nexport const HttpHeadersSchema = z.record(z.string());\n\nexport const makeHttpOutputSchema = <TBody extends z.ZodTypeAny>(bodySchema: TBody) =>\n  z.object({\n    status: HttpStatusSchema,\n    headers: HttpHeadersSchema.optional(),\n    body: bodySchema\n  });\n\nexport type HttpOutput<TBody> = {\n  status: number;\n  headers?: Record<string, string>;\n  body: TBody;\n};\n\n/**\n * Shared auth/context types for TS tools.\n */\n\nexport const AuthContextSchema = z.object({\n  oauth2: z\n    .object({\n      accessToken: z.string(),\n      idToken: z.string().optional(),\n      claims: z.record(z.any()).optional()\n    })\n    .optional(),\n  bearer: z\n    .object({\n      token: z.string()\n    })\n    .optional(),\n  apiKey: z\n    .object({\n      name: z.string().optional(),\n      value: z.string()\n    })\n    .optional()\n});\n\nexport type AuthContext = z.infer<typeof AuthContextSchema>;\n\nexport const ExecuteContextSchema = z.object({\n  baseUrl: z.string().url(),\n  auth: AuthContextSchema,\n  fetch: z\n    .function()\n    .args(z.string(), z.any())\n    .returns(z.promise(z.any()))\n    .optional(),\n  requestId: z.string().optional(),\n  timeoutMs: z.number().int().positive().optional(),\n  logDebug: z.boolean().optional()\n});\n\nexport type ExecuteContext = z.infer<typeof ExecuteContextSchema>;\n\n/**\n * Generic execute signature for TS tools.\n */\n\nexport type ToolExecute<I, B> = (args: {\n  input: I;\n  ctx: ExecuteContext;\n}) => Promise<HttpOutput<B>>;\n"]}