@jaypie/mcp 0.7.9 → 0.7.11

package/dist/suites/datadog/index.js

@@ -2,7 +2,7 @@ import { fabricService } from '@jaypie/fabric';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { getDatadogCredentials, searchDatadogRum, queryDatadogMetrics, getDatadogSyntheticResults, listDatadogSynthetics, listDatadogMonitors, aggregateDatadogLogs, searchDatadogLogs } from './datadog.js';
+import { getDatadogCredentials, searchDatadogRum, queryDatadogMetrics, getDatadogSyntheticResults, listDatadogSynthetics, listDatadogMonitors, aggregateDatadogLogs, searchDatadogLogs, validateDatadogSetup } from './datadog.js';
 export { buildDatadogQuery, validateDatadogCredentials } from './datadog.js';
 
 /**
@@ -21,18 +21,99 @@ const datadogService = fabricService({
     alias: "datadog",
     description: "Access Datadog observability data. Commands: logs, log_analytics, monitors, synthetics, metrics, rum. Call with no args for help.",
     input: {
+        aggregation: {
+            description: "Aggregation type for log_analytics (count, avg, sum, min, max, cardinality)",
+            required: false,
+            type: String,
+        },
         command: {
-            description: "Command to execute (omit for help)",
+            description: "Command to execute: logs, log_analytics, monitors, synthetics, metrics, rum (omit for help)",
             required: false,
             type: String,
         },
-        input: {
-            description: "Command parameters",
+        env: {
+            description: "Environment filter (e.g., production, staging)",
             required: false,
-            type: Object,
+            type: String,
+        },
+        from: {
+            description: "Start time (e.g., now-1h, now-15m, now-1d, or ISO 8601 timestamp)",
+            required: false,
+            type: String,
+        },
+        groupBy: {
+            description: "Fields to group by for log_analytics (comma-separated, e.g., service,status)",
+            required: false,
+            type: String,
+        },
+        limit: {
+            description: "Maximum number of results to return",
+            required: false,
+            type: Number,
+        },
+        metric: {
+            description: "Metric field for aggregation (e.g., @duration)",
+            required: false,
+            type: String,
+        },
+        monitorTags: {
+            description: "Monitor tags filter (comma-separated)",
+            required: false,
+            type: String,
+        },
+        name: {
+            description: "Name filter for monitors",
+            required: false,
+            type: String,
+        },
+        query: {
+            description: 'Datadog query string (e.g., status:error, @lambda.arn:"arn:aws:...")',
+            required: false,
+            type: String,
+        },
+        service: {
+            description: "Service name filter",
+            required: false,
+            type: String,
+        },
+        sort: {
+            description: "Sort order (timestamp or -timestamp)",
+            required: false,
+            type: String,
+        },
+        source: {
+            description: "Log source filter (default: lambda)",
+            required: false,
+            type: String,
+        },
+        status: {
+            description: "Monitor status filter (comma-separated: Alert, Warn, No Data, OK)",
+            required: false,
+            type: String,
+        },
+        tags: {
+            description: "Tags filter (comma-separated)",
+            required: false,
+            type: String,
+        },
+        testId: {
+            description: "Synthetic test ID for getting results",
+            required: false,
+            type: String,
+        },
+        to: {
+            description: "End time (e.g., now, or ISO 8601 timestamp)",
+            required: false,
+            type: String,
+        },
+        type: {
+            description: "Synthetic test type filter (api or browser)",
+            required: false,
+            type: String,
         },
     },
-    service: async ({ command, input: params, }) => {
+    service: async (params) => {
+        const { command } = params;
         if (!command || command === "help") {
             return getHelp();
         }
@@ -40,75 +121,90 @@ const datadogService = fabricService({
         if (!credentials) {
             throw new Error("Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.");
         }
-        const p = params || {};
+        // Helper to parse comma-separated strings into arrays
+        const parseArray = (value) => {
+            if (!value)
+                return undefined;
+            return value.split(",").map((s) => s.trim());
+        };
         switch (command) {
+            case "validate": {
+                return validateDatadogSetup();
+            }
             case "logs": {
                 const result = await searchDatadogLogs(credentials, {
-                    env: p.env,
-                    from: p.from,
-                    limit: p.limit,
-                    query: p.query,
-                    service: p.service,
-                    sort: p.sort,
-                    source: p.source,
-                    to: p.to,
+                    env: params.env,
+                    from: params.from,
+                    limit: params.limit,
+                    query: params.query,
+                    service: params.service,
+                    sort: params.sort,
+                    source: params.source,
+                    to: params.to,
                 }, log);
                 if (!result.success)
                     throw new Error(result.error);
                 return result;
             }
             case "log_analytics": {
-                if (!p.groupBy || p.groupBy.length === 0) {
-                    throw new Error("groupBy is required (array of field names)");
+                const groupByArray = parseArray(params.groupBy);
+                if (!groupByArray || groupByArray.length === 0) {
+                    throw new Error("groupBy is required (comma-separated field names, e.g., service,status)");
                 }
-                const compute = p.aggregation
-                    ? [{ aggregation: p.aggregation, metric: p.metric }]
+                const compute = params.aggregation
+                    ? [
+                        {
+                            aggregation: params.aggregation,
+                            metric: params.metric,
+                        },
+                    ]
                     : [{ aggregation: "count" }];
                 const result = await aggregateDatadogLogs(credentials, {
                     compute,
-                    env: p.env,
-                    from: p.from,
-                    groupBy: p.groupBy,
-                    query: p.query,
-                    service: p.service,
-                    source: p.source,
-                    to: p.to,
+                    env: params.env,
+                    from: params.from,
+                    groupBy: groupByArray,
+                    query: params.query,
+                    service: params.service,
+                    source: params.source,
+                    to: params.to,
                 }, log);
                 if (!result.success)
                     throw new Error(result.error);
                 return result;
             }
             case "monitors": {
+                const statusArray = parseArray(params.status);
                 const result = await listDatadogMonitors(credentials, {
-                    monitorTags: p.monitorTags,
-                    name: p.name,
-                    status: p.status,
-                    tags: p.tags,
+                    monitorTags: parseArray(params.monitorTags),
+                    name: params.name,
+                    status: statusArray,
+                    tags: parseArray(params.tags),
                 }, log);
                 if (!result.success)
                     throw new Error(result.error);
                 return result;
             }
             case "synthetics": {
-                if (p.testId) {
-                    const result = await getDatadogSyntheticResults(credentials, p.testId, log);
+                if (params.testId) {
+                    const result = await getDatadogSyntheticResults(credentials, params.testId, log);
                     if (!result.success)
                         throw new Error(result.error);
                     return result;
                 }
                 const result = await listDatadogSynthetics(credentials, {
-                    tags: p.tags,
-                    type: p.type,
+                    tags: parseArray(params.tags),
+                    type: params.type,
                 }, log);
                 if (!result.success)
                     throw new Error(result.error);
                 return result;
             }
             case "metrics": {
-                if (!p.query)
+                if (!params.query)
                     throw new Error("query is required for metrics");
                 const now = Math.floor(Date.now() / 1000);
-                const fromStr = p.from || "1h";
+                const fromStr = params.from || "1h";
                 let fromTs;
                 if (fromStr.match(/^\d+$/)) {
                     fromTs = parseInt(fromStr, 10);
@@ -128,19 +224,19 @@ const datadogService = fabricService({
                 else {
                     fromTs = now - 3600;
                 }
-                const toStr = p.to || "now";
+                const toStr = params.to || "now";
                 const toTs = toStr === "now" ? now : parseInt(toStr, 10);
-                const result = await queryDatadogMetrics(credentials, { from: fromTs, query: p.query, to: toTs }, log);
+                const result = await queryDatadogMetrics(credentials, { from: fromTs, query: params.query, to: toTs }, log);
                 if (!result.success)
                     throw new Error(result.error);
                 return result;
             }
             case "rum": {
                 const result = await searchDatadogRum(credentials, {
-                    from: p.from,
-                    limit: p.limit,
-                    query: p.query,
-                    to: p.to,
+                    from: params.from,
+                    limit: params.limit,
+                    query: params.query,
+                    to: params.to,
                 }, log);
                 if (!result.success)
                     throw new Error(result.error);
@@ -152,5 +248,5 @@ const datadogService = fabricService({
     },
 });
 
-export { aggregateDatadogLogs, datadogService, getDatadogCredentials, getDatadogSyntheticResults, listDatadogMonitors, listDatadogSynthetics, queryDatadogMetrics, searchDatadogLogs, searchDatadogRum };
+export { aggregateDatadogLogs, datadogService, getDatadogCredentials, getDatadogSyntheticResults, listDatadogMonitors, listDatadogSynthetics, queryDatadogMetrics, searchDatadogLogs, searchDatadogRum, validateDatadogSetup };
 //# sourceMappingURL=index.js.map

package/dist/suites/datadog/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/suites/datadog/index.ts"],"sourcesContent":["/**\n * Datadog Suite - Unified Datadog observability access\n */\nimport { fabricService } from \"@jaypie/fabric\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  aggregateDatadogLogs,\n  getDatadogCredentials,\n  getDatadogSyntheticResults,\n  listDatadogMonitors,\n  listDatadogSynthetics,\n  queryDatadogMetrics,\n  searchDatadogLogs,\n  searchDatadogRum,\n} from \"./datadog.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n// Silent logger for direct execution\nconst log = {\n  error: () => {},\n  info: () => {},\n};\n\nasync function getHelp(): Promise<string> {\n  return fs.readFile(path.join(__dirname, \"help.md\"), \"utf-8\");\n}\n\n// Input type for the unified Datadog service\ninterface DatadogInput {\n  aggregation?: \"count\" | \"avg\" | \"sum\" | \"min\" | \"max\" | \"cardinality\";\n  env?: string;\n  from?: string;\n  groupBy?: string[];\n  limit?: number;\n  metric?: string;\n  monitorTags?: string[];\n  name?: string;\n  query?: string;\n  service?: string;\n  sort?: \"timestamp\" | \"-timestamp\";\n  source?: string;\n  status?: (\"Alert\" | \"Warn\" | \"No Data\" | \"OK\")[];\n  tags?: string[];\n  testId?: string;\n  to?: string;\n  type?: \"api\" | \"browser\";\n}\n\nexport const datadogService = fabricService({\n  alias: \"datadog\",\n  description:\n    \"Access Datadog observability data. Commands: logs, log_analytics, monitors, synthetics, metrics, rum. Call with no args for help.\",\n  input: {\n    command: {\n      description: \"Command to execute (omit for help)\",\n      required: false,\n      type: String,\n    },\n    input: {\n      description: \"Command parameters\",\n      required: false,\n      type: Object,\n    },\n  },\n  service: async ({\n    command,\n    input: params,\n  }: {\n    command?: string;\n    input?: DatadogInput;\n  }) => {\n    if (!command || command === \"help\") {\n      return getHelp();\n    }\n\n    const credentials = getDatadogCredentials();\n    if (!credentials) {\n      throw new Error(\n        \"Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.\",\n      );\n    }\n\n    const p = params || {};\n\n    switch (command) {\n      case \"logs\": {\n        const result = await searchDatadogLogs(\n          credentials,\n          {\n            env: p.env,\n            from: p.from,\n            limit: p.limit,\n            query: p.query,\n            service: p.service,\n            sort: p.sort,\n            source: p.source,\n            to: p.to,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"log_analytics\": {\n        if (!p.groupBy || p.groupBy.length === 0) {\n          throw new Error(\"groupBy is required (array of field names)\");\n        }\n        const compute = p.aggregation\n          ? [{ aggregation: p.aggregation, metric: p.metric }]\n          : [{ aggregation: \"count\" as const }];\n        const result = await aggregateDatadogLogs(\n          credentials,\n          {\n            compute,\n            env: p.env,\n            from: p.from,\n            groupBy: p.groupBy,\n            query: p.query,\n            service: p.service,\n            source: p.source,\n            to: p.to,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"monitors\": {\n        const result = await listDatadogMonitors(\n          credentials,\n          {\n            monitorTags: p.monitorTags,\n            name: p.name,\n            status: p.status,\n            tags: p.tags,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"synthetics\": {\n        if (p.testId) {\n          const result = await getDatadogSyntheticResults(\n            credentials,\n            p.testId,\n            log,\n          );\n          if (!result.success) throw new Error(result.error);\n          return result;\n        }\n        const result = await listDatadogSynthetics(\n          credentials,\n          {\n            tags: p.tags,\n            type: p.type,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"metrics\": {\n        if (!p.query) throw new Error(\"query is required for metrics\");\n        const now = Math.floor(Date.now() / 1000);\n        const fromStr = p.from || \"1h\";\n        let fromTs: number;\n        if (fromStr.match(/^\\d+$/)) {\n          fromTs = parseInt(fromStr, 10);\n        } else if (fromStr.match(/^(\\d+)h$/)) {\n          const hours = parseInt(fromStr.match(/^(\\d+)h$/)![1], 10);\n          fromTs = now - hours * 3600;\n        } else if (fromStr.match(/^(\\d+)m$/)) {\n          const minutes = parseInt(fromStr.match(/^(\\d+)m$/)![1], 10);\n          fromTs = now - minutes * 60;\n        } else if (fromStr.match(/^(\\d+)d$/)) {\n          const days = parseInt(fromStr.match(/^(\\d+)d$/)![1], 10);\n          fromTs = now - days * 86400;\n        } else {\n          fromTs = now - 3600;\n        }\n        const toStr = p.to || \"now\";\n        const toTs = toStr === \"now\" ? now : parseInt(toStr, 10);\n        const result = await queryDatadogMetrics(\n          credentials,\n          { from: fromTs, query: p.query, to: toTs },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"rum\": {\n        const result = await searchDatadogRum(\n          credentials,\n          {\n            from: p.from,\n            limit: p.limit,\n            query: p.query,\n            to: p.to,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      default:\n        throw new Error(`Unknown command: ${command}. Use datadog() for help.`);\n    }\n  },\n});\n\n// Re-export types and functions for testing\nexport * from \"./datadog.js\";\n"],"names":["__dirname"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/suites/datadog/index.ts"],"sourcesContent":["/**\n * Datadog Suite - Unified Datadog observability access\n */\nimport { fabricService } from \"@jaypie/fabric\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  aggregateDatadogLogs,\n  getDatadogCredentials,\n  getDatadogSyntheticResults,\n  listDatadogMonitors,\n  listDatadogSynthetics,\n  queryDatadogMetrics,\n  searchDatadogLogs,\n  searchDatadogRum,\n  validateDatadogSetup,\n} from \"./datadog.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n// Silent logger for direct execution\nconst log = {\n  error: () => {},\n  info: () => {},\n};\n\nasync function getHelp(): Promise<string> {\n  return fs.readFile(path.join(__dirname, \"help.md\"), \"utf-8\");\n}\n\n// Flattened input type for the unified Datadog service\ninterface DatadogInput {\n  aggregation?: string;\n  command?: string;\n  env?: string;\n  from?: string;\n  groupBy?: string;\n  limit?: number;\n  metric?: string;\n  monitorTags?: string;\n  name?: string;\n  query?: string;\n  service?: string;\n  sort?: string;\n  source?: string;\n  status?: string;\n  tags?: string;\n  testId?: string;\n  to?: string;\n  type?: string;\n}\n\nexport const datadogService = fabricService({\n  alias: \"datadog\",\n  description:\n    \"Access Datadog observability data. Commands: logs, log_analytics, monitors, synthetics, metrics, rum. Call with no args for help.\",\n  input: {\n    aggregation: {\n      description:\n        \"Aggregation type for log_analytics (count, avg, sum, min, max, cardinality)\",\n      required: false,\n      type: String,\n    },\n    command: {\n      description:\n        \"Command to execute: logs, log_analytics, monitors, synthetics, metrics, rum (omit for help)\",\n      required: false,\n      type: String,\n    },\n    env: {\n      description: \"Environment filter (e.g., production, staging)\",\n      required: false,\n      type: String,\n    },\n    from: {\n      description:\n        \"Start time (e.g., now-1h, now-15m, now-1d, or ISO 8601 timestamp)\",\n      required: false,\n      type: String,\n    },\n    groupBy: {\n      description:\n        \"Fields to group by for log_analytics (comma-separated, e.g., service,status)\",\n      required: false,\n      type: String,\n    },\n    limit: {\n      description: \"Maximum number of results to return\",\n      required: false,\n      type: Number,\n    },\n    metric: {\n      description: \"Metric field for aggregation (e.g., @duration)\",\n      required: false,\n      type: String,\n    },\n    monitorTags: {\n      description: \"Monitor tags filter (comma-separated)\",\n      required: false,\n      type: String,\n    },\n    name: {\n      description: \"Name filter for monitors\",\n      required: false,\n      type: String,\n    },\n    query: {\n      description:\n        'Datadog query string (e.g., status:error, @lambda.arn:\"arn:aws:...\")',\n      required: false,\n      type: String,\n    },\n    service: {\n      description: \"Service name filter\",\n      required: false,\n      type: String,\n    },\n    sort: {\n      description: \"Sort order (timestamp or -timestamp)\",\n      required: false,\n      type: String,\n    },\n    source: {\n      description: \"Log source filter (default: lambda)\",\n      required: false,\n      type: String,\n    },\n    status: {\n      description:\n        \"Monitor status filter (comma-separated: Alert, Warn, No Data, OK)\",\n      required: false,\n      type: String,\n    },\n    tags: {\n      description: \"Tags filter (comma-separated)\",\n      required: false,\n      type: String,\n    },\n    testId: {\n      description: \"Synthetic test ID for getting results\",\n      required: false,\n      type: String,\n    },\n    to: {\n      description: \"End time (e.g., now, or ISO 8601 timestamp)\",\n      required: false,\n      type: String,\n    },\n    type: {\n      description: \"Synthetic test type filter (api or browser)\",\n      required: false,\n      type: String,\n    },\n  },\n  service: async (params: DatadogInput) => {\n    const { command } = params;\n\n    if (!command || command === \"help\") {\n      return getHelp();\n    }\n\n    const credentials = getDatadogCredentials();\n    if (!credentials) {\n      throw new Error(\n        \"Datadog credentials not found. Set DATADOG_API_KEY and DATADOG_APP_KEY.\",\n      );\n    }\n\n    // Helper to parse comma-separated strings into arrays\n    const parseArray = (value?: string): string[] | undefined => {\n      if (!value) return undefined;\n      return value.split(\",\").map((s) => s.trim());\n    };\n\n    switch (command) {\n      case \"validate\": {\n        return validateDatadogSetup();\n      }\n\n      case \"logs\": {\n        const result = await searchDatadogLogs(\n          credentials,\n          {\n            env: params.env,\n            from: params.from,\n            limit: params.limit,\n            query: params.query,\n            service: params.service,\n            sort: params.sort as \"timestamp\" | \"-timestamp\" | undefined,\n            source: params.source,\n            to: params.to,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"log_analytics\": {\n        const groupByArray = parseArray(params.groupBy);\n        if (!groupByArray || groupByArray.length === 0) {\n          throw new Error(\n            \"groupBy is required (comma-separated field names, e.g., service,status)\",\n          );\n        }\n        const compute = params.aggregation\n          ? [\n              {\n                aggregation: params.aggregation as\n                  | \"count\"\n                  | \"avg\"\n                  | \"sum\"\n                  | \"min\"\n                  | \"max\"\n                  | \"cardinality\",\n                metric: params.metric,\n              },\n            ]\n          : [{ aggregation: \"count\" as const }];\n        const result = await aggregateDatadogLogs(\n          credentials,\n          {\n            compute,\n            env: params.env,\n            from: params.from,\n            groupBy: groupByArray,\n            query: params.query,\n            service: params.service,\n            source: params.source,\n            to: params.to,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"monitors\": {\n        const statusArray = parseArray(params.status) as\n          | (\"Alert\" | \"Warn\" | \"No Data\" | \"OK\")[]\n          | undefined;\n        const result = await listDatadogMonitors(\n          credentials,\n          {\n            monitorTags: parseArray(params.monitorTags),\n            name: params.name,\n            status: statusArray,\n            tags: parseArray(params.tags),\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"synthetics\": {\n        if (params.testId) {\n          const result = await getDatadogSyntheticResults(\n            credentials,\n            params.testId,\n            log,\n          );\n          if (!result.success) throw new Error(result.error);\n          return result;\n        }\n        const result = await listDatadogSynthetics(\n          credentials,\n          {\n            tags: parseArray(params.tags),\n            type: params.type as \"api\" | \"browser\" | undefined,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"metrics\": {\n        if (!params.query) throw new Error(\"query is required for metrics\");\n        const now = Math.floor(Date.now() / 1000);\n        const fromStr = params.from || \"1h\";\n        let fromTs: number;\n        if (fromStr.match(/^\\d+$/)) {\n          fromTs = parseInt(fromStr, 10);\n        } else if (fromStr.match(/^(\\d+)h$/)) {\n          const hours = parseInt(fromStr.match(/^(\\d+)h$/)![1], 10);\n          fromTs = now - hours * 3600;\n        } else if (fromStr.match(/^(\\d+)m$/)) {\n          const minutes = parseInt(fromStr.match(/^(\\d+)m$/)![1], 10);\n          fromTs = now - minutes * 60;\n        } else if (fromStr.match(/^(\\d+)d$/)) {\n          const days = parseInt(fromStr.match(/^(\\d+)d$/)![1], 10);\n          fromTs = now - days * 86400;\n        } else {\n          fromTs = now - 3600;\n        }\n        const toStr = params.to || \"now\";\n        const toTs = toStr === \"now\" ? now : parseInt(toStr, 10);\n        const result = await queryDatadogMetrics(\n          credentials,\n          { from: fromTs, query: params.query, to: toTs },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      case \"rum\": {\n        const result = await searchDatadogRum(\n          credentials,\n          {\n            from: params.from,\n            limit: params.limit,\n            query: params.query,\n            to: params.to,\n          },\n          log,\n        );\n        if (!result.success) throw new Error(result.error);\n        return result;\n      }\n\n      default:\n        throw new Error(`Unknown command: ${command}. Use datadog() for help.`);\n    }\n  },\n});\n\n// Re-export types and functions for testing\nexport * from \"./datadog.js\";\n"],"names":["__dirname"],"mappings":"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"}

