// Test Live Media script supports OpenClaw repository automation.

import { pathToFileURL } from "node:url";
import { formatErrorMessage } from "../src/infra/errors.ts";
import { spawnPnpmRunner as _spawnPnpmRunner } from "./pnpm-runner.mjs";

export type MediaSuiteId = "image" | "music" | "video";

export type MediaSuiteConfig = {
  id: MediaSuiteId;
  testFile: string;
  providerEnvVar: string;
  providers: string[];
  defaultProviders?: string[];
};

export const MEDIA_SUITES: Record<MediaSuiteId, MediaSuiteConfig> = {
  image: {
    id: "image",
    testFile: "test/image-generation.runtime.live.test.ts",
    providerEnvVar: "OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS",
    providers: ["deepinfra", "fal", "google", "minimax", "openai", "openrouter", "vydra", "xai"],
  },
  music: {
    id: "music",
    testFile: "extensions/music-generation-providers.live.test.ts",
    providerEnvVar: "OPENCLAW_LIVE_MUSIC_GENERATION_PROVIDERS",
    providers: ["fal", "google", "minimax", "openrouter"],
  },
  video: {
    id: "video",
    testFile: "extensions/video-generation-providers.live.test.ts",
    providerEnvVar: "OPENCLAW_LIVE_VIDEO_GENERATION_PROVIDERS",
    providers: [
      "alibaba",
      "byteplus",
      "deepinfra",
      "fal",
      "google",
      "minimax",
      "openai",
      "openrouter",
      "qwen",
      "runway",
      "together",
      "vydra",
      "xai",
    ],
    defaultProviders: [
      "alibaba",
      "byteplus",
      "deepinfra",
      "google",
      "minimax",
      "openai",
      "openrouter",
      "qwen",
      "runway",
      "together",
      "vydra",
      "xai",
    ],
  },
};

const DEFAULT_SUITES: MediaSuiteId[] = ["image", "music", "video"];

export type CliOptions = {
  allowEmpty: boolean;
  suites: MediaSuiteId[];
  globalProviders: Set<string> | null;
  suiteProviders: Partial<Record<MediaSuiteId, Set<string>>>;
  requireAuth: boolean;
  quietArgs: string[];
  passthroughArgs: string[];
  help: boolean;
};

export type SuiteRunPlan = {
  suite: MediaSuiteConfig;
  providers: string[];
  skippedReason?: string;
};

export type BuildRunPlanDeps = {
  collectProviderApiKeysImpl?: (provider: string) => Promise<unknown[]> | unknown[];
  getProviderEnvVarsImpl?: (provider: string) => Promise<string[]> | string[];
  loadShellEnvFallbackImpl?: (params: {
    enabled: true;
    env: NodeJS.ProcessEnv;
    expectedKeys: string[];
    logger: { warn: (message: string) => void };
  }) => Promise<void> | void;
};

export type RunCliDeps = {
  buildRunPlanImpl?: (options: CliOptions) => Promise<SuiteRunPlan[]> | SuiteRunPlan[];
  runSuiteImpl?: typeof runSuite;
};

function formatProviderList(providers: Iterable<string>): string {
  return [...providers].toSorted().join(", ");
}

function spawnLivePnpm(params: { pnpmArgs: string[]; env: NodeJS.ProcessEnv }) {
  return _spawnPnpmRunner({
    pnpmArgs: params.pnpmArgs,
    stdio: "inherit",
    env: params.env,
  });
}

async function collectProviderApiKeysForLiveMedia(provider: string): Promise<unknown[]> {
  const { collectProviderApiKeys } = await import("../src/agents/live-auth-keys.js");
  return collectProviderApiKeys(provider);
}

async function getProviderEnvVarsForLiveMedia(provider: string): Promise<string[]> {
  const { getProviderEnvVars } = await import("../src/secrets/provider-env-vars.js");
  return getProviderEnvVars(provider);
}

async function loadShellEnvFallbackForLiveMedia(params: {
  enabled: true;
  env: NodeJS.ProcessEnv;
  expectedKeys: string[];
  logger: { warn: (message: string) => void };
}): Promise<void> {
  const { loadShellEnvFallback } = await import("../src/infra/shell-env.js");
  loadShellEnvFallback(params);
}

