// packages/ui-gen/src/adapters/types.ts
//
// Production adapter types — used by both Lambda generation and benchmarks.

import type { z } from 'zod';
import type { JsonObject } from '@ggui-ai/protocol';

// =============================================================================
// Provider & Mode
// =============================================================================

export type ProviderName = 'claude' | 'openai' | 'google' | 'openrouter';
export type AdapterMode = 'raw' | 'sdk' | 'multi-agent';

export const PROVIDER_DISPLAY_NAMES: Record<ProviderName, string> = {
  claude: 'Anthropic Claude',
  openai: 'OpenAI',
  google: 'Google Gemini',
  openrouter: 'OpenRouter',
};

// =============================================================================
// Tool Definition (SDK-agnostic)
// =============================================================================

export interface ToolResultContent {
  type: 'text';
  text: string;
}

export interface ToolResult {
  content: ToolResultContent[];
  isError?: boolean;
}

/**
 * SDK-agnostic tool definition.
 * Each adapter converts these to its native tool format.
 */
export interface ToolDefinition {
  /** Tool name (e.g., 'compile_component') */
  name: string;
  /** Tool description for the LLM */
  description: string;
  /** Zod schema for input parameters (always an object schema — tools take named args) */
  inputSchema: z.ZodObject<z.ZodRawShape>;
  /** Handler function — same signature regardless of SDK */
  handler: (args: JsonObject) => Promise<ToolResult>;
}

// =============================================================================
// Adapter Result
// =============================================================================

/**
 * Result returned by any adapter's generate() method.
 *
 * Core fields are populated by all adapters. Extended fields are
 * populated by adapters that support richer output (e.g., Claude SDK).
 */
export interface AdapterResult {
  /** Final compiled JavaScript component code */
  compiledCode: string;
  /** TSX source code (captured from compile_component input) */
  sourceCode?: string;
  /** Token usage breakdown */
  tokens: {
    input: number;
    output: number;
    total: number;
  };
  /** Wall-clock generation time in ms */
  generationTimeMs: number;
  /** Total number of LLM API calls across all phases */
  turnsUsed: number;
  /** Number of harness iterations (Plan→Code→Evaluate→Regen cycles). 1 = single pass. */
  iterations?: number;
  /** Raw cost from SDK if available */
  rawCostUsd?: number;

  // ── Extended fields (production use) ───────────────────────────────

  /** Data spec for ggui_emit — describes what data the component accepts */
  stream?: JsonObject;
  /** LLM-generated metadata annotation for blueprint indexing */
  generatorMeta?: { category: string; description: string };
  /** Names of subagents invoked during generation */
  subagentsUsed?: string[];
  /** Tokens written to prompt cache (Claude-specific) */
  cacheCreationTokens?: number;
  /** Tokens read from prompt cache (Claude-specific) */
  cacheReadTokens?: number;
  /** SDK session ID for evaluation loop resume (Claude SDK-specific) */
  sdkSessionId?: string;
}