package/dist/suites/docs/index.js

@@ -9,7 +9,7 @@ import { gt } from 'semver';
 /**
  * Docs Suite - Documentation services (skill, version, release_notes)
  */
-const BUILD_VERSION_STRING = "@jaypie/mcp@0.7.9#3c1d1abd"
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.7.11#d7ce271c"
     ;
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);
@@ -95,6 +95,44 @@ function filterReleaseNotesSince(notes, sinceVersion) {
 // =============================================================================
 // SKILL SERVICE
 // =============================================================================
+/**
+ * Generate alternative spellings for plural/singular matching
+ */
+function getAlternativeSpellings(alias) {
+    const alternatives = [];
+    if (alias.endsWith("es")) {
+        // "indexes" -> try "indexe" and "index"
+        alternatives.push(alias.slice(0, -1)); // Remove "s" -> "indexe"
+        alternatives.push(alias.slice(0, -2)); // Remove "es" -> "index"
+    }
+    else if (alias.endsWith("s")) {
+        // "skills" -> try "skill"
+        alternatives.push(alias.slice(0, -1)); // Remove "s" -> "skill"
+    }
+    else {
+        // "fish" -> try "fishs" and "fishes"
+        alternatives.push(alias + "s");
+        alternatives.push(alias + "es");
+    }
+    return alternatives;
+}
+/**
+ * Add alias to frontmatter indicating the canonical skill name
+ */
+function addAliasToFrontmatter(content, matchedAlias) {
+    if (content.startsWith("---")) {
+        // Find the end of frontmatter
+        const endIndex = content.indexOf("---", 3);
+        if (endIndex !== -1) {
+            // Insert alias before the closing ---
+            const beforeClose = content.slice(0, endIndex);
+            const afterClose = content.slice(endIndex);
+            return `${beforeClose}alias: ${matchedAlias}\n${afterClose}`;
+        }
+    }
+    // No frontmatter exists, create one
+    return `---\nalias: ${matchedAlias}\n---\n\n${content}`;
+}
 const skillService = 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.",
@@ -123,13 +161,31 @@ const skillService = fabricService({
             }
             return `# Jaypie Skills\n\n## Available Skills\n\n${skillList}`;
         }
-        const skill = await skillStore.get(alias);
+        // Try exact match first
+        let skill = await skillStore.get(alias);
+        let matchedAlias = alias;
+        // If no exact match, try alternative spellings (plural/singular)
+        if (!skill) {
+            const alternatives = getAlternativeSpellings(alias);
+            for (const alt of alternatives) {
+                skill = await skillStore.get(alt);
+                if (skill) {
+                    matchedAlias = alt;
+                    break;
+                }
+            }
+        }
         if (!skill) {
             throw new Error(`Skill "${alias}" not found. Use skill("index") to list available skills.`);
         }
         // Return raw file content for non-index skills (preserve frontmatter)
-        const skillPath = path.join(SKILLS_PATH, `${alias}.md`);
-        return fs.readFile(skillPath, "utf-8");
+        const skillPath = path.join(SKILLS_PATH, `${matchedAlias}.md`);
+        let content = await fs.readFile(skillPath, "utf-8");
+        // If we matched via alternative spelling, add alias to indicate canonical name
+        if (matchedAlias !== alias) {
+            content = addAliasToFrontmatter(content, matchedAlias);
+        }
+        return content;
     },
 });
 // =============================================================================

