import type { ContextEntry } from "@copilotkit/channels";
import type { PlatformUser } from "@copilotkit/channels-ui";

/**
 * Build the per-turn context naming the requesting user, so the agent can act
 * "as" them (filter Linear by their email, @-mention/tag them). The platform
 * adapter resolves `{ id, name?, email? }` per turn; if it's absent there's
 * nothing to attribute, so we add no entry. `platform` is the surface the turn
 * came from (`thread.platform`), so the label is correct across Slack, Discord,
 * Telegram, and WhatsApp alike.
 */
export function senderContext(
  user: PlatformUser | undefined,
  platform: string,
): ContextEntry[] {
  // `createBot` substitutes `{ id: "" }` for an unresolved sender (a truthy
  // object), so guard on a usable id — not mere object presence — otherwise we
  // emit a "Requesting <platform> user (... id )" entry with nothing to attribute.
  if (!user?.id) return [];
  const label = `${user.name ?? user.id}${user.email ? ` <${user.email}>` : ""} (${platform} id ${user.id})`;
  return [{ description: `Requesting ${platform} user`, value: label }];
}