@rashidazarang/airtable-mcp 3.1.0 → 3.2.8

package/types/ai-prompts.d.ts

@@ -1,321 +0,0 @@
-/**
- * AI-Powered Prompt Templates Type Definitions
- * Enterprise-grade TypeScript types for all 10 AI prompt templates
- */
-
-import { PromptSchema, PromptArgument } from './index';
-
-// ============================================================================
-// AI Prompt Template Interfaces
-// ============================================================================
-
-export interface AnalyzeDataPrompt {
-  table: string;
-  analysis_type?: 'trends' | 'statistical' | 'patterns' | 'predictive' | 'anomaly_detection' | 'correlation_matrix';
-  field_focus?: string;
-  time_dimension?: string;
-  confidence_level?: 0.90 | 0.95 | 0.99;
-}
-
-export interface CreateReportPrompt {
-  table: string;
-  report_type: 'executive_summary' | 'detailed_analysis' | 'dashboard' | 'stakeholder_report';
-  target_audience: 'executives' | 'managers' | 'analysts' | 'technical_team';
-  include_recommendations?: boolean;
-  time_period?: string;
-  format_preference?: 'narrative' | 'bullet_points' | 'charts' | 'mixed';
-}
-
-export interface DataInsightsPrompt {
-  table: string;
-  insight_type: 'business_intelligence' | 'trend_analysis' | 'performance_metrics' | 'opportunity_identification';
-  focus_areas?: string[];
-  comparison_period?: string;
-  include_forecasting?: boolean;
-  stakeholder_context?: string;
-}
-
-export interface OptimizeWorkflowPrompt {
-  table: string;
-  current_process_description: string;
-  optimization_goals: ('efficiency' | 'accuracy' | 'speed' | 'cost_reduction' | 'compliance')[];
-  constraints?: string[];
-  automation_preference?: 'minimal' | 'moderate' | 'aggressive';
-  change_tolerance?: 'low' | 'medium' | 'high';
-}
-
-export interface SmartSchemaDesignPrompt {
-  purpose: string;
-  data_types: string[];
-  expected_volume: 'small' | 'medium' | 'large' | 'enterprise';
-  compliance_requirements?: ('GDPR' | 'HIPAA' | 'SOX' | 'PCI_DSS')[];
-  performance_priorities?: ('query_speed' | 'storage_efficiency' | 'scalability' | 'maintainability')[];
-  integration_needs?: string[];
-  user_access_patterns?: string;
-}
-
-export interface DataQualityAuditPrompt {
-  table: string;
-  quality_dimensions: ('completeness' | 'accuracy' | 'consistency' | 'timeliness' | 'validity' | 'uniqueness')[];
-  automated_fixes?: boolean;
-  severity_threshold?: 'low' | 'medium' | 'high' | 'critical';
-  compliance_context?: string;
-  reporting_requirements?: string[];
-}
-
-export interface PredictiveAnalyticsPrompt {
-  table: string;
-  target_field: string;
-  prediction_periods?: number;
-  algorithm?: 'linear_regression' | 'arima' | 'exponential_smoothing' | 'random_forest' | 'neural_network';
-  include_confidence_intervals?: boolean;
-  historical_periods?: number;
-  external_factors?: string[];
-  business_context?: string;
-}
-
-export interface NaturalLanguageQueryPrompt {
-  question: string;
-  tables?: string[];
-  response_format?: 'natural_language' | 'structured_data' | 'visualization_ready' | 'action_items';
-  context_awareness?: boolean;
-  confidence_threshold?: number;
-  clarifying_questions?: boolean;
-}
-
-export interface SmartDataTransformationPrompt {
-  source_table: string;
-  target_schema?: string;
-  transformation_goals: ('normalization' | 'aggregation' | 'enrichment' | 'validation' | 'standardization')[];
-  data_quality_rules?: string[];
-  preserve_history?: boolean;
-  validation_strategy?: 'strict' | 'permissive' | 'custom';
-  error_handling?: 'fail_fast' | 'log_and_continue' | 'manual_review';
-}
-
-export interface AutomationRecommendationsPrompt {
-  workflow_description: string;
-  current_pain_points: string[];
-  automation_scope: 'single_task' | 'workflow_segment' | 'end_to_end' | 'cross_system';
-  technical_constraints?: string[];
-  business_impact_priority?: ('cost_savings' | 'time_efficiency' | 'error_reduction' | 'scalability')[];
-  implementation_timeline?: 'immediate' | 'short_term' | 'medium_term' | 'long_term';
-  risk_tolerance?: 'conservative' | 'moderate' | 'aggressive';
-}
-
-// ============================================================================
-// AI Prompt Response Types
-// ============================================================================
-
-export interface AnalysisResult {
-  summary: string;
-  key_findings: string[];
-  statistical_measures?: {
-    mean?: number;
-    median?: number;
-    std_deviation?: number;
-    correlation_coefficients?: Record<string, number>;
-    confidence_intervals?: Array<{ field: string; lower: number; upper: number; confidence: number }>;
-  };
-  trends?: Array<{
-    field: string;
-    direction: 'increasing' | 'decreasing' | 'stable' | 'volatile';
-    strength: 'weak' | 'moderate' | 'strong';
-    significance: number;
-  }>;
-  anomalies?: Array<{
-    record_id: string;
-    field: string;
-    expected_value: unknown;
-    actual_value: unknown;
-    deviation_score: number;
-  }>;
-  recommendations: string[];
-  next_steps: string[];
-}
-
-export interface ReportResult {
-  title: string;
-  executive_summary: string;
-  detailed_sections: Array<{
-    heading: string;
-    content: string;
-    supporting_data?: unknown[];
-    visualizations?: Array<{ type: string; data: unknown; description: string }>;
-  }>;
-  key_metrics: Record<string, { value: unknown; change: string; significance: string }>;
-  recommendations: Array<{
-    priority: 'high' | 'medium' | 'low';
-    recommendation: string;
-    expected_impact: string;
-    implementation_effort: 'low' | 'medium' | 'high';
-  }>;
-  appendices?: Array<{ title: string; content: string }>;
-}
-
-export interface WorkflowOptimizationResult {
-  current_state_analysis: {
-    efficiency_score: number;
-    bottlenecks: Array<{ step: string; impact: 'high' | 'medium' | 'low'; description: string }>;
-    resource_utilization: Record<string, number>;
-  };
-  optimization_recommendations: Array<{
-    category: 'automation' | 'process_redesign' | 'tool_integration' | 'skill_development';
-    recommendation: string;
-    expected_benefits: string[];
-    implementation_complexity: 'simple' | 'moderate' | 'complex';
-    estimated_roi: string;
-    timeline: string;
-  }>;
-  implementation_roadmap: Array<{
-    phase: number;
-    duration: string;
-    objectives: string[];
-    deliverables: string[];
-    success_metrics: string[];
-  }>;
-  risk_assessment: Array<{
-    risk: string;
-    probability: 'low' | 'medium' | 'high';
-    impact: 'low' | 'medium' | 'high';
-    mitigation: string;
-  }>;
-}
-
-export interface SchemaDesignResult {
-  recommended_schema: {
-    tables: Array<{
-      name: string;
-      purpose: string;
-      fields: Array<{
-        name: string;
-        type: string;
-        constraints: string[];
-        description: string;
-      }>;
-      relationships: Array<{
-        type: 'one_to_one' | 'one_to_many' | 'many_to_many';
-        target_table: string;
-        description: string;
-      }>;
-    }>;
-  };
-  design_principles: string[];
-  performance_considerations: string[];
-  scalability_notes: string[];
-  compliance_alignment: Record<string, string[]>;
-  migration_strategy?: {
-    phases: Array<{ phase: number; description: string; estimated_time: string }>;
-    data_migration_notes: string[];
-    validation_checkpoints: string[];
-  };
-}
-
-export interface PredictionResult {
-  predictions: Array<{
-    period: string;
-    predicted_value: number;
-    confidence_interval?: { lower: number; upper: number };
-    probability_bands?: Array<{ probability: number; range: [number, number] }>;
-  }>;
-  model_performance: {
-    algorithm_used: string;
-    accuracy_metrics: Record<string, number>;
-    feature_importance?: Record<string, number>;
-    validation_results: Record<string, number>;
-  };
-  business_insights: {
-    trend_direction: 'positive' | 'negative' | 'stable';
-    seasonality_detected: boolean;
-    external_factors_impact: string[];
-    risk_factors: string[];
-  };
-  recommendations: Array<{
-    type: 'operational' | 'strategic' | 'tactical';
-    recommendation: string;
-    timing: string;
-    confidence: number;
-  }>;
-}
-
-// ============================================================================
-// Prompt Template Definitions (Type-Safe)
-// ============================================================================
-
-export const AI_PROMPT_TEMPLATES: Record<string, PromptSchema> = {
-  analyze_data: {
-    name: 'analyze_data',
-    description: 'Advanced AI data analysis with statistical insights, pattern recognition, and predictive modeling',
-    arguments: [
-      { name: 'table', description: 'Table name or ID to analyze', required: true, type: 'string' },
-      { name: 'analysis_type', description: 'Type of analysis', required: false, type: 'string', enum: ['trends', 'statistical', 'patterns', 'predictive', 'anomaly_detection', 'correlation_matrix'] },
-      { name: 'field_focus', description: 'Specific fields to focus the analysis on', required: false, type: 'string' },
-      { name: 'time_dimension', description: 'Time field for temporal analysis', required: false, type: 'string' },
-      { name: 'confidence_level', description: 'Statistical confidence level', required: false, type: 'number', enum: ['0.90', '0.95', '0.99'] }
-    ]
-  },
-  
-  create_report: {
-    name: 'create_report',
-    description: 'Intelligent report generation with business insights and stakeholder-specific recommendations',
-    arguments: [
-      { name: 'table', description: 'Table name or ID for report data', required: true, type: 'string' },
-      { name: 'report_type', description: 'Type of report to generate', required: true, type: 'string', enum: ['executive_summary', 'detailed_analysis', 'dashboard', 'stakeholder_report'] },
-      { name: 'target_audience', description: 'Primary audience for the report', required: true, type: 'string', enum: ['executives', 'managers', 'analysts', 'technical_team'] },
-      { name: 'include_recommendations', description: 'Include actionable recommendations', required: false, type: 'boolean' },
-      { name: 'time_period', description: 'Time period for analysis', required: false, type: 'string' },
-      { name: 'format_preference', description: 'Preferred report format', required: false, type: 'string', enum: ['narrative', 'bullet_points', 'charts', 'mixed'] }
-    ]
-  },
-  
-  predictive_analytics: {
-    name: 'predictive_analytics',
-    description: 'Advanced forecasting and trend prediction with multiple algorithms and uncertainty quantification',
-    arguments: [
-      { name: 'table', description: 'Table name or ID for prediction', required: true, type: 'string' },
-      { name: 'target_field', description: 'Field to predict', required: true, type: 'string' },
-      { name: 'prediction_periods', description: 'Number of periods to predict', required: false, type: 'number' },
-      { name: 'algorithm', description: 'Prediction algorithm to use', required: false, type: 'string', enum: ['linear_regression', 'arima', 'exponential_smoothing', 'random_forest', 'neural_network'] },
-      { name: 'include_confidence_intervals', description: 'Include confidence intervals', required: false, type: 'boolean' },
-      { name: 'historical_periods', description: 'Historical periods for training', required: false, type: 'number' },
-      { name: 'external_factors', description: 'External factors to consider', required: false, type: 'string' },
-      { name: 'business_context', description: 'Business context for predictions', required: false, type: 'string' }
-    ]
-  },
-  
-  natural_language_query: {
-    name: 'natural_language_query',
-    description: 'Process natural language questions about data with intelligent context awareness',
-    arguments: [
-      { name: 'question', description: 'Natural language question about the data', required: true, type: 'string' },
-      { name: 'tables', description: 'Specific tables to search (optional)', required: false, type: 'string' },
-      { name: 'response_format', description: 'Preferred response format', required: false, type: 'string', enum: ['natural_language', 'structured_data', 'visualization_ready', 'action_items'] },
-      { name: 'context_awareness', description: 'Use context from previous queries', required: false, type: 'boolean' },
-      { name: 'confidence_threshold', description: 'Minimum confidence for responses', required: false, type: 'number' },
-      { name: 'clarifying_questions', description: 'Ask clarifying questions if needed', required: false, type: 'boolean' }
-    ]
-  }
-};
-
-// ============================================================================
-// Export All AI Prompt Types
-// ============================================================================
-
-export {
-  AnalyzeDataPrompt,
-  CreateReportPrompt,
-  DataInsightsPrompt,
-  OptimizeWorkflowPrompt,
-  SmartSchemaDesignPrompt,
-  DataQualityAuditPrompt,
-  PredictiveAnalyticsPrompt,
-  NaturalLanguageQueryPrompt,
-  SmartDataTransformationPrompt,
-  AutomationRecommendationsPrompt,
-  
-  AnalysisResult,
-  ReportResult,
-  WorkflowOptimizationResult,
-  SchemaDesignResult,
-  PredictionResult
-};

