@jaypie/mcp 0.5.0 → 0.6.1

package/dist/createMcpServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"createMcpServer.js","sources":["../src/createMcpServer.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\n\nimport { createMcpServerFromSuite } from \"@jaypie/fabric/mcp\";\n\nimport { suite } from \"./suite.js\";\n\nexport interface CreateMcpServerOptions {\n  version?: string;\n  verbose?: boolean;\n}\n\n/**\n * Creates and configures an MCP server instance with Jaypie tools\n *\n * Uses ServiceSuite to register all services as MCP tools automatically.\n * Services are defined in suite.ts using fabricService and registered\n * by category. The createMcpServerFromSuite bridge converts them to\n * MCP tools with proper Zod schema validation.\n *\n * @param options - Configuration options (or legacy version string)\n * @returns Configured MCP server instance\n */\nexport function createMcpServer(\n  options: CreateMcpServerOptions | string = {},\n): McpServer {\n  // Support legacy signature: createMcpServer(version: string)\n  const config: CreateMcpServerOptions =\n    typeof options === \"string\" ? { version: options } : options;\n\n  const { version = \"0.0.0\", verbose = false } = config;\n\n  if (verbose) {\n    console.error(\"[jaypie-mcp] Creating MCP server instance from suite\");\n  }\n\n  const server = createMcpServerFromSuite(suite, {\n    name: suite.name,\n    version,\n  });\n\n  if (verbose) {\n    console.error(\n      `[jaypie-mcp] Registered ${suite.services.length} tools from suite`,\n    );\n    console.error(\n      `[jaypie-mcp] Categories: ${suite.categories.join(\", \")}`,\n    );\n  }\n\n  return server;\n}\n"],"names":[],"mappings":";;;AAWA;;;;;;;;;;AAUG;AACG,SAAU,eAAe,CAC7B,OAAA,GAA2C,EAAE,EAAA;;AAG7C,IAAA,MAAM,MAAM,GACV,OAAO,OAAO,KAAK,QAAQ,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO;IAE9D,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,MAAM;IAErD,IAAI,OAAO,EAAE;AACX,QAAA,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC;IACvE;AAEA,IAAA,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,EAAE;QAC7C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO;AACR,KAAA,CAAC;IAEF,IAAI,OAAO,EAAE;QACX,OAAO,CAAC,KAAK,CACX,CAAA,wBAAA,EAA2B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAA,iBAAA,CAAmB,CACpE;AACD,QAAA,OAAO,CAAC,KAAK,CACX,CAAA,yBAAA,EAA4B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAC1D;IACH;AAEA,IAAA,OAAO,MAAM;AACf;;;;"}
+{"version":3,"file":"createMcpServer.js","sources":["../src/createMcpServer.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\n\nimport { createMcpServerFromSuite } from \"@jaypie/fabric/mcp\";\n\nimport { suite } from \"./suite.js\";\n\nexport interface CreateMcpServerOptions {\n  version?: string;\n  verbose?: boolean;\n}\n\n/**\n * Creates and configures an MCP server instance with Jaypie tools\n *\n * Uses ServiceSuite to register all services as MCP tools automatically.\n * Services are defined in suite.ts using fabricService and registered\n * by category. The createMcpServerFromSuite bridge converts them to\n * MCP tools with proper Zod schema validation.\n *\n * @param options - Configuration options (or legacy version string)\n * @returns Configured MCP server instance\n */\nexport function createMcpServer(\n  options: CreateMcpServerOptions | string = {},\n): McpServer {\n  // Support legacy signature: createMcpServer(version: string)\n  const config: CreateMcpServerOptions =\n    typeof options === \"string\" ? { version: options } : options;\n\n  const { version = \"0.0.0\", verbose = false } = config;\n\n  if (verbose) {\n    console.error(\"[jaypie-mcp] Creating MCP server instance from suite\");\n  }\n\n  const server = createMcpServerFromSuite(suite, {\n    name: suite.name,\n    version,\n  });\n\n  if (verbose) {\n    console.error(\n      `[jaypie-mcp] Registered ${suite.services.length} tools from suite`,\n    );\n    console.error(`[jaypie-mcp] Categories: ${suite.categories.join(\", \")}`);\n  }\n\n  return server;\n}\n"],"names":[],"mappings":";;;AAWA;;;;;;;;;;AAUG;AACG,SAAU,eAAe,CAC7B,OAAA,GAA2C,EAAE,EAAA;;AAG7C,IAAA,MAAM,MAAM,GACV,OAAO,OAAO,KAAK,QAAQ,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO;IAE9D,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,MAAM;IAErD,IAAI,OAAO,EAAE;AACX,QAAA,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC;IACvE;AAEA,IAAA,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,EAAE;QAC7C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO;AACR,KAAA,CAAC;IAEF,IAAI,OAAO,EAAE;QACX,OAAO,CAAC,KAAK,CACX,CAAA,wBAAA,EAA2B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAA,iBAAA,CAAmB,CACpE;AACD,QAAA,OAAO,CAAC,KAAK,CAAC,CAAA,yBAAA,EAA4B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAAC;IAC1E;AAEA,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/suites/docs/index.js

@@ -8,7 +8,7 @@ import { gt } from 'semver';
 /**
  * Docs Suite - Documentation services (skill, version, release_notes)
  */
-const BUILD_VERSION_STRING = "@jaypie/mcp@0.5.0#6259f1e8"
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.6.1#212eddb5"
     ;
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);

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 * 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(__dirname, \"..\", \"..\", \"..\", \"release-notes\");\nconst SKILLS_PATH = path.join(__dirname, \"..\", \"..\", \"..\", \"skills\");\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\ninterface ReleaseNoteFrontMatter {\n  date?: string;\n  summary?: string;\n  version?: string;\n}\n\ninterface SkillFrontMatter {\n  description?: string;\n}\n\nfunction isValidSkillAlias(alias: string): boolean {\n  const normalized = alias.toLowerCase().trim();\n  if (\n    normalized.includes(\"/\") ||\n    normalized.includes(\"\\\\\") ||\n    normalized.includes(\"..\")\n  ) {\n    return false;\n  }\n  return /^[a-z0-9_-]+$/.test(normalized);\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\nasync function parseSkillFile(filePath: string): Promise<{\n  alias: string;\n  description?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const alias = path.basename(filePath, \".md\");\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as SkillFrontMatter;\n      return {\n        alias,\n        description: frontMatter.description,\n      };\n    }\n\n    return { alias };\n  } catch {\n    return { alias: path.basename(filePath, \".md\") };\n  }\n}\n\nfunction formatSkillListItem(skill: {\n  alias: string;\n  description?: string;\n}): 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 = (inputAlias || \"index\").toLowerCase().trim();\n\n    if (!isValidSkillAlias(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      const indexPath = path.join(SKILLS_PATH, \"index.md\");\n      let indexContent = \"\";\n\n      try {\n        indexContent = await fs.readFile(indexPath, \"utf-8\");\n        if (indexContent.startsWith(\"---\")) {\n          const parsed = matter(indexContent);\n          indexContent = parsed.content.trim();\n        }\n      } catch {\n        // Index file doesn't exist, will just show skill list\n      }\n\n      const files = await fs.readdir(SKILLS_PATH);\n      const mdFiles = files.filter(\n        (file) => file.endsWith(\".md\") && file !== \"index.md\",\n      );\n\n      const skills = await Promise.all(\n        mdFiles.map((file) => parseSkillFile(path.join(SKILLS_PATH, file))),\n      );\n\n      skills.sort((a, b) => a.alias.localeCompare(b.alias));\n\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 skillPath = path.join(SKILLS_PATH, `${alias}.md`);\n    try {\n      return await fs.readFile(skillPath, \"utf-8\");\n    } catch {\n      throw new Error(\n        `Skill \"${alias}\" not found. Use skill(\"index\") to list available skills.`,\n      );\n    }\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(\n    path.join(__dirname, \"release-notes\", \"help.md\"),\n    \"utf-8\",\n  );\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 * 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// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\ninterface ReleaseNoteFrontMatter {\n  date?: string;\n  summary?: string;\n  version?: string;\n}\n\ninterface SkillFrontMatter {\n  description?: string;\n}\n\nfunction isValidSkillAlias(alias: string): boolean {\n  const normalized = alias.toLowerCase().trim();\n  if (\n    normalized.includes(\"/\") ||\n    normalized.includes(\"\\\\\") ||\n    normalized.includes(\"..\")\n  ) {\n    return false;\n  }\n  return /^[a-z0-9_-]+$/.test(normalized);\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\nasync function parseSkillFile(filePath: string): Promise<{\n  alias: string;\n  description?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const alias = path.basename(filePath, \".md\");\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as SkillFrontMatter;\n      return {\n        alias,\n        description: frontMatter.description,\n      };\n    }\n\n    return { alias };\n  } catch {\n    return { alias: path.basename(filePath, \".md\") };\n  }\n}\n\nfunction formatSkillListItem(skill: {\n  alias: string;\n  description?: string;\n}): 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 = (inputAlias || \"index\").toLowerCase().trim();\n\n    if (!isValidSkillAlias(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      const indexPath = path.join(SKILLS_PATH, \"index.md\");\n      let indexContent = \"\";\n\n      try {\n        indexContent = await fs.readFile(indexPath, \"utf-8\");\n        if (indexContent.startsWith(\"---\")) {\n          const parsed = matter(indexContent);\n          indexContent = parsed.content.trim();\n        }\n      } catch {\n        // Index file doesn't exist, will just show skill list\n      }\n\n      const files = await fs.readdir(SKILLS_PATH);\n      const mdFiles = files.filter(\n        (file) => file.endsWith(\".md\") && file !== \"index.md\",\n      );\n\n      const skills = await Promise.all(\n        mdFiles.map((file) => parseSkillFile(path.join(SKILLS_PATH, file))),\n      );\n\n      skills.sort((a, b) => a.alias.localeCompare(b.alias));\n\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 skillPath = path.join(SKILLS_PATH, `${alias}.md`);\n    try {\n      return await fs.readFile(skillPath, \"utf-8\");\n    } catch {\n      throw new Error(\n        `Skill \"${alias}\" not found. Use skill(\"index\") to list available skills.`,\n      );\n    }\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,17 +6,11 @@ Debug and inspect LLM provider responses. Useful for understanding how providers
 
 | Command | Description | Required Parameters |
 |---------|-------------|---------------------|
-| `list_providers` | List available providers and models | - |
 | `debug_call` | Make a debug call and inspect response | `provider`, `message` |
 
 ## Providers
 
-| Provider | Default Model | Reasoning Models |
-|----------|---------------|------------------|
-| `openai` | gpt-4o-mini | o3-mini, o1-preview, o1-mini |
-| `anthropic` | claude-sonnet-4-20250514 | - |
-| `gemini` | gemini-2.0-flash | - |
-| `openrouter` | openai/gpt-4o-mini | openai/o3-mini, openai/o1-preview |
+Supported providers: `openai`, `anthropic`, `gemini`, `openrouter`
 
 ## Environment Variables
 
@@ -30,7 +24,6 @@ Debug and inspect LLM provider responses. Useful for understanding how providers
 ## Examples
 
 ```
-llm("list_providers")
 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." })
 ```

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

@@ -7,17 +7,5 @@ interface LlmInput {
 export declare const llmService: import("@jaypie/fabric").Service<{
     command?: string;
     input?: LlmInput;
-}, string | import("./llm.js").LlmDebugCallResult | {
-    providers: Array<{
-        name: LlmProvider;
-        defaultModel: string;
-        reasoningModels: string[];
-    }>;
-}, string | import("./llm.js").LlmDebugCallResult | {
-    providers: Array<{
-        name: LlmProvider;
-        defaultModel: string;
-        reasoningModels: string[];
-    }>;
-}>;
+}, string | import("./llm.js").LlmDebugCallResult, string | import("./llm.js").LlmDebugCallResult>;
 export * from "./llm.js";

package/dist/suites/llm/index.js

@@ -2,8 +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, listLlmProviders } from './llm.js';
-export { REASONING_MODELS } from './llm.js';
+import { debugLlmCall } from './llm.js';
 
 /**
  * LLM Suite - Unified LLM debugging and inspection
@@ -19,7 +18,7 @@ async function getHelp() {
 }
 const llmService = fabricService({
     alias: "llm",
-    description: "Debug LLM provider responses. Commands: list_providers, debug_call. Call with no args for help.",
+    description: "Debug LLM provider responses. Commands: debug_call. Call with no args for help.",
     input: {
         command: {
             description: "Command to execute (omit for help)",
@@ -38,9 +37,6 @@ const llmService = fabricService({
         }
         const p = params || {};
         switch (command) {
-            case "list_providers": {
-                return listLlmProviders();
-            }
             case "debug_call": {
                 if (!p.provider)
                     throw new Error("provider is required");
@@ -61,5 +57,5 @@ const llmService = fabricService({
     },
 });
 
-export { debugLlmCall, listLlmProviders, llmService };
+export { debugLlmCall, llmService };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/suites/llm/index.ts"],"sourcesContent":["/**\n * LLM Suite - Unified LLM debugging and inspection\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 { debugLlmCall, listLlmProviders, type LlmProvider } from \"./llm.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 LLM service\ninterface LlmInput {\n  message?: string;\n  model?: string;\n  provider?: LlmProvider;\n}\n\nexport const llmService = fabricService({\n  alias: \"llm\",\n  description:\n    \"Debug LLM provider responses. Commands: list_providers, debug_call. 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?: LlmInput;\n  }) => {\n    if (!command || command === \"help\") {\n      return getHelp();\n    }\n\n    const p = params || {};\n\n    switch (command) {\n      case \"list_providers\": {\n        return listLlmProviders();\n      }\n\n      case \"debug_call\": {\n        if (!p.provider) throw new Error(\"provider is required\");\n        if (!p.message) throw new Error(\"message is required\");\n        const result = await debugLlmCall(\n          {\n            message: p.message,\n            model: p.model,\n            provider: p.provider,\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 llm() for help.`);\n    }\n  },\n});\n\n// Re-export types and functions for testing\nexport * from \"./llm.js\";\n"],"names":["__dirname"],"mappings":";;;;;;;AAAA;;AAEG;AAQH,MAAMA,WAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE9D;AACA,MAAM,GAAG,GAAG;AACV,IAAA,KAAK,EAAE,MAAK,EAAE,CAAC;AACf,IAAA,IAAI,EAAE,MAAK,EAAE,CAAC;CACf;AAED,eAAe,OAAO,GAAA;AACpB,IAAA,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAACA,WAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC;AAC9D;AASO,MAAM,UAAU,GAAG,aAAa,CAAC;AACtC,IAAA,KAAK,EAAE,KAAK;AACZ,IAAA,WAAW,EACT,iGAAiG;AACnG,IAAA,KAAK,EAAE;AACL,QAAA,OAAO,EAAE;AACP,YAAA,WAAW,EAAE,oCAAoC;AACjD,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,IAAI,EAAE,MAAM;AACb,SAAA;AACD,QAAA,KAAK,EAAE;AACL,YAAA,WAAW,EAAE,oBAAoB;AACjC,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,IAAI,EAAE,MAAM;AACb,SAAA;AACF,KAAA;IACD,OAAO,EAAE,OAAO,EACd,OAAO,EACP,KAAK,EAAE,MAAM,GAId,KAAI;AACH,QAAA,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,EAAE;YAClC,OAAO,OAAO,EAAE;QAClB;AAEA,QAAA,MAAM,CAAC,GAAG,MAAM,IAAI,EAAE;QAEtB,QAAQ,OAAO;YACb,KAAK,gBAAgB,EAAE;gBACrB,OAAO,gBAAgB,EAAE;YAC3B;YAEA,KAAK,YAAY,EAAE;gBACjB,IAAI,CAAC,CAAC,CAAC,QAAQ;AAAE,oBAAA,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;gBACxD,IAAI,CAAC,CAAC,CAAC,OAAO;AAAE,oBAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC;AACtD,gBAAA,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B;oBACE,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,EACD,GAAG,CACJ;gBACD,IAAI,CAAC,MAAM,CAAC,OAAO;AAAE,oBAAA,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;AAClD,gBAAA,OAAO,MAAM;YACf;AAEA,YAAA;AACE,gBAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,CAAA,qBAAA,CAAuB,CAAC;;IAEzE,CAAC;AACF,CAAA;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/suites/llm/index.ts"],"sourcesContent":["/**\n * LLM Suite - Unified LLM debugging and inspection\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 { debugLlmCall, type LlmProvider } from \"./llm.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 LLM service\ninterface LlmInput {\n  message?: string;\n  model?: string;\n  provider?: LlmProvider;\n}\n\nexport const llmService = fabricService({\n  alias: \"llm\",\n  description:\n    \"Debug LLM provider responses. Commands: debug_call. 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?: LlmInput;\n  }) => {\n    if (!command || command === \"help\") {\n      return getHelp();\n    }\n\n    const p = params || {};\n\n    switch (command) {\n      case \"debug_call\": {\n        if (!p.provider) throw new Error(\"provider is required\");\n        if (!p.message) throw new Error(\"message is required\");\n        const result = await debugLlmCall(\n          {\n            message: p.message,\n            model: p.model,\n            provider: p.provider,\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 llm() for help.`);\n    }\n  },\n});\n\n// Re-export types and functions for testing\nexport * from \"./llm.js\";\n"],"names":["__dirname"],"mappings":";;;;;;AAAA;;AAEG;AAQH,MAAMA,WAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE9D;AACA,MAAM,GAAG,GAAG;AACV,IAAA,KAAK,EAAE,MAAK,EAAE,CAAC;AACf,IAAA,IAAI,EAAE,MAAK,EAAE,CAAC;CACf;AAED,eAAe,OAAO,GAAA;AACpB,IAAA,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAACA,WAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC;AAC9D;AASO,MAAM,UAAU,GAAG,aAAa,CAAC;AACtC,IAAA,KAAK,EAAE,KAAK;AACZ,IAAA,WAAW,EACT,iFAAiF;AACnF,IAAA,KAAK,EAAE;AACL,QAAA,OAAO,EAAE;AACP,YAAA,WAAW,EAAE,oCAAoC;AACjD,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,IAAI,EAAE,MAAM;AACb,SAAA;AACD,QAAA,KAAK,EAAE;AACL,YAAA,WAAW,EAAE,oBAAoB;AACjC,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,IAAI,EAAE,MAAM;AACb,SAAA;AACF,KAAA;IACD,OAAO,EAAE,OAAO,EACd,OAAO,EACP,KAAK,EAAE,MAAM,GAId,KAAI;AACH,QAAA,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,EAAE;YAClC,OAAO,OAAO,EAAE;QAClB;AAEA,QAAA,MAAM,CAAC,GAAG,MAAM,IAAI,EAAE;QAEtB,QAAQ,OAAO;YACb,KAAK,YAAY,EAAE;gBACjB,IAAI,CAAC,CAAC,CAAC,QAAQ;AAAE,oBAAA,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;gBACxD,IAAI,CAAC,CAAC,CAAC,OAAO;AAAE,oBAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC;AACtD,gBAAA,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B;oBACE,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,EACD,GAAG,CACJ;gBACD,IAAI,CAAC,MAAM,CAAC,OAAO;AAAE,oBAAA,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;AAClD,gBAAA,OAAO,MAAM;YACf;AAEA,YAAA;AACE,gBAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,CAAA,qBAAA,CAAuB,CAAC;;IAEzE,CAAC;AACF,CAAA;;;;"}

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

@@ -23,19 +23,8 @@ interface Logger {
     info: (message: string, ...args: unknown[]) => void;
     error: (message: string, ...args: unknown[]) => void;
 }
-export declare const REASONING_MODELS: Record<string, string>;
 /**
  * Make a debug LLM call and return the raw response data for inspection
  */
 export declare function debugLlmCall(params: LlmDebugCallParams, log: Logger): Promise<LlmDebugCallResult>;