function parseCsv(raw: string | undefined): Set<string> | null {
  const trimmed = raw?.trim();
  if (!trimmed) {
    return null;
  }
  const values = trimmed
    .split(",")
    .map((entry) => entry.trim().toLowerCase())
    .filter(Boolean);
  return values.length ? new Set(values) : null;
}

function parseSuiteToken(raw: string): MediaSuiteId | null {
  const normalized = raw.trim().toLowerCase();
  if (normalized === "image" || normalized === "music" || normalized === "video") {
    return normalized;
  }
  return null;
}

export function parseArgs(argv: string[]): CliOptions {
  const separatorIndex = argv.indexOf("--");
  const optionArgs = separatorIndex >= 0 ? argv.slice(0, separatorIndex) : argv;
  const separatorPassthroughArgs = separatorIndex >= 0 ? argv.slice(separatorIndex + 1) : [];
  const suites = new Set<MediaSuiteId>();
  const suiteProviders: Partial<Record<MediaSuiteId, Set<string>>> = {};
  const passthroughArgs: string[] = [];
  const quietArgs: string[] = [];
  let globalProviders: Set<string> | null = null;
  let requireAuth = true;
  let help = false;
  let allowEmpty = false;

  const readValue = (index: number): string => {
    const value = optionArgs[index + 1]?.trim();
    if (!value) {
      throw new Error(`Missing value for ${optionArgs[index]}`);
    }
    return value;
  };

  for (let index = 0; index < optionArgs.length; index += 1) {
    const arg = optionArgs[index] ?? "";
    if (!arg) {
      continue;
    }
    if (arg === "--help" || arg === "-h") {
      help = true;
      continue;
    }
    if (
      arg === "--quiet" ||
      arg === "--quiet-live" ||
      arg === "--no-quiet" ||
      arg === "--no-quiet-live"
    ) {
      quietArgs.push(arg);
      continue;
    }
    if (arg === "--providers") {
      globalProviders = parseCsv(readValue(index));
      index += 1;
      continue;
    }
    if (arg === "--image-providers" || arg === "--music-providers" || arg === "--video-providers") {
      const suite = parseSuiteToken(arg.slice(2, arg.indexOf("-providers")));
      if (!suite) {
        throw new Error(`Unknown suite flag: ${arg}`);
      }
      suiteProviders[suite] = parseCsv(readValue(index)) ?? new Set<string>();
      index += 1;
      continue;
    }
    if (arg === "--with-auth" || arg === "--require-auth") {
      requireAuth = true;
      continue;
    }
    if (arg === "--allow-empty") {
      allowEmpty = true;
      continue;
    }
    if (arg === "--all-providers" || arg === "--no-auth-filter") {
      requireAuth = false;
      continue;
    }
    if (arg.startsWith("--")) {
      passthroughArgs.push(arg);
      const next = argv[index + 1];
      if (next && !next.startsWith("--")) {
        passthroughArgs.push(next);
        index += 1;
      }
      continue;
    }
    const suite = parseSuiteToken(arg);
    if (suite) {
      suites.add(suite);
      continue;
    }
    if (arg === "all") {
      suites.add("image");
      suites.add("music");
      suites.add("video");
      continue;
    }
    throw new Error(`Unknown argument: ${arg}`);
  }

  const options = {
    allowEmpty,
    suites: (suites.size ? [...suites] : DEFAULT_SUITES).toSorted(),
    globalProviders,
    suiteProviders,
    requireAuth,
    quietArgs,
    passthroughArgs: [...passthroughArgs, ...separatorPassthroughArgs],
    help,
  };
  validateProviderFilters(options);
  return options;
}

