// ============================================================================
// AI Provider Types — shared between server tool output and client hooks
// ============================================================================

export const PROVIDER_IDS = [
  "deco",
  "anthropic",
  "openrouter",
  "google",
  "claude-code",
  "codex",
  "openai-compatible",
] as const;

export type ProviderId = (typeof PROVIDER_IDS)[number];

/** All known model capability tokens. Sourced from OpenRouter modality strings. */
export const MODEL_CAPABILITIES = [
  "text",
  "image",
  "vision",
  "audio",
  "video",
  "file",
  "reasoning",
] as const;

export type ModelCapability = (typeof MODEL_CAPABILITIES)[number];

export interface AiProviderModelLimits {
  contextWindow: number;
  /** Null means the provider does not advertise a specific cap. */
  maxOutputTokens: number | null;
}

export interface AiProviderModelCosts {
  input: number;
  output: number;
}

export interface AiProviderModel {
  providerId: ProviderId;
  modelId: string;
  title: string;
  description: string | null;
  logo: string | null;
  capabilities: ModelCapability[];
  limits: AiProviderModelLimits | null;
  costs: AiProviderModelCosts | null;
  /** When true the upstream provider has flagged this model as deprecated. */
  deprecated?: boolean;
  /**
   * When true, this model can ONLY be used through the provider's
   * `AsyncResearchProvider` capability (e.g. Gemini Deep Research via the
   * Interactions API). It is unusable as a Thinking/Coding/Fast/Image model
   * because `streamText` / `generateContent` will reject it. UIs should
   * restrict it to the deep-research slot.
   */
  asyncResearch?: boolean;
  /** Client-side only — the credential key ID used to fetch this model. */
  keyId?: string;
}

export interface AiProviderKey {
  id: string;
  providerId: ProviderId;
  label: string;
  /**
   * Frontend preset id (e.g. "litellm", "ollama") for openai-compatible keys
   * that were created from a branded preset card. Null otherwise.
   */
  presetId: string | null;
  createdBy: string;
  createdAt: string;
}

export interface AiProviderInfo {
  id: ProviderId;
  name: string;
  description: string;
  logo?: string | null;
  supportedMethods: ("api-key" | "oauth-pkce" | "cli-activate")[];
  supportsTopUp?: boolean;
  supportsCredits?: boolean;
  supportsProvision?: boolean;
}