n8n-nodes-github-copilot 4.1.2 → 4.2.0

package/shared/models/GitHubCopilotModels.ts

@@ -0,0 +1,420 @@
+/**
+ * Centralized model definitions for GitHub Copilot integration
+ * This file maintains consistency across all nodes and provides
+ * a single source of truth for available models and their capabilities
+ */
+
+export interface ModelCapability {
+    /** Supports function/tools calling */
+    toolsCalling: boolean;
+    /** Supports vision/image processing */
+    vision: boolean;
+    /** Supports multimodal input (text + images) */
+    multimodal: boolean;
+    /** Maximum context window in tokens */
+    maxContextTokens: number;
+    /** Maximum output tokens */
+    maxOutputTokens: number;
+    /** Supports streaming responses */
+    streaming: boolean;
+    /** Provider of the model */
+    provider: "OpenAI" | "Anthropic" | "Google" | "Microsoft";
+    /** Model category */
+    category: "chat" | "reasoning" | "coding" | "vision" | "multimodal";
+}
+
+export interface GitHubCopilotModel {
+    /** Model identifier for API calls */
+    value: string;
+    /** Display name for UI */
+    name: string;
+    /** Detailed description */
+    description: string;
+    /** Model capabilities */
+    capabilities: ModelCapability;
+    /** Whether model is recommended for general use */
+    recommended: boolean;
+    /** Release status */
+    status: "stable" | "preview" | "experimental";
+}
+
+/**
+ * Complete list of GitHub Copilot available models
+ * Updated from REAL API response - September 2025
+ */
+export const GITHUB_COPILOT_MODELS: GitHubCopilotModel[] = [
+  // Auto selection (important!)
+  {
+    value: "auto",
+    name: "Auto (Recommended)",
+    description: "Automatically selects the best model for your task",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 16384,
+      streaming: true,
+      provider: "OpenAI",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+
+  // OpenAI GPT Models - VERIFIED via API
+  {
+    value: "gpt-5",
+    name: "GPT-5",
+    description: "Latest generation GPT model with enhanced capabilities",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 64000,
+      streaming: true,
+      provider: "OpenAI",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "gpt-5-mini",
+    name: "GPT-5 Mini",
+    description: "Faster and more efficient GPT-5 model",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 64000,
+      streaming: true,
+      provider: "OpenAI",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "gpt-4.1",
+    name: "GPT-4.1",
+    description: "Enhanced GPT-4 model with improved capabilities",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 16384,
+      streaming: true,
+      provider: "OpenAI",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "gpt-4o",
+    name: "GPT-4o",
+    description: "Most capable GPT-4 model with vision, optimized for chat and complex reasoning",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 4096,
+      streaming: true,
+      provider: "OpenAI",
+      category: "multimodal"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "gpt-4o-mini",
+    name: "GPT-4o Mini",
+    description: "Faster and more cost-effective GPT-4o - VERIFIED WORKING",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 4096,
+      streaming: true,
+      provider: "OpenAI",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "o3-mini",
+    name: "o3 Mini",
+    description: "New reasoning model optimized for coding and complex tasks",
+    capabilities: {
+      toolsCalling: true,
+      vision: false,
+      multimodal: false,
+      maxContextTokens: 200000,
+      maxOutputTokens: 100000,
+      streaming: true,
+      provider: "OpenAI",
+      category: "reasoning"
+    },
+    recommended: true,
+    status: "stable"
+  },
+
+  // Microsoft Models
+  {
+    value: "oswe-vscode-prime",
+    name: "Raptor mini (Preview)",
+    description: "Fast and versatile model optimized for VS Code by Microsoft (Azure OpenAI)",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 264000,
+      maxOutputTokens: 64000,
+      streaming: true,
+      provider: "Microsoft",
+      category: "chat"
+    },
+    recommended: true,
+    status: "preview"
+  },
+
+  // Anthropic Claude Models - VERIFIED via API
+  {
+    value: "claude-sonnet-4",
+    name: "Claude Sonnet 4",
+    description: "Latest Claude model with advanced reasoning capabilities",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 16000,
+      streaming: true,
+      provider: "Anthropic",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "claude-opus-4",
+    name: "Claude Opus 4",
+    description: "Most powerful Claude model for complex reasoning (may have performance issues)",
+    capabilities: {
+      toolsCalling: false, // Based on API response
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 80000,
+      maxOutputTokens: 16000,
+      streaming: true,
+      provider: "Anthropic",
+      category: "reasoning"
+    },
+    recommended: false,
+    status: "stable"
+  },
+  {
+    value: "claude-3.7-sonnet",
+    name: "Claude 3.7 Sonnet",
+    description: "Enhanced Claude 3.5 with improved capabilities",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 200000,
+      maxOutputTokens: 16384,
+      streaming: true,
+      provider: "Anthropic",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "claude-3.7-sonnet-thought",
+    name: "Claude 3.7 Sonnet Thinking",
+    description: "Claude with visible reasoning process",
+    capabilities: {
+      toolsCalling: false, // Based on API response
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 200000,
+      maxOutputTokens: 16384,
+      streaming: true,
+      provider: "Anthropic",
+      category: "reasoning"
+    },
+    recommended: false,
+    status: "stable"
+  },
+  {
+    value: "claude-3.5-sonnet",
+    name: "Claude 3.5 Sonnet",
+    description: "Anthropic's balanced model with excellent reasoning and creativity",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 90000,
+      maxOutputTokens: 8192,
+      streaming: true,
+      provider: "Anthropic",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  },
+
+  // Google Gemini Models - VERIFIED via API
+  {
+    value: "gemini-2.5-pro",
+    name: "Gemini 2.5 Pro",
+    description: "Most advanced Gemini model with reasoning capabilities",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 128000,
+      maxOutputTokens: 64000,
+      streaming: true,
+      provider: "Google",
+      category: "reasoning"
+    },
+    recommended: true,
+    status: "stable"
+  },
+  {
+    value: "gemini-2.0-flash-001",
+    name: "Gemini 2.0 Flash",
+    description: "Fast and efficient Gemini model with large context window",
+    capabilities: {
+      toolsCalling: true,
+      vision: true,
+      multimodal: true,
+      maxContextTokens: 1000000,
+      maxOutputTokens: 8192,
+      streaming: true,
+      provider: "Google",
+      category: "chat"
+    },
+    recommended: true,
+    status: "stable"
+  }
+];
+
+/**
+ * Get models filtered by capability
+ */
+export class GitHubCopilotModelsManager {
+  /**
+     * Get all available models
+     */
+  static getAllModels(): GitHubCopilotModel[] {
+    return GITHUB_COPILOT_MODELS;
+  }
+
+  /**
+     * Get models that support tools calling
+     */
+  static getToolsCapableModels(): GitHubCopilotModel[] {
+    return GITHUB_COPILOT_MODELS.filter(model => model.capabilities.toolsCalling);
+  }
+
+  /**
+     * Get models that support vision
+     */
+  static getVisionCapableModels(): GitHubCopilotModel[] {
+    return GITHUB_COPILOT_MODELS.filter(model => model.capabilities.vision);
+  }
+
+  /**
+     * Get models by provider
+     */
+  static getModelsByProvider(provider: "OpenAI" | "Anthropic" | "Google" | "Microsoft"): GitHubCopilotModel[] {
+    return GITHUB_COPILOT_MODELS.filter(model => model.capabilities.provider === provider);
+  }
+
+  /**
+     * Get models by category
+     */
+  static getModelsByCategory(category: "chat" | "reasoning" | "coding" | "vision" | "multimodal"): GitHubCopilotModel[] {
+    return GITHUB_COPILOT_MODELS.filter(model => model.capabilities.category === category);
+  }
+
+  /**
+     * Get recommended models only
+     */
+  static getRecommendedModels(): GitHubCopilotModel[] {
+    return GITHUB_COPILOT_MODELS.filter(model => model.recommended);
+  }
+
+  /**
+     * Get stable models only
+     */
+  static getStableModels(): GitHubCopilotModel[] {
+    return GITHUB_COPILOT_MODELS.filter(model => model.status === "stable");
+  }
+
+  /**
+     * Get model by value
+     */
+  static getModelByValue(value: string): GitHubCopilotModel | undefined {
+    return GITHUB_COPILOT_MODELS.find(model => model.value === value);
+  }
+
+  /**
+     * Convert models to n8n options format
+     */
+  static toN8nOptions(models?: GitHubCopilotModel[]): Array<{name: string, value: string, description: string}> {
+    const modelsToUse = models || GITHUB_COPILOT_MODELS;
+    return modelsToUse.map(model => ({
+      name: model.name,
+      value: model.value,
+      description: model.description
+    }));
+  }
+
+  /**
+     * Get models suitable for specific use cases
+     */
+  static getModelsForUseCase(useCase: "general" | "coding" | "vision" | "reasoning" | "tools"): GitHubCopilotModel[] {
+    switch (useCase) {
+    case "general":
+      return this.getRecommendedModels();
+    case "coding":
+      return GITHUB_COPILOT_MODELS.filter(model => 
+        model.capabilities.category === "coding" || 
+                    model.capabilities.toolsCalling
+      );
+    case "vision":
+      return this.getVisionCapableModels();
+    case "reasoning":
+      return GITHUB_COPILOT_MODELS.filter(model => 
+        model.capabilities.category === "reasoning"
+      );
+    case "tools":
+      return this.getToolsCapableModels();
+    default:
+      return this.getAllModels();
+    }
+  }
+}
+
+/**
+ * Default model for different scenarios
+ */
+export const DEFAULT_MODELS = {
+  GENERAL: "gpt-4o-mini",  // VERIFIED working in tests
+  CODING: "o3-mini",
+  VISION: "gpt-4o",
+  REASONING: "claude-sonnet-4",
+  TOOLS: "gpt-5",
+  MULTIMODAL: "gemini-2.5-pro"
+} as const;