function validateProviderFilters(options: CliOptions): void {
  const selectedSuites = new Set(options.suites);
  const unselectedSuiteFilters = Object.keys(options.suiteProviders).filter(
    (suiteId) => !selectedSuites.has(suiteId as MediaSuiteId),
  );
  if (unselectedSuiteFilters.length > 0) {
    throw new Error(
      `Provider filter(s) target unselected media suite(s): ${unselectedSuiteFilters.toSorted().join(", ")}`,
    );
  }

  if (options.globalProviders) {
    const selectedProviders = new Set(
      options.suites.flatMap((suiteId) => MEDIA_SUITES[suiteId].providers),
    );
    const unknown = [...options.globalProviders].filter(
      (provider) => !selectedProviders.has(provider),
    );
    if (unknown.length > 0) {
      throw new Error(
        `Unknown provider(s) for selected media suite(s): ${formatProviderList(unknown)}`,
      );
    }
  }

  for (const [suiteId, providers] of Object.entries(options.suiteProviders) as [
    MediaSuiteId,
    Set<string>,
  ][]) {
    const suite = MEDIA_SUITES[suiteId];
    const supported = new Set(suite.providers);
    const unknown = [...providers].filter((provider) => !supported.has(provider));
    if (unknown.length > 0) {
      throw new Error(`Unknown ${suiteId} provider(s): ${formatProviderList(unknown)}`);
    }
  }
}

function hasExplicitProviderSelection(options: CliOptions): boolean {
  return options.globalProviders !== null || Object.keys(options.suiteProviders).length > 0;
}

function hasExplicitProviderSelectionForSuite(options: CliOptions, suiteId: MediaSuiteId): boolean {
  if (Object.hasOwn(options.suiteProviders, suiteId)) {
    return true;
  }
  if (!options.globalProviders) {
    return false;
  }
  return MEDIA_SUITES[suiteId].providers.some((provider) => options.globalProviders?.has(provider));
}

export function findSkippedExplicitProviderSelections(
  options: CliOptions,
  plan: SuiteRunPlan[],
): SuiteRunPlan[] {
  return plan.filter(
    (entry) =>
      entry.providers.length === 0 && hasExplicitProviderSelectionForSuite(options, entry.suite.id),
  );
}

async function selectProviders(params: {
  collectProviderApiKeysImpl?: BuildRunPlanDeps["collectProviderApiKeysImpl"];
  suite: MediaSuiteConfig;
  globalProviders: Set<string> | null;
  suiteProviders: Set<string> | undefined;
  requireAuth: boolean;
}): Promise<string[]> {
  const explicit = params.suiteProviders ?? params.globalProviders;
  const candidates = explicit
    ? params.suite.providers
    : (params.suite.defaultProviders ?? params.suite.providers);
  let providers = candidates.filter((provider) => (explicit ? explicit.has(provider) : true));
  if (!params.requireAuth) {
    return providers;
  }
  const providerAuth = await Promise.all(
    providers.map(async (provider) => ({
      provider,
      hasAuth:
        (await (params.collectProviderApiKeysImpl ?? collectProviderApiKeysForLiveMedia)(provider))
          .length > 0,
    })),
  );
  providers = providerAuth.filter((entry) => entry.hasAuth).map((entry) => entry.provider);
  return providers;
}

export async function buildRunPlan(
  options: CliOptions,
  deps: BuildRunPlanDeps = {},
): Promise<SuiteRunPlan[]> {
  const getProviderEnvVarsImpl = deps.getProviderEnvVarsImpl ?? getProviderEnvVarsForLiveMedia;
  const expectedKeys = [
    ...new Set(
      (
        await Promise.all(
          options.suites.flatMap((suiteId) =>
            MEDIA_SUITES[suiteId].providers.map(
              async (provider) => await getProviderEnvVarsImpl(provider),
            ),
          ),
        )
      ).flat(),
    ),
  ];
  if (expectedKeys.length) {
    await (deps.loadShellEnvFallbackImpl ?? loadShellEnvFallbackForLiveMedia)({
      enabled: true,
      env: process.env,
      expectedKeys,
      logger: { warn: (message: string) => console.warn(message) },
    });
  }

  return await Promise.all(
    options.suites.map(async (suiteId) => {
      const suite = MEDIA_SUITES[suiteId];
      const providers = await selectProviders({
        collectProviderApiKeysImpl: deps.collectProviderApiKeysImpl,
        suite,
        globalProviders: options.globalProviders,
        suiteProviders: options.suiteProviders[suiteId],
        requireAuth: options.requireAuth,
      });
      return {
        suite,
        providers,
        ...(providers.length === 0
          ? {
              skippedReason: options.requireAuth
                ? "no providers with usable auth"
                : "no providers selected",
            }
          : {}),
      };
    }),
  );
}