package/types/airtable-mcp-server.d.ts

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-/**
- * Airtable MCP Server - TypeScript Implementation
- * Model Context Protocol server for Airtable integration with enterprise-grade type safety
- *
- * Features:
- * - Complete MCP 2024-11-05 protocol support with strict typing
- * - OAuth2 authentication with PKCE and type safety
- * - Enterprise security features with validated types
- * - Rate limiting and comprehensive input validation
- * - Production monitoring and health checks
- * - AI-powered analytics with strongly typed schemas
- *
- * Author: Rashid Azarang
- * License: MIT
- */
-import { MCPServerInfo } from '../types/index';
-import { ToolResponse } from '../types/tools';
-declare class AirtableMCPServer {
-    private server;
-    private readonly config;
-    private readonly tools;
-    private readonly prompts;
-    private readonly roots;
-    constructor();
-    initialize(): Promise<MCPServerInfo>;
-    handleToolCall(name: string, params: Record<string, unknown>): Promise<ToolResponse>;
-    private handleListTables;
-    private handleListRecords;
-    private handleCreateRecord;
-    private handleUpdateRecord;
-    private handleDeleteRecord;
-    handlePromptGet(name: string, args: Record<string, unknown>): Promise<{
-        messages: Array<{
-            role: string;
-            content: {
-                type: string;
-                text: string;
-            };
-        }>;
-    }>;
-    private handleAnalyzeDataPrompt;
-    private handleCreateReportPrompt;
-    private handlePredictiveAnalyticsPrompt;
-    private handleNaturalLanguageQueryPrompt;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    private handleRequest;
-    private handleMCPRequest;
-}
-export { AirtableMCPServer };
-export default AirtableMCPServer;