package/shared/models/ModelVersionRequirements.ts

@@ -0,0 +1,165 @@
+/**
+ * Model Version Requirements Configuration
+ * 
+ * Maps GitHub Copilot models to their specific version requirements,
+ * supported endpoints, and any additional headers needed.
+ * 
+ * This is extracted from models.json and API error responses.
+ */
+
+export interface ModelRequirements {
+  /** Minimum VS Code version required (e.g., "1.104.1") */
+  minVSCodeVersion: string;
+  
+  /** Supported API endpoints for this model */
+  supportedEndpoints: string[];
+  
+  /** Whether model is in preview mode */
+  preview?: boolean;
+  
+  /** Additional headers required for this model */
+  additionalHeaders?: Record<string, string>;
+  
+  /** Special notes or warnings */
+  notes?: string;
+}
+
+/**
+ * Model-specific requirements configuration
+ * 
+ * Models not listed here use default configuration:
+ * - minVSCodeVersion: "1.95.0"
+ * - supportedEndpoints: ["/chat/completions", "/responses"]
+ */
+export const MODEL_VERSION_REQUIREMENTS: Record<string, ModelRequirements> = {
+  // GPT-5-Codex: Requires newer VS Code version and /responses endpoint only
+  "gpt-5-codex": {
+    minVSCodeVersion: "1.104.1",
+    supportedEndpoints: ["/responses"],
+    preview: true,
+    notes: "Preview model requiring VS Code 1.104.1 or newer. Only supports /responses endpoint."
+  },
+  
+  // GPT-5: Supports both endpoints
+  "gpt-5": {
+    minVSCodeVersion: "1.95.0",
+    supportedEndpoints: ["/chat/completions", "/responses"],
+    preview: false,
+  },
+  
+  // GPT-5 Mini: Supports both endpoints
+  "gpt-5-mini": {
+    minVSCodeVersion: "1.95.0",
+    supportedEndpoints: ["/chat/completions", "/responses"],
+    preview: false,
+  },
+  
+  // o3: Preview model but works with standard version
+  "o3": {
+    minVSCodeVersion: "1.95.0",
+    supportedEndpoints: ["/chat/completions", "/responses"],
+    preview: true,
+  },
+  
+  // o3-2025-04-16: Specific version
+  "o3-2025-04-16": {
+    minVSCodeVersion: "1.95.0",
+    supportedEndpoints: ["/chat/completions", "/responses"],
+    preview: true,
+  },
+  
+  // o4-mini: Preview model
+  "o4-mini": {
+    minVSCodeVersion: "1.95.0",
+    supportedEndpoints: ["/chat/completions", "/responses"],
+    preview: true,
+  },
+  
+  // o4-mini-2025-04-16: Specific version
+  "o4-mini-2025-04-16": {
+    minVSCodeVersion: "1.95.0",
+    supportedEndpoints: ["/chat/completions", "/responses"],
+    preview: true,
+  },
+
+  // Raptor Mini (oswe-vscode-prime)
+  "oswe-vscode-prime": {
+    minVSCodeVersion: "1.96.0",
+    supportedEndpoints: ["/chat/completions", "/responses"],
+    preview: true,
+  },
+  
+  // Add more models with special requirements here as needed
+};
+
+/**
+ * Default requirements for models not explicitly configured
+ */
+export const DEFAULT_MODEL_REQUIREMENTS: ModelRequirements = {
+  minVSCodeVersion: "1.95.0",
+  supportedEndpoints: ["/chat/completions", "/responses"],
+  preview: false,
+};
+
+/**
+ * Get requirements for a specific model
+ * Returns model-specific requirements or defaults if not configured
+ */
+export function getModelRequirements(model: string): ModelRequirements {
+  return MODEL_VERSION_REQUIREMENTS[model] || DEFAULT_MODEL_REQUIREMENTS;
+}
+
+/**
+ * Check if model supports a specific endpoint
+ */
+export function modelSupportsEndpoint(model: string, endpoint: string): boolean {
+  const requirements = getModelRequirements(model);
+  return requirements.supportedEndpoints.includes(endpoint);
+}
+
+/**
+ * Get recommended endpoint for a model
+ * Returns the first supported endpoint (usually preferred one)
+ */
+export function getRecommendedEndpoint(model: string): string {
+  const requirements = getModelRequirements(model);
+  return requirements.supportedEndpoints[0] || "/chat/completions";
+}
+
+/**
+ * Validate model and endpoint combination
+ * Throws error if combination is not supported
+ */
+export function validateModelEndpoint(model: string, endpoint: string): void {
+  if (!modelSupportsEndpoint(model, endpoint)) {
+    const requirements = getModelRequirements(model);
+    throw new Error(
+      `Model "${model}" does not support endpoint "${endpoint}". ` +
+      `Supported endpoints: ${requirements.supportedEndpoints.join(", ")}`
+    );
+  }
+}
+
+/**
+ * Get minimum VS Code version for a model
+ */
+export function getMinVSCodeVersion(model: string): string {
+  const requirements = getModelRequirements(model);
+  return requirements.minVSCodeVersion;
+}
+
+/**
+ * Check if model is in preview mode
+ */
+export function isPreviewModel(model: string): boolean {
+  const requirements = getModelRequirements(model);
+  return requirements.preview || false;
+}
+
+/**
+ * Get all additional headers required for a model
+ */
+export function getAdditionalHeaders(model: string): Record<string, string> {
+  const requirements = getModelRequirements(model);
+  return requirements.additionalHeaders || {};
+}