function printHelp(): void {
  console.log(`Media live harness

Usage:
  pnpm test:live:media
  pnpm test:live:media image
  pnpm test:live:media image video --providers openai,google,minimax
  pnpm test:live:media video --video-providers openai,runway --all-providers

Defaults:
  - runs image + music + video
  - auto-loads missing provider env vars from ~/.profile
  - narrows each suite to providers that currently have usable auth
  - skips the slow fal video smoke by default; pass --video-providers fal to run it
  - forwards extra args to scripts/test-live.mjs

Flags:
  --providers <csv>         global provider filter
  --image-providers <csv>   image-suite provider filter
  --music-providers <csv>   music-suite provider filter
  --video-providers <csv>   video-suite provider filter
  --all-providers           do not auto-filter by available auth
  --allow-empty             exit 0 when auth filtering leaves no runnable providers
  --quiet | --no-quiet      passed through to test:live
`);
}

async function runSuite(params: {
  plan: SuiteRunPlan;
  quietArgs: string[];
  passthroughArgs: string[];
}): Promise<number> {
  const { plan } = params;
  if (!plan.providers.length) {
    console.log(
      `[live:media] skip ${plan.suite.id}: ${plan.skippedReason ?? "no providers selected"}`,
    );
    return 0;
  }

  const env = {
    ...process.env,
    [plan.suite.providerEnvVar]: plan.providers.join(","),
  };
  const args = [
    "test:live",
    ...params.quietArgs,
    "--",
    plan.suite.testFile,
    ...params.passthroughArgs,
  ];
  console.log(
    `[live:media] run ${plan.suite.id}: ${plan.suite.testFile} providers=${plan.providers.join(",")}`,
  );

  const child = spawnLivePnpm({ pnpmArgs: args, env });

  return await new Promise<number>((resolve, reject) => {
    child.on("error", reject);
    child.on("exit", (code: number | null, signal: NodeJS.Signals | null) => {
      if (signal) {
        reject(new Error(`${plan.suite.id} exited via signal ${signal}`));
        return;
      }
      resolve(code ?? 1);
    });
  });
}

export async function runCli(argv: string[], deps: RunCliDeps = {}): Promise<number> {
  const options = parseArgs(argv);
  if (options.help) {
    printHelp();
    return 0;
  }
  const plan = await (deps.buildRunPlanImpl ?? buildRunPlan)(options);
  const runnable = plan.filter((entry) => entry.providers.length > 0);
  const skipped = plan.filter((entry) => entry.providers.length === 0);

  for (const entry of skipped) {
    console.log(
      `[live:media] skip ${entry.suite.id}: ${entry.skippedReason ?? "no providers selected"}`,
    );
  }
  const skippedExplicit = findSkippedExplicitProviderSelections(options, plan);
  if (skippedExplicit.length > 0) {
    console.error(
      `[live:media] no runnable providers matched explicit provider selection for: ${skippedExplicit.map((entry) => entry.suite.id).join(", ")}`,
    );
    return 1;
  }
  if (runnable.length === 0) {
    console.log("[live:media] nothing to run");
    if (options.allowEmpty) {
      return 0;
    }
    console.error(
      hasExplicitProviderSelection(options)
        ? "[live:media] no runnable providers matched the explicit provider selection"
        : "[live:media] no runnable providers matched available auth; pass --allow-empty to accept an empty live-media run",
    );
    return 1;
  }

  for (const entry of runnable) {
    const exitCode = await (deps.runSuiteImpl ?? runSuite)({
      plan: entry,
      quietArgs: options.quietArgs,
      passthroughArgs: options.passthroughArgs,
    });
    if (exitCode !== 0) {
      return exitCode;
    }
  }
  return 0;
}

if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
  runCli(process.argv.slice(2))
    .then((code) => process.exit(code))
    .catch((error: unknown) => {
      console.error(formatErrorMessage(error));
      process.exit(1);
    });
}
