interface ErrorResponse {
  detail: string;
}

interface Collection<T> {
  items: T[];
  total: number;
}

interface PaginatedCollection<T> extends Collection<T> {
  page: number;
  page_size: number;
  total_pages: number;
}

interface FunctionRecord {
  name: string;
  repo: string;
  file_path: string;
  args?: string | string[];
  decorators?: string | string[];
  docstring?: string;
  line_count?: number;
  complexity?: number;
  domain?: string;
  ontology_class?: string;
  ontology_confidence?: number;
}

interface OntologyMatch {
  uri: string;
  name: string | null;
  confidence: number;
}

interface HybridSearchResponse {
  query: string;
  mode: "bm25" | "vector" | "hybrid";
  node_type: "Function" | "Class";
  count: number;
  filters: Record<string, string | number | boolean>;
  results: Array<FunctionRecord & {
    score: number;
    ontology_matches: OntologyMatch[];
  }>;
}

interface EmbeddingSearchResult {
  repo: string;
  name: string;
  file_path: string;
  domain: string | null;
  model: string;
  similarity: number;
}

interface OntologySkillItem {
  name: string;
  repo: string;
  file_path: string;
  docstring: string | null;
  domain: string | null;
  complexity: number | null;
  mapped_confidence: number | null;
}

interface OntologySkillResponse {
  concept: { uri: string; name: string };
  limit: number;
  count: number;
  items: OntologySkillItem[];
}

interface NodeWriteRequest {
  label: string;
  properties: Record<string, unknown>;
}

interface NodeUpdateRequest {
  properties: Record<string, unknown>;
}

interface EdgeWriteRequest {
  source_label: string;
  source_name: string;
  target_label: string;
  target_name: string;
  relationship: string;
  properties?: Record<string, unknown>;
}

interface CheckoutSessionRequest {
  plan_id: string;
  success_url: string;
  cancel_url?: string;
  customer_email?: string;
}

interface CheckoutSessionResponse {
  session_id: string;
  url: string;
  plan_id: string;
}

interface UsageEventRequest {
  idempotency_key: string;
  organization_id?: string;
  workspace_id?: string;
  source: string;
  unit: string;
  quantity: number;
  subject_type?: string;
  subject_id?: string;
  metadata?: Record<string, unknown>;
}