@jaypie/mcp 0.7.3 → 0.7.6

package/skills/monorepo.md

@@ -0,0 +1,166 @@
+---
+description: Initialize a Jaypie monorepo project
+related: subpackage, cicd, style, tests
+---
+
+# Jaypie Monorepo Setup
+
+Initialize a new monorepo using Jaypie conventions and utilities.
+
+## Overview
+
+- ESLint 9+ flat config with @jaypie/eslint
+- NPM with Workspaces ("monorepo")
+- TypeScript with ESM modules
+- Vite for building, Vitest for testing
+- Node.js 22, 24, 25 support
+
+## Process
+
+1. Create root configuration files
+2. Install dev dependencies
+3. Configure workspaces
+
+## Root Files
+
+### package.json
+
+```json
+{
+  "name": "@project-org/monorepo",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "build": "npm run build --workspaces --if-present",
+    "clean": "rimraf ./packages/*/dist",
+    "format": "npm run format:package && npm run format:lint",
+    "format:lint": "eslint --fix .",
+    "format:package": "sort-package-json ./package.json ./packages/*/package.json",
+    "lint": "eslint --quiet .",
+    "test": "vitest run",
+    "typecheck": "npm run typecheck --workspaces --if-present"
+  }
+}
+```
+
+### eslint.config.mjs
+
+```javascript
+export { default } from "@jaypie/eslint";
+```
+
+For projects needing custom rules:
+
+```javascript
+import jaypie from "@jaypie/eslint";
+
+export default [
+  ...jaypie,
+  {
+    ignores: ["LOCAL/**"],
+  },
+];
+```
+
+### tsconfig.json (root)
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "exclude": ["node_modules", "dist"]
+}
+```
+
+### vitest.workspace.ts
+
+```typescript
+export default ["packages/*/vitest.config.{ts,js}"];
+```
+
+### .gitignore
+
+```
+.DS_Store
+node_modules
+dist
+
+# Local env files
+.env
+.env.local
+.env.*.local
+
+# Log files
+npm-debug.log*
+
+# Editor directories
+.idea
+*.sw?
+
+# Build artifacts
+*.tsbuildinfo
+```
+
+### .vscode/settings.json
+
+```json
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "typescript.preferences.importModuleSpecifier": "relative"
+}
+```
+
+## Installation
+
+Install root dev dependencies:
+
+```bash
+npm install --save-dev @jaypie/eslint @jaypie/testkit eslint rimraf sort-package-json tsx vite vite-plugin-dts vitest
+```
+
+## Workspace Conventions
+
+| Directory | Purpose |
+|-----------|---------|
+| `packages/` | npm packages (default workspace) |
+| `stacks/` | CDK-deployed infrastructure and sites |
+
+## Scripts Reference
+
+| Script | Top-level | Package-level |
+|--------|-----------|---------------|
+| `build` | `npm run build --workspaces` | `vite build` |
+| `clean` | `rimraf ./packages/*/dist` | `rimraf dist` |
+| `format` | `eslint --fix .` | `eslint --fix` |
+| `format:package` | `sort-package-json ./package.json ./packages/*/package.json` | `sort-package-json` |
+| `lint` | `eslint --quiet .` | `eslint` |
+| `test` | `vitest run` | `vitest run` |
+| `typecheck` | `npm run typecheck --workspaces` | `tsc --noEmit` |
+
+## Guidelines
+
+- Run `npm install` to generate package-lock.json (do not hard-code versions)
+- Use `"version": "0.0.1"`, `"type": "module"`, and `"private": true` for new packages
+- Do not include authors, keywords, or external links in package.json
+- If this is the first commit, commit directly to main; otherwise create a branch
+
+## Next Steps
+
+- `skill("subpackage")` - Create packages within the monorepo
+- `skill("cicd")` - Add GitHub Actions workflows
+- `skill("tests")` - Testing patterns with Vitest

package/skills/skills.md

@@ -16,7 +16,7 @@ Look up skills by alias: `mcp__jaypie__skill(alias)`
 | Category | Skills |
 |----------|--------|
 | contents | index, releasenotes |
-| development | documentation, errors, logs, mocks, style, tests |
-| infrastructure | aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, secrets, variables |
+| development | documentation, errors, logs, mocks, monorepo, style, subpackages, tests |
+| infrastructure | aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, secrets, streaming, variables, websockets |
 | patterns | fabric, handlers, models, services, vocabulary |
 | meta | issues, jaypie, skills, tools |

package/skills/subpackage.md

@@ -0,0 +1,219 @@
+---
+description: Create a subpackage within a monorepo
+related: monorepo, tests, style
+---
+
+# Jaypie Subpackage Setup
+
+Create a new subpackage within an existing Jaypie monorepo.
+
+## Overview
+
+- TypeScript subpackage with Vite/Vitest
+- Standard Jaypie project structure
+- NPM workspace integration
+- ESLint configuration inheritance
+
+## Guidelines
+
+- Subpackage names follow `@project-org/package-name` pattern
+- Use `"version": "0.0.1"`, `"type": "module"`, and `"private": true`
+- Place packages in `packages/<package-name>/` directory
+- Use Vite for new TypeScript packages
+- Never manually edit package.json for dependencies; use npm commands
+
+## Process
+
+1. Create package directory structure
+2. Create configuration files from templates
+3. Create basic src structure
+4. Update workspace configuration
+5. Install dependencies
+
+## Directory Structure
+
+```
+packages/<package-name>/
+├── src/
+│   ├── index.ts
+│   └── __tests__/
+│       └── index.spec.ts
+├── package.json
+├── tsconfig.json
+├── vite.config.ts
+├── vitest.config.ts
+└── vitest.setup.ts
+```
+
+## Template Files
+
+### package.json
+
+```json
+{
+  "name": "@project-org/package-name",
+  "version": "0.0.1",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "build": "vite build",
+    "clean": "rimraf dist",
+    "format": "eslint --fix",
+    "format:package": "sort-package-json",
+    "lint": "eslint",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "typecheck": "tsc --noEmit"
+  }
+}
+```
+
+### tsconfig.json
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "exclude": ["node_modules", "dist"],
+  "include": ["src/**/*"]
+}
+```
+
+### vite.config.ts
+
+```typescript
+import { defineConfig } from "vite";
+import dts from "vite-plugin-dts";
+
+export default defineConfig({
+  plugins: [
+    dts({
+      include: ["src"],
+      exclude: ["**/*.spec.ts"],
+    }),
+  ],
+  build: {
+    lib: {
+      entry: "./src/index.ts",
+      name: "PackageName",
+      fileName: "index",
+      formats: ["es"],
+    },
+    rollupOptions: {
+      external: [
+        // Add external dependencies here
+        "jaypie",
+      ],
+    },
+    target: "node22",
+  },
+});
+```
+
+### vitest.config.ts
+
+```typescript
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    setupFiles: ["./vitest.setup.ts"],
+  },
+});
+```
+
+### vitest.setup.ts
+
+```typescript
+import { matchers as jaypieMatchers } from "@jaypie/testkit";
+import * as extendedMatchers from "jest-extended";
+import { expect } from "vitest";
+
+expect.extend(extendedMatchers);
+expect.extend(jaypieMatchers);
+```
+
+### src/index.ts
+
+```typescript
+// Export public API here
+export {};
+```
+
+### src/__tests__/index.spec.ts
+
+```typescript
+import { describe, expect, it } from "vitest";
+
+describe("Package Name", () => {
+  describe("Base Cases", () => {
+    it("is a function", () => {
+      // Replace with actual export test
+      expect(true).toBe(true);
+    });
+  });
+
+  describe("Happy Paths", () => {
+    it("works", () => {
+      // Add happy path tests
+      expect(true).toBe(true);
+    });
+  });
+});
+```
+
+## Installation Commands
+
+Add dependencies to the subpackage:
+
+```bash
+# Runtime dependencies
+npm install <package-name> --workspace ./packages/<package-name>
+
+# Dev dependencies
+npm install <package-name> --workspace ./packages/<package-name> --save-dev
+```
+
+Common dev dependencies for subpackages:
+
+```bash
+npm install jest-extended --workspace ./packages/<package-name> --save-dev
+```
+
+## Workspace Configuration
+
+The root `vitest.workspace.ts` uses a glob pattern that auto-discovers packages:
+
+```typescript
+export default ["packages/*/vitest.config.{ts,js}"];
+```
+
+New packages are automatically included when they have a `vitest.config.ts`.
+
+## Checklist
+
+After creating a subpackage:
+
+1. ✅ Update package name in `package.json`
+2. ✅ Update `name` in `vite.config.ts` build.lib
+3. ✅ Add external dependencies to `rollupOptions.external`
+4. ✅ Run `npm install` from root to link workspace
+5. ✅ Verify with `npm run build -w packages/<package-name>`
+6. ✅ Verify with `npm run test -w packages/<package-name>`
+
+## Next Steps
+
+- `skill("tests")` - Testing patterns with Vitest
+- `skill("mocks")` - Mock patterns via @jaypie/testkit
+- `skill("style")` - Code style conventions