-/**
- * List available providers and their default/reasoning models
- */
-export declare function listLlmProviders(): {
-    providers: Array<{
-        name: LlmProvider;
-        defaultModel: string;
-        reasoningModels: string[];
-    }>;
-};
 export {};

package/dist/suites/llm/llm.js

@@ -1,20 +1,14 @@
-import { Llm } from '@jaypie/llm';
+import { LLM, Llm } from '@jaypie/llm';
 
 /**
  * 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",
-};
-// Reasoning-capable models for testing reasoning extraction
-const REASONING_MODELS = {
-    "openai-o3-mini": "o3-mini",
-    "openai-o1-preview": "o1-preview",
-    "openai-o1-mini": "o1-mini",
+    anthropic: LLM.PROVIDER.ANTHROPIC.MODEL.SMALL,
+    gemini: LLM.PROVIDER.GEMINI.MODEL.SMALL,
+    openai: LLM.PROVIDER.OPENAI.MODEL.SMALL,
+    openrouter: LLM.PROVIDER.OPENROUTER.MODEL.SMALL,
 };
 /**
  * Make a debug LLM call and return the raw response data for inspection
@@ -62,35 +56,6 @@ async function debugLlmCall(params, log) {
         };
     }
 }
-/**
- * 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"],
-            },
-        ],
-    };
-}
 
-export { REASONING_MODELS, debugLlmCall, listLlmProviders };
+export { debugLlmCall };
 //# sourceMappingURL=llm.js.map

package/dist/suites/llm/llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm.js","sources":["../../../src/suites/llm/llm.ts"],"sourcesContent":["/**\n * LLM debugging utilities for inspecting raw provider responses\n */\n\nimport { Llm } from \"@jaypie/llm\";\n\nexport type LlmProvider = \"anthropic\" | \"gemini\" | \"openai\" | \"openrouter\";\n\nexport interface LlmDebugCallParams {\n  provider: LlmProvider;\n  model?: string;\n  message: string;\n}\n\nexport interface LlmDebugCallResult {\n  success: boolean;\n  provider: string;\n  model: string;\n  content?: string;\n  reasoning?: string[];\n  reasoningTokens?: number;\n  history?: unknown[];\n  rawResponses?: unknown[];\n  usage?: unknown[];\n  error?: string;\n}\n\ninterface Logger {\n  info: (message: string, ...args: unknown[]) => void;\n  error: (message: string, ...args: unknown[]) => void;\n}\n\n// Default models for each provider\nconst DEFAULT_MODELS: Record<LlmProvider, string> = {\n  anthropic: \"claude-sonnet-4-20250514\",\n  gemini: \"gemini-2.0-flash\",\n  openai: \"gpt-4o-mini\",\n  openrouter: \"openai/gpt-4o-mini\",\n};\n\n// Reasoning-capable models for testing reasoning extraction\nexport const REASONING_MODELS: Record<string, string> = {\n  \"openai-o3-mini\": \"o3-mini\",\n  \"openai-o1-preview\": \"o1-preview\",\n  \"openai-o1-mini\": \"o1-mini\",\n};\n\n/**\n * Make a debug LLM call and return the raw response data for inspection\n */\nexport async function debugLlmCall(\n  params: LlmDebugCallParams,\n  log: Logger,\n): Promise<LlmDebugCallResult> {\n  const { provider, message } = params;\n  const model = params.model || DEFAULT_MODELS[provider];\n\n  log.info(`Making debug LLM call to ${provider} with model ${model}`);\n\n  try {\n    const llm = new Llm(provider, { model });\n\n    const result = await llm.operate(message, {\n      user: \"[jaypie-mcp] Debug LLM Call\",\n    });\n\n    if (result.error) {\n      return {\n        success: false,\n        provider,\n        model,\n        error: `${result.error.title}: ${result.error.detail || \"Unknown error\"}`,\n      };\n    }\n\n    // Calculate total reasoning tokens\n    const reasoningTokens = result.usage.reduce(\n      (sum, u) => sum + (u.reasoning || 0),\n      0,\n    );\n\n    return {\n      success: true,\n      provider,\n      model,\n      content:\n        typeof result.content === \"string\"\n          ? result.content\n          : JSON.stringify(result.content),\n      reasoning: result.reasoning,\n      reasoningTokens,\n      history: result.history,\n      rawResponses: result.responses,\n      usage: result.usage,\n    };\n  } catch (error) {\n    log.error(`Error calling ${provider}:`, error);\n    return {\n      success: false,\n      provider,\n      model,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * List available providers and their default/reasoning models\n */\nexport function listLlmProviders(): {\n  providers: Array<{\n    name: LlmProvider;\n    defaultModel: string;\n    reasoningModels: string[];\n  }>;\n} {\n  return {\n    providers: [\n      {\n        name: \"openai\",\n        defaultModel: DEFAULT_MODELS.openai,\n        reasoningModels: [\"o3-mini\", \"o1-preview\", \"o1-mini\"],\n      },\n      {\n        name: \"anthropic\",\n        defaultModel: DEFAULT_MODELS.anthropic,\n        reasoningModels: [], // Anthropic doesn't expose reasoning the same way\n      },\n      {\n        name: \"gemini\",\n        defaultModel: DEFAULT_MODELS.gemini,\n        reasoningModels: [], // Gemini has thoughtsTokenCount but unclear on content\n      },\n      {\n        name: \"openrouter\",\n        defaultModel: DEFAULT_MODELS.openrouter,\n        reasoningModels: [\"openai/o3-mini\", \"openai/o1-preview\"],\n      },\n    ],\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"llm.js","sources":["../../../src/suites/llm/llm.ts"],"sourcesContent":["/**\n * LLM debugging utilities for inspecting raw provider responses\n */\n\nimport { LLM, Llm } from \"@jaypie/llm\";\n\nexport type LlmProvider = \"anthropic\" | \"gemini\" | \"openai\" | \"openrouter\";\n\nexport interface LlmDebugCallParams {\n  provider: LlmProvider;\n  model?: string;\n  message: string;\n}\n\nexport interface LlmDebugCallResult {\n  success: boolean;\n  provider: string;\n  model: string;\n  content?: string;\n  reasoning?: string[];\n  reasoningTokens?: number;\n  history?: unknown[];\n  rawResponses?: unknown[];\n  usage?: unknown[];\n  error?: string;\n}\n\ninterface Logger {\n  info: (message: string, ...args: unknown[]) => void;\n  error: (message: string, ...args: unknown[]) => void;\n}\n\n// Default models for each provider\nconst DEFAULT_MODELS: Record<LlmProvider, string> = {\n  anthropic: LLM.PROVIDER.ANTHROPIC.MODEL.SMALL,\n  gemini: LLM.PROVIDER.GEMINI.MODEL.SMALL,\n  openai: LLM.PROVIDER.OPENAI.MODEL.SMALL,\n  openrouter: LLM.PROVIDER.OPENROUTER.MODEL.SMALL,\n};\n\n/**\n * Make a debug LLM call and return the raw response data for inspection\n */\nexport async function debugLlmCall(\n  params: LlmDebugCallParams,\n  log: Logger,\n): Promise<LlmDebugCallResult> {\n  const { provider, message } = params;\n  const model = params.model || DEFAULT_MODELS[provider];\n\n  log.info(`Making debug LLM call to ${provider} with model ${model}`);\n\n  try {\n    const llm = new Llm(provider, { model });\n\n    const result = await llm.operate(message, {\n      user: \"[jaypie-mcp] Debug LLM Call\",\n    });\n\n    if (result.error) {\n      return {\n        success: false,\n        provider,\n        model,\n        error: `${result.error.title}: ${result.error.detail || \"Unknown error\"}`,\n      };\n    }\n\n    // Calculate total reasoning tokens\n    const reasoningTokens = result.usage.reduce(\n      (sum, u) => sum + (u.reasoning || 0),\n      0,\n    );\n\n    return {\n      success: true,\n      provider,\n      model,\n      content:\n        typeof result.content === \"string\"\n          ? result.content\n          : JSON.stringify(result.content),\n      reasoning: result.reasoning,\n      reasoningTokens,\n      history: result.history,\n      rawResponses: result.responses,\n      usage: result.usage,\n    };\n  } catch (error) {\n    log.error(`Error calling ${provider}:`, error);\n    return {\n      success: false,\n      provider,\n      model,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n"],"names":[],"mappings":";;AAAA;;AAEG;AA8BH;AACA,MAAM,cAAc,GAAgC;IAClD,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK;IAC7C,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK;IACvC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK;IACvC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK;CAChD;AAED;;AAEG;AACI,eAAe,YAAY,CAChC,MAA0B,EAC1B,GAAW,EAAA;AAEX,IAAA,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,cAAc,CAAC,QAAQ,CAAC;IAEtD,GAAG,CAAC,IAAI,CAAC,CAAA,yBAAA,EAA4B,QAAQ,CAAA,YAAA,EAAe,KAAK,CAAA,CAAE,CAAC;AAEpE,IAAA,IAAI;QACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC;QAExC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE;AACxC,YAAA,IAAI,EAAE,6BAA6B;AACpC,SAAA,CAAC;AAEF,QAAA,IAAI,MAAM,CAAC,KAAK,EAAE;YAChB,OAAO;AACL,gBAAA,OAAO,EAAE,KAAK;gBACd,QAAQ;gBACR,KAAK;AACL,gBAAA,KAAK,EAAE,CAAA,EAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAA,EAAA,EAAK,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,eAAe,CAAA,CAAE;aAC1E;QACH;;QAGA,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CACzC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,EACpC,CAAC,CACF;QAED,OAAO;AACL,YAAA,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,KAAK;AACL,YAAA,OAAO,EACL,OAAO,MAAM,CAAC,OAAO,KAAK;kBACtB,MAAM,CAAC;kBACP,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,eAAe;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,SAAS;YAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB;IACH;IAAE,OAAO,KAAK,EAAE;QACd,GAAG,CAAC,KAAK,CAAC,CAAA,cAAA,EAAiB,QAAQ,CAAA,CAAA,CAAG,EAAE,KAAK,CAAC;QAC9C,OAAO;AACL,YAAA,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,KAAK;AACL,YAAA,KAAK,EAAE,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;SAC9D;IACH;AACF;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/mcp",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Jaypie MCP",
   "repository": {
     "type": "git",

package/release-notes/aws/1.2.5.md

@@ -0,0 +1,18 @@
+---
+version: 1.2.5
+date: 2025-01-23
+summary: Add WebSocket connection management utilities
+---
+
+## New Features
+
+### WebSocket Utilities
+
+- **`sendToConnection(data, { connectionId, domainName, stage })`** - Send data to a WebSocket connection
+- **`broadcastToConnections(data, { connectionIds, domainName, stage })`** - Broadcast data to multiple connections
+
+Both functions use the ApiGatewayManagementApi client and handle stale connection errors gracefully.
+
+## Dependencies
+
+- Added `@aws-sdk/client-apigatewaymanagementapi`

package/release-notes/constructs/1.2.19.md

@@ -0,0 +1,35 @@
+---
+version: 1.2.19
+date: 2025-01-23
+summary: Add WebSocket API Gateway constructs
+---
+
+## New Constructs
+
+### JaypieWebSocket
+
+WebSocket API using AWS API Gateway v2 with custom domain support:
+
+```typescript
+const ws = new JaypieWebSocket(this, "Chat", {
+  host: "ws.example.com",
+  connect: connectLambda,
+  disconnect: disconnectLambda,
+  default: messageLambda,
+  routes: { sendMessage: sendMessageLambda },
+});
+```
+
+### JaypieWebSocketLambda
+
+Convenience Lambda construct for WebSocket handlers with appropriate defaults.
+
+### JaypieWebSocketTable
+
+Optional DynamoDB table for connection tracking with TTL support:
+
+```typescript
+const table = new JaypieWebSocketTable(this, "Connections", {
+  ttl: Duration.hours(24),
+});
+```

package/release-notes/constructs/1.2.20.md

@@ -0,0 +1,17 @@
+---
+version: 1.2.20
+date: 2025-01-25
+summary: Fix grantManageConnections IAM permission
+---
+
+## Bug Fixes
+
+### JaypieWebSocket.grantManageConnections
+
+Fixed `grantManageConnections()` to grant the correct IAM permission for sending messages to WebSocket clients.
+
+**Before**: The method generated an ARN without the `@connections` path, causing `AccessDeniedException` when Lambdas tried to use the API Gateway Management API.
+
+**After**: The ARN now correctly includes `/POST/@connections/*` to match the required permission format.
+
+Fixes #151

package/release-notes/express/1.2.5.md

@@ -0,0 +1,33 @@
+---
+version: 1.2.5
+date: 2026-01-23
+summary: Fix array query parameters with bracket notation in API Gateway v1 events
+---
+
+# @jaypie/express 1.2.5
+
+## Bug Fixes
+
+### Array Query Parameters with Bracket Notation
+
+Fixed a bug where array query parameters using bracket notation (e.g., `?filterByStatus[]=APPROVED&filterByStatus[]=RESOLVED`) were completely ignored when using AWS API Gateway REST API v1 events.
+
+**Before:**
+```javascript
+// URL: ?filterByStatus[]=APPROVED&filterByStatus[]=RESOLVED
+req.query = { "filterByStatus[]": "RESOLVED" }  // Only last value, brackets preserved
+```
+
+**After:**
+```javascript
+// URL: ?filterByStatus[]=APPROVED&filterByStatus[]=RESOLVED
+req.query = { filterByStatus: ["APPROVED", "RESOLVED"] }  // Array with normalized key
+```
+
+## Changes
+
+- Now uses `multiValueQueryStringParameters` from API Gateway v1 events instead of `queryStringParameters` to capture all values
+- Normalizes bracket notation by stripping `[]` suffix from keys
+- Properly handles multi-value query parameters in Function URL v2 events via `rawQueryString` parsing
+- Single values remain as strings unless bracket notation is used
+- Values with bracket notation are always arrays (even with single values)

package/release-notes/fabric/0.2.1.md

@@ -0,0 +1,36 @@
+---
+version: 0.2.1
+date: 2025-01-23
+summary: Add WebSocket adapter for fabric services
+---
+
+## New Features
+
+### fabricWebSocket
+
+Wrap fabric services for WebSocket Lambda handlers:
+
+```typescript
+import { fabricService } from "@jaypie/fabric";
+import { fabricWebSocket } from "@jaypie/fabric/websocket";
+
+const chatService = fabricService({
+  alias: "chat",
+  input: {
+    action: { type: String, validate: ["join", "message"] },
+    room: { type: String },
+  },
+  service: async (input, context) => {
+    // context.connectionId available
+    // context.sendMessage() wired to WebSocket send
+  },
+});
+
+export const handler = fabricWebSocket(chatService, {
+  secrets: ["MONGODB_URI"],
+});
+```
+
+### New Export
+
+- `@jaypie/fabric/websocket` - WebSocket adapter exports

package/release-notes/jaypie/1.2.4.md

@@ -0,0 +1,11 @@
+---
+version: 1.2.4
+date: 2026-01-23
+summary: Update @jaypie/express dependency with array query parameter fix
+---
+
+# jaypie 1.2.4
+
+## Dependencies
+
+- Updated `@jaypie/express` to 1.2.5 with fix for array query parameters with bracket notation in API Gateway v1 events

package/release-notes/jaypie/1.2.5.md

@@ -0,0 +1,9 @@
+---
+version: 1.2.5
+date: 2025-01-25
+summary: Dependency updates for @jaypie/llm 1.2.7
+---
+
+## Changes
+
+- Updated to use @jaypie/llm 1.2.7 with refactored constants and gpt-5.2 default model

package/release-notes/lambda/1.2.4.md

@@ -0,0 +1,39 @@
+---
+version: 1.2.4
+date: 2025-01-23
+summary: Add WebSocket Lambda handler
+---
+
+## New Features
+
+### websocketHandler
+
+Lambda handler for WebSocket API Gateway events with lifecycle management:
+
+```typescript
+export const handler = websocketHandler(async (event, context) => {
+  const { routeKey, connectionId, body } = context;
+
+  // Send to this connection
+  await context.send({ received: true });
+
+  // Broadcast to multiple connections
+  await context.broadcast(connectionIds, { message: "hello" });
+
+  return { statusCode: 200 };
+}, {
+  name: "chat",
+  secrets: ["MONGODB_URI"],
+});
+```
+
+### WebSocket Context
+
+- `routeKey` - Route key ($connect, $disconnect, $default, or custom)
+- `connectionId` - WebSocket connection ID
+- `domainName` - API Gateway domain
+- `stage` - API Gateway stage
+- `body` - Message body (null for connect/disconnect)
+- `queryStringParameters` - Query params (available on $connect)
+- `send(data)` - Send to current connection
+- `broadcast(connectionIds, data)` - Send to multiple connections

package/release-notes/llm/1.2.7.md

@@ -0,0 +1,12 @@
+---
+version: 1.2.7
+date: 2025-01-25
+summary: Refactor constants structure and update default OpenAI model to gpt-5.2
+---
+
+## Changes
+
+- Refactored `PROVIDER` constants to use internal `FIRST_CLASS_PROVIDER` for cleaner organization
+- Alphabetized provider order in constants (ANTHROPIC, GEMINI, OPENAI, OPENROUTER)
+- Updated default OpenAI model from `gpt-5.1` to `gpt-5.2`
+- Updated OpenAI model variants: `gpt-5.2-mini` (SMALL), `gpt-5.2-nano` (TINY)

package/release-notes/mcp/0.5.1.md

@@ -0,0 +1,23 @@
+---
+version: 0.5.1
+date: 2025-01-23
+summary: Add streaming and websockets skills
+---
+
+## New Skills
+
+- **`streaming`** - Response streaming guide for Lambda and Express with SSE and NLJSON formats
+- **`websockets`** - WebSocket API support documentation (planned feature)
+
+## Updated Skills
+
+Added "See Also" sections with cross-references:
+
+- `cdk` - Added streaming and websockets references
+- `express` - Added streaming reference
+- `fabric` - Added websockets reference
+- `handlers` - Added streaming and websockets references
+- `infrastructure` - Added websockets reference
+- `lambda` - Added streaming and websockets references
+- `llm` - Added streaming reference
+- `patterns` - Added streaming and websockets references

package/release-notes/mcp/0.6.0.md

@@ -0,0 +1,19 @@
+---
+version: 0.6.0
+date: 2025-01-25
+summary: Remove list_providers command from LLM tool
+---
+
+## Breaking Changes
+
+- Removed `list_providers` command from `llm` tool
+- Removed `REASONING_MODELS` export from llm suite
+
+## Rationale
+
+The `list_providers` command provided metadata about available LLM providers and reasoning models. This information was largely static and better served by documentation. The `debug_call` command remains for actual LLM API testing.
+
+## Migration
+
+If you were using `llm("list_providers")`, refer to the help documentation instead:
+- `llm()` or `llm("help")` returns available commands and provider information

package/release-notes/testkit/1.2.18.md

@@ -0,0 +1,16 @@
+---
+version: 1.2.18
+date: 2025-01-23
+summary: Add WebSocket mocks
+---
+
+## New Mocks
+
+### AWS WebSocket Mocks
+
+- `sendToConnection` - Mock for WebSocket send function
+- `broadcastToConnections` - Mock for WebSocket broadcast function
+
+### Lambda WebSocket Mocks
+
+- `websocketHandler` - Mock for WebSocket Lambda handler

package/skills/agents.md

@@ -21,7 +21,7 @@ Query `mcp__jaypie__skill(alias: String)` for development guidance:
 
 Contents: index, releasenotes
 Development: documentation, errors, logs, mocks, style, tests
-Infrastructure: aws, cdk, cicd, datadog, dns, dynamodb, secrets, variables
+Infrastructure: aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, secrets, streaming, variables, websockets
 Patterns: fabric, models, services, vocabulary
 Meta: issues, jaypie, skills, tools
 ```