npm - polydev-ai - Versions diffs - 1.0.0 - Mend

polydev-ai 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/mcp/manifest.json ADDED Viewed

@@ -0,0 +1,462 @@
+{
+  "name": "polydev-perspectives",
+  "version": "1.0.0",
+  "description": "Agentic workflow assistant - get diverse perspectives from multiple LLMs when stuck or need enhanced reasoning",
+  "author": "Polydev AI",
+  "license": "MIT",
+  "main": "server.js",
+  "mcpVersion": "1.0",
+  "capabilities": {
+    "tools": true,
+    "resources": false,
+    "prompts": false
+  },
+  "tools": [
+    {
+      "name": "get_perspectives",
+      "description": "When stuck in agentic workflows, get diverse perspectives from multiple LLMs to overcome roadblocks. All models use Polydev-managed API keys - just configure once in dashboard.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "prompt": {
+            "type": "string",
+            "description": "The prompt to get perspectives on",
+            "minLength": 1
+          },
+          "models": {
+            "type": "array",
+            "description": "Array of model names to query (optional, defaults to [gpt-4, claude-3-sonnet, gemini-pro])",
+            "items": {
+              "type": "string",
+              "enum": [
+                "gpt-4",
+                "gpt-3.5-turbo",
+                "claude-3-sonnet",
+                "claude-3-haiku",
+                "gemini-pro",
+                "gemini-1.5-pro"
+              ]
+            },
+            "default": ["gpt-4", "claude-3-sonnet", "gemini-pro"]
+          },
+          "user_token": {
+            "type": "string",
+            "description": "Polydev user authentication token (get from dashboard)",
+            "minLength": 1
+          },
+          "project_memory": {
+            "type": "string",
+            "description": "Project context level - 'none', 'light' (recent files), or 'full' (TF-IDF similarity)",
+            "enum": ["none", "light", "full"],
+            "default": "none"
+          },
+          "max_messages": {
+            "type": "integer",
+            "description": "Maximum number of messages to process for tool calls",
+            "minimum": 1,
+            "maximum": 50,
+            "default": 10
+          },
+          "temperature": {
+            "type": "number",
+            "description": "Temperature for model responses",
+            "minimum": 0,
+            "maximum": 2,
+            "default": 0.7
+          },
+          "max_tokens": {
+            "type": "integer",
+            "description": "Maximum tokens per response",
+            "minimum": 100,
+            "maximum": 8000,
+            "default": 2000
+          },
+          "project_context": {
+            "type": "object",
+            "description": "Project context for memory retrieval",
+            "properties": {
+              "root_path": {
+                "type": "string",
+                "description": "Root directory path for project"
+              },
+              "includes": {
+                "type": "array",
+                "description": "File patterns to include",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "excludes": {
+                "type": "array",
+                "description": "File patterns to exclude",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "required": ["prompt"]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "responses": {
+            "type": "array",
+            "description": "Array of responses from different models",
+            "items": {
+              "type": "object",
+              "properties": {
+                "model": {
+                  "type": "string",
+                  "description": "Model name"
+                },
+                "content": {
+                  "type": "string",
+                  "description": "Response content"
+                },
+                "tokens_used": {
+                  "type": "integer",
+                  "description": "Number of tokens used"
+                },
+                "latency_ms": {
+                  "type": "integer",
+                  "description": "Response latency in milliseconds"
+                },
+                "error": {
+                  "type": "string",
+                  "description": "Error message if the request failed"
+                }
+              },
+              "required": ["model", "content"]
+            }
+          },
+          "total_tokens": {
+            "type": "integer",
+            "description": "Total tokens used across all models"
+          },
+          "total_latency_ms": {
+            "type": "integer",
+            "description": "Total latency in milliseconds"
+          },
+          "cached": {
+            "type": "boolean",
+            "description": "Whether the response was cached"
+          }
+        },
+        "required": ["responses"]
+      },
+      "examples": [
+        {
+          "description": "Agent stuck on TypeScript decision",
+          "input": {
+            "prompt": "I'm building a new API and considering TypeScript vs JavaScript. I need multiple perspectives to make the right choice.",
+            "user_token": "poly_abc123..."
+          },
+          "output": {
+            "responses": [
+              {
+                "model": "gpt-4",
+                "content": "TypeScript offers several key advantages over JavaScript: 1) Static type checking catches errors at compile time...",
+                "tokens_used": 150,
+                "latency_ms": 1200
+              },
+              {
+                "model": "claude-3-sonnet",
+                "content": "TypeScript provides enhanced developer experience through: Type safety, better IDE support...",
+                "tokens_used": 140,
+                "latency_ms": 1100
+              }
+            ],
+            "total_tokens": 290,
+            "total_latency_ms": 1300,
+            "cached": false
+          }
+        },
+        {
+          "description": "Agent debugging performance issue with context",
+          "input": {
+            "prompt": "My React app is slow and I can't figure out why. Help me identify the bottlenecks.",
+            "user_token": "poly_abc123...",
+            "models": ["gpt-4", "claude-3-sonnet"],
+            "project_memory": "full",
+            "project_context": {
+              "root_path": "/workspace/my-react-app",
+              "includes": ["**/*.tsx", "**/*.ts", "**/*.js"],
+              "excludes": ["node_modules/**", "dist/**", "build/**"]
+            }
+          }
+        },
+        {
+          "description": "Agent needs diverse architectural opinions",
+          "input": {
+            "prompt": "I'm designing a microservices architecture for a fintech app. What are the key considerations and potential pitfalls?",
+            "user_token": "poly_abc123...",
+            "models": ["gpt-4", "claude-3-sonnet", "gemini-pro"]
+          }
+        }
+      ]
+    },
+    {
+      "name": "polydev.force_cli_detection",
+      "description": "Force detection and status update for CLI tools (Claude Code, Codex CLI, Gemini CLI). Updates local cache and reports status to MCP server via Supabase.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "user_id": {
+            "type": "string",
+            "description": "User ID for database status updates (optional for stdio-wrapper)",
+            "minLength": 1
+          },
+          "provider_id": {
+            "type": "string",
+            "description": "Specific CLI provider to detect (optional, detects all if not provided)",
+            "enum": ["claude_code", "codex_cli", "gemini_cli"]
+          }
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether detection was successful"
+          },
+          "results": {
+            "type": "object",
+            "description": "Detection results for each provider",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "available": {
+                  "type": "boolean",
+                  "description": "Whether CLI is available"
+                },
+                "authenticated": {
+                  "type": "boolean",
+                  "description": "Whether CLI is authenticated"
+                },
+                "version": {
+                  "type": "string",
+                  "description": "CLI version if available"
+                },
+                "path": {
+                  "type": "string",
+                  "description": "Path to CLI executable"
+                },
+                "error": {
+                  "type": "string",
+                  "description": "Error message if detection failed"
+                }
+              }
+            }
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable result message"
+          },
+          "timestamp": {
+            "type": "string",
+            "description": "Detection timestamp"
+          }
+        },
+        "required": ["success", "results", "message", "timestamp"]
+      },
+      "examples": [
+        {
+          "description": "Detect all CLI providers",
+          "input": {
+            "user_id": "user_123"
+          },
+          "output": {
+            "success": true,
+            "results": {
+              "claude_code": {
+                "available": true,
+                "authenticated": true,
+                "version": "claude-code v1.2.3",
+                "path": "/usr/local/bin/claude"
+              },
+              "codex_cli": {
+                "available": false,
+                "authenticated": false,
+                "error": "Codex CLI not found in PATH. Install Codex CLI from OpenAI"
+              }
+            },
+            "message": "CLI detection completed for all providers",
+            "timestamp": "2024-01-15T10:30:00Z"
+          }
+        }
+      ]
+    },
+    {
+      "name": "polydev.get_cli_status",
+      "description": "Get current CLI status with caching support. Returns cached results if available and fresh, otherwise performs new detection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "user_id": {
+            "type": "string",
+            "description": "User ID for database status retrieval (optional for stdio-wrapper)",
+            "minLength": 1
+          },
+          "provider_id": {
+            "type": "string",
+            "description": "Specific CLI provider status to get (optional, gets all if not provided)",
+            "enum": ["claude_code", "codex_cli", "gemini_cli"]
+          }
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether status retrieval was successful"
+          },
+          "results": {
+            "type": "object",
+            "description": "Status results for each provider",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "available": {
+                  "type": "boolean"
+                },
+                "authenticated": {
+                  "type": "boolean"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "lastChecked": {
+                  "type": "string",
+                  "description": "Last status check timestamp"
+                }
+              }
+            }
+          },
+          "message": {
+            "type": "string"
+          },
+          "timestamp": {
+            "type": "string"
+          }
+        },
+        "required": ["success", "results"]
+      }
+    },
+    {
+      "name": "polydev.send_cli_prompt",
+      "description": "Send a prompt to a CLI provider and get response. Supports both stdin and argument modes for maximum compatibility.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "provider_id": {
+            "type": "string",
+            "description": "CLI provider to send prompt to",
+            "enum": ["claude_code", "codex_cli", "gemini_cli"]
+          },
+          "prompt": {
+            "type": "string",
+            "description": "Prompt to send to the CLI",
+            "minLength": 1
+          },
+          "mode": {
+            "type": "string",
+            "description": "Prompt sending mode",
+            "enum": ["stdin", "args"],
+            "default": "args"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "description": "Timeout in milliseconds",
+            "minimum": 1000,
+            "maximum": 300000,
+            "default": 30000
+          },
+          "user_id": {
+            "type": "string",
+            "description": "User ID for usage tracking (optional)",
+            "minLength": 1
+          }
+        },
+        "required": ["provider_id", "prompt"]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether the prompt was sent successfully"
+          },
+          "content": {
+            "type": "string",
+            "description": "CLI response content"
+          },
+          "error": {
+            "type": "string",
+            "description": "Error message if prompt failed"
+          },
+          "tokens_used": {
+            "type": "integer",
+            "description": "Number of tokens used"
+          },
+          "latency_ms": {
+            "type": "integer",
+            "description": "Response latency in milliseconds"
+          },
+          "provider": {
+            "type": "string",
+            "description": "CLI provider used"
+          },
+          "mode": {
+            "type": "string",
+            "description": "Mode used for sending"
+          },
+          "timestamp": {
+            "type": "string",
+            "description": "Response timestamp"
+          }
+        },
+        "required": ["success", "provider", "timestamp"]
+      },
+      "examples": [
+        {
+          "description": "Send prompt to Claude Code",
+          "input": {
+            "provider_id": "claude_code",
+            "prompt": "Help me debug this TypeScript error: Property 'map' does not exist on type 'string'",
+            "mode": "args",
+            "user_id": "user_123"
+          },
+          "output": {
+            "success": true,
+            "content": "This error occurs when you're trying to use the .map() method on a string variable. The .map() method is an array method, not a string method...",
+            "tokens_used": 150,
+            "latency_ms": 1200,
+            "provider": "claude_code",
+            "mode": "args",
+            "timestamp": "2024-01-15T10:35:00Z"
+          }
+        }
+      ]
+    }
+  ],
+  "configuration": {
+    "server_url": "https://www.polydev.ai/api/perspectives",
+    "dashboard_url": "https://polydev.ai/dashboard/mcp-tools",
+    "auth_required": true,
+    "rate_limits": {
+      "requests_per_minute": 100,
+      "requests_per_hour": 2000,
+      "requests_per_day": 10000
+    },
+    "setup_instructions": {
+      "step_1": "Visit https://polydev.ai/dashboard/mcp-tools",
+      "step_2": "Generate your MCP access token",
+      "step_3": "Configure your preferred models and settings",
+      "step_4": "Use the token in your MCP tool calls"
+    }
+  }
+}

package/mcp/package.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "name": "polydev-perspectives-mcp",
+  "version": "1.0.0",
+  "description": "Get diverse AI perspectives from multiple LLMs via MCP - supports Cline, Claude Code, and other MCP clients",
+  "main": "stdio-wrapper.js",
+  "bin": {
+    "polydev-mcp": "./stdio-wrapper.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "test": "node server.js --help"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "perspectives",
+    "multi-model",
+    "cline",
+    "claude",
+    "openai",
+    "anthropic",
+    "gemini",
+    "polydev"
+  ],
+  "author": "Polydev AI <support@polydev.ai>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "stdio-wrapper.js",
+    "manifest.json",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/backspacevenkat/polydev-website.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://polydev.ai/docs/mcp-integration",
+  "bugs": {
+    "url": "https://github.com/backspacevenkat/polydev-website/issues"
+  }
+}