package/shared/properties/ModelProperties.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared Model Properties for GitHub Copilot Nodes
+ *
+ * Provides consistent model selection properties across all GitHub Copilot nodes.
+ * All nodes now use the simplified CHAT_MODEL_PROPERTIES for uniform interface.
+ */
+
+import { INodeProperties } from "n8n-workflow";
+import { DEFAULT_MODELS } from "../models/GitHubCopilotModels";
+
+/**
+ * Chat Model Property (for all nodes)
+ * Simplified version that allows both list selection and manual entry
+ */
+export const CHAT_MODEL_PROPERTY: INodeProperties = {
+  displayName: "Model",
+  name: "model",
+  type: "options",
+  typeOptions: {
+    loadOptionsMethod: "getAvailableModels",
+  },
+  default: DEFAULT_MODELS.GENERAL,
+  description: "Select the GitHub Copilot model to use (loaded dynamically based on your subscription)",
+};
+
+/**
+ * Manual Model Entry Property
+ * Appears when user selects "__manual__" from the dynamic dropdown
+ */
+export const MANUAL_MODEL_PROPERTY: INodeProperties = {
+  displayName: "Custom Model Name",
+  name: "customModel",
+  type: "string",
+  default: "",
+  placeholder: "gpt-4o, claude-3.5-sonnet, grok-code-fast-1, etc.",
+  description: "Enter the model name manually. This is useful for new/beta models not yet in the list.",
+  hint: "Examples: gpt-4o, gpt-4o-mini, claude-3.5-sonnet, gemini-2.0-flash-exp, grok-code-fast-1",
+  displayOptions: {
+    show: {
+      model: ["__manual__"],
+    },
+  },
+};
+
+/**
+ * Chat Model Properties Set (used by all nodes)
+ * Simplified and consistent interface for all GitHub Copilot nodes
+ */
+export const CHAT_MODEL_PROPERTIES: INodeProperties[] = [
+  CHAT_MODEL_PROPERTY,
+  MANUAL_MODEL_PROPERTY,
+];