package/dist/suites/docs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/suites/docs/index.ts"],"sourcesContent":["/**\n * Docs Suite - Documentation services (skill, version, release_notes)\n */\nimport { fabricService } from \"@jaypie/fabric\";\nimport {\n  createMarkdownStore,\n  isValidAlias,\n  normalizeAlias,\n  type SkillRecord,\n} from \"@jaypie/tildeskill\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport matter from \"gray-matter\";\nimport { gt } from \"semver\";\n\n// Build-time constants\ndeclare const __BUILD_VERSION_STRING__: string;\nconst BUILD_VERSION_STRING =\n  typeof __BUILD_VERSION_STRING__ !== \"undefined\"\n    ? __BUILD_VERSION_STRING__\n    : \"@jaypie/mcp@0.0.0\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n// From dist/suites/docs/, go up 3 levels to package root where skills/ and release-notes/ live\nconst RELEASE_NOTES_PATH = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"..\",\n  \"release-notes\",\n);\nconst SKILLS_PATH = path.join(__dirname, \"..\", \"..\", \"..\", \"skills\");\n\n// Create skill store using tildeskill\nconst skillStore = createMarkdownStore({ path: SKILLS_PATH });\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\ninterface ReleaseNoteFrontMatter {\n  date?: string;\n  summary?: string;\n  version?: string;\n}\n\nasync function parseReleaseNoteFile(filePath: string): Promise<{\n  date?: string;\n  filename: string;\n  summary?: string;\n  version?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const filename = path.basename(filePath, \".md\");\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as ReleaseNoteFrontMatter;\n      return {\n        date: frontMatter.date,\n        filename,\n        summary: frontMatter.summary,\n        version: frontMatter.version || filename,\n      };\n    }\n\n    return { filename, version: filename };\n  } catch {\n    return { filename: path.basename(filePath, \".md\") };\n  }\n}\n\nfunction formatReleaseNoteListItem(note: {\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}): string {\n  const { date, packageName, summary, version } = note;\n  const parts = [`* ${packageName}@${version}`];\n\n  if (date) {\n    parts.push(`(${date})`);\n  }\n\n  if (summary) {\n    parts.push(`- ${summary}`);\n  }\n\n  return parts.join(\" \");\n}\n\nfunction formatSkillListItem(skill: SkillRecord): string {\n  const { alias, description } = skill;\n  if (description) {\n    return `* ${alias} - ${description}`;\n  }\n  return `* ${alias}`;\n}\n\nasync function getPackageReleaseNotes(packageName: string): Promise<\n  Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>\n> {\n  const packageDir = path.join(RELEASE_NOTES_PATH, packageName);\n  try {\n    const files = await fs.readdir(packageDir);\n    const mdFiles = files.filter((file) => file.endsWith(\".md\"));\n\n    const notes = await Promise.all(\n      mdFiles.map(async (file) => {\n        const parsed = await parseReleaseNoteFile(path.join(packageDir, file));\n        return { ...parsed, packageName };\n      }),\n    );\n\n    return notes.sort((a, b) => {\n      if (!a.version || !b.version) return 0;\n      try {\n        return gt(a.version, b.version) ? -1 : 1;\n      } catch {\n        return b.version.localeCompare(a.version);\n      }\n    });\n  } catch {\n    return [];\n  }\n}\n\nfunction filterReleaseNotesSince(\n  notes: Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>,\n  sinceVersion: string,\n): Array<{\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}> {\n  return notes.filter((note) => {\n    if (!note.version) return false;\n    try {\n      return gt(note.version, sinceVersion);\n    } catch {\n      return false;\n    }\n  });\n}\n\n// =============================================================================\n// SKILL SERVICE\n// =============================================================================\n\nexport const skillService = fabricService({\n  alias: \"skill\",\n  description:\n    \"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.\",\n  input: {\n    alias: {\n      description:\n        \"Skill alias (e.g., 'aws', 'tests'). Omit or use 'index' to list all skills.\",\n      required: false,\n      type: String,\n    },\n  },\n  service: async ({ alias: inputAlias }: { alias?: string }) => {\n    const alias = normalizeAlias(inputAlias || \"index\");\n\n    if (!isValidAlias(alias)) {\n      throw new Error(\n        `Invalid skill alias \"${alias}\". Use alphanumeric characters, hyphens, and underscores only.`,\n      );\n    }\n\n    if (alias === \"index\") {\n      // Get index content\n      const indexRecord = await skillStore.get(\"index\");\n      const indexContent = indexRecord?.content || \"\";\n\n      // List all skills except index\n      const allSkills = await skillStore.list();\n      const skills = allSkills.filter((s) => s.alias !== \"index\");\n      const skillList = skills.map(formatSkillListItem).join(\"\\n\");\n\n      if (indexContent) {\n        return `${indexContent}\\n\\n## Available Skills\\n\\n${skillList}`;\n      }\n      return `# Jaypie Skills\\n\\n## Available Skills\\n\\n${skillList}`;\n    }\n\n    const skill = await skillStore.get(alias);\n    if (!skill) {\n      throw new Error(\n        `Skill \"${alias}\" not found. Use skill(\"index\") to list available skills.`,\n      );\n    }\n\n    // Return raw file content for non-index skills (preserve frontmatter)\n    const skillPath = path.join(SKILLS_PATH, `${alias}.md`);\n    return fs.readFile(skillPath, \"utf-8\");\n  },\n});\n\n// =============================================================================\n// VERSION SERVICE\n// =============================================================================\n\nexport const versionService = fabricService({\n  alias: \"version\",\n  description: `Prints the current version and hash, \\`${BUILD_VERSION_STRING}\\``,\n  input: {},\n  service: async () => BUILD_VERSION_STRING,\n});\n\n// =============================================================================\n// RELEASE NOTES SERVICE\n// =============================================================================\n\nasync function getReleaseNotesHelp(): Promise<string> {\n  return fs.readFile(path.join(__dirname, \"release-notes\", \"help.md\"), \"utf-8\");\n}\n\ninterface ReleaseNotesInput {\n  package?: string;\n  since_version?: string;\n  version?: string;\n}\n\nexport const releaseNotesService = fabricService({\n  alias: \"release_notes\",\n  description:\n    \"Browse Jaypie package release notes. Commands: list, read. Call with no args for help.\",\n  input: {\n    command: {\n      description: \"Command to execute (omit for help)\",\n      required: false,\n      type: String,\n    },\n    input: {\n      description: \"Command parameters\",\n      required: false,\n      type: Object,\n    },\n  },\n  service: async ({\n    command,\n    input: params,\n  }: {\n    command?: string;\n    input?: ReleaseNotesInput;\n  }) => {\n    if (!command || command === \"help\") {\n      return getReleaseNotesHelp();\n    }\n\n    const p = params || {};\n\n    switch (command) {\n      case \"list\": {\n        const entries = await fs.readdir(RELEASE_NOTES_PATH, {\n          withFileTypes: true,\n        });\n        const packageDirs = entries\n          .filter((entry) => entry.isDirectory())\n          .map((entry) => entry.name);\n        const packagesToList = p.package\n          ? packageDirs.filter((pkg) => pkg === p.package)\n          : packageDirs;\n\n        if (packagesToList.length === 0 && p.package) {\n          return `No release notes found for package \"${p.package}\".`;\n        }\n\n        const allNotes = await Promise.all(\n          packagesToList.map((pkg) => getPackageReleaseNotes(pkg)),\n        );\n        let flatNotes = allNotes.flat();\n\n        if (p.since_version) {\n          flatNotes = filterReleaseNotesSince(flatNotes, p.since_version);\n        }\n\n        if (flatNotes.length === 0) {\n          const filterDesc = p.since_version\n            ? ` newer than ${p.since_version}`\n            : \"\";\n          return `No release notes found${filterDesc}.`;\n        }\n\n        return flatNotes.map(formatReleaseNoteListItem).join(\"\\n\");\n      }\n\n      case \"read\": {\n        if (!p.package) throw new Error(\"package is required\");\n        if (!p.version) throw new Error(\"version is required\");\n        const filePath = path.join(\n          RELEASE_NOTES_PATH,\n          p.package,\n          `${p.version}.md`,\n        );\n        return fs.readFile(filePath, \"utf-8\");\n      }\n\n      default:\n        throw new Error(\n          `Unknown command: ${command}. Use release_notes() for help.`,\n        );\n    }\n  },\n});\n"],"names":["__filename","__dirname"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/suites/docs/index.ts"],"sourcesContent":["/**\n * Docs Suite - Documentation services (skill, version, release_notes)\n */\nimport { fabricService } from \"@jaypie/fabric\";\nimport {\n  createMarkdownStore,\n  isValidAlias,\n  normalizeAlias,\n  type SkillRecord,\n} from \"@jaypie/tildeskill\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport matter from \"gray-matter\";\nimport { gt } from \"semver\";\n\n// Build-time constants\ndeclare const __BUILD_VERSION_STRING__: string;\nconst BUILD_VERSION_STRING =\n  typeof __BUILD_VERSION_STRING__ !== \"undefined\"\n    ? __BUILD_VERSION_STRING__\n    : \"@jaypie/mcp@0.0.0\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n// From dist/suites/docs/, go up 3 levels to package root where skills/ and release-notes/ live\nconst RELEASE_NOTES_PATH = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"..\",\n  \"release-notes\",\n);\nconst SKILLS_PATH = path.join(__dirname, \"..\", \"..\", \"..\", \"skills\");\n\n// Create skill store using tildeskill\nconst skillStore = createMarkdownStore({ path: SKILLS_PATH });\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\ninterface ReleaseNoteFrontMatter {\n  date?: string;\n  summary?: string;\n  version?: string;\n}\n\nasync function parseReleaseNoteFile(filePath: string): Promise<{\n  date?: string;\n  filename: string;\n  summary?: string;\n  version?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const filename = path.basename(filePath, \".md\");\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as ReleaseNoteFrontMatter;\n      return {\n        date: frontMatter.date,\n        filename,\n        summary: frontMatter.summary,\n        version: frontMatter.version || filename,\n      };\n    }\n\n    return { filename, version: filename };\n  } catch {\n    return { filename: path.basename(filePath, \".md\") };\n  }\n}\n\nfunction formatReleaseNoteListItem(note: {\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}): string {\n  const { date, packageName, summary, version } = note;\n  const parts = [`* ${packageName}@${version}`];\n\n  if (date) {\n    parts.push(`(${date})`);\n  }\n\n  if (summary) {\n    parts.push(`- ${summary}`);\n  }\n\n  return parts.join(\" \");\n}\n\nfunction formatSkillListItem(skill: SkillRecord): string {\n  const { alias, description } = skill;\n  if (description) {\n    return `* ${alias} - ${description}`;\n  }\n  return `* ${alias}`;\n}\n\nasync function getPackageReleaseNotes(packageName: string): Promise<\n  Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>\n> {\n  const packageDir = path.join(RELEASE_NOTES_PATH, packageName);\n  try {\n    const files = await fs.readdir(packageDir);\n    const mdFiles = files.filter((file) => file.endsWith(\".md\"));\n\n    const notes = await Promise.all(\n      mdFiles.map(async (file) => {\n        const parsed = await parseReleaseNoteFile(path.join(packageDir, file));\n        return { ...parsed, packageName };\n      }),\n    );\n\n    return notes.sort((a, b) => {\n      if (!a.version || !b.version) return 0;\n      try {\n        return gt(a.version, b.version) ? -1 : 1;\n      } catch {\n        return b.version.localeCompare(a.version);\n      }\n    });\n  } catch {\n    return [];\n  }\n}\n\nfunction filterReleaseNotesSince(\n  notes: Array<{\n    date?: string;\n    filename: string;\n    packageName: string;\n    summary?: string;\n    version?: string;\n  }>,\n  sinceVersion: string,\n): Array<{\n  date?: string;\n  filename: string;\n  packageName: string;\n  summary?: string;\n  version?: string;\n}> {\n  return notes.filter((note) => {\n    if (!note.version) return false;\n    try {\n      return gt(note.version, sinceVersion);\n    } catch {\n      return false;\n    }\n  });\n}\n\n// =============================================================================\n// SKILL SERVICE\n// =============================================================================\n\n/**\n * Generate alternative spellings for plural/singular matching\n */\nfunction getAlternativeSpellings(alias: string): string[] {\n  const alternatives: string[] = [];\n\n  if (alias.endsWith(\"es\")) {\n    // \"indexes\" -> try \"indexe\" and \"index\"\n    alternatives.push(alias.slice(0, -1)); // Remove \"s\" -> \"indexe\"\n    alternatives.push(alias.slice(0, -2)); // Remove \"es\" -> \"index\"\n  } else if (alias.endsWith(\"s\")) {\n    // \"skills\" -> try \"skill\"\n    alternatives.push(alias.slice(0, -1)); // Remove \"s\" -> \"skill\"\n  } else {\n    // \"fish\" -> try \"fishs\" and \"fishes\"\n    alternatives.push(alias + \"s\");\n    alternatives.push(alias + \"es\");\n  }\n\n  return alternatives;\n}\n\n/**\n * Add alias to frontmatter indicating the canonical skill name\n */\nfunction addAliasToFrontmatter(content: string, matchedAlias: string): string {\n  if (content.startsWith(\"---\")) {\n    // Find the end of frontmatter\n    const endIndex = content.indexOf(\"---\", 3);\n    if (endIndex !== -1) {\n      // Insert alias before the closing ---\n      const beforeClose = content.slice(0, endIndex);\n      const afterClose = content.slice(endIndex);\n      return `${beforeClose}alias: ${matchedAlias}\\n${afterClose}`;\n    }\n  }\n  // No frontmatter exists, create one\n  return `---\\nalias: ${matchedAlias}\\n---\\n\\n${content}`;\n}\n\nexport const skillService = fabricService({\n  alias: \"skill\",\n  description:\n    \"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.\",\n  input: {\n    alias: {\n      description:\n        \"Skill alias (e.g., 'aws', 'tests'). Omit or use 'index' to list all skills.\",\n      required: false,\n      type: String,\n    },\n  },\n  service: async ({ alias: inputAlias }: { alias?: string }) => {\n    const alias = normalizeAlias(inputAlias || \"index\");\n\n    if (!isValidAlias(alias)) {\n      throw new Error(\n        `Invalid skill alias \"${alias}\". Use alphanumeric characters, hyphens, and underscores only.`,\n      );\n    }\n\n    if (alias === \"index\") {\n      // Get index content\n      const indexRecord = await skillStore.get(\"index\");\n      const indexContent = indexRecord?.content || \"\";\n\n      // List all skills except index\n      const allSkills = await skillStore.list();\n      const skills = allSkills.filter((s) => s.alias !== \"index\");\n      const skillList = skills.map(formatSkillListItem).join(\"\\n\");\n\n      if (indexContent) {\n        return `${indexContent}\\n\\n## Available Skills\\n\\n${skillList}`;\n      }\n      return `# Jaypie Skills\\n\\n## Available Skills\\n\\n${skillList}`;\n    }\n\n    // Try exact match first\n    let skill = await skillStore.get(alias);\n    let matchedAlias = alias;\n\n    // If no exact match, try alternative spellings (plural/singular)\n    if (!skill) {\n      const alternatives = getAlternativeSpellings(alias);\n      for (const alt of alternatives) {\n        skill = await skillStore.get(alt);\n        if (skill) {\n          matchedAlias = alt;\n          break;\n        }\n      }\n    }\n\n    if (!skill) {\n      throw new Error(\n        `Skill \"${alias}\" not found. Use skill(\"index\") to list available skills.`,\n      );\n    }\n\n    // Return raw file content for non-index skills (preserve frontmatter)\n    const skillPath = path.join(SKILLS_PATH, `${matchedAlias}.md`);\n    let content = await fs.readFile(skillPath, \"utf-8\");\n\n    // If we matched via alternative spelling, add alias to indicate canonical name\n    if (matchedAlias !== alias) {\n      content = addAliasToFrontmatter(content, matchedAlias);\n    }\n\n    return content;\n  },\n});\n\n// =============================================================================\n// VERSION SERVICE\n// =============================================================================\n\nexport const versionService = fabricService({\n  alias: \"version\",\n  description: `Prints the current version and hash, \\`${BUILD_VERSION_STRING}\\``,\n  input: {},\n  service: async () => BUILD_VERSION_STRING,\n});\n\n// =============================================================================\n// RELEASE NOTES SERVICE\n// =============================================================================\n\nasync function getReleaseNotesHelp(): Promise<string> {\n  return fs.readFile(path.join(__dirname, \"release-notes\", \"help.md\"), \"utf-8\");\n}\n\ninterface ReleaseNotesInput {\n  package?: string;\n  since_version?: string;\n  version?: string;\n}\n\nexport const releaseNotesService = fabricService({\n  alias: \"release_notes\",\n  description:\n    \"Browse Jaypie package release notes. Commands: list, read. Call with no args for help.\",\n  input: {\n    command: {\n      description: \"Command to execute (omit for help)\",\n      required: false,\n      type: String,\n    },\n    input: {\n      description: \"Command parameters\",\n      required: false,\n      type: Object,\n    },\n  },\n  service: async ({\n    command,\n    input: params,\n  }: {\n    command?: string;\n    input?: ReleaseNotesInput;\n  }) => {\n    if (!command || command === \"help\") {\n      return getReleaseNotesHelp();\n    }\n\n    const p = params || {};\n\n    switch (command) {\n      case \"list\": {\n        const entries = await fs.readdir(RELEASE_NOTES_PATH, {\n          withFileTypes: true,\n        });\n        const packageDirs = entries\n          .filter((entry) => entry.isDirectory())\n          .map((entry) => entry.name);\n        const packagesToList = p.package\n          ? packageDirs.filter((pkg) => pkg === p.package)\n          : packageDirs;\n\n        if (packagesToList.length === 0 && p.package) {\n          return `No release notes found for package \"${p.package}\".`;\n        }\n\n        const allNotes = await Promise.all(\n          packagesToList.map((pkg) => getPackageReleaseNotes(pkg)),\n        );\n        let flatNotes = allNotes.flat();\n\n        if (p.since_version) {\n          flatNotes = filterReleaseNotesSince(flatNotes, p.since_version);\n        }\n\n        if (flatNotes.length === 0) {\n          const filterDesc = p.since_version\n            ? ` newer than ${p.since_version}`\n            : \"\";\n          return `No release notes found${filterDesc}.`;\n        }\n\n        return flatNotes.map(formatReleaseNoteListItem).join(\"\\n\");\n      }\n\n      case \"read\": {\n        if (!p.package) throw new Error(\"package is required\");\n        if (!p.version) throw new Error(\"version is required\");\n        const filePath = path.join(\n          RELEASE_NOTES_PATH,\n          p.package,\n          `${p.version}.md`,\n        );\n        return fs.readFile(filePath, \"utf-8\");\n      }\n\n      default:\n        throw new Error(\n          `Unknown command: ${command}. Use release_notes() for help.`,\n        );\n    }\n  },\n});\n"],"names":["__filename","__dirname"],"mappings":"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"}

