interface AiSearchResult {
  answer: string;                            // AI-generated answer
  documents: Array<{                         // Source documents
    id: string;
    name: string;                           // Human-readable name
  }>;
  sources: string[];                        // Document excerpts
  confidence: number;                       // Answer confidence score
}

curl -X POST https://plugged.in/api/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@document.pdf" \
  -F "name=Project Documentation" \
  -F "description=Complete project specs" \
  -F "tags=project,specs,requirements"

interface DocumentVersion {
  id: string;
  version_number: number;
  created_by_model: {
    name: string;           // e.g., "Claude 3.5 Sonnet"
    provider: string;       // e.g., "Anthropic"
    version?: string;       // e.g., "3.5"
  };
  created_at: Date;
  change_summary?: string;
  content_diff?: {
    additions: number;      // Lines added
    deletions: number;      // Lines removed
    changes: Array<{
      type: 'addition' | 'deletion' | 'modification';
      content: string;
    }>;
  };
}

interface DocumentPreview {
  document: Doc;
  isOpen: boolean;
  viewMode: 'preview' | 'metadata' | 'versions';
  zoomLevel: number;        // 10-500
  currentPage?: number;      // For PDFs
  fullscreen: boolean;
}

# Bulk upload
curl -X POST https://plugged.in/api/documents/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documents": [
      {"name": "Doc1", "content": "..."},
      {"name": "Doc2", "content": "..."}
    ]
  }'

# Bulk delete
curl -X DELETE https://plugged.in/api/documents/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["uuid1", "uuid2", "uuid3"]}'

interface DocumentAnalytics {
  views: number;
  searches: number;
  ai_queries: number;
  last_accessed: Date;
  popular_queries: string[];
  access_patterns: {
    hourly: number[];
    daily: number[];
  };
}

// Upload document
POST /api/documents

// Get document
GET /api/documents/:id

// Update document
PUT /api/documents/:id

// Delete document
DELETE /api/documents/:id

// Search documents
POST /api/documents/search

// AI query
POST /api/documents/ai-search

// Get versions
GET /api/documents/:id/versions

// Compare versions
GET /api/documents/:id/compare?v1=1&v2=2

{
  "document": {
    "id": "uuid",
    "name": "Document Name",
    "content": "...",
    "metadata": {
      "source": "upload|ai_generated|api",
      "model": { "name": "...", "provider": "..." },
      "version": 1,
      "created_at": "2025-01-18T..."
    }
  },
  "versions": [...],
  "analytics": {...}
}