<?php

namespace App\Mcp\Tools\Experiment;

use App\Domain\Experiment\Models\Experiment;
use App\Domain\Experiment\Models\ExperimentStage;
use App\Mcp\Concerns\HasStructuredErrors;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;

#[IsReadOnly]
// @mcp-cross-tenant transitive-via-experiment
class ExperimentStageTelemetryTool extends Tool
{
    use HasStructuredErrors;

    protected string $name = 'experiment_stage_telemetry';

    protected string $description = 'Get per-node telemetry for an experiment\'s pipeline stages: token usage, latency, retry rounds, and LLM call counts per stage.';

    public function schema(JsonSchema $schema): array
    {
        return [
            'experiment_id' => $schema->string()
                ->description('The experiment UUID')
                ->required(),
        ];
    }

    public function handle(Request $request): Response
    {
        $validated = $request->validate([
            'experiment_id' => 'required|string',
        ]);

        $teamId = (app()->bound('mcp.team_id') ? app('mcp.team_id') : null) ?? auth()->user()?->current_team_id;
        if (! $teamId) {
            return $this->permissionDeniedError('No current team.');
        }

        $experiment = Experiment::withoutGlobalScopes()
            ->where('team_id', $teamId)
            ->find($validated['experiment_id']);

        if (! $experiment) {
            return $this->notFoundError('experiment');
        }

        $stages = ExperimentStage::withoutGlobalScopes()
            ->where('experiment_id', $experiment->id)
            ->orderBy('iteration')
            ->get(['id', 'stage', 'status', 'iteration', 'duration_ms', 'retry_count', 'telemetry', 'started_at', 'completed_at']);

        $summary = [
            'total_token_input' => 0,
            'total_token_output' => 0,
            'total_llm_calls' => 0,
            'total_latency_ms' => 0,
            'max_retry_round' => 0,
        ];

        $stageData = $stages->map(function (ExperimentStage $stage) use (&$summary) {
            $t = $stage->telemetry ?? [];
            $summary['total_token_input'] += $t['token_input'] ?? 0;
            $summary['total_token_output'] += $t['token_output'] ?? 0;
            $summary['total_llm_calls'] += $t['llm_calls'] ?? 0;
            $summary['total_latency_ms'] += $t['stage_latency_ms'] ?? $stage->duration_ms ?? 0;
            $summary['max_retry_round'] = max($summary['max_retry_round'], $t['retry_round'] ?? 0);

            return [
                'stage' => $stage->stage->value,
                'status' => $stage->status->value,
                'iteration' => $stage->iteration,
                'duration_ms' => $stage->duration_ms,
                'telemetry' => $t,
            ];
        });

        return Response::text(json_encode([
            'experiment_id' => $experiment->id,
            'summary' => $summary,
            'stages' => $stageData,
        ]));
    }
}
