@jaypie/mcp 0.3.2 → 0.4.0

package/dist/suite.js

@@ -0,0 +1,2442 @@
+import { fabricService, createServiceSuite } from '@jaypie/fabric';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import matter from 'gray-matter';
+import { gt } from 'semver';
+import * as https from 'node:https';
+import { Llm } from '@jaypie/llm';
+import { spawn } from 'node:child_process';
+import * as os from 'node:os';
+
+/**
+ * Datadog API integration module
+ */
+const nullLogger$1 = {
+    info: () => { },
+    error: () => { },
+};
+/**
+ * Get Datadog credentials from environment variables
+ */
+function getDatadogCredentials() {
+    const apiKey = process.env.DATADOG_API_KEY || process.env.DD_API_KEY;
+    const appKey = process.env.DATADOG_APP_KEY ||
+        process.env.DATADOG_APPLICATION_KEY ||
+        process.env.DD_APP_KEY ||
+        process.env.DD_APPLICATION_KEY;
+    if (!apiKey || !appKey) {
+        return null;
+    }
+    return { apiKey, appKey };
+}
+/**
+ * Build query string from environment variables and options
+ */
+function buildDatadogQuery(options) {
+    const ddEnv = process.env.DD_ENV;
+    const ddService = process.env.DD_SERVICE;
+    const ddSource = process.env.DD_SOURCE;
+    const ddQuery = process.env.DD_QUERY;
+    const queryParts = [];
+    // Add source (parameter > env var > default 'lambda')
+    const effectiveSource = options.source || ddSource || "lambda";
+    queryParts.push(`source:${effectiveSource}`);
+    // Add env (parameter > env var)
+    const effectiveEnv = options.env || ddEnv;
+    if (effectiveEnv) {
+        queryParts.push(`env:${effectiveEnv}`);
+    }
+    // Add service (parameter > env var)
+    const effectiveService = options.service || ddService;
+    if (effectiveService) {
+        queryParts.push(`service:${effectiveService}`);
+    }
+    // Add base query from DD_QUERY if available
+    if (ddQuery) {
+        queryParts.push(ddQuery);
+    }
+    // Add user-provided query terms
+    if (options.query) {
+        queryParts.push(options.query);
+    }
+    return queryParts.join(" ");
+}
+/**
+ * Search Datadog logs
+ */
+async function searchDatadogLogs(credentials, options = {}, logger = nullLogger$1) {
+    const effectiveQuery = buildDatadogQuery(options);
+    const effectiveFrom = options.from || "now-15m";
+    const effectiveTo = options.to || "now";
+    const effectiveLimit = Math.min(options.limit || 50, 1000);
+    const effectiveSort = options.sort || "-timestamp";
+    logger.info(`Effective query: ${effectiveQuery}`);
+    logger.info(`Search params: from=${effectiveFrom}, to=${effectiveTo}, limit=${effectiveLimit}, sort=${effectiveSort}`);
+    const requestBody = JSON.stringify({
+        filter: {
+            query: effectiveQuery,
+            from: effectiveFrom,
+            to: effectiveTo,
+        },
+        page: {
+            limit: effectiveLimit,
+        },
+        sort: effectiveSort,
+    });
+    return new Promise((resolve) => {
+        const requestOptions = {
+            hostname: "api.datadoghq.com",
+            port: 443,
+            path: "/api/v2/logs/events/search",
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "DD-API-KEY": credentials.apiKey,
+                "DD-APPLICATION-KEY": credentials.appKey,
+                "Content-Length": Buffer.byteLength(requestBody),
+            },
+        };
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                logger.info(`Response status: ${res.statusCode}`);
+                if (res.statusCode !== 200) {
+                    logger.error(`Datadog API error: ${res.statusCode}`);
+                    let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
+                    if (res.statusCode === 400) {
+                        errorMessage = `Invalid query syntax. Check your query: "${effectiveQuery}". Datadog error: ${data}`;
+                    }
+                    else if (res.statusCode === 403) {
+                        errorMessage =
+                            "Access denied. Verify your API and Application keys have logs_read permission.";
+                    }
+                    else if (res.statusCode === 429) {
+                        errorMessage =
+                            "Rate limited by Datadog. Wait a moment and try again, or reduce your query scope.";
+                    }
+                    resolve({
+                        success: false,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        logs: [],
+                        error: errorMessage,
+                    });
+                    return;
+                }
+                try {
+                    const response = JSON.parse(data);
+                    const logs = (response.data || []).map((log) => {
+                        const attrs = log.attributes || {};
+                        return {
+                            id: log.id,
+                            timestamp: attrs.timestamp,
+                            status: attrs.status,
+                            service: attrs.service,
+                            message: attrs.message,
+                            attributes: attrs.attributes,
+                        };
+                    });
+                    logger.info(`Retrieved ${logs.length} log entries`);
+                    resolve({
+                        success: true,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        logs,
+                    });
+                }
+                catch (parseError) {
+                    logger.error("Failed to parse Datadog response:", parseError);
+                    resolve({
+                        success: false,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        logs: [],
+                        error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+                    });
+                }
+            });
+        });
+        req.on("error", (error) => {
+            logger.error("Request error:", error);
+            resolve({
+                success: false,
+                query: effectiveQuery,
+                timeRange: { from: effectiveFrom, to: effectiveTo },
+                logs: [],
+                error: `Connection error: ${error.message}`,
+            });
+        });
+        req.write(requestBody);
+        req.end();
+    });
+}
+/**
+ * Aggregate Datadog logs using the Analytics API
+ * Groups logs by specified fields and computes aggregations
+ */
+async function aggregateDatadogLogs(credentials, options, logger = nullLogger$1) {
+    const effectiveQuery = buildDatadogQuery(options);
+    const effectiveFrom = options.from || "now-15m";
+    const effectiveTo = options.to || "now";
+    const groupBy = options.groupBy;
+    const compute = options.compute || [{ aggregation: "count" }];
+    logger.info(`Analytics query: ${effectiveQuery}`);
+    logger.info(`Group by: ${groupBy.join(", ")}`);
+    logger.info(`Time range: ${effectiveFrom} to ${effectiveTo}`);
+    // Build compute array - each item needs aggregation and type
+    const computeItems = compute.map((c) => {
+        const item = {
+            aggregation: c.aggregation,
+            type: "total",
+        };
+        if (c.metric) {
+            item.metric = c.metric;
+        }
+        return item;
+    });
+    // Build group_by with proper sort configuration
+    const groupByItems = groupBy.map((field) => {
+        const item = {
+            facet: field,
+            limit: 100,
+            sort: {
+                type: "measure",
+                order: "desc",
+                aggregation: compute[0]?.aggregation || "count",
+            },
+        };
+        return item;
+    });
+    const requestBody = JSON.stringify({
+        filter: {
+            query: effectiveQuery,
+            from: effectiveFrom,
+            to: effectiveTo,
+        },
+        group_by: groupByItems,
+        compute: computeItems,
+        page: {
+            limit: 100,
+        },
+    });
+    return new Promise((resolve) => {
+        const requestOptions = {
+            hostname: "api.datadoghq.com",
+            port: 443,
+            path: "/api/v2/logs/analytics/aggregate",
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "DD-API-KEY": credentials.apiKey,
+                "DD-APPLICATION-KEY": credentials.appKey,
+                "Content-Length": Buffer.byteLength(requestBody),
+            },
+        };
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                logger.info(`Response status: ${res.statusCode}`);
+                if (res.statusCode !== 200) {
+                    logger.error(`Datadog Analytics API error: ${res.statusCode}`);
+                    let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
+                    if (res.statusCode === 400) {
+                        errorMessage = `Invalid query or groupBy fields. Verify facet names exist: ${groupBy.join(", ")}. Datadog error: ${data}`;
+                    }
+                    else if (res.statusCode === 403) {
+                        errorMessage =
+                            "Access denied. Verify your API and Application keys have logs_read permission.";
+                    }
+                    else if (res.statusCode === 429) {
+                        errorMessage =
+                            "Rate limited by Datadog. Wait a moment and try again, or reduce your query scope.";
+                    }
+                    resolve({
+                        success: false,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        groupBy,
+                        buckets: [],
+                        error: errorMessage,
+                    });
+                    return;
+                }
+                try {
+                    const response = JSON.parse(data);
+                    const buckets = (response.data?.buckets || []).map((bucket) => ({
+                        by: bucket.by || {},
+                        computes: bucket.computes || {},
+                    }));
+                    logger.info(`Retrieved ${buckets.length} aggregation buckets`);
+                    resolve({
+                        success: true,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        groupBy,
+                        buckets,
+                    });
+                }
+                catch (parseError) {
+                    logger.error("Failed to parse Datadog analytics response:", parseError);
+                    resolve({
+                        success: false,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        groupBy,
+                        buckets: [],
+                        error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+                    });
+                }
+            });
+        });
+        req.on("error", (error) => {
+            logger.error("Request error:", error);
+            resolve({
+                success: false,
+                query: effectiveQuery,
+                timeRange: { from: effectiveFrom, to: effectiveTo },
+                groupBy,
+                buckets: [],
+                error: `Connection error: ${error.message}`,
+            });
+        });
+        req.write(requestBody);
+        req.end();
+    });
+}
+/**
+ * List Datadog monitors with optional filtering
+ */
+async function listDatadogMonitors(credentials, options = {}, logger = nullLogger$1) {
+    logger.info("Fetching Datadog monitors");
+    const queryParams = new URLSearchParams();
+    if (options.tags && options.tags.length > 0) {
+        queryParams.set("tags", options.tags.join(","));
+    }
+    if (options.monitorTags && options.monitorTags.length > 0) {
+        queryParams.set("monitor_tags", options.monitorTags.join(","));
+    }
+    if (options.name) {
+        queryParams.set("name", options.name);
+    }
+    const queryString = queryParams.toString();
+    const path = `/api/v1/monitor${queryString ? `?${queryString}` : ""}`;
+    logger.info(`Request path: ${path}`);
+    return new Promise((resolve) => {
+        const requestOptions = {
+            hostname: "api.datadoghq.com",
+            port: 443,
+            path,
+            method: "GET",
+            headers: {
+                "DD-API-KEY": credentials.apiKey,
+                "DD-APPLICATION-KEY": credentials.appKey,
+            },
+        };
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                logger.info(`Response status: ${res.statusCode}`);
+                if (res.statusCode !== 200) {
+                    logger.error(`Datadog Monitors API error: ${res.statusCode}`);
+                    let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
+                    if (res.statusCode === 403) {
+                        errorMessage =
+                            "Access denied. Verify your API and Application keys have monitors_read permission.";
+                    }
+                    else if (res.statusCode === 429) {
+                        errorMessage =
+                            "Rate limited by Datadog. Wait a moment and try again.";
+                    }
+                    resolve({
+                        success: false,
+                        monitors: [],
+                        error: errorMessage,
+                    });
+                    return;
+                }
+                try {
+                    const response = JSON.parse(data);
+                    let monitors = response.map((monitor) => ({
+                        id: monitor.id,
+                        name: monitor.name,
+                        type: monitor.type,
+                        status: monitor.overall_state || "Unknown",
+                        message: monitor.message,
+                        tags: monitor.tags || [],
+                        priority: monitor.priority,
+                        query: monitor.query,
+                        overallState: monitor.overall_state,
+                    }));
+                    // Filter by status if specified
+                    if (options.status && options.status.length > 0) {
+                        monitors = monitors.filter((m) => options.status.includes(m.status));
+                    }
+                    logger.info(`Retrieved ${monitors.length} monitors`);
+                    resolve({
+                        success: true,
+                        monitors,
+                    });
+                }
+                catch (parseError) {
+                    logger.error("Failed to parse Datadog monitors response:", parseError);
+                    resolve({
+                        success: false,
+                        monitors: [],
+                        error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+                    });
+                }
+            });
+        });
+        req.on("error", (error) => {
+            logger.error("Request error:", error);
+            resolve({
+                success: false,
+                monitors: [],
+                error: `Connection error: ${error.message}`,
+            });
+        });
+        req.end();
+    });
+}
+/**
+ * List Datadog Synthetic tests
+ */
+async function listDatadogSynthetics(credentials, options = {}, logger = nullLogger$1) {
+    logger.info("Fetching Datadog Synthetic tests");
+    return new Promise((resolve) => {
+        const requestOptions = {
+            hostname: "api.datadoghq.com",
+            port: 443,
+            path: "/api/v1/synthetics/tests",
+            method: "GET",
+            headers: {
+                "DD-API-KEY": credentials.apiKey,
+                "DD-APPLICATION-KEY": credentials.appKey,
+            },
+        };
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                logger.info(`Response status: ${res.statusCode}`);
+                if (res.statusCode !== 200) {
+                    logger.error(`Datadog Synthetics API error: ${res.statusCode}`);
+                    let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
+                    if (res.statusCode === 403) {
+                        errorMessage =
+                            "Access denied. Verify your API and Application keys have synthetics_read permission.";
+                    }
+                    else if (res.statusCode === 429) {
+                        errorMessage =
+                            "Rate limited by Datadog. Wait a moment and try again.";
+                    }
+                    resolve({
+                        success: false,
+                        tests: [],
+                        error: errorMessage,
+                    });
+                    return;
+                }
+                try {
+                    const response = JSON.parse(data);
+                    let tests = (response.tests || []).map((test) => ({
+                        publicId: test.public_id,
+                        name: test.name,
+                        type: test.type,
+                        status: test.status,
+                        tags: test.tags || [],
+                        locations: test.locations || [],
+                        message: test.message,
+                    }));
+                    // Filter by type if specified
+                    if (options.type) {
+                        tests = tests.filter((t) => t.type === options.type);
+                    }
+                    // Filter by tags if specified
+                    if (options.tags && options.tags.length > 0) {
+                        tests = tests.filter((t) => options.tags.some((tag) => t.tags.includes(tag)));
+                    }
+                    logger.info(`Retrieved ${tests.length} synthetic tests`);
+                    resolve({
+                        success: true,
+                        tests,
+                    });
+                }
+                catch (parseError) {
+                    logger.error("Failed to parse Datadog synthetics response:", parseError);
+                    resolve({
+                        success: false,
+                        tests: [],
+                        error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+                    });
+                }
+            });
+        });
+        req.on("error", (error) => {
+            logger.error("Request error:", error);
+            resolve({
+                success: false,
+                tests: [],
+                error: `Connection error: ${error.message}`,
+            });
+        });
+        req.end();
+    });
+}
+/**
+ * Get recent results for a specific Synthetic test
+ */
+async function getDatadogSyntheticResults(credentials, publicId, logger = nullLogger$1) {
+    logger.info(`Fetching results for Synthetic test: ${publicId}`);
+    return new Promise((resolve) => {
+        const requestOptions = {
+            hostname: "api.datadoghq.com",
+            port: 443,
+            path: `/api/v1/synthetics/tests/${publicId}/results`,
+            method: "GET",
+            headers: {
+                "DD-API-KEY": credentials.apiKey,
+                "DD-APPLICATION-KEY": credentials.appKey,
+            },
+        };
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                logger.info(`Response status: ${res.statusCode}`);
+                if (res.statusCode !== 200) {
+                    logger.error(`Datadog Synthetics Results API error: ${res.statusCode}`);
+                    let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
+                    if (res.statusCode === 403) {
+                        errorMessage =
+                            "Access denied. Verify your API and Application keys have synthetics_read permission.";
+                    }
+                    else if (res.statusCode === 404) {
+                        errorMessage = `Synthetic test '${publicId}' not found. Use datadog_synthetics (without testId) to list available tests.`;
+                    }
+                    else if (res.statusCode === 429) {
+                        errorMessage =
+                            "Rate limited by Datadog. Wait a moment and try again.";
+                    }
+                    resolve({
+                        success: false,
+                        publicId,
+                        results: [],
+                        error: errorMessage,
+                    });
+                    return;
+                }
+                try {
+                    const response = JSON.parse(data);
+                    const results = (response.results || []).map((result) => ({
+                        publicId,
+                        resultId: result.result_id,
+                        status: result.status,
+                        checkTime: result.check_time,
+                        passed: result.result?.passed ?? result.status === 0,
+                        location: result.dc_id?.toString(),
+                    }));
+                    logger.info(`Retrieved ${results.length} synthetic results`);
+                    resolve({
+                        success: true,
+                        publicId,
+                        results,
+                    });
+                }
+                catch (parseError) {
+                    logger.error("Failed to parse Datadog synthetic results:", parseError);
+                    resolve({
+                        success: false,
+                        publicId,
+                        results: [],
+                        error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+                    });
+                }
+            });
+        });
+        req.on("error", (error) => {
+            logger.error("Request error:", error);
+            resolve({
+                success: false,
+                publicId,
+                results: [],
+                error: `Connection error: ${error.message}`,
+            });
+        });
+        req.end();
+    });
+}
+/**
+ * Query Datadog metrics
+ */
+async function queryDatadogMetrics(credentials, options, logger = nullLogger$1) {
+    logger.info(`Querying metrics: ${options.query}`);
+    logger.info(`Time range: ${options.from} to ${options.to}`);
+    const queryParams = new URLSearchParams({
+        query: options.query,
+        from: options.from.toString(),
+        to: options.to.toString(),
+    });
+    return new Promise((resolve) => {
+        const requestOptions = {
+            hostname: "api.datadoghq.com",
+            port: 443,
+            path: `/api/v1/query?${queryParams.toString()}`,
+            method: "GET",
+            headers: {
+                "DD-API-KEY": credentials.apiKey,
+                "DD-APPLICATION-KEY": credentials.appKey,
+            },
+        };
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                logger.info(`Response status: ${res.statusCode}`);
+                if (res.statusCode !== 200) {
+                    logger.error(`Datadog Metrics API error: ${res.statusCode}`);
+                    let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
+                    if (res.statusCode === 400) {
+                        errorMessage = `Invalid metric query. Check format: 'aggregation:metric.name{tags}'. Query: "${options.query}". Datadog error: ${data}`;
+                    }
+                    else if (res.statusCode === 403) {
+                        errorMessage =
+                            "Access denied. Verify your API and Application keys have metrics_read permission.";
+                    }
+                    else if (res.statusCode === 429) {
+                        errorMessage =
+                            "Rate limited by Datadog. Wait a moment and try again, or reduce your time range.";
+                    }
+                    resolve({
+                        success: false,
+                        query: options.query,
+                        timeRange: { from: options.from, to: options.to },
+                        series: [],
+                        error: errorMessage,
+                    });
+                    return;
+                }
+                try {
+                    const response = JSON.parse(data);
+                    const series = (response.series || []).map((s) => ({
+                        metric: s.metric,
+                        scope: s.scope,
+                        pointlist: s.pointlist,
+                        unit: s.unit?.[0]?.name,
+                    }));
+                    logger.info(`Retrieved ${series.length} metric series`);
+                    resolve({
+                        success: true,
+                        query: options.query,
+                        timeRange: { from: options.from, to: options.to },
+                        series,
+                    });
+                }
+                catch (parseError) {
+                    logger.error("Failed to parse Datadog metrics response:", parseError);
+                    resolve({
+                        success: false,
+                        query: options.query,
+                        timeRange: { from: options.from, to: options.to },
+                        series: [],
+                        error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+                    });
+                }
+            });
+        });
+        req.on("error", (error) => {
+            logger.error("Request error:", error);
+            resolve({
+                success: false,
+                query: options.query,
+                timeRange: { from: options.from, to: options.to },
+                series: [],
+                error: `Connection error: ${error.message}`,
+            });
+        });
+        req.end();
+    });
+}
+/**
+ * Search Datadog RUM events
+ */
+async function searchDatadogRum(credentials, options = {}, logger = nullLogger$1) {
+    const effectiveQuery = options.query || "*";
+    const effectiveFrom = options.from || "now-15m";
+    const effectiveTo = options.to || "now";
+    const effectiveLimit = Math.min(options.limit || 50, 1000);
+    const effectiveSort = options.sort || "-timestamp";
+    logger.info(`RUM query: ${effectiveQuery}`);
+    logger.info(`Time range: ${effectiveFrom} to ${effectiveTo}`);
+    const requestBody = JSON.stringify({
+        filter: {
+            query: effectiveQuery,
+            from: effectiveFrom,
+            to: effectiveTo,
+        },
+        page: {
+            limit: effectiveLimit,
+        },
+        sort: effectiveSort,
+    });
+    return new Promise((resolve) => {
+        const requestOptions = {
+            hostname: "api.datadoghq.com",
+            port: 443,
+            path: "/api/v2/rum/events/search",
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "DD-API-KEY": credentials.apiKey,
+                "DD-APPLICATION-KEY": credentials.appKey,
+                "Content-Length": Buffer.byteLength(requestBody),
+            },
+        };
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                logger.info(`Response status: ${res.statusCode}`);
+                if (res.statusCode !== 200) {
+                    logger.error(`Datadog RUM API error: ${res.statusCode}`);
+                    let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
+                    // Check for specific "No valid indexes" error which means no RUM app is configured
+                    if (data.includes("No valid indexes")) {
+                        errorMessage =
+                            "No RUM application found. Ensure you have a RUM application configured in Datadog and it has collected data. " +
+                                "You can create a RUM application at https://app.datadoghq.com/rum/list";
+                    }
+                    else if (res.statusCode === 400) {
+                        errorMessage = `Invalid RUM query. Check syntax: "${effectiveQuery}". Datadog error: ${data}`;
+                    }
+                    else if (res.statusCode === 403) {
+                        errorMessage =
+                            "Access denied. Verify your API and Application keys have rum_read permission.";
+                    }
+                    else if (res.statusCode === 429) {
+                        errorMessage =
+                            "Rate limited by Datadog. Wait a moment and try again, or reduce your query scope.";
+                    }
+                    resolve({
+                        success: false,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        events: [],
+                        error: errorMessage,
+                    });
+                    return;
+                }
+                try {
+                    const response = JSON.parse(data);
+                    const events = (response.data || []).map((event) => {
+                        const attrs = event.attributes?.attributes || {};
+                        return {
+                            id: event.id,
+                            type: event.type,
+                            timestamp: event.attributes?.timestamp,
+                            sessionId: attrs.session?.id,
+                            viewUrl: attrs.view?.url,
+                            viewName: attrs.view?.name,
+                            errorMessage: attrs.error?.message,
+                            errorType: attrs.error?.type,
+                            attributes: attrs,
+                        };
+                    });
+                    logger.info(`Retrieved ${events.length} RUM events`);
+                    resolve({
+                        success: true,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        events,
+                    });
+                }
+                catch (parseError) {
+                    logger.error("Failed to parse Datadog RUM response:", parseError);
+                    resolve({
+                        success: false,
+                        query: effectiveQuery,
+                        timeRange: { from: effectiveFrom, to: effectiveTo },
+                        events: [],
+                        error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
+                    });
+                }
+            });
+        });
+        req.on("error", (error) => {
+            logger.error("Request error:", error);
+            resolve({
+                success: false,
+                query: effectiveQuery,
+                timeRange: { from: effectiveFrom, to: effectiveTo },
+                events: [],
+                error: `Connection error: ${error.message}`,
+            });
+        });
+        req.write(requestBody);
+        req.end();
+    });
+}
+
+/**
+ * LLM debugging utilities for inspecting raw provider responses
+ */
+// Default models for each provider
+const DEFAULT_MODELS = {
+    anthropic: "claude-sonnet-4-20250514",
+    gemini: "gemini-2.0-flash",
+    openai: "gpt-4o-mini",
+    openrouter: "openai/gpt-4o-mini",
+};
+/**
+ * Make a debug LLM call and return the raw response data for inspection
+ */
+async function debugLlmCall(params, log) {
+    const { provider, message } = params;
+    const model = params.model || DEFAULT_MODELS[provider];
+    try {
+        const llm = new Llm(provider, { model });
+        const result = await llm.operate(message, {
+            user: "[jaypie-mcp] Debug LLM Call",
+        });
+        if (result.error) {
+            return {
+                success: false,
+                provider,
+                model,
+                error: `${result.error.title}: ${result.error.detail || "Unknown error"}`,
+            };
+        }
+        // Calculate total reasoning tokens
+        const reasoningTokens = result.usage.reduce((sum, u) => sum + (u.reasoning || 0), 0);
+        return {
+            success: true,
+            provider,
+            model,
+            content: typeof result.content === "string"
+                ? result.content
+                : JSON.stringify(result.content),
+            reasoning: result.reasoning,
+            reasoningTokens,
+            history: result.history,
+            rawResponses: result.responses,
+            usage: result.usage,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            provider,
+            model,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * List available providers and their default/reasoning models
+ */
+function listLlmProviders() {
+    return {
+        providers: [
+            {
+                name: "openai",
+                defaultModel: DEFAULT_MODELS.openai,
+                reasoningModels: ["o3-mini", "o1-preview", "o1-mini"],
+            },
+            {
+                name: "anthropic",
+                defaultModel: DEFAULT_MODELS.anthropic,
+                reasoningModels: [], // Anthropic doesn't expose reasoning the same way
+            },
+            {
+                name: "gemini",
+                defaultModel: DEFAULT_MODELS.gemini,
+                reasoningModels: [], // Gemini has thoughtsTokenCount but unclear on content
+            },
+            {
+                name: "openrouter",
+                defaultModel: DEFAULT_MODELS.openrouter,
+                reasoningModels: ["openai/o3-mini", "openai/o1-preview"],
+            },
+        ],
+    };
+}
+
+/**
+ * AWS CLI integration module
+ * Provides a structured interface for common AWS operations via the AWS CLI
+ */
+const nullLogger = {
+    info: () => { },
+    error: () => { },
+};
+/**
+ * Parse AWS CLI error messages into user-friendly descriptions
+ */
+function parseAwsError(stderr, service, command) {
+    if (stderr.includes("ExpiredToken") || stderr.includes("Token has expired")) {
+        return "AWS credentials have expired. Run 'aws sso login' or refresh your credentials.";
+    }
+    if (stderr.includes("NoCredentialProviders") ||
+        stderr.includes("Unable to locate credentials")) {
+        return "No AWS credentials found. Configure credentials with 'aws configure' or 'aws sso login'.";
+    }
+    if (stderr.includes("AccessDenied") || stderr.includes("Access Denied")) {
+        return `Access denied for ${service}:${command}. Check your IAM permissions.`;
+    }
+    if (stderr.includes("ResourceNotFoundException")) {
+        return `Resource not found. Check that the specified resource exists in the correct region.`;
+    }
+    if (stderr.includes("ValidationException")) {
+        const match = stderr.match(/ValidationException[^:]*:\s*(.+)/);
+        return match
+            ? `Validation error: ${match[1].trim()}`
+            : "Validation error in request parameters.";
+    }
+    if (stderr.includes("ThrottlingException") ||
+        stderr.includes("Rate exceeded")) {
+        return "AWS API rate limit exceeded. Wait a moment and try again.";
+    }
+    if (stderr.includes("InvalidParameterValue")) {
+        const match = stderr.match(/InvalidParameterValue[^:]*:\s*(.+)/);
+        return match
+            ? `Invalid parameter: ${match[1].trim()}`
+            : "Invalid parameter value provided.";
+    }
+    return stderr.trim();
+}
+/**
+ * Parse relative time strings like 'now-1h' to Unix timestamps
+ */
+function parseRelativeTime(timeStr) {
+    const now = Date.now();
+    if (timeStr === "now") {
+        return now;
+    }
+    // Handle relative time like 'now-15m', 'now-1h', 'now-1d'
+    const relativeMatch = timeStr.match(/^now-(\d+)([smhd])$/);
+    if (relativeMatch) {
+        const value = parseInt(relativeMatch[1], 10);
+        const unit = relativeMatch[2];
+        const multipliers = {
+            s: 1000,
+            m: 60 * 1000,
+            h: 60 * 60 * 1000,
+            d: 24 * 60 * 60 * 1000,
+        };
+        return now - value * multipliers[unit];
+    }
+    // Handle ISO 8601 format
+    const parsed = Date.parse(timeStr);
+    if (!isNaN(parsed)) {
+        return parsed;
+    }
+    // Default to the current time if parsing fails
+    return now;
+}
+/**
+ * Execute an AWS CLI command and return parsed JSON output
+ */
+async function executeAwsCommand(service, command, args, options = {}, logger = nullLogger) {
+    const fullArgs = [service, command, ...args, "--output", "json"];
+    if (options.profile) {
+        fullArgs.push("--profile", options.profile);
+    }
+    if (options.region) {
+        fullArgs.push("--region", options.region);
+    }
+    logger.info(`Executing: aws ${fullArgs.join(" ")}`);
+    return new Promise((resolve) => {
+        const proc = spawn("aws", fullArgs);
+        let stdout = "";
+        let stderr = "";
+        proc.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            if (code !== 0) {
+                logger.error(`AWS CLI error: ${stderr}`);
+                resolve({
+                    success: false,
+                    error: parseAwsError(stderr, service, command),
+                });
+                return;
+            }
+            // Handle empty output (some commands return nothing on success)
+            if (!stdout.trim()) {
+                resolve({ success: true });
+                return;
+            }
+            try {
+                const data = JSON.parse(stdout);
+                resolve({ success: true, data });
+            }
+            catch {
+                // Some commands return plain text
+                resolve({ success: true, data: stdout.trim() });
+            }
+        });
+        proc.on("error", (error) => {
+            if (error.message.includes("ENOENT")) {
+                resolve({
+                    success: false,
+                    error: "AWS CLI not found. Install it from https://aws.amazon.com/cli/",
+                });
+            }
+            else {
+                resolve({ success: false, error: error.message });
+            }
+        });
+    });
+}
+/**
+ * List available AWS profiles from ~/.aws/config and ~/.aws/credentials
+ */
+async function listAwsProfiles(logger = nullLogger) {
+    const profiles = [];
+    const homeDir = os.homedir();
+    try {
+        // Parse ~/.aws/config
+        const configPath = path.join(homeDir, ".aws", "config");
+        try {
+            const configContent = await fs.readFile(configPath, "utf-8");
+            const profileRegex = /\[profile\s+([^\]]+)\]|\[default\]/g;
+            let match;
+            while ((match = profileRegex.exec(configContent)) !== null) {
+                const name = match[1] || "default";
+                profiles.push({
+                    name,
+                    source: "config",
+                });
+            }
+            logger.info(`Found ${profiles.length} profiles in config`);
+        }
+        catch {
+            logger.info("No ~/.aws/config file found");
+        }
+        // Parse ~/.aws/credentials
+        const credentialsPath = path.join(homeDir, ".aws", "credentials");
+        try {
+            const credentialsContent = await fs.readFile(credentialsPath, "utf-8");
+            const profileRegex = /\[([^\]]+)\]/g;
+            let match;
+            while ((match = profileRegex.exec(credentialsContent)) !== null) {
+                const name = match[1];
+                // Only add if not already in the list
+                if (!profiles.find((p) => p.name === name)) {
+                    profiles.push({
+                        name,
+                        source: "credentials",
+                    });
+                }
+            }
+            logger.info(`Total profiles after credentials: ${profiles.length}`);
+        }
+        catch {
+            logger.info("No ~/.aws/credentials file found");
+        }
+        return { success: true, data: profiles };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        logger.error(`Error listing profiles: ${errorMessage}`);
+        return { success: false, error: errorMessage };
+    }
+}
+// Step Functions operations
+async function listStepFunctionExecutions(options, logger = nullLogger) {
+    const args = ["--state-machine-arn", options.stateMachineArn];
+    if (options.statusFilter) {
+        args.push("--status-filter", options.statusFilter);
+    }
+    if (options.maxResults) {
+        args.push("--max-results", String(options.maxResults));
+    }
+    return executeAwsCommand("stepfunctions", "list-executions", args, { profile: options.profile, region: options.region }, logger);
+}
+async function stopStepFunctionExecution(options, logger = nullLogger) {
+    const args = ["--execution-arn", options.executionArn];
+    if (options.cause) {
+        args.push("--cause", options.cause);
+    }
+    return executeAwsCommand("stepfunctions", "stop-execution", args, { profile: options.profile, region: options.region }, logger);
+}
+// Lambda operations
+async function listLambdaFunctions(options = {}, logger = nullLogger) {
+    const args = [];
+    if (options.maxResults) {
+        args.push("--max-items", String(options.maxResults));
+    }
+    const result = await executeAwsCommand("lambda", "list-functions", args, { profile: options.profile, region: options.region }, logger);
+    // Filter by prefix if specified
+    if (result.success && result.data && options.functionNamePrefix) {
+        result.data.Functions = result.data.Functions.filter((f) => f.FunctionName.startsWith(options.functionNamePrefix));
+    }
+    return result;
+}
+async function getLambdaFunction(options, logger = nullLogger) {
+    return executeAwsCommand("lambda", "get-function", ["--function-name", options.functionName], { profile: options.profile, region: options.region }, logger);
+}
+// CloudWatch Logs operations
+async function filterLogEvents(options, logger = nullLogger) {
+    const args = ["--log-group-name", options.logGroupName];
+    if (options.filterPattern) {
+        args.push("--filter-pattern", options.filterPattern);
+    }
+    if (options.startTime) {
+        const startMs = parseRelativeTime(options.startTime);
+        args.push("--start-time", String(startMs));
+    }
+    if (options.endTime) {
+        const endMs = parseRelativeTime(options.endTime);
+        args.push("--end-time", String(endMs));
+    }
+    {
+        args.push("--limit", String(options.limit));
+    }
+    return executeAwsCommand("logs", "filter-log-events", args, { profile: options.profile, region: options.region }, logger);
+}
+// S3 operations
+async function listS3Objects(options, logger = nullLogger) {
+    const args = ["--bucket", options.bucket];
+    if (options.prefix) {
+        args.push("--prefix", options.prefix);
+    }
+    if (options.maxResults) {
+        args.push("--max-items", String(options.maxResults));
+    }
+    return executeAwsCommand("s3api", "list-objects-v2", args, { profile: options.profile, region: options.region }, logger);
+}
+// CloudFormation operations
+async function describeStack(options, logger = nullLogger) {
+    return executeAwsCommand("cloudformation", "describe-stacks", ["--stack-name", options.stackName], { profile: options.profile, region: options.region }, logger);
+}
+// DynamoDB operations
+async function describeDynamoDBTable(options, logger = nullLogger) {
+    return executeAwsCommand("dynamodb", "describe-table", ["--table-name", options.tableName], { profile: options.profile, region: options.region }, logger);
+}
+async function scanDynamoDB(options, logger = nullLogger) {
+    const args = ["--table-name", options.tableName];
+    if (options.filterExpression) {
+        args.push("--filter-expression", options.filterExpression);
+    }
+    if (options.expressionAttributeValues) {
+        args.push("--expression-attribute-values", options.expressionAttributeValues);
+    }
+    {
+        args.push("--limit", String(options.limit));
+    }
+    return executeAwsCommand("dynamodb", "scan", args, { profile: options.profile, region: options.region }, logger);
+}
+async function queryDynamoDB(options, logger = nullLogger) {
+    const args = [
+        "--table-name",
+        options.tableName,
+        "--key-condition-expression",
+        options.keyConditionExpression,
+        "--expression-attribute-values",
+        options.expressionAttributeValues,
+    ];
+    if (options.indexName) {
+        args.push("--index-name", options.indexName);
+    }
+    if (options.filterExpression) {
+        args.push("--filter-expression", options.filterExpression);
+    }
+    if (options.limit) {
+        args.push("--limit", String(options.limit));
+    }
+    if (options.scanIndexForward === false) {
+        args.push("--no-scan-index-forward");
+    }
+    return executeAwsCommand("dynamodb", "query", args, { profile: options.profile, region: options.region }, logger);
+}
+async function getDynamoDBItem(options, logger = nullLogger) {
+    return executeAwsCommand("dynamodb", "get-item", ["--table-name", options.tableName, "--key", options.key], { profile: options.profile, region: options.region }, logger);
+}
+// SQS operations
+async function listSQSQueues(options = {}, logger = nullLogger) {
+    const args = [];
+    if (options.queueNamePrefix) {
+        args.push("--queue-name-prefix", options.queueNamePrefix);
+    }
+    return executeAwsCommand("sqs", "list-queues", args, { profile: options.profile, region: options.region }, logger);
+}
+async function getSQSQueueAttributes(options, logger = nullLogger) {
+    return executeAwsCommand("sqs", "get-queue-attributes", ["--queue-url", options.queueUrl, "--attribute-names", "All"], { profile: options.profile, region: options.region }, logger);
+}
+async function receiveSQSMessage(options, logger = nullLogger) {
+    const args = ["--queue-url", options.queueUrl];
+    {
+        args.push("--max-number-of-messages", String(options.maxNumberOfMessages));
+    }
+    {
+        args.push("--visibility-timeout", String(options.visibilityTimeout));
+    }
+    args.push("--attribute-names", "All");
+    return executeAwsCommand("sqs", "receive-message", args, { profile: options.profile, region: options.region }, logger);
+}
+async function purgeSQSQueue(options, logger = nullLogger) {
+    return executeAwsCommand("sqs", "purge-queue", ["--queue-url", options.queueUrl], { profile: options.profile, region: options.region }, logger);
+}
+
+// ServiceSuite for @jaypie/mcp
+// Provides metadata and direct execution for Jaypie MCP services
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.4.0#988a2bd8"
+    ;
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname$1 = path.dirname(__filename$1);
+const PROMPTS_PATH = path.join(__dirname$1, "..", "prompts");
+const RELEASE_NOTES_PATH = path.join(__dirname$1, "..", "release-notes");
+const SKILLS_PATH = path.join(__dirname$1, "..", "skills");
+// Silent logger for direct execution
+const log = {
+    info: () => { },
+    error: () => { },
+};
+async function parseMarkdownFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const filename = path.basename(filePath);
+        if (content.startsWith("---")) {
+            const parsed = matter(content);
+            const frontMatter = parsed.data;
+            return {
+                filename,
+                description: frontMatter.description,
+                include: frontMatter.include || frontMatter.globs,
+            };
+        }
+        return { filename };
+    }
+    catch {
+        return { filename: path.basename(filePath) };
+    }
+}
+function formatPromptListItem(prompt) {
+    const { filename, description, include } = prompt;
+    if (description && include) {
+        return `* ${filename}: ${description} - Required for ${include}`;
+    }
+    else if (description) {
+        return `* ${filename}: ${description}`;
+    }
+    else if (include) {
+        return `* ${filename} - Required for ${include}`;
+    }
+    else {
+        return `* ${filename}`;
+    }
+}
+async function parseReleaseNoteFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const filename = path.basename(filePath, ".md");
+        if (content.startsWith("---")) {
+            const parsed = matter(content);
+            const frontMatter = parsed.data;
+            return {
+                date: frontMatter.date,
+                filename,
+                summary: frontMatter.summary,
+                version: frontMatter.version || filename,
+            };
+        }
+        return { filename, version: filename };
+    }
+    catch {
+        return { filename: path.basename(filePath, ".md") };
+    }
+}
+function formatReleaseNoteListItem(note) {
+    const { date, packageName, summary, version } = note;
+    const parts = [`* ${packageName}@${version}`];
+    if (date) {
+        parts.push(`(${date})`);
+    }
+    if (summary) {
+        parts.push(`- ${summary}`);
+    }
+    return parts.join(" ");
+}
+function isValidSkillAlias(alias) {
+    const normalized = alias.toLowerCase().trim();
+    // Reject if contains path separators or traversal
+    if (normalized.includes("/") ||
+        normalized.includes("\\") ||
+        normalized.includes("..")) {
+        return false;
+    }
+    // Only allow alphanumeric, hyphens, underscores
+    return /^[a-z0-9_-]+$/.test(normalized);
+}
+async function parseSkillFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const alias = path.basename(filePath, ".md");
+        if (content.startsWith("---")) {
+            const parsed = matter(content);
+            const frontMatter = parsed.data;
+            return {
+                alias,
+                description: frontMatter.description,
+            };
+        }
+        return { alias };
+    }
+    catch {
+        return { alias: path.basename(filePath, ".md") };
+    }
+}
+function formatSkillListItem(skill) {
+    const { alias, description } = skill;
+    if (description) {
+        return `* ${alias} - ${description}`;
+    }
+    return `* ${alias}`;
+}
+async function getPackageReleaseNotes(packageName) {
+    const packageDir = path.join(RELEASE_NOTES_PATH, packageName);
+    try {
+        const files = await fs.readdir(packageDir);
+        const mdFiles = files.filter((file) => file.endsWith(".md"));
+        const notes = await Promise.all(mdFiles.map(async (file) => {
+            const parsed = await parseReleaseNoteFile(path.join(packageDir, file));
+            return { ...parsed, packageName };
+        }));
+        return notes.sort((a, b) => {
+            if (!a.version || !b.version)
+                return 0;
+            try {
+                return gt(a.version, b.version) ? -1 : 1;
+            }
+            catch {
+                return b.version.localeCompare(a.version);
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function filterReleaseNotesSince(notes, sinceVersion) {
+    return notes.filter((note) => {
+        if (!note.version)
+            return false;
+        try {
+            return gt(note.version, sinceVersion);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+// =============================================================================
+// DOCS SERVICES
+// =============================================================================
+const version = fabricService({
+    alias: "version",
+    description: `Prints the current version and hash, \`${BUILD_VERSION_STRING}\``,
+    input: {},
+    service: async () => BUILD_VERSION_STRING,
+});
+const skill = fabricService({
+    alias: "skill",
+    description: "Access Jaypie development documentation. Pass a skill alias (e.g., 'aws', 'tests', 'errors') to get that documentation. Pass 'index' or no argument to list all available skills.",
+    input: {
+        alias: {
+            type: String,
+            required: false,
+            description: "Skill alias (e.g., 'aws', 'tests'). Omit or use 'index' to list all skills.",
+        },
+    },
+    service: async ({ alias: inputAlias }) => {
+        const alias = (inputAlias || "index").toLowerCase().trim();
+        // Security: validate alias to prevent path traversal
+        if (!isValidSkillAlias(alias)) {
+            throw new Error(`Invalid skill alias "${alias}". Use alphanumeric characters, hyphens, and underscores only.`);
+        }
+        // If requesting index, return list of all skills with descriptions
+        if (alias === "index") {
+            const indexPath = path.join(SKILLS_PATH, "index.md");
+            let indexContent = "";
+            try {
+                indexContent = await fs.readFile(indexPath, "utf-8");
+                // Strip frontmatter for display
+                if (indexContent.startsWith("---")) {
+                    const parsed = matter(indexContent);
+                    indexContent = parsed.content.trim();
+                }
+            }
+            catch {
+                // Index file doesn't exist, will just show skill list
+            }
+            // Get all skill files
+            const files = await fs.readdir(SKILLS_PATH);
+            const mdFiles = files.filter((file) => file.endsWith(".md") && file !== "index.md");
+            const skills = await Promise.all(mdFiles.map((file) => parseSkillFile(path.join(SKILLS_PATH, file))));
+            // Sort alphabetically
+            skills.sort((a, b) => a.alias.localeCompare(b.alias));
+            const skillList = skills.map(formatSkillListItem).join("\n");
+            if (indexContent) {
+                return `${indexContent}\n\n## Available Skills\n\n${skillList}`;
+            }
+            return `# Jaypie Skills\n\n## Available Skills\n\n${skillList}`;
+        }
+        // Read specific skill file
+        const skillPath = path.join(SKILLS_PATH, `${alias}.md`);
+        try {
+            return await fs.readFile(skillPath, "utf-8");
+        }
+        catch {
+            throw new Error(`Skill "${alias}" not found. Use skill("index") to list available skills.`);
+        }
+    },
+});
+const listPrompts = fabricService({
+    alias: "list_prompts",
+    description: "[DEPRECATED: Use skill('index') instead] List available Jaypie development prompts and guides. Use this FIRST when starting work on a Jaypie project to discover relevant documentation. Returns filenames, descriptions, and which file patterns each prompt applies to (e.g., 'Required for packages/express/**').",
+    input: {},
+    service: async () => {
+        const files = await fs.readdir(PROMPTS_PATH);
+        const mdFiles = files.filter((file) => file.endsWith(".md"));
+        const prompts = await Promise.all(mdFiles.map((file) => parseMarkdownFile(path.join(PROMPTS_PATH, file))));
+        return (prompts.map(formatPromptListItem).join("\n") ||
+            "No .md files found in the prompts directory.");
+    },
+});
+const readPrompt = fabricService({
+    alias: "read_prompt",
+    description: "[DEPRECATED: Use skill(alias) instead] Read a Jaypie prompt/guide by filename. Call list_prompts first to see available prompts. These contain best practices, templates, code patterns, and step-by-step guides for Jaypie development tasks.",
+    input: {
+        filename: {
+            type: String,
+            required: true,
+            description: "The prompt filename from list_prompts (e.g., 'Jaypie_Express_Package.md', 'Development_Process.md')",
+        },
+    },
+    service: async ({ filename }) => {
+        const filePath = path.join(PROMPTS_PATH, filename);
+        return fs.readFile(filePath, "utf-8");
+    },
+});
+const listReleaseNotes = fabricService({
+    alias: "list_release_notes",
+    description: "List available release notes for Jaypie packages. Filter by package name and/or get only versions newer than a specified version.",
+    input: {
+        package: {
+            type: String,
+            required: false,
+            description: "Filter by package name (e.g., 'jaypie', 'mcp'). If not provided, lists release notes for all packages.",
+        },
+        since_version: {
+            type: String,
+            required: false,
+            description: "Only show versions newer than this (e.g., '1.0.0'). Uses semver comparison.",
+        },
+    },
+    service: async ({ package: packageFilter, since_version: sinceVersion, }) => {
+        const entries = await fs.readdir(RELEASE_NOTES_PATH, {
+            withFileTypes: true,
+        });
+        const packageDirs = entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+        const packagesToList = packageFilter
+            ? packageDirs.filter((pkg) => pkg === packageFilter)
+            : packageDirs;
+        if (packagesToList.length === 0 && packageFilter) {
+            return `No release notes found for package "${packageFilter}".`;
+        }
+        const allNotes = await Promise.all(packagesToList.map((pkg) => getPackageReleaseNotes(pkg)));
+        let flatNotes = allNotes.flat();
+        if (sinceVersion) {
+            flatNotes = filterReleaseNotesSince(flatNotes, sinceVersion);
+        }
+        if (flatNotes.length === 0) {
+            const filterDesc = sinceVersion ? ` newer than ${sinceVersion}` : "";
+            return `No release notes found${filterDesc}.`;
+        }
+        return flatNotes.map(formatReleaseNoteListItem).join("\n");
+    },
+});
+const readReleaseNote = fabricService({
+    alias: "read_release_note",
+    description: "Read the full content of a specific release note. Call list_release_notes first to see available versions.",
+    input: {
+        package: {
+            type: String,
+            required: true,
+            description: "Package name (e.g., 'jaypie', 'mcp')",
+        },
+        version: {
+            type: String,
+            required: true,
+            description: "Version number (e.g., '1.2.3')",
+        },
+    },
+    service: async ({ package: packageName, version: ver, }) => {
+        const filePath = path.join(RELEASE_NOTES_PATH, packageName, `${ver}.md`);
+        return fs.readFile(filePath, "utf-8");
+    },
+});
+// =============================================================================
+// DATADOG SERVICES
+// =============================================================================
+const datadogLogs = fabricService({
+    alias: "datadog_logs",
+    description: "Search and retrieve individual Datadog log entries. Use this to view actual log messages and details. For aggregated counts/statistics (e.g., 'how many errors by service?'), use datadog_log_analytics instead. Requires DATADOG_API_KEY and DATADOG_APP_KEY environment variables.",
+    input: {
+        query: {
+            type: String,
+            required: false,
+            description: "Search query to filter logs. Examples: 'status:error', '@http.status_code:500', '*timeout*', '@requestId:abc123'. Combined with DD_ENV, DD_SERVICE, DD_SOURCE env vars if set.",
+        },
+        source: {
+            type: String,
+            required: false,
+            description: "Override the log source (e.g., 'lambda', 'auth0', 'nginx'). If not provided, uses DD_SOURCE env var or defaults to 'lambda'.",
+        },
+        env: {
+            type: String,
+            required: false,
+            description: "Override the environment (e.g., 'sandbox', 'kitchen', 'lab', 'studio', 'production'). If not provided, uses DD_ENV env var.",
+        },
+        service: {
+            type: String,
+            required: false,
+            description: "Override the service name. If not provided, uses DD_SERVICE env var.",
+        },
+        from: {
+            type: String,
+            required: false,
+            description: "Start time. Formats: relative ('now-15m', 'now-1h', 'now-1d'), ISO 8601 ('2024-01-15T10:00:00Z'). Defaults to 'now-15m'.",
+        },
+        to: {
+            type: String,
+            required: false,
+            description: "End time. Formats: 'now', relative ('now-5m'), or ISO 8601. Defaults to 'now'.",
+        },
+        limit: {
+            type: Number,
+            required: false,
+            description: "Max logs to return (1-1000). Defaults to 50.",
+        },
+        sort: {
+            type: ["timestamp", "-timestamp"],
+            required: false,
+            description: "Sort order: 'timestamp' (oldest first) or '-timestamp' (newest first, default).",
+        },
+    },
+    service: async (input) => {
+        const credentials = getDatadogCredentials();
+        if (!credentials) {
+            throw new Error("Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.");
+        }
+        const result = await searchDatadogLogs(credentials, input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result;
+    },
+});
+const datadogLogAnalytics = fabricService({
+    alias: "datadog_log_analytics",
+    description: "Aggregate and analyze Datadog logs by grouping them by fields. Use this for statistics and counts (e.g., 'errors by service', 'requests by status code'). For viewing individual log entries, use datadog_logs instead.",
+    input: {
+        groupBy: {
+            type: [String],
+            required: true,
+            description: "Fields to group by. Examples: ['source'], ['service', 'status'], ['@http.status_code']. Common facets: source, service, status, host, @http.status_code, @env.",
+        },
+        query: {
+            type: String,
+            required: false,
+            description: "Filter query. Examples: 'status:error', '*timeout*', '@http.method:POST'. Use '*' for all logs.",
+        },
+        source: {
+            type: String,
+            required: false,
+            description: "Override the log source filter. Use '*' to include all sources. If not provided, uses DD_SOURCE env var or defaults to 'lambda'.",
+        },
+        env: {
+            type: String,
+            required: false,
+            description: "Override the environment filter. If not provided, uses DD_ENV env var.",
+        },
+        service: {
+            type: String,
+            required: false,
+            description: "Override the service name filter. If not provided, uses DD_SERVICE env var.",
+        },
+        from: {
+            type: String,
+            required: false,
+            description: "Start time. Formats: relative ('now-15m', 'now-1h', 'now-1d'), ISO 8601 ('2024-01-15T10:00:00Z'). Defaults to 'now-15m'.",
+        },
+        to: {
+            type: String,
+            required: false,
+            description: "End time. Formats: 'now', relative ('now-5m'), or ISO 8601. Defaults to 'now'.",
+        },
+        aggregation: {
+            type: ["count", "avg", "sum", "min", "max", "cardinality"],
+            required: false,
+            description: "Aggregation type. 'count' counts logs, others require a metric field. Defaults to 'count'.",
+        },
+        metric: {
+            type: String,
+            required: false,
+            description: "Metric field to aggregate when using avg, sum, min, max, or cardinality. E.g., '@duration', '@http.response_time'.",
+        },
+    },
+    service: async (input) => {
+        const credentials = getDatadogCredentials();
+        if (!credentials) {
+            throw new Error("Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.");
+        }
+        const compute = input.aggregation
+            ? [{ aggregation: input.aggregation, metric: input.metric }]
+            : [{ aggregation: "count" }];
+        const result = await aggregateDatadogLogs(credentials, { ...input, compute }, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result;
+    },
+});
+const datadogMonitors = fabricService({
+    alias: "datadog_monitors",
+    description: "List and check Datadog monitors. Shows monitor status (Alert, Warn, No Data, OK), name, type, and tags. Useful for quickly checking if any monitors are alerting.",
+    input: {
+        status: {
+            type: Array,
+            required: false,
+            description: "Filter monitors by status. E.g., ['Alert', 'Warn'] to see only alerting monitors.",
+        },
+        tags: {
+            type: Array,
+            required: false,
+            description: "Filter monitors by resource tags (tags on the monitored resources).",
+        },
+        monitorTags: {
+            type: Array,
+            required: false,
+            description: "Filter monitors by monitor tags (tags on the monitor itself).",
+        },
+        name: {
+            type: String,
+            required: false,
+            description: "Filter monitors by name (partial match supported).",
+        },
+    },
+    service: async (input) => {
+        const credentials = getDatadogCredentials();
+        if (!credentials) {
+            throw new Error("Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.");
+        }
+        const result = await listDatadogMonitors(credentials, input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result;
+    },
+});
+const datadogSynthetics = fabricService({
+    alias: "datadog_synthetics",
+    description: "List Datadog Synthetic tests and optionally get recent results for a specific test. Shows test status, type (api/browser), and locations.",
+    input: {
+        type: {
+            type: ["api", "browser"],
+            required: false,
+            description: "Filter tests by type: 'api' or 'browser'.",
+        },
+        tags: {
+            type: Array,
+            required: false,
+            description: "Filter tests by tags.",
+        },
+        testId: {
+            type: String,
+            required: false,
+            description: "If provided, fetches recent results for this specific test (public_id). Otherwise lists all tests.",
+        },
+    },
+    service: async (input) => {
+        const credentials = getDatadogCredentials();
+        if (!credentials) {
+            throw new Error("Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.");
+        }
+        if (input.testId) {
+            const result = await getDatadogSyntheticResults(credentials, input.testId, log);
+            if (!result.success) {
+                throw new Error(result.error);
+            }
+            return result;
+        }
+        const result = await listDatadogSynthetics(credentials, input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result;
+    },
+});
+const datadogMetrics = fabricService({
+    alias: "datadog_metrics",
+    description: "Query Datadog metrics. Returns timeseries data for the specified metric query. Useful for checking specific metric values.",
+    input: {
+        query: {
+            type: String,
+            required: true,
+            description: "Metric query. Format: 'aggregation:metric.name{tags}'. Examples: 'avg:system.cpu.user{*}', 'sum:aws.lambda.invocations{function:my-func}.as_count()', 'max:aws.lambda.duration{env:production}'.",
+        },
+        from: {
+            type: String,
+            required: false,
+            description: "Start time. Formats: relative ('1h', '30m', '1d'), or Unix timestamp. Defaults to '1h'.",
+        },
+        to: {
+            type: String,
+            required: false,
+            description: "End time. Formats: 'now' or Unix timestamp. Defaults to 'now'.",
+        },
+    },
+    service: async (input) => {
+        const credentials = getDatadogCredentials();
+        if (!credentials) {
+            throw new Error("Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.");
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const fromStr = input.from || "1h";
+        let fromTs;
+        if (fromStr.match(/^\d+$/)) {
+            fromTs = parseInt(fromStr, 10);
+        }
+        else if (fromStr.match(/^(\d+)h$/)) {
+            const hours = parseInt(fromStr.match(/^(\d+)h$/)[1], 10);
+            fromTs = now - hours * 3600;
+        }
+        else if (fromStr.match(/^(\d+)m$/)) {
+            const minutes = parseInt(fromStr.match(/^(\d+)m$/)[1], 10);
+            fromTs = now - minutes * 60;
+        }
+        else if (fromStr.match(/^(\d+)d$/)) {
+            const days = parseInt(fromStr.match(/^(\d+)d$/)[1], 10);
+            fromTs = now - days * 86400;
+        }
+        else {
+            fromTs = now - 3600;
+        }
+        const toStr = input.to || "now";
+        const toTs = toStr === "now" ? now : parseInt(toStr, 10);
+        const result = await queryDatadogMetrics(credentials, { query: input.query, from: fromTs, to: toTs }, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result;
+    },
+});
+const datadogRum = fabricService({
+    alias: "datadog_rum",
+    description: "Search Datadog RUM (Real User Monitoring) events. Find user sessions, page views, errors, and actions. Useful for debugging frontend issues and understanding user behavior.",
+    input: {
+        query: {
+            type: String,
+            required: false,
+            description: "RUM search query. E.g., '@type:error', '@session.id:abc123', '@view.url:*checkout*'. Defaults to '*' (all events).",
+        },
+        from: {
+            type: String,
+            required: false,
+            description: "Start time. Formats: relative ('now-15m', 'now-1h', 'now-1d'), ISO 8601 ('2024-01-15T10:00:00Z'). Defaults to 'now-15m'.",
+        },
+        to: {
+            type: String,
+            required: false,
+            description: "End time. Formats: 'now', relative ('now-5m'), or ISO 8601. Defaults to 'now'.",
+        },
+        limit: {
+            type: Number,
+            required: false,
+            description: "Max events to return (1-1000). Defaults to 50.",
+        },
+    },
+    service: async (input) => {
+        const credentials = getDatadogCredentials();
+        if (!credentials) {
+            throw new Error("Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.");
+        }
+        const result = await searchDatadogRum(credentials, input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result;
+    },
+});
+// =============================================================================
+// LLM SERVICES
+// =============================================================================
+const llmDebugCall = fabricService({
+    alias: "llm_debug_call",
+    description: "Make a debug LLM API call and inspect the raw response. Useful for understanding how each provider formats responses, especially for reasoning/thinking content. Returns full history, raw responses, and extracted reasoning.",
+    input: {
+        provider: {
+            type: ["anthropic", "gemini", "openai", "openrouter"],
+            required: true,
+            description: "LLM provider to call",
+        },
+        model: {
+            type: String,
+            required: false,
+            description: "Model to use. If not provided, uses a sensible default. For reasoning tests, try 'o3-mini' with openai.",
+        },
+        message: {
+            type: String,
+            required: true,
+            description: "Message to send to the LLM. For reasoning tests, try something that requires thinking like 'What is 15 * 17? Think step by step.'",
+        },
+    },
+    service: async (input) => {
+        const result = await debugLlmCall({
+            provider: input.provider,
+            model: input.model,
+            message: input.message,
+        });
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result;
+    },
+});
+const llmListProviders = fabricService({
+    alias: "llm_list_providers",
+    description: "List available LLM providers with their default and reasoning-capable models.",
+    input: {},
+    service: async () => listLlmProviders(),
+});
+// =============================================================================
+// AWS SERVICES
+// =============================================================================
+const awsListProfiles = fabricService({
+    alias: "aws_list_profiles",
+    description: "List available AWS profiles from ~/.aws/config and credentials.",
+    input: {},
+    service: async () => {
+        const result = await listAwsProfiles(log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsStepfunctionsListExecutions = fabricService({
+    alias: "aws_stepfunctions_list_executions",
+    description: "List Step Function executions for a state machine. Useful for finding stuck or running executions.",
+    input: {
+        stateMachineArn: {
+            type: String,
+            required: true,
+            description: "ARN of the state machine",
+        },
+        statusFilter: {
+            type: [
+                "RUNNING",
+                "SUCCEEDED",
+                "FAILED",
+                "TIMED_OUT",
+                "ABORTED",
+                "PENDING_REDRIVE",
+            ],
+            required: false,
+            description: "Filter by execution status",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+        maxResults: {
+            type: Number,
+            required: false,
+            description: "Max results (1-1000, default 100)",
+        },
+    },
+    service: async (input) => {
+        const result = await listStepFunctionExecutions(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsStepfunctionsStopExecution = fabricService({
+    alias: "aws_stepfunctions_stop_execution",
+    description: "Stop a running Step Function execution. Use with caution - this will abort the workflow.",
+    input: {
+        executionArn: {
+            type: String,
+            required: true,
+            description: "ARN of the execution to stop",
+        },
+        cause: {
+            type: String,
+            required: false,
+            description: "Description of why the execution was stopped",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await stopStepFunctionExecution(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsLambdaListFunctions = fabricService({
+    alias: "aws_lambda_list_functions",
+    description: "List Lambda functions in the account. Filter by function name prefix.",
+    input: {
+        functionNamePrefix: {
+            type: String,
+            required: false,
+            description: "Filter by function name prefix",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+        maxResults: {
+            type: Number,
+            required: false,
+            description: "Max results to return",
+        },
+    },
+    service: async (input) => {
+        const result = await listLambdaFunctions(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsLambdaGetFunction = fabricService({
+    alias: "aws_lambda_get_function",
+    description: "Get configuration and details for a specific Lambda function.",
+    input: {
+        functionName: {
+            type: String,
+            required: true,
+            description: "Function name or ARN",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await getLambdaFunction(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsLogsFilterLogEvents = fabricService({
+    alias: "aws_logs_filter_log_events",
+    description: "Search CloudWatch Logs for a log group. Filter by pattern and time range.",
+    input: {
+        logGroupName: {
+            type: String,
+            required: true,
+            description: "Log group name (e.g., /aws/lambda/my-function)",
+        },
+        filterPattern: {
+            type: String,
+            required: false,
+            description: "CloudWatch filter pattern (e.g., 'ERROR', '{ $.level = \"error\" }')",
+        },
+        startTime: {
+            type: String,
+            required: false,
+            description: "Start time (ISO 8601 or relative like 'now-1h'). Defaults to 'now-15m'.",
+        },
+        endTime: {
+            type: String,
+            required: false,
+            description: "End time (ISO 8601 or 'now'). Defaults to 'now'.",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+        limit: {
+            type: Number,
+            required: false,
+            description: "Max events to return (default 100)",
+        },
+    },
+    service: async (input) => {
+        const result = await filterLogEvents({
+            ...input,
+            startTime: input.startTime || "now-15m",
+            endTime: input.endTime || "now",
+            limit: input.limit || 100,
+        }, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsS3ListObjects = fabricService({
+    alias: "aws_s3_list_objects",
+    description: "List objects in an S3 bucket with optional prefix filtering.",
+    input: {
+        bucket: {
+            type: String,
+            required: true,
+            description: "S3 bucket name",
+        },
+        prefix: {
+            type: String,
+            required: false,
+            description: "Object key prefix filter",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+        maxResults: {
+            type: Number,
+            required: false,
+            description: "Max results to return",
+        },
+    },
+    service: async (input) => {
+        const result = await listS3Objects(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsCloudformationDescribeStack = fabricService({
+    alias: "aws_cloudformation_describe_stack",
+    description: "Get details and status of a CloudFormation stack.",
+    input: {
+        stackName: {
+            type: String,
+            required: true,
+            description: "Stack name or ARN",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await describeStack(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsDynamodbDescribeTable = fabricService({
+    alias: "aws_dynamodb_describe_table",
+    description: "Get metadata about a DynamoDB table including key schema, indexes, and provisioned capacity.",
+    input: {
+        tableName: {
+            type: String,
+            required: true,
+            description: "DynamoDB table name",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await describeDynamoDBTable(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsDynamodbScan = fabricService({
+    alias: "aws_dynamodb_scan",
+    description: "Scan a DynamoDB table. Use sparingly on large tables - prefer query when possible.",
+    input: {
+        tableName: {
+            type: String,
+            required: true,
+            description: "DynamoDB table name",
+        },
+        filterExpression: {
+            type: String,
+            required: false,
+            description: "Filter expression (e.g., 'status = :s')",
+        },
+        expressionAttributeValues: {
+            type: String,
+            required: false,
+            description: 'JSON object of attribute values (e.g., \'{\\":s\\":{\\"S\\":\\"active\\"}}\')',
+        },
+        limit: {
+            type: Number,
+            required: false,
+            description: "Max items to return (default 25)",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await scanDynamoDB({ ...input, limit: input.limit || 25 }, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsDynamodbQuery = fabricService({
+    alias: "aws_dynamodb_query",
+    description: "Query a DynamoDB table by partition key. More efficient than scan for targeted lookups.",
+    input: {
+        tableName: {
+            type: String,
+            required: true,
+            description: "DynamoDB table name",
+        },
+        keyConditionExpression: {
+            type: String,
+            required: true,
+            description: "Key condition (e.g., 'pk = :pk')",
+        },
+        expressionAttributeValues: {
+            type: String,
+            required: true,
+            description: "JSON object of attribute values",
+        },
+        indexName: {
+            type: String,
+            required: false,
+            description: "GSI or LSI name to query",
+        },
+        filterExpression: {
+            type: String,
+            required: false,
+            description: "Additional filter expression",
+        },
+        limit: {
+            type: Number,
+            required: false,
+            description: "Max items to return",
+        },
+        scanIndexForward: {
+            type: Boolean,
+            required: false,
+            description: "Sort ascending (true) or descending (false)",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await queryDynamoDB(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsDynamodbGetItem = fabricService({
+    alias: "aws_dynamodb_get_item",
+    description: "Get a single item from a DynamoDB table by its primary key.",
+    input: {
+        tableName: {
+            type: String,
+            required: true,
+            description: "DynamoDB table name",
+        },
+        key: {
+            type: String,
+            required: true,
+            description: 'JSON object of the primary key (e.g., \'{\\"pk\\":{\\"S\\":\\"user#123\\"},\\"sk\\":{\\"S\\":\\"profile\\"}}\')',
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await getDynamoDBItem(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsSqsListQueues = fabricService({
+    alias: "aws_sqs_list_queues",
+    description: "List SQS queues in the account. Filter by queue name prefix.",
+    input: {
+        queueNamePrefix: {
+            type: String,
+            required: false,
+            description: "Filter by queue name prefix",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await listSQSQueues(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsSqsGetQueueAttributes = fabricService({
+    alias: "aws_sqs_get_queue_attributes",
+    description: "Get attributes for an SQS queue including approximate message count, visibility timeout, and dead-letter config.",
+    input: {
+        queueUrl: {
+            type: String,
+            required: true,
+            description: "SQS queue URL",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await getSQSQueueAttributes(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsSqsReceiveMessage = fabricService({
+    alias: "aws_sqs_receive_message",
+    description: "Receive messages from an SQS queue for inspection. Messages are returned to the queue after visibility timeout.",
+    input: {
+        queueUrl: {
+            type: String,
+            required: true,
+            description: "SQS queue URL",
+        },
+        maxNumberOfMessages: {
+            type: Number,
+            required: false,
+            description: "Max messages to receive (1-10, default 1)",
+        },
+        visibilityTimeout: {
+            type: Number,
+            required: false,
+            description: "Seconds to hide message (default 30)",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await receiveSQSMessage({
+            ...input,
+            maxNumberOfMessages: input.maxNumberOfMessages || 1,
+            visibilityTimeout: input.visibilityTimeout || 30,
+        }, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.data;
+    },
+});
+const awsSqsPurgeQueue = fabricService({
+    alias: "aws_sqs_purge_queue",
+    description: "Delete all messages from an SQS queue. Use with caution - this is irreversible.",
+    input: {
+        queueUrl: {
+            type: String,
+            required: true,
+            description: "SQS queue URL",
+        },
+        profile: {
+            type: String,
+            required: false,
+            description: "AWS profile to use",
+        },
+        region: {
+            type: String,
+            required: false,
+            description: "AWS region",
+        },
+    },
+    service: async (input) => {
+        const result = await purgeSQSQueue(input, log);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return { success: true };
+    },
+});
+// =============================================================================
+// SUITE CREATION
+// =============================================================================
+const VERSION = "0.3.4";
+const suite = createServiceSuite({
+    name: "jaypie",
+    version: VERSION,
+});
+// Register docs services
+suite.register(skill, "docs");
+suite.register(version, "docs");
+suite.register(listPrompts, "docs");
+suite.register(readPrompt, "docs");
+suite.register(listReleaseNotes, "docs");
+suite.register(readReleaseNote, "docs");
+// Register Datadog services
+suite.register(datadogLogs, "datadog");
+suite.register(datadogLogAnalytics, "datadog");
+suite.register(datadogMonitors, "datadog");
+suite.register(datadogSynthetics, "datadog");
+suite.register(datadogMetrics, "datadog");
+suite.register(datadogRum, "datadog");
+// Register LLM services
+suite.register(llmDebugCall, "llm");
+suite.register(llmListProviders, "llm");
+// Register AWS services
+suite.register(awsListProfiles, "aws");
+suite.register(awsStepfunctionsListExecutions, "aws");
+suite.register(awsStepfunctionsStopExecution, "aws");
+suite.register(awsLambdaListFunctions, "aws");
+suite.register(awsLambdaGetFunction, "aws");
+suite.register(awsLogsFilterLogEvents, "aws");
+suite.register(awsS3ListObjects, "aws");
+suite.register(awsCloudformationDescribeStack, "aws");
+suite.register(awsDynamodbDescribeTable, "aws");
+suite.register(awsDynamodbScan, "aws");
+suite.register(awsDynamodbQuery, "aws");
+suite.register(awsDynamodbGetItem, "aws");
+suite.register(awsSqsListQueues, "aws");
+suite.register(awsSqsGetQueueAttributes, "aws");
+suite.register(awsSqsReceiveMessage, "aws");
+suite.register(awsSqsPurgeQueue, "aws");
+
+export { suite };
+//# sourceMappingURL=suite.js.map