reverse-engineering-anything/src/application/SetupClients.ts

import type {
  ClientConfigurationResult,
  SetupClient,
  SetupHost,
} from "./Setup.js";

const failedConfigurationMessage = (
  reason: "path" | "backup" | "write" | "readback",
): string => {
  if (reason === "path")
    return "Agent configuration path could not be safely verified. Check its permissions and, if it is a symbolic link, verify that the link resolves to a regular file owned by the current user, then rerun setup.";
  if (reason === "backup")
    return "Agent configuration could not be backed up, so no change was made. Check file permissions, then rerun setup.";
  if (reason === "write")
    return "Agent configuration could not be updated. Check file permissions, then rerun setup.";
  return "Agent configuration could not be verified after writing. Repair the configuration file or restore its `.rea.backup`, then rerun setup.";
};

/** Configure each detected agent, stopping after the first failed transaction. */
export const configureDetectedClients = async (options: {
  readonly host: SetupHost;
  readonly detectedClients: readonly SetupClient[];
  readonly hopperPath: string | undefined;
  readonly command: readonly string[];
  readonly clients: Record<string, ClientConfigurationResult>;
  readonly appliedActions: string[];
}): Promise<string | undefined> => {
  for (const client of options.detectedClients) {
    const result = await options.host.configureClient(
      client,
      options.hopperPath,
      options.command,
    );
    options.clients[client.name] = result;
    if (result.status === "failed")
      return failedConfigurationMessage(result.reason);
    if (result.status === "configured")
      options.appliedActions.push(`configured_${client.name}`);
  }
  return undefined;
};