@klitchevo/code-council 0.0.1

package/dist/errors.js

@@ -0,0 +1,92 @@
+/**
+ * Custom error classes for better error handling and user feedback.
+ */
+/**
+ * Base error class for all application errors
+ */
+export class AppError extends Error {
+    code;
+    userMessage;
+    constructor(message, code, userMessage) {
+        super(message);
+        this.code = code;
+        this.userMessage = userMessage;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Error thrown when OpenRouter API calls fail
+ */
+export class OpenRouterError extends AppError {
+    statusCode;
+    retryable;
+    constructor(message, statusCode, retryable = false) {
+        super(message, "OPENROUTER_ERROR", retryable
+            ? "The AI service is temporarily unavailable. Please try again in a moment."
+            : "Unable to complete the review. Please check your API key and try again.");
+        this.statusCode = statusCode;
+        this.retryable = retryable;
+    }
+}
+/**
+ * Error thrown when configuration is invalid
+ */
+export class ConfigurationError extends AppError {
+    field;
+    constructor(message, field) {
+        super(message, "CONFIGURATION_ERROR", `Configuration error: ${message}`);
+        this.field = field;
+    }
+}
+/**
+ * Error thrown when input validation fails
+ */
+export class ValidationError extends AppError {
+    field;
+    constructor(message, field) {
+        super(message, "VALIDATION_ERROR", `Invalid input for ${field}: ${message}`);
+        this.field = field;
+    }
+}
+/**
+ * Format any error for display to users (string format)
+ */
+export function formatErrorMessage(error) {
+    if (error instanceof AppError) {
+        return error.userMessage || error.message;
+    }
+    if (error instanceof Error) {
+        // Sanitize error messages to avoid leaking sensitive info
+        const sanitized = error.message
+            .replace(/sk-or-v1-[a-zA-Z0-9]+/g, "[REDACTED]")
+            .replace(/Bearer [a-zA-Z0-9-_]+/g, "Bearer [REDACTED]");
+        // Map common errors to user-friendly messages
+        if (sanitized.includes("401") || sanitized.includes("Unauthorized")) {
+            return "API authentication failed. Please check your OPENROUTER_API_KEY environment variable.";
+        }
+        if (sanitized.includes("429") || sanitized.includes("rate limit")) {
+            return "Rate limit exceeded. Please wait a moment and try again.";
+        }
+        if (sanitized.includes("timeout") || sanitized.includes("ETIMEDOUT")) {
+            return "Request timed out. The AI service may be slow. Please try again.";
+        }
+        return sanitized;
+    }
+    return "An unexpected error occurred. Please try again.";
+}
+/**
+ * Format error for MCP tool response
+ */
+export function formatError(error) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Error: ${formatErrorMessage(error)}`,
+            },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Code Council MCP Server
+ * Multi-model AI code review server using OpenRouter API
+ */
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/**
+ * Code Council MCP Server
+ * Multi-model AI code review server using OpenRouter API
+ */
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { BACKEND_REVIEW_MODELS, CODE_REVIEW_MODELS, FRONTEND_REVIEW_MODELS, PLAN_REVIEW_MODELS, } from "./config";
+import { logger } from "./logger";
+import { ReviewClient } from "./review-client";
+import { createReviewTool } from "./tools/factory";
+import { handleListConfig } from "./tools/list-config";
+import { backendReviewSchema, handleBackendReview, } from "./tools/review-backend";
+import { codeReviewSchema, handleCodeReview } from "./tools/review-code";
+import { frontendReviewSchema, handleFrontendReview, } from "./tools/review-frontend";
+import { handlePlanReview, planReviewSchema } from "./tools/review-plan";
+// Validate API key
+const OPENROUTER_API_KEY = process.env.OPENROUTER_API_KEY;
+if (!OPENROUTER_API_KEY) {
+    console.error("Error: OPENROUTER_API_KEY environment variable is required");
+    console.error("For MCP clients, add it to the 'env' section of your server config.");
+    console.error("For local development, create a .env file with: OPENROUTER_API_KEY=your-key");
+    process.exit(1);
+}
+// Initialize client and server
+const client = new ReviewClient(OPENROUTER_API_KEY);
+const server = new McpServer({
+    name: "code-council",
+    version: "1.0.0",
+});
+// Register review tools
+createReviewTool(server, {
+    name: "review_code",
+    description: "Review code for quality, bugs, performance, and security issues using multiple AI models in parallel",
+    inputSchema: codeReviewSchema,
+    handler: (input) => handleCodeReview(client, input),
+});
+createReviewTool(server, {
+    name: "review_frontend",
+    description: "Review frontend code for accessibility, performance, UX, and best practices using multiple AI models in parallel",
+    inputSchema: frontendReviewSchema,
+    handler: (input) => handleFrontendReview(client, input),
+});
+createReviewTool(server, {
+    name: "review_backend",
+    description: "Review backend code for security, performance, architecture, and best practices using multiple AI models in parallel",
+    inputSchema: backendReviewSchema,
+    handler: (input) => handleBackendReview(client, input),
+});
+createReviewTool(server, {
+    name: "review_plan",
+    description: "Review implementation plans BEFORE coding to catch issues early using multiple AI models in parallel",
+    inputSchema: planReviewSchema,
+    handler: (input) => handlePlanReview(client, input),
+});
+// Register config tool
+server.registerTool("list_review_config", { description: "Show current model configuration" }, async () => {
+    const { text } = await handleListConfig();
+    return {
+        content: [{ type: "text", text }],
+    };
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("Code Council MCP server started", {
+        codeReviewModels: CODE_REVIEW_MODELS,
+        frontendReviewModels: FRONTEND_REVIEW_MODELS,
+        backendReviewModels: BACKEND_REVIEW_MODELS,
+        planReviewModels: PLAN_REVIEW_MODELS,
+    });
+}
+main().catch((error) => {
+    logger.error("Fatal error during server startup", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/logger.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Structured logging utility for better observability.
+ * Logs to stderr in JSON format for easy parsing.
+ */
+interface LogContext {
+    [key: string]: unknown;
+}
+declare class Logger {
+    private isDevelopment;
+    private debugEnabled;
+    private log;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error | unknown, context?: LogContext): void;
+}
+/**
+ * Global logger instance
+ */
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,UAAU;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,cAAM,MAAM;IACX,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,YAAY,CAAgC;IAEpD,OAAO,CAAC,GAAG;IA2BX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAMlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAiB3E;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/logger.js

@@ -0,0 +1,62 @@
+/**
+ * Structured logging utility for better observability.
+ * Logs to stderr in JSON format for easy parsing.
+ */
+class Logger {
+    isDevelopment = process.env.NODE_ENV === "development";
+    debugEnabled = process.env.DEBUG === "true";
+    log(level, message, context) {
+        const logEntry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...context,
+        };
+        // In development, use pretty printing
+        if (this.isDevelopment) {
+            const emoji = {
+                debug: "🔍",
+                info: "ℹ️",
+                warn: "⚠️",
+                error: "❌",
+            }[level];
+            console.error(`${emoji} [${level.toUpperCase()}] ${message}`, context ? JSON.stringify(context, null, 2) : "");
+        }
+        else {
+            // In production, use JSON for structured logging
+            console.error(JSON.stringify(logEntry));
+        }
+    }
+    debug(message, context) {
+        if (this.debugEnabled) {
+            this.log("debug", message, context);
+        }
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, error, context) {
+        const errorContext = {
+            ...context,
+        };
+        if (error instanceof Error) {
+            errorContext.error = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        else if (error) {
+            errorContext.error = error;
+        }
+        this.log("error", message, errorContext);
+    }
+}
+/**
+ * Global logger instance
+ */
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/prompts/backend-review.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prompt templates for backend code review
+ */
+export declare const SYSTEM_PROMPT = "You are an expert backend developer and security specialist. Review backend code for security, performance, and architecture.";
+export declare function buildUserMessage(code: string, reviewType?: string, language?: string, context?: string): string;
+//# sourceMappingURL=backend-review.d.ts.map

package/dist/prompts/backend-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-review.d.ts","sourceRoot":"","sources":["../../src/prompts/backend-review.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa,kIAAkI,CAAC;AAE7J,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAe,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACd,MAAM,CAWR"}

package/dist/prompts/backend-review.js

@@ -0,0 +1,28 @@
+/**
+ * Prompt templates for backend code review
+ */
+export const SYSTEM_PROMPT = `You are an expert backend developer and security specialist. Review backend code for security, performance, and architecture.`;
+export function buildUserMessage(code, reviewType = "full", language, context) {
+    const focusArea = getFocusArea(reviewType);
+    const languageContext = language ? `Language/Framework: ${language}\n` : "";
+    const additionalContext = context ? `${context}\n` : "";
+    return `${languageContext}${additionalContext}${focusArea}
+
+Code to review:
+\`\`\`
+${code}
+\`\`\``;
+}
+function getFocusArea(reviewType) {
+    switch (reviewType) {
+        case "security":
+            return "Focus specifically on security (authentication, authorization, input validation, SQL injection, XSS, CSRF, secrets management).";
+        case "performance":
+            return "Focus specifically on backend performance (database queries, caching, async operations, resource usage, scalability).";
+        case "architecture":
+            return "Focus specifically on architecture (design patterns, separation of concerns, modularity, maintainability, scalability).";
+        default:
+            return "Provide a comprehensive backend review covering security, performance, and architecture.";
+    }
+}
+//# sourceMappingURL=backend-review.js.map

package/dist/prompts/code-review.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prompt templates for code review
+ */
+export declare const SYSTEM_PROMPT = "You are an expert code reviewer. Analyze the code for:\n- Code quality and best practices\n- Potential bugs and edge cases\n- Performance issues\n- Security vulnerabilities\n- Maintainability concerns\n\nProvide specific, actionable feedback.";
+export declare function buildUserMessage(code: string, context?: string): string;
+//# sourceMappingURL=code-review.d.ts.map

package/dist/prompts/code-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-review.d.ts","sourceRoot":"","sources":["../../src/prompts/code-review.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa,uPAOa,CAAC;AAExC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvE"}

package/dist/prompts/code-review.js

@@ -0,0 +1,18 @@
+/**
+ * Prompt templates for code review
+ */
+export const SYSTEM_PROMPT = `You are an expert code reviewer. Analyze the code for:
+- Code quality and best practices
+- Potential bugs and edge cases
+- Performance issues
+- Security vulnerabilities
+- Maintainability concerns
+
+Provide specific, actionable feedback.`;
+export function buildUserMessage(code, context) {
+    if (context) {
+        return `${context}\n\nCode to review:\n\`\`\`\n${code}\n\`\`\``;
+    }
+    return `Code to review:\n\`\`\`\n${code}\n\`\`\``;
+}
+//# sourceMappingURL=code-review.js.map

package/dist/prompts/frontend-review.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prompt templates for frontend code review
+ */
+export declare const SYSTEM_PROMPT = "You are an expert frontend developer and UX specialist. Review frontend code for best practices.";
+export declare function buildUserMessage(code: string, reviewType?: string, framework?: string, context?: string): string;
+//# sourceMappingURL=frontend-review.d.ts.map

package/dist/prompts/frontend-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-review.d.ts","sourceRoot":"","sources":["../../src/prompts/frontend-review.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa,qGAAqG,CAAC;AAEhI,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAe,EAC3B,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACd,MAAM,CAWR"}

package/dist/prompts/frontend-review.js

@@ -0,0 +1,28 @@
+/**
+ * Prompt templates for frontend code review
+ */
+export const SYSTEM_PROMPT = `You are an expert frontend developer and UX specialist. Review frontend code for best practices.`;
+export function buildUserMessage(code, reviewType = "full", framework, context) {
+    const focusArea = getFocusArea(reviewType);
+    const frameworkContext = framework ? `Framework: ${framework}\n` : "";
+    const additionalContext = context ? `${context}\n` : "";
+    return `${frameworkContext}${additionalContext}${focusArea}
+
+Code to review:
+\`\`\`
+${code}
+\`\`\``;
+}
+function getFocusArea(reviewType) {
+    switch (reviewType) {
+        case "accessibility":
+            return "Focus specifically on accessibility (WCAG compliance, ARIA labels, keyboard navigation, screen reader support).";
+        case "performance":
+            return "Focus specifically on frontend performance (bundle size, render optimization, lazy loading, Core Web Vitals).";
+        case "ux":
+            return "Focus specifically on user experience (intuitive design, error handling, loading states, responsive design).";
+        default:
+            return "Provide a comprehensive frontend review covering accessibility, performance, and user experience.";
+    }
+}
+//# sourceMappingURL=frontend-review.js.map

package/dist/prompts/plan-review.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prompt templates for implementation plan review
+ */
+export declare const SYSTEM_PROMPT = "You are an expert software architect and project planner. Review implementation plans before code is written to catch issues early.";
+export declare function buildUserMessage(plan: string, reviewType?: string, context?: string): string;
+//# sourceMappingURL=plan-review.d.ts.map

package/dist/prompts/plan-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-review.d.ts","sourceRoot":"","sources":["../../src/prompts/plan-review.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa,wIAAwI,CAAC;AAEnK,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAe,EAC3B,OAAO,CAAC,EAAE,MAAM,GACd,MAAM,CAUR"}

package/dist/prompts/plan-review.js

@@ -0,0 +1,29 @@
+/**
+ * Prompt templates for implementation plan review
+ */
+export const SYSTEM_PROMPT = `You are an expert software architect and project planner. Review implementation plans before code is written to catch issues early.`;
+export function buildUserMessage(plan, reviewType = "full", context) {
+    const focusArea = getFocusArea(reviewType);
+    const additionalContext = context ? `${context}\n` : "";
+    return `${additionalContext}${focusArea}
+
+Implementation plan to review:
+\`\`\`
+${plan}
+\`\`\``;
+}
+function getFocusArea(reviewType) {
+    switch (reviewType) {
+        case "feasibility":
+            return "Focus specifically on feasibility (technical complexity, resource requirements, potential blockers, dependencies).";
+        case "completeness":
+            return "Focus specifically on completeness (missing requirements, edge cases, error handling, testing strategy).";
+        case "risks":
+            return "Focus specifically on risks (technical risks, security concerns, scalability issues, maintenance burden).";
+        case "timeline":
+            return "Focus specifically on timeline (realistic estimates, task breakdown, critical path, potential delays).";
+        default:
+            return "Provide a comprehensive plan review covering feasibility, completeness, risks, and timeline.";
+    }
+}
+//# sourceMappingURL=plan-review.js.map

package/dist/review-client.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Multi-model review client for code, frontend, backend, and plan reviews
+ * Uses OpenRouter API to access multiple LLM providers
+ */
+/**
+ * Result from a single model's review.
+ * Either contains a review or an error, never both.
+ */
+export interface ModelReviewResult {
+    /** The model identifier (e.g., "anthropic/claude-3.5-sonnet") */
+    model: string;
+    /** The review content from the model */
+    review: string;
+    /** Error message if the review failed */
+    error?: string;
+}
+/**
+ * Client for performing multi-model code reviews.
+ * Supports parallel execution across multiple AI models for diverse perspectives.
+ *
+ * @example
+ * ```typescript
+ * const client = new ReviewClient(process.env.OPENROUTER_API_KEY);
+ * const results = await client.reviewCode(
+ *   'function add(a, b) { return a + b; }',
+ *   ['anthropic/claude-3.5-sonnet', 'openai/gpt-4-turbo'],
+ *   'JavaScript addition function'
+ * );
+ * ```
+ */
+export declare class ReviewClient {
+    private client;
+    constructor(apiKey: string);
+    /**
+     * Send a chat request to OpenRouter API
+     * @param model - Model identifier (e.g., "anthropic/claude-3.5-sonnet")
+     * @param systemPrompt - System prompt for the model
+     * @param userMessage - User message/question
+     * @returns The model's response content
+     * @throws {OpenRouterError} If the API call fails
+     */
+    private chat;
+    /**
+     * Review code for quality, bugs, performance, and security
+     * @param code - Code to review
+     * @param models - Array of model identifiers to use
+     * @param context - Optional context (language, description, etc.)
+     * @returns Array of review results from each model
+     */
+    reviewCode(code: string, models: string[], context?: string): Promise<ModelReviewResult[]>;
+    /**
+     * Review frontend code for accessibility, performance, and UX
+     */
+    reviewFrontend(code: string, models: string[], options?: {
+        framework?: string;
+        reviewType?: "accessibility" | "performance" | "ux" | "full";
+        context?: string;
+    }): Promise<ModelReviewResult[]>;
+    /**
+     * Review backend code for security, performance, and architecture
+     */
+    reviewBackend(code: string, models: string[], options?: {
+        language?: string;
+        reviewType?: "security" | "performance" | "architecture" | "full";
+        context?: string;
+    }): Promise<ModelReviewResult[]>;
+    /**
+     * Review implementation plans before code is written
+     */
+    reviewPlan(plan: string, models: string[], options?: {
+        reviewType?: "feasibility" | "completeness" | "risks" | "timeline" | "full";
+        context?: string;
+    }): Promise<ModelReviewResult[]>;
+}
+//# sourceMappingURL=review-client.d.ts.map

package/dist/review-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-client.d.ts","sourceRoot":"","sources":["../src/review-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,MAAM;IAM1B;;;;;;;OAOG;YACW,IAAI;IAoDlB;;;;;;OAMG;IACG,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAQ/B;;OAEG;IACG,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,IAAI,GAAG,MAAM,CAAC;QAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,GACC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAa/B;;OAEG;IACG,aAAa,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,CAAC;QAClE,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,GACC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAa/B;;OAEG;IACG,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;QACT,UAAU,CAAC,EACR,aAAa,GACb,cAAc,GACd,OAAO,GACP,UAAU,GACV,MAAM,CAAC;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,GACC,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAW/B"}

package/dist/review-client.js

@@ -0,0 +1,116 @@
+/**
+ * Multi-model review client for code, frontend, backend, and plan reviews
+ * Uses OpenRouter API to access multiple LLM providers
+ */
+import { OpenRouter } from "@openrouter/sdk";
+import { LLM_CONFIG } from "./constants";
+import { OpenRouterError } from "./errors";
+import { logger } from "./logger";
+import * as backendReviewPrompts from "./prompts/backend-review";
+import * as codeReviewPrompts from "./prompts/code-review";
+import * as frontendReviewPrompts from "./prompts/frontend-review";
+import * as planReviewPrompts from "./prompts/plan-review";
+import { executeInParallel } from "./utils/parallel-executor";
+/**
+ * Client for performing multi-model code reviews.
+ * Supports parallel execution across multiple AI models for diverse perspectives.
+ *
+ * @example
+ * ```typescript
+ * const client = new ReviewClient(process.env.OPENROUTER_API_KEY);
+ * const results = await client.reviewCode(
+ *   'function add(a, b) { return a + b; }',
+ *   ['anthropic/claude-3.5-sonnet', 'openai/gpt-4-turbo'],
+ *   'JavaScript addition function'
+ * );
+ * ```
+ */
+export class ReviewClient {
+    client;
+    constructor(apiKey) {
+        this.client = new OpenRouter({
+            apiKey,
+        });
+    }
+    /**
+     * Send a chat request to OpenRouter API
+     * @param model - Model identifier (e.g., "anthropic/claude-3.5-sonnet")
+     * @param systemPrompt - System prompt for the model
+     * @param userMessage - User message/question
+     * @returns The model's response content
+     * @throws {OpenRouterError} If the API call fails
+     */
+    async chat(model, systemPrompt, userMessage) {
+        try {
+            logger.debug("Sending chat request", {
+                model,
+                messageLength: userMessage.length,
+            });
+            const response = await this.client.chat.send({
+                model,
+                messages: [
+                    { role: "system", content: systemPrompt },
+                    { role: "user", content: userMessage },
+                ],
+                temperature: LLM_CONFIG.DEFAULT_TEMPERATURE,
+                maxTokens: LLM_CONFIG.DEFAULT_MAX_TOKENS,
+            });
+            const content = response.choices?.[0]?.message?.content;
+            if (typeof content === "string") {
+                logger.debug("Received response", { model, length: content.length });
+                return content;
+            }
+            if (Array.isArray(content)) {
+                const text = content
+                    .filter((item) => item.type === "text")
+                    .map((item) => item.text)
+                    .join("\n");
+                logger.debug("Received array response", { model, length: text.length });
+                return text;
+            }
+            throw new OpenRouterError("No response content from model", 500);
+        }
+        catch (error) {
+            if (error instanceof OpenRouterError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : "Unknown error";
+            logger.error("Chat request failed", error, { model });
+            const isRetryable = message.includes("429") || message.includes("rate limit");
+            throw new OpenRouterError(message, undefined, isRetryable);
+        }
+    }
+    /**
+     * Review code for quality, bugs, performance, and security
+     * @param code - Code to review
+     * @param models - Array of model identifiers to use
+     * @param context - Optional context (language, description, etc.)
+     * @returns Array of review results from each model
+     */
+    async reviewCode(code, models, context) {
+        const userMessage = codeReviewPrompts.buildUserMessage(code, context);
+        return executeInParallel(models, (model) => this.chat(model, codeReviewPrompts.SYSTEM_PROMPT, userMessage));
+    }
+    /**
+     * Review frontend code for accessibility, performance, and UX
+     */
+    async reviewFrontend(code, models, options) {
+        const userMessage = frontendReviewPrompts.buildUserMessage(code, options?.reviewType || "full", options?.framework, options?.context);
+        return executeInParallel(models, (model) => this.chat(model, frontendReviewPrompts.SYSTEM_PROMPT, userMessage));
+    }
+    /**
+     * Review backend code for security, performance, and architecture
+     */
+    async reviewBackend(code, models, options) {
+        const userMessage = backendReviewPrompts.buildUserMessage(code, options?.reviewType || "full", options?.language, options?.context);
+        return executeInParallel(models, (model) => this.chat(model, backendReviewPrompts.SYSTEM_PROMPT, userMessage));
+    }
+    /**
+     * Review implementation plans before code is written
+     */
+    async reviewPlan(plan, models, options) {
+        const userMessage = planReviewPrompts.buildUserMessage(plan, options?.reviewType || "full", options?.context);
+        return executeInParallel(models, (model) => this.chat(model, planReviewPrompts.SYSTEM_PROMPT, userMessage));
+    }
+}
+//# sourceMappingURL=review-client.js.map