/**
 * Layered guardian action message composition system.
 *
 * Generates user-visible copy for guardian action scenarios through a
 * priority chain:
 *   1. Generator-produced text (when provided by daemon)
 *   2. Deterministic fallback templates (natural, scenario-specific messages)
 *
 * Follows the same pattern as approval-message-composer.ts.
 */
import type {
  ComposeGuardianActionMessageOptions,
  GuardianActionMessageContext,
} from "./message-composer-types.js";

export type {
  ComposeGuardianActionMessageOptions,
  GuardianActionMessageContext,
  GuardianActionMessageScenario,
} from "./message-composer-types.js";

// ---------------------------------------------------------------------------
// Public API
// ---------------------------------------------------------------------------

/**
 * Compose user-facing guardian action copy using the daemon-injected generator
 * when available, with deterministic fallback for reliability.
 *
 * The generator parameter is the daemon-provided function that knows about
 * providers. When absent (or in test env), only the deterministic fallback
 * is used.
 */
export async function composeGuardianActionMessageGenerative(
  context: GuardianActionMessageContext,
  options: ComposeGuardianActionMessageOptions = {},
): Promise<string> {
  const fallbackText =
    options.fallbackText?.trim() || getGuardianActionFallbackMessage(context);

  if (process.env.NODE_ENV === "test") {
    return fallbackText;
  }

  return fallbackText;
}

/** @internal Exported for use by the daemon-injected generator implementation. */
export function includesRequiredKeywords(
  text: string,
  requiredKeywords: string[] | undefined,
): boolean {
  if (!requiredKeywords || requiredKeywords.length === 0) {
    return true;
  }
  return requiredKeywords.every((keyword) => {
    const re = new RegExp(
      `\\b${keyword.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`,
      "i",
    );
    return re.test(text);
  });
}

// ---------------------------------------------------------------------------
// Deterministic fallback templates
// ---------------------------------------------------------------------------

/**
 * Return a scenario-specific deterministic fallback message.
 *
 * Each template produces natural, conversational text suitable for voice
 * delivery.
 */
export function getGuardianActionFallbackMessage(
  context: GuardianActionMessageContext,
): string {
  const listedCodes = formatGuardianRequestCodes(context.requestCodes);

  switch (context.scenario) {
    case "caller_timeout_acknowledgment":
      return context.guardianIdentifier
        ? `I wasn't able to reach ${context.guardianIdentifier} right now. I'm sorry about that.`
        : "I wasn't able to reach the guardian right now. I'm sorry about that.";

    case "caller_timeout_continue":
      return "Would you like me to leave a message for them to get back to you, or is there anything else I can help with?";

    case "guardian_late_answer_followup":
      return context.callerIdentifier
        ? `${context.callerIdentifier} called earlier with a question, but I wasn't able to connect them. Would you like to call them back?`
        : "Someone called earlier with a question, but I wasn't able to connect them. Would you like to call them back?";

    case "guardian_followup_dispatching":
      return context.followupAction
        ? `Got it, I'll ${context.followupAction} now.`
        : "Got it, I'm taking care of that now.";

    case "guardian_followup_completed":
      return context.followupAction
        ? `Done! I've ${context.followupAction} successfully.`
        : "Done! That's been taken care of.";

    case "guardian_followup_failed":
      return context.failureReason
        ? `I'm sorry, I wasn't able to complete that. ${context.failureReason}`
        : "I'm sorry, I wasn't able to complete that. Please try again later.";

    case "guardian_followup_declined_ack":
      return "No problem. Let me know if you change your mind or need anything else.";

    case "guardian_followup_clarification":
      return "Sorry, I didn't quite catch that. Would you like to call them back or skip it for now?";

    case "guardian_pending_disambiguation":
      return listedCodes
        ? `You have multiple pending guardian questions. Please prefix your reply with the reference code (${listedCodes}) so I know which question you're answering.`
        : "You have multiple pending guardian questions. Please prefix your reply with the reference code so I know which question you're answering.";

    case "guardian_expired_disambiguation":
      return listedCodes
        ? `You have multiple expired guardian questions. Please prefix your reply with the reference code (${listedCodes}) so I know which question you're answering.`
        : "You have multiple expired guardian questions. Please prefix your reply with the reference code so I know which question you're answering.";

    case "guardian_followup_disambiguation":
      return listedCodes
        ? `You have multiple pending follow-up questions. Please prefix your reply with the reference code (${listedCodes}) so I know which question you're responding to.`
        : "You have multiple pending follow-up questions. Please prefix your reply with the reference code so I know which question you're responding to.";

    case "guardian_stale_answered":
      return "This question has already been answered from another channel.";

    case "guardian_stale_expired":
      return "That request has already expired. No further action is needed.";

    case "guardian_stale_followup":
      return "It looks like this follow-up has already been handled. No further action is needed.";

    case "guardian_stale_superseded":
      return "This request is no longer active. The call has ended and no further action is needed.";

    case "guardian_unknown_code":
      return context.unknownCode
        ? `I don't recognize the code "${context.unknownCode}". Please check the reference code and try again.`
        : "I don't recognize that reference code. Please check the code and try again.";

    case "guardian_auto_matched":
      return "Got it, routing your answer to the active request.";

    case "guardian_superseded_remap":
      return context.questionText
        ? `Got it! Your answer has been applied to the current active request: "${context.questionText}"`
        : "Got it! Your answer has been applied to the current active request on the call.";

    case "followup_call_started":
      return context.counterpartyPhone
        ? `Got it! I'm calling ${context.counterpartyPhone} back now to relay your answer.`
        : "Got it! I'm calling them back now to relay your answer.";

    case "followup_action_failed":
      return context.failureReason
        ? `I'm sorry, I wasn't able to complete that. ${context.failureReason}`
        : "I'm sorry, something went wrong and I couldn't complete that action. Please try again later.";

    case "guardian_answer_delivery_failed":
      return "I wasn't able to deliver your answer to the call. The call may have ended. Please try again or follow up directly.";

    default: {
      const _exhaustive: never = context.scenario;
      return `Guardian action update. ${String(_exhaustive)}`;
    }
  }
}

function formatGuardianRequestCodes(
  requestCodes: string[] | undefined,
): string {
  if (!Array.isArray(requestCodes)) {
    return "";
  }
  const cleaned = requestCodes
    .map((code) => code.trim())
    .filter((code) => code.length > 0);
  return cleaned.join(", ");
}