package/shared/properties/ModelSelectionProperty.ts

@@ -0,0 +1,68 @@
+/**
+ * Model Selection Property
+ * 
+ * Reusable property for model selection across all GitHub Copilot nodes.
+ * Supports both dynamic model loading and manual input.
+ */
+
+import { INodeProperties } from "n8n-workflow";
+import { DEFAULT_MODELS } from "../models/GitHubCopilotModels";
+
+/**
+ * Model selection property with dynamic loading and manual input
+ * 
+ * Features:
+ * - Dynamic model loading from user's subscription
+ * - Manual input for custom/new models
+ * - Refresh button to update model list
+ * - Fallback to default models if loading fails
+ */
+export const modelSelectionProperty: INodeProperties = {
+  displayName: "Model",
+  name: "model",
+  type: "options",
+  typeOptions: {
+    loadOptionsMethod: "getAvailableModels",
+    loadOptionsDependsOn: ["refresh"], // Triggers reload when refresh changes
+  },
+  default: DEFAULT_MODELS.GENERAL,
+  required: true,
+  description: "Select a model from your subscription or enter a custom model name",
+  placeholder: "Select model or type custom name (e.g., gpt-4o, claude-3.5-sonnet)",
+  hint: "Models are loaded based on your GitHub Copilot subscription. Use the refresh button to update the list.",
+  // Allow manual input - user can type any model name
+  validateType: "string",
+  ignoreValidationDuringExecution: false,
+};
+
+/**
+ * Optional refresh button property
+ * Place this after the model property to add a refresh button
+ */
+export const modelRefreshProperty: INodeProperties = {
+  displayName: "Refresh Models",
+  name: "refreshModels",
+  type: "button",
+  typeOptions: {
+    action: "refreshModels",
+  },
+  default: "",
+  description: "Click to refresh the list of available models from your subscription",
+  displayOptions: {
+    show: {
+      operation: ["chat"], // Show only in chat operation
+    },
+  },
+};
+
+/**
+ * Helper property to trigger model list refresh
+ * This is a hidden field that changes value when refresh button is clicked
+ */
+export const refreshTriggerProperty: INodeProperties = {
+  displayName: "Refresh Trigger",
+  name: "refresh",
+  type: "hidden",
+  default: 0,
+  description: "Internal field to trigger model list refresh",
+};