import { createProviderManager } from 'auto-skill/core/providers';

const manager = createProviderManager();

{
  /** Register a provider. Earlier registrations have higher priority. */
  register(provider: SkillProvider): void;
  
  /** List of registered providers in priority order. */
  providers: SkillProvider[];
  
  /**
   * Search all available providers and merge results.
   *
   * Results are ordered by provider priority (first registered = highest).
   * Each provider contributes up to `limit` results, then the combined
   * list is deduplicated and truncated.
   *
   * @param query - Search keywords.
   * @param limit - Maximum total results to return (default 10).
   * @returns Merged and deduplicated list of SkillSearchResult objects.
   */
  searchAll(query: string, limit?: number): Promise<SkillSearchResult[]>;
  
  /**
   * Get skill details from the first provider that has it.
   *
   * @param skillId - The skill identifier.
   * @param sourceId - Optional provider sourceId to query specifically.
   * @returns SkillSearchResult if found, null otherwise.
   */
  getSkillDetails(
    skillId: string,
    sourceId?: string,
  ): Promise<SkillSearchResult | null>;
}

interface SkillProvider {
  /** Human-readable name of this provider (e.g., 'Skills.sh'). */
  readonly name: string;

  /** Short identifier used in results (e.g., 'skillssh', 'local'). */
  readonly sourceId: string;

  /**
   * Search for skills matching a query.
   *
   * @param query - Search keywords.
   * @param limit - Maximum number of results (default 10).
   * @returns List of matching SkillSearchResult objects.
   */
  search(query: string, limit?: number): Promise<SkillSearchResult[]>;

  /**
   * Get detailed information about a specific skill.
   *
   * @param skillId - The skill identifier.
   * @returns SkillSearchResult with full details, or null if not found.
   */
  getSkillDetails(skillId: string): Promise<SkillSearchResult | null>;

  /**
   * Check if this provider is currently available.
   *
   * @returns True if the provider can serve requests, false otherwise.
   */
  isAvailable(): boolean;
}

interface SkillSearchResult {
  id: string;
  name: string;
  description: string;
  source: string; // provider id, e.g. "skillssh" | "local" | "wellknown"
  confidence: number;
  author: string;
  tags: string[];
  installCount: number;
  sourceUrl: string;
  compatibleAgents: string[];
  metadata?: Record<string, unknown> | null;
}

import {
  createProviderManager,
  createLocalProvider,
  createWellKnownProvider,
} from 'auto-skill/core/providers';

const manager = createProviderManager();

// Register providers (order matters - first = highest priority)
manager.register(createLocalProvider());
manager.register(createWellKnownProvider(['example.com']));

// Search across all providers
const results = await manager.searchAll('typescript testing', 5);
console.log(`Found ${results.length} skills`);

// Get details for a specific skill
const skill = await manager.getSkillDetails('my-skill');
if (skill) {
  console.log(`${skill.name}: ${skill.description}`);
}

// Get details from a specific provider
const localSkill = await manager.getSkillDetails('my-skill', 'local');

manager.register(localProvider);      // Highest priority
manager.register(skillsshProvider);   // Medium priority
manager.register(wellknownProvider);  // Lowest priority