@jaypie/mcp 0.7.45 → 0.8.0

package/dist/suites/llm/llm.js

@@ -1,111 +0,0 @@
-import { LLM, Llm } from '@jaypie/llm';
-
-/**
- * LLM debugging utilities for inspecting raw provider responses
- */
-/**
- * Infer provider from model string prefix
- */
-function inferProvider(model) {
-    const m = model.toLowerCase();
-    if (m.startsWith("claude-"))
-        return "anthropic";
-    if (m.startsWith("gemini-"))
-        return "google";
-    if (m.startsWith("chatgpt-") ||
-        m.startsWith("gpt-") ||
-        m.startsWith("o1-") ||
-        m.startsWith("o3-") ||
-        m.startsWith("o4-"))
-        return "openai";
-    if (m.startsWith("grok-"))
-        return "xai";
-    return undefined;
-}
-// Default models for each provider
-const DEFAULT_MODELS = {
-    anthropic: LLM.PROVIDER.ANTHROPIC.MODEL.SMALL,
-    google: LLM.PROVIDER.GEMINI.MODEL.SMALL,
-    openai: LLM.PROVIDER.OPENAI.MODEL.SMALL,
-    openrouter: LLM.PROVIDER.OPENROUTER.MODEL.SMALL,
-    xai: LLM.PROVIDER.XAI.MODEL.SMALL,
-};
-const TOTAL_PROVIDERS = 5;
-/**
- * Validate LLM setup without making API calls
- */
-function validateLlmSetup() {
-    const anthropicAvailable = Boolean(process.env.ANTHROPIC_API_KEY);
-    const googleAvailable = Boolean(process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY);
-    const openaiAvailable = Boolean(process.env.OPENAI_API_KEY);
-    const openrouterAvailable = Boolean(process.env.OPENROUTER_API_KEY);
-    const xaiAvailable = Boolean(process.env.XAI_API_KEY);
-    const availableCount = [
-        anthropicAvailable,
-        googleAvailable,
-        openaiAvailable,
-        openrouterAvailable,
-        xaiAvailable,
-    ].filter(Boolean).length;
-    return {
-        availableCount,
-        providers: {
-            anthropic: { available: anthropicAvailable },
-            google: { available: googleAvailable },
-            openai: { available: openaiAvailable },
-            openrouter: { available: openrouterAvailable },
-            xai: { available: xaiAvailable },
-        },
-        success: availableCount > 0,
-        totalProviders: TOTAL_PROVIDERS,
-    };
-}
-/**
- * Make a debug LLM call and return the raw response data for inspection
- */
-async function debugLlmCall(params, log) {
-    const { provider, message } = params;
-    const model = params.model || DEFAULT_MODELS[provider];
-    log.info(`Making debug LLM call to ${provider} with model ${model}`);
-    try {
-        const llm = new Llm(provider, { model });
-        const result = await llm.operate(message, {
-            user: "[jaypie-mcp] Debug LLM Call",
-        });
-        if (result.error) {
-            return {
-                success: false,
-                provider,
-                model,
-                error: `${result.error.title}: ${result.error.detail || "Unknown error"}`,
-            };
-        }
-        // Calculate total reasoning tokens
-        const reasoningTokens = result.usage.reduce((sum, u) => sum + (u.reasoning || 0), 0);
-        return {
-            success: true,
-            provider,
-            model,
-            content: typeof result.content === "string"
-                ? result.content
-                : JSON.stringify(result.content),
-            reasoning: result.reasoning,
-            reasoningTokens,
-            history: result.history,
-            rawResponses: result.responses,
-            usage: result.usage,
-        };
-    }
-    catch (error) {
-        log.error(`Error calling ${provider}:`, error);
-        return {
-            success: false,
-            provider,
-            model,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}
-
-export { debugLlmCall, inferProvider, validateLlmSetup };
-//# sourceMappingURL=llm.js.map

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

@@ -1 +0,0 @@
-{"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 =\n  | \"anthropic\"\n  | \"google\"\n  | \"openai\"\n  | \"openrouter\"\n  | \"xai\";\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\n// Validation types\nexport interface LlmProviderStatus {\n  available: boolean;\n}\n\nexport interface LlmValidationResult {\n  success: boolean;\n  providers: {\n    anthropic: LlmProviderStatus;\n    google: LlmProviderStatus;\n    openai: LlmProviderStatus;\n    openrouter: LlmProviderStatus;\n    xai: LlmProviderStatus;\n  };\n  availableCount: number;\n  totalProviders: number;\n}\n\ninterface Logger {\n  info: (message: string, ...args: unknown[]) => void;\n  error: (message: string, ...args: unknown[]) => void;\n}\n\n/**\n * Infer provider from model string prefix\n */\nexport function inferProvider(model: string): LlmProvider | undefined {\n  const m = model.toLowerCase();\n  if (m.startsWith(\"claude-\")) return \"anthropic\";\n  if (m.startsWith(\"gemini-\")) return \"google\";\n  if (\n    m.startsWith(\"chatgpt-\") ||\n    m.startsWith(\"gpt-\") ||\n    m.startsWith(\"o1-\") ||\n    m.startsWith(\"o3-\") ||\n    m.startsWith(\"o4-\")\n  )\n    return \"openai\";\n  if (m.startsWith(\"grok-\")) return \"xai\";\n  return undefined;\n}\n\n// Default models for each provider\nconst DEFAULT_MODELS: Record<LlmProvider, string> = {\n  anthropic: LLM.PROVIDER.ANTHROPIC.MODEL.SMALL,\n  google: LLM.PROVIDER.GEMINI.MODEL.SMALL,\n  openai: LLM.PROVIDER.OPENAI.MODEL.SMALL,\n  openrouter: LLM.PROVIDER.OPENROUTER.MODEL.SMALL,\n  xai: LLM.PROVIDER.XAI.MODEL.SMALL,\n};\n\nconst TOTAL_PROVIDERS = 5;\n\n/**\n * Validate LLM setup without making API calls\n */\nexport function validateLlmSetup(): LlmValidationResult {\n  const anthropicAvailable = Boolean(process.env.ANTHROPIC_API_KEY);\n  const googleAvailable = Boolean(\n    process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY,\n  );\n  const openaiAvailable = Boolean(process.env.OPENAI_API_KEY);\n  const openrouterAvailable = Boolean(process.env.OPENROUTER_API_KEY);\n  const xaiAvailable = Boolean(process.env.XAI_API_KEY);\n\n  const availableCount = [\n    anthropicAvailable,\n    googleAvailable,\n    openaiAvailable,\n    openrouterAvailable,\n    xaiAvailable,\n  ].filter(Boolean).length;\n\n  return {\n    availableCount,\n    providers: {\n      anthropic: { available: anthropicAvailable },\n      google: { available: googleAvailable },\n      openai: { available: openaiAvailable },\n      openrouter: { available: openrouterAvailable },\n      xai: { available: xaiAvailable },\n    },\n    success: availableCount > 0,\n    totalProviders: TOTAL_PROVIDERS,\n  };\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":"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"}

package/skills/index.md

@@ -1,18 +0,0 @@
----
-description: Skill directory listing
----
-
-# Jaypie Skills
-
-Query the Jaypie MCP `skill` tool with one of the following alias keywords `mcp__jaypie__skill(alias: String)`:
-
-## Categories
-
-| Category | Skills |
-|----------|--------|
-| contents | index, releasenotes |
-| development | apikey, documentation, errors, llm, logs, mocks, monorepo, style, subpackages, tests |
-| infrastructure | aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, secrets, streaming, variables, websockets |
-| patterns | api, fabric, handlers, models, services, vocabulary |
-| recipes | recipe-api-server |
-| meta | issues, jaypie, skills, tools |

package/skills/tools-aws.md

@@ -1,208 +0,0 @@
----
-description: AWS MCP tool for Lambda, S3, SQS, CloudWatch, Step Functions, CloudFormation
-related: aws, tools, tools-dynamodb
----
-
-# AWS MCP Tool
-
-Unified tool for interacting with AWS services via the Jaypie MCP. Uses your local AWS credentials.
-
-## Usage
-
-All parameters are passed at the top level (flat structure):
-
-```
-aws()                                         # Show help with all commands
-aws({ command: "...", ...params })            # Execute a command
-```
-
-## Lambda Functions
-
-| Command | Description |
-|---------|-------------|
-| `lambda_list_functions` | List functions with optional prefix filter |
-| `lambda_get_function` | Get function configuration and details |
-
-```
-# List all functions
-aws({ command: "lambda_list_functions" })
-
-# Filter by prefix
-aws({ command: "lambda_list_functions", functionNamePrefix: "my-api" })
-
-# Get function details
-aws({ command: "lambda_get_function", functionName: "my-api-handler" })
-```
-
-## Step Functions
-
-| Command | Description |
-|---------|-------------|
-| `stepfunctions_list_executions` | List executions for a state machine |
-| `stepfunctions_stop_execution` | Stop a running execution |
-
-```
-# List recent executions
-aws({ command: "stepfunctions_list_executions", stateMachineArn: "arn:aws:states:..." })
-
-# Stop a running execution
-aws({ command: "stepfunctions_stop_execution", executionArn: "arn:aws:states:..." })
-```
-
-## CloudWatch Logs
-
-| Command | Description |
-|---------|-------------|
-| `logs_filter_log_events` | Search logs with patterns and time ranges |
-
-```
-# Search for errors in Lambda logs
-aws({ command: "logs_filter_log_events", logGroupName: "/aws/lambda/my-function", filterPattern: "ERROR" })
-
-# Search with time range
-aws({ command: "logs_filter_log_events", logGroupName: "/aws/lambda/my-function", startTime: "now-1h" })
-```
-
-## S3
-
-| Command | Description |
-|---------|-------------|
-| `s3_list_objects` | List bucket objects with prefix filtering |
-
-```
-# List all objects
-aws({ command: "s3_list_objects", bucket: "my-bucket" })
-
-# Filter by prefix
-aws({ command: "s3_list_objects", bucket: "my-bucket", prefix: "uploads/" })
-```
-
-## SQS
-
-| Command | Description |
-|---------|-------------|
-| `sqs_list_queues` | List queues with prefix filter |
-| `sqs_get_queue_attributes` | Get queue attributes including message counts |
-| `sqs_receive_message` | Peek at queue messages (does not delete) |
-| `sqs_purge_queue` | Delete all messages (irreversible) |
-
-```
-# List queues
-aws({ command: "sqs_list_queues", queueNamePrefix: "my-app" })
-
-# Check queue depth
-aws({ command: "sqs_get_queue_attributes", queueUrl: "https://sqs..." })
-
-# Peek at messages
-aws({ command: "sqs_receive_message", queueUrl: "https://sqs...", maxNumberOfMessages: 5 })
-
-# Purge queue (careful!)
-aws({ command: "sqs_purge_queue", queueUrl: "https://sqs..." })
-```
-
-## CloudFormation
-
-| Command | Description |
-|---------|-------------|
-| `cloudformation_describe_stack` | Get stack details, outputs, and status |
-
-```
-# Get stack details
-aws({ command: "cloudformation_describe_stack", stackName: "MyStack" })
-```
-
-## DynamoDB
-
-See **tools-dynamodb** for DynamoDB-specific documentation.
-
-| Command | Description |
-|---------|-------------|
-| `dynamodb_describe_table` | Get table metadata |
-| `dynamodb_query` | Query by partition key |
-| `dynamodb_scan` | Full table scan |
-| `dynamodb_get_item` | Get single item |
-
-## Parameters
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `command` | string | Command to execute (omit for help) |
-| `profile` | string | AWS profile name |
-| `region` | string | AWS region (e.g., us-east-1) |
-| `functionName` | string | Lambda function name |
-| `functionNamePrefix` | string | Lambda function name prefix filter |
-| `stateMachineArn` | string | Step Functions state machine ARN |
-| `executionArn` | string | Step Functions execution ARN |
-| `statusFilter` | string | Step Functions status: RUNNING, SUCCEEDED, FAILED, TIMED_OUT, ABORTED, PENDING_REDRIVE |
-| `logGroupName` | string | CloudWatch Logs group name |
-| `filterPattern` | string | CloudWatch Logs filter pattern |
-| `startTime` | string | Start time (e.g., now-15m) |
-| `endTime` | string | End time (e.g., now) |
-| `bucket` | string | S3 bucket name |
-| `prefix` | string | S3 object prefix filter |
-| `stackName` | string | CloudFormation stack name |
-| `tableName` | string | DynamoDB table name |
-| `keyConditionExpression` | string | DynamoDB key condition expression |
-| `expressionAttributeValues` | string | DynamoDB expression attribute values (JSON string) |
-| `queueUrl` | string | SQS queue URL |
-| `queueNamePrefix` | string | SQS queue name prefix filter |
-| `maxNumberOfMessages` | number | SQS max messages to receive |
-| `limit` | number | Maximum number of results |
-| `maxResults` | number | Maximum number of results |
-
-## Validation
-
-Check AWS CLI availability and list profiles without making API calls:
-
-```
-aws({ command: "validate" })
-```
-
-Returns:
-- `cliAvailable` - Whether AWS CLI is installed
-- `cliVersion` - AWS CLI version string
-- `profiles` - List of configured profiles from ~/.aws/config and ~/.aws/credentials
-
-## Credential Management
-
-Tools use the host's AWS credential chain:
-1. Environment variables (`AWS_ACCESS_KEY_ID`, etc.)
-2. `~/.aws/credentials` and `~/.aws/config`
-3. SSO sessions via `aws sso login`
-
-```
-# List available profiles
-aws({ command: "list_profiles" })
-
-# Use a specific profile (supported on all commands)
-aws({ command: "lambda_list_functions", profile: "production", region: "us-west-2" })
-```
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `AWS_PROFILE` | Default profile |
-| `AWS_REGION` | Default region |
-
-## Common Patterns
-
-### Debug Lambda Issues
-
-```
-# Check function config
-aws({ command: "lambda_get_function", functionName: "my-function" })
-
-# Search recent logs
-aws({ command: "logs_filter_log_events", logGroupName: "/aws/lambda/my-function", filterPattern: "ERROR" })
-```
-
-### Check Queue Health
-
-```
-# Get queue depth
-aws({ command: "sqs_get_queue_attributes", queueUrl: "https://..." })
-
-# Peek at messages
-aws({ command: "sqs_receive_message", queueUrl: "https://...", maxNumberOfMessages: 5 })
-```

package/skills/tools-dynamodb.md

@@ -1,179 +0,0 @@
----
-description: DynamoDB commands in the AWS MCP tool for table queries, scans, and item retrieval
-related: dynamodb, tools, tools-aws
----
-
-# DynamoDB MCP Commands
-
-DynamoDB commands in the unified AWS tool for interacting with DynamoDB tables.
-
-## Usage
-
-All parameters are passed at the top level (flat structure):
-
-```
-aws({ command: "dynamodb_command", ...params })
-```
-
-## Available Commands
-
-| Command | Description |
-|---------|-------------|
-| `dynamodb_describe_table` | Get table schema, indexes, and metadata |
-| `dynamodb_query` | Query by partition key (efficient) |
-| `dynamodb_scan` | Full table scan (use sparingly) |
-| `dynamodb_get_item` | Get single item by primary key |
-
-## Describe Table
-
-Get table metadata including key schema, indexes, and throughput:
-
-```
-aws({ command: "dynamodb_describe_table", tableName: "MyTable" })
-```
-
-Returns:
-- Key schema (partition key, sort key)
-- Global secondary indexes
-- Billing mode and provisioned throughput
-- Item count and size estimates
-
-## Query by Partition Key
-
-Query is the most efficient way to retrieve items:
-
-```
-# Simple partition key query
-aws({
-  command: "dynamodb_query",
-  tableName: "MyTable",
-  keyConditionExpression: "pk = :pk",
-  expressionAttributeValues: '{":pk":{"S":"USER#123"}}'
-})
-
-# With sort key condition
-aws({
-  command: "dynamodb_query",
-  tableName: "MyTable",
-  keyConditionExpression: "pk = :pk AND begins_with(sk, :prefix)",
-  expressionAttributeValues: '{":pk":{"S":"USER#123"},":prefix":{"S":"ORDER#"}}'
-})
-
-# Query GSI
-aws({
-  command: "dynamodb_query",
-  tableName: "MyTable",
-  indexName: "gsi1",
-  keyConditionExpression: "gsi1pk = :status",
-  expressionAttributeValues: '{":status":{"S":"ORDER#pending"}}'
-})
-```
-
-## Get Single Item
-
-Retrieve a specific item by its full primary key:
-
-```
-# Simple key
-aws({
-  command: "dynamodb_get_item",
-  tableName: "MyTable",
-  key: '{"pk":{"S":"USER#123"}}'
-})
-
-# Composite key (partition + sort)
-aws({
-  command: "dynamodb_get_item",
-  tableName: "MyTable",
-  key: '{"pk":{"S":"USER#123"},"sk":{"S":"PROFILE"}}'
-})
-```
-
-## Scan Table
-
-Full table scan - use sparingly on large tables:
-
-```
-# Scan all items
-aws({ command: "dynamodb_scan", tableName: "MyTable" })
-
-# With filter (applied after scan, not efficient for filtering)
-aws({
-  command: "dynamodb_scan",
-  tableName: "MyTable",
-  filterExpression: "status = :status",
-  expressionAttributeValues: '{":status":{"S":"active"}}'
-})
-
-# Limit results
-aws({ command: "dynamodb_scan", tableName: "MyTable", limit: 10 })
-```
-
-## DynamoDB Attribute Format
-
-All values use DynamoDB's attribute value format:
-
-| Type | Format | Example |
-|------|--------|---------|
-| String | `{"S": "value"}` | `{"S": "USER#123"}` |
-| Number | `{"N": "123"}` | `{"N": "99.99"}` |
-| Boolean | `{"BOOL": true}` | `{"BOOL": false}` |
-| List | `{"L": [...]}` | `{"L": [{"S": "a"}, {"S": "b"}]}` |
-| Map | `{"M": {...}}` | `{"M": {"name": {"S": "John"}}}` |
-| Null | `{"NULL": true}` | `{"NULL": true}` |
-
-## Common Patterns
-
-### Get User Profile
-
-```
-aws({
-  command: "dynamodb_get_item",
-  tableName: "DataTable",
-  key: '{"pk":{"S":"USER#123"},"sk":{"S":"PROFILE"}}'
-})
-```
-
-### List User Orders
-
-```
-aws({
-  command: "dynamodb_query",
-  tableName: "DataTable",
-  keyConditionExpression: "pk = :pk AND begins_with(sk, :prefix)",
-  expressionAttributeValues: '{":pk":{"S":"USER#123"},":prefix":{"S":"ORDER#"}}'
-})
-```
-
-### Find Pending Orders (via GSI)
-
-```
-aws({
-  command: "dynamodb_query",
-  tableName: "DataTable",
-  indexName: "gsi1",
-  keyConditionExpression: "gsi1pk = :status",
-  expressionAttributeValues: '{":status":{"S":"ORDER#pending"}}'
-})
-```
-
-### Check Table Schema
-
-```
-aws({ command: "dynamodb_describe_table", tableName: "DataTable" })
-```
-
-## Profile and Region
-
-All DynamoDB commands support profile and region options:
-
-```
-aws({
-  command: "dynamodb_query",
-  tableName: "MyTable",
-  profile: "production",
-  region: "us-west-2",
-  keyConditionExpression: "pk = :pk",
-  expressionAttributeValues: '{":pk":{"S":"USER#123"}}'
-})
-```

package/skills/tools-llm.md

@@ -1,109 +0,0 @@
----
-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
-
-All parameters are passed at the top level (flat structure):
-
-```
-llm()                                         # Show help
-llm({ command: "...", ...params })            # Execute a command
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `validate` | Check which API keys are configured |
-| `debug_call` | Make a debug call to an LLM provider |
-
-## Validation
-
-Check which LLM provider API keys are configured without making API calls:
-
-```
-llm({ command: "validate" })
-```
-
-Returns:
-- `providers` - Status for each provider: anthropic, google, openai, openrouter, xai
-- `availableCount` - Number of providers with API keys configured
-- `totalProviders` - Total number of supported providers (5)
-- `success` - true if at least one provider is available
-
-## Debug Call
-
-Make a test call to inspect the raw response:
-
-```
-llm({ command: "debug_call", provider: "openai", message: "Hello, world!" })
-llm({ command: "debug_call", provider: "anthropic", message: "Hello, world!" })
-llm({ command: "debug_call", provider: "openai", model: "o3-mini", message: "What is 15 * 17?" })
-```
-
-## 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, google, openai, openrouter, xai |
-| `message` | string | Message to send to the LLM provider |
-| `model` | string | Model to use (provider-specific, e.g., gpt-4, claude-3-sonnet) |
-
-## 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` or `GEMINI_API_KEY` | Google/Gemini API key |
-| `OPENROUTER_API_KEY` | OpenRouter API key |
-| `XAI_API_KEY` | xAI (Grok) API key |
-
-## Supported Providers
-
-| Provider | Models |
-|----------|--------|
-| `anthropic` | claude-sonnet-4-20250514, claude-opus-4-20250514, etc. |
-| `gemini` | gemini-2.0-flash, gemini-1.5-pro, etc. |
-| `openai` | gpt-4o, gpt-4o-mini, o1, o3-mini, etc. |
-| `openrouter` | Access to multiple providers |
-| `xai` | grok-4-1-fast-reasoning, grok-3, grok-3-mini |
-
-## Common Patterns
-
-### Compare Provider Responses
-
-```
-llm({ command: "debug_call", provider: "openai", message: "Explain recursion briefly" })
-llm({ command: "debug_call", provider: "anthropic", message: "Explain recursion briefly" })
-```
-
-### Test Reasoning Models
-
-```
-llm({ command: "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.