package/dist/suites/llm/help.md

@@ -6,8 +6,20 @@ Debug and inspect LLM provider responses. Useful for understanding how providers
 
 | Command | Description | Required Parameters |
 |---------|-------------|---------------------|
+| `validate` | Validate LLM setup (check API keys) | - |
 | `debug_call` | Make a debug call and inspect response | `provider`, `message` |
 
+## Parameters
+
+All parameters are passed at the top level (flat structure):
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `command` | string | Command to execute (omit for help) |
+| `provider` | string | LLM provider: anthropic, openai, google, openrouter |
+| `message` | string | Message to send to the LLM provider |
+| `model` | string | Model to use (provider-specific, e.g., gpt-4, claude-3-sonnet) |
+
 ## Providers
 
 Supported providers: `openai`, `anthropic`, `gemini`, `openrouter`
@@ -18,14 +30,20 @@ Supported providers: `openai`, `anthropic`, `gemini`, `openrouter`
 |----------|-------------|
 | `OPENAI_API_KEY` | OpenAI API key |
 | `ANTHROPIC_API_KEY` | Anthropic API key |
-| `GOOGLE_API_KEY` | Google/Gemini API key |
+| `GOOGLE_API_KEY` or `GEMINI_API_KEY` | Google/Gemini API key |
 | `OPENROUTER_API_KEY` | OpenRouter API key |
 
 ## Examples
 
 ```
-llm("debug_call", { provider: "openai", message: "Hello, world!" })
-llm("debug_call", { provider: "openai", model: "o3-mini", message: "What is 15 * 17? Think step by step." })
+# Debug OpenAI call
+llm({ command: "debug_call", provider: "openai", message: "Hello, world!" })
+
+# Debug with specific model
+llm({ command: "debug_call", provider: "openai", model: "o3-mini", message: "What is 15 * 17? Think step by step." })
+
+# Debug Anthropic call
+llm({ command: "debug_call", provider: "anthropic", message: "Explain quantum computing" })
 ```
 
 ## Response Fields