package/skills/tools-llm.md

@@ -0,0 +1,98 @@
+---
+description: LLM MCP tool for debugging provider responses
+related: llm, tools
+---
+
+# LLM MCP Tool
+
+Debug and inspect LLM provider responses. Useful for understanding how providers format responses and troubleshooting API integrations.
+
+## Usage
+
+```
+llm()                                    # Show help
+llm("command", { ...params })            # Execute a command
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `list_providers` | List available LLM providers and their status |
+| `debug_call` | Make a debug call to an LLM provider |
+
+## List Providers
+
+Check which providers are configured:
+
+```
+llm("list_providers")
+```
+
+Returns provider availability based on environment variables.
+
+## Debug Call
+
+Make a test call to inspect the raw response:
+
+```
+llm("debug_call", { provider: "openai", message: "Hello, world!" })
+llm("debug_call", { provider: "anthropic", message: "Hello, world!" })
+llm("debug_call", { provider: "openai", model: "o3-mini", message: "What is 15 * 17?" })
+```
+
+### Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `provider` | Yes | Provider name: `openai`, `anthropic`, `gemini`, `openrouter` |
+| `message` | Yes | Message to send |
+| `model` | No | Specific model to use |
+
+### Response Fields
+
+| Field | Description |
+|-------|-------------|
+| `content` | The response text |
+| `reasoning` | Extracted reasoning/thinking content (if available) |
+| `reasoningTokens` | Count of reasoning tokens used |
+| `history` | Full conversation history |
+| `rawResponses` | Raw API responses for debugging |
+| `usage` | Token usage statistics |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `OPENAI_API_KEY` | OpenAI API key |
+| `ANTHROPIC_API_KEY` | Anthropic API key |
+| `GOOGLE_API_KEY` | Google/Gemini API key |
+| `OPENROUTER_API_KEY` | OpenRouter API key |
+
+## Supported Providers
+
+| Provider | Models |
+|----------|--------|
+| `openai` | gpt-4o, gpt-4o-mini, o1, o3-mini, etc. |
+| `anthropic` | claude-sonnet-4-20250514, claude-opus-4-20250514, etc. |
+| `gemini` | gemini-2.0-flash, gemini-1.5-pro, etc. |
+| `openrouter` | Access to multiple providers |
+
+## Common Patterns
+
+### Compare Provider Responses
+
+```
+llm("debug_call", { provider: "openai", message: "Explain recursion briefly" })
+llm("debug_call", { provider: "anthropic", message: "Explain recursion briefly" })
+```
+
+### Test Reasoning Models
+
+```
+llm("debug_call", { provider: "openai", model: "o3-mini", message: "Solve: If 3x + 5 = 14, what is x?" })
+```
+
+### Check Token Usage
+
+Use `debug_call` to inspect the `usage` field for token consumption analysis.

package/skills/tools.md

@@ -1,6 +1,6 @@
 ---
 description: Available MCP tools reference
-related: tools-aws, tools-dynamodb, tools-datadog, debugging
+related: tools-aws, tools-datadog, tools-dynamodb, tools-llm, debugging
 ---
 
 # MCP Tools Reference
@@ -79,6 +79,10 @@ datadog("monitors", { status: ["Alert", "Warn"] })
 
 ## LLM Tool
 
+Debug and inspect LLM provider responses.
+
+See **tools-llm** for complete documentation.
+
 ```
 llm()                   # Show help
 llm("list_providers")   # List available LLM providers
@@ -103,3 +107,9 @@ llm("debug_call", { provider: "openai", message: "Hello" })
 - `DD_SERVICE` - Default service filter
 - `DD_SOURCE` - Default log source
 
+### LLM Tools
+- `OPENAI_API_KEY` - OpenAI API key
+- `ANTHROPIC_API_KEY` - Anthropic API key
+- `GOOGLE_API_KEY` - Google/Gemini API key
+- `OPENROUTER_API_KEY` - OpenRouter API key
+