/**
 * GET /api/agent-transcript.json?id=<recordingId>[&password=<pw>|&t=<token>]
 *
 * Timestamped transcript for a public clip, optimized for external agents.
 */

import {
  defineEventHandler,
  getQuery,
  getRequestURL,
  setResponseStatus,
  type H3Event,
} from "h3";

import {
  buildAgentApiUrls,
  getAgentClipReadiness,
} from "../../../shared/agent-context.js";
import { isLoomEmbedBackedRecording } from "../../../shared/loom.js";
import {
  applyAgentJsonHeaders,
  CLIPS_AGENT_ACCESS_PARAM,
  getServerAppBasePath,
  loadAgentTranscript,
  loadPublicAgentAccess,
  queryString,
  transcriptStatusInstructions,
} from "../../lib/public-agent-context.js";

export default defineEventHandler(async (event: H3Event) => {
  applyAgentJsonHeaders(event);

  const query = getQuery(event);
  const id = queryString(query.id);
  const accessResult = await loadPublicAgentAccess(event, id, {
    password: queryString(query.password),
    token: queryString(query[CLIPS_AGENT_ACCESS_PARAM]) || queryString(query.t),
  });

  if (!accessResult.ok) {
    setResponseStatus(event, accessResult.failure.status);
    return accessResult.failure.body;
  }

  const recording = accessResult.access.recording;
  const { transcript, agentSegments } = await loadAgentTranscript(
    recording.id,
    recording.durationMs,
  );
  const api = buildAgentApiUrls(recording.id, {
    origin: getRequestURL(event).origin,
    basePath: getServerAppBasePath(),
    token: accessResult.access.apiToken,
  });
  const isLoomEmbedBacked = isLoomEmbedBackedRecording(recording);
  const agentReadiness = getAgentClipReadiness(recording.status);
  const clipIsReady = agentReadiness.state === "ready";

  return {
    type: "agent-native.clip.transcript",
    recording: {
      id: recording.id,
      title: recording.title,
      durationMs: recording.durationMs,
      status: recording.status,
      agentReadiness,
    },
    apis: {
      context: { method: "GET", url: api.contextUrl },
      transcript: { method: "GET", url: api.transcriptUrl },
      ...(!clipIsReady || isLoomEmbedBacked
        ? {}
        : {
            frame: {
              method: "GET",
              urlTemplate: api.frameUrlTemplate,
            },
          }),
    },
    transcript: {
      status: transcript?.status ?? "missing",
      language: transcript?.language ?? null,
      failureReason: transcript?.failureReason ?? null,
      retryAfterSeconds: transcript?.status === "pending" ? 15 : null,
      fullText: transcript?.fullText ?? "",
      segments: agentSegments,
      segmentCount: agentSegments.length,
    },
    instructions: [
      ...(agentReadiness.instruction ? [agentReadiness.instruction] : []),
      ...transcriptStatusInstructions(transcript),
    ],
  };
});