package/dist/suites/llm/index.d.ts

@@ -1,11 +1,2 @@
-import { type LlmProvider } from "./llm.js";
-interface LlmInput {
-    message?: string;
-    model?: string;
-    provider?: LlmProvider;
-}
-export declare const llmService: import("@jaypie/fabric").Service<{
-    command?: string;
-    input?: LlmInput;
-}, string | import("./llm.js").LlmDebugCallResult, string | import("./llm.js").LlmDebugCallResult>;
+export declare const llmService: import("@jaypie/fabric").Service<Record<string, unknown>, string | import("./llm.js").LlmDebugCallResult | import("./llm.js").LlmValidationResult, string | import("./llm.js").LlmDebugCallResult | import("./llm.js").LlmValidationResult>;
 export * from "./llm.js";

package/dist/suites/llm/index.js

@@ -2,7 +2,7 @@ import { fabricService } from '@jaypie/fabric';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { debugLlmCall } from './llm.js';
+import { debugLlmCall, validateLlmSetup } from './llm.js';
 
 /**
  * LLM Suite - Unified LLM debugging and inspection
@@ -25,18 +25,32 @@ const llmService = fabricService({
             required: false,
             type: String,
         },
-        input: {
-            description: "Command parameters",
+        message: {
+            description: "Message to send to the LLM provider",
             required: false,
-            type: Object,
+            type: String,
+        },
+        model: {
+            description: "Model to use (provider-specific, e.g., gpt-4, claude-3-sonnet)",
+            required: false,
+            type: String,
+        },
+        provider: {
+            description: "LLM provider: anthropic, openai, google, openrouter",
+            required: false,
+            type: String,
         },
     },
-    service: async ({ command, input: params, }) => {
+    service: async (params) => {
+        const { command } = params;
         if (!command || command === "help") {
             return getHelp();
         }
-        const p = params || {};
+        const p = params;
         switch (command) {
+            case "validate": {
+                return validateLlmSetup();
+            }
             case "debug_call": {
                 if (!p.provider)
                     throw new Error("provider is required");
@@ -57,5 +71,5 @@ const llmService = fabricService({
     },
 });
 
-export { debugLlmCall, llmService };
+export { debugLlmCall, llmService, validateLlmSetup };
 //# sourceMappingURL=index.js.map