Enterprise agent platform for building, deploying, and operating AI teammates.
import React, { useRef, useState } from "react";
import { Sparkles } from "lucide-react";
import {
ChatInput,
type ComposerAttachmentStatus,
type ComposerAutoSendRequest,
} from "@/components/chat/ChatInput";
import type { SessionAttachmentsConfig } from "@/contexts/app-context-chat";
import { useI18n } from "@/contexts/i18n-context";
import { resolveAgentLogoUrl, getApiUrl } from "@/lib/utils";
import { PersonaAvatar } from "@/components/templates/persona-avatar";
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip";
import { useVoiceCallView } from "@/contexts/voice-call-store";
import { VoiceOrb } from "./voice-call-ui";
export interface PromptCard {
icon?: React.ElementType<{ className?: string }>;
title?: string;
description?: string;
prompt: string;
promptHighlights?: string[];
color?: string;
bg?: string;
}
export interface AgentCard {
id: number | string;
name: string;
description?: string | null;
logo_url?: string | null;
status?: string;
readonly?: boolean;
can_edit?: boolean;
// Built-in template id this agent was instantiated from, or null/undefined
// for agents built from scratch. Used to key template-reuse matching off a
// stable id instead of the user-editable display name.
template_id?: string | null;
// The agent's own suggested starting prompts (from its `suggested_prompts`
// config). Read by callers that auto-fill the composer from the first one
// when this agent is picked as the task's lead - not consumed here.
suggested_prompts?: string[];
// A hired agent's persona portrait (resolved by the caller from the
// template it traces back to via `template_id`) - preferred over
// `logo_url` when present, since a hired agent's `logo_url` is never
// actually set to its persona's face today.
persona_avatar?: string | null;
// A short label shown next to the agent's name in the picker row (e.g.
// its template's category) - purely cosmetic, omitted when unknown.
specialty?: string;
}
// A hired agent's persona photo, falling back to a resolved `logo_url` -
// shared by the hero swap and the picker pill so both always agree on
// which photo an agent shows.
function resolveTeammateAvatar(agent: Pick<AgentCard, "persona_avatar" | "logo_url">): string | null {
return agent.persona_avatar || resolveAgentLogoUrl(agent.logo_url ?? null, getApiUrl());
}
type ChatStartScreenProps = {
title: string;
description?: string;
icon?: React.ReactNode | string; // URL string or ReactNode
prompts?: (PromptCard | string)[];
agents?: AgentCard[];
// True when the caller's agent-list fetch failed - shown in place of the
// picker row (which would otherwise look identical to "no published
// agents exist" with no way to recover).
agentsError?: boolean;
onRetryAgents?: () => void;
onAgentClick?: (agent: AgentCard) => void;
selectedAgents?: AgentCard[];
onSend: (message: string, files: File[], config?: React.ComponentProps<typeof ChatInput>["taskConfig"]) => void | Promise<void>;
isSending?: boolean;
inputValue?: string;
onInputChange?: (value: string) => void;
onFocusChange?: (focused: boolean) => void;
onPromptSelect?: (prompt: string, promptHighlights?: string[]) => void;
// A clicked prompt is typed into the composer and sent from it, as if the
// visitor had typed it (see ChatInput's autoSendRequest). `onPromptSelect`
// still takes precedence when both are passed.
sendPromptOnClick?: boolean;
promptHighlightTerms?: string[];
files?: File[];
onFilesChange?: (files: File[]) => void;
showModeToggle?: boolean;
readOnlyConfig?: boolean;
hideConfig?: boolean;
compactInput?: boolean;
deferFileUpload?: boolean;
filesDisabled?: boolean;
// Upload-only mode (see ChatInput): files can be collected although
// `filesDisabled` keeps every file read closed.
attachments?: SessionAttachmentsConfig;
attachmentStatuses?: ReadonlyMap<File, ComposerAttachmentStatus>;
onRetryAttachment?: (file: File) => void;
attachmentsBusy?: boolean;
voiceInputEnabled?: boolean;
onVoiceConversation?: React.ComponentProps<typeof ChatInput>["onVoiceConversation"];
taskConfig?: React.ComponentProps<typeof ChatInput>["taskConfig"];
autoFocus?: boolean;
inputMinHeightClass?: string;
};
export function ChatStartScreen({
title,
description,
icon,
prompts,
agents,
agentsError = false,
onRetryAgents,
onAgentClick,
selectedAgents = [],
onSend,
isSending = false,
inputValue,
onInputChange,
onFocusChange,
onPromptSelect,
sendPromptOnClick = false,
promptHighlightTerms = [],
files = [],
onFilesChange,
showModeToggle = false,
readOnlyConfig = false,
hideConfig = false,
compactInput = false,
deferFileUpload = false,
filesDisabled = false,
attachments,
attachmentStatuses,
onRetryAttachment,
attachmentsBusy = false,
voiceInputEnabled = true,
onVoiceConversation,
taskConfig,
autoFocus = false,
inputMinHeightClass,
}: ChatStartScreenProps) {
const { t } = useI18n();
const filesBlocked = filesDisabled && !attachments;
const enabledFiles = filesBlocked ? [] : files;
const [autoSendRequest, setAutoSendRequest] =
useState<ComposerAutoSendRequest | null>(null);
const nextAutoSendIdRef = useRef(0);
const handlePromptClick = (prompt: string, promptHighlights?: string[]) => {
if (onPromptSelect) {
onPromptSelect(prompt, promptHighlights);
return;
}
if (sendPromptOnClick) {
nextAutoSendIdRef.current += 1;
setAutoSendRequest({ id: nextAutoSendIdRef.current, text: prompt });
return;
}
if (onInputChange) {
onInputChange(prompt);
}
};
// Only meaningful in the "My Team" picker context (`agents` supplied) -
// other callers (an agent's own chat, widget pages) pass `selectedAgents`
// for a different purpose or not at all, so this stays undefined for them
// and the header falls back to the plain title/description below.
const leadAgent = agents && agents.length > 0 ? selectedAgents[0] : undefined;
// During a voice call the greeting gives way to the orb.
const voiceCall = useVoiceCallView();
const voiceHero = Boolean(voiceCall && voiceInputEnabled && onVoiceConversation);
return (
<div className="flex min-h-full flex-col items-center justify-center px-6 py-10 text-center">
{voiceHero && voiceCall ? (
// About the height of the logo and title it replaces, so nothing jumps.
<div className="mb-2 flex h-[92px] items-center justify-center" data-testid="voice-orb-hero">
<VoiceOrb call={voiceCall} className="h-[68px] w-[68px]" />
</div>
) : leadAgent ? (
<div className="w-full max-w-[680px] mx-auto flex items-center gap-4 mb-6 text-left">
<PersonaAvatar
persona={{
name: leadAgent.name,
avatar: resolveTeammateAvatar(leadAgent),
}}
sizeClassName="h-16 w-16"
textClassName="text-xl"
className="rounded-[22px] shrink-0"
/>
<div className="min-w-0">
<h2 className="text-2xl font-bold leading-tight break-words">{title}</h2>
<p className="text-sm text-muted-foreground mt-1 break-words">
{t("chatPage.sections.leadReady", { name: leadAgent.name })}
</p>
</div>
</div>
) : (
<>
{icon && (
<div className="mb-4 grid h-9 min-w-9 place-items-center text-[#2536e0]">
{typeof icon === "string" ? <img src={icon} alt="" className="h-8 w-8 object-contain" /> : icon}
</div>
)}
<h2 className="mb-2 text-[26px] font-bold leading-[1.2] tracking-[-0.025em] text-foreground">
{title}
</h2>
{description && (
<p className="text-[13.5px] text-muted-foreground mb-7 max-w-md leading-[1.7]">{description}</p>
)}
</>
)}
<div className="mx-auto w-full max-w-[700px] space-y-5">
<div>
<ChatInput
onSend={(msg, config) => onSend(msg, enabledFiles, config)}
isLoading={isSending}
files={enabledFiles}
onFilesChange={
filesBlocked ? undefined : (onFilesChange || (() => { }))
}
showModeToggle={showModeToggle}
inputValue={inputValue}
onInputChange={onInputChange}
onFocusChange={onFocusChange}
promptHighlightTerms={promptHighlightTerms}
readOnlyConfig={readOnlyConfig}
hideConfig={hideConfig}
compact={compactInput}
deferFileUpload={deferFileUpload}
filesDisabled={filesDisabled}
attachments={attachments}
attachmentStatuses={attachmentStatuses}
onRetryAttachment={onRetryAttachment}
attachmentsBusy={attachmentsBusy}
voiceInputEnabled={voiceInputEnabled}
onVoiceConversation={onVoiceConversation}
hideFileUpload={filesBlocked}
taskConfig={taskConfig}
autoFocus={autoFocus}
minHeightClass={inputMinHeightClass}
selectedAgents={selectedAgents}
autoSendRequest={autoSendRequest}
/>
</div>
{/* A call is not modal, so keep the teammate strip and prompt cards from
changing what the call will do (or editing the hidden draft). */}
<div
className={voiceHero ? "pointer-events-none space-y-5 opacity-50" : "space-y-5"}
{...(voiceHero ? { inert: true, "aria-hidden": true } : {})}
>
{prompts && prompts.length > 0 && (
<div className={agents ? "flex flex-wrap items-center justify-center gap-2" : "space-y-3"}>
{!agents && (
<div className="flex items-center gap-2 px-1 text-[10.5px] font-semibold uppercase tracking-[0.08em] text-muted-foreground">
<Sparkles className="h-3.5 w-3.5" />
<span>{t("chatPage.sections.startingPrompts")}</span>
</div>
)}
<div className={agents ? "contents" : "grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-3"}>
{prompts.map((item, index) => {
const isString = typeof item === 'string';
const promptText = isString ? item : item.prompt;
if (agents) {
return (
<button
key={index}
type="button"
onClick={() => handlePromptClick(promptText, isString ? undefined : item.promptHighlights)}
className="inline-flex items-center gap-1.5 rounded-full px-3 py-1.5 text-xs font-medium text-muted-foreground transition-colors hover:bg-muted hover:text-[#2536e0]"
>
{!isString && item.icon ? <item.icon className="h-3.5 w-3.5" /> : <Sparkles className="h-3.5 w-3.5" />}
{isString ? promptText : item.title}
</button>
);
}
if (isString) {
return (
<div
key={index}
onClick={() => handlePromptClick(promptText)}
className="group relative p-4 h-28 rounded-xl border border-border bg-card hover:bg-muted/50 cursor-pointer transition-all duration-300 flex flex-col justify-center text-left"
>
<p className="text-sm text-foreground/90 line-clamp-3">{promptText}</p>
</div>
);
}
// Card style for Task Page
return (
<div
key={index}
onClick={() => handlePromptClick(promptText, item.promptHighlights)}
className="group relative px-4 py-3 min-h-[72px] rounded-xl border border-border bg-card hover:bg-muted/50 cursor-pointer transition-all duration-300 flex flex-row items-center text-left gap-4"
>
<div className="flex items-center justify-center shrink-0 h-10 w-10 rounded-lg bg-blue-50 dark:bg-blue-900/20 text-blue-500">
{item.icon && <item.icon className="w-5 h-5" />}
</div>
<h3 className="font-medium text-[14px] text-foreground/90 leading-snug">{item.title}</h3>
</div>
);
})}
</div>
</div>
)}
{agentsError ? (
<div className="flex items-center justify-between gap-3 rounded-xl border border-destructive/30 bg-destructive/[0.04] px-4 py-3 text-left">
<p className="text-xs text-destructive">{t("chatPage.sections.assignToTeammateError")}</p>
<button
type="button"
onClick={onRetryAgents}
className="shrink-0 text-xs font-semibold text-destructive underline underline-offset-2 hover:no-underline"
>
{t("common.retry")}
</button>
</div>
) : agents && agents.length > 0 && (
<div className="space-y-1 text-center">
<p className="text-[11.5px] text-muted-foreground">
<b className="font-medium text-foreground/70">{t("chatPage.sections.assignToTeammateLead")}</b>
<span className="sr-only">{t("chatPage.sections.assignToTeammate")}</span>
</p>
<div
data-testid="team-strip"
role="group"
aria-label={t("chatPage.sections.assignToTeammate")}
tabIndex={0}
className="relative overflow-x-auto"
>
{/* Center short lists without centering overflow off the left edge. */}
<div className="flex w-max min-w-full flex-nowrap items-start justify-center gap-1 p-1">
<TooltipProvider delayDuration={200}>
{agents.map((agent) => {
const isSelected = selectedAgents.some(
(selectedAgent) => selectedAgent.id === agent.id
);
const avatarUrl = resolveTeammateAvatar(agent);
const pill = (
<button
type="button"
aria-pressed={isSelected}
onClick={() => onAgentClick?.(agent)}
className={`flex shrink-0 flex-col items-center gap-1 rounded-2xl border px-2.5 py-2 transition-all ${
isSelected
? "border-[#cfd5fb] bg-[#eef1fe]"
: "border-transparent bg-transparent hover:-translate-y-0.5 hover:bg-muted"
}`}
>
<PersonaAvatar
persona={{ name: agent.name, avatar: avatarUrl }}
sizeClassName="h-[34px] w-[34px]"
textClassName="text-[11px]"
className={isSelected ? "shadow-[0_0_0_2px_hsl(var(--background)),0_0_0_3px_hsl(var(--primary))]" : ""}
decorative
/>
<b className={`max-w-[72px] truncate text-[11.5px] font-medium ${isSelected ? "text-primary" : "text-foreground"}`}>
{agent.name}
</b>
{agent.specialty && <span className="sr-only">{agent.specialty}</span>}
</button>
);
return (
<Tooltip key={agent.id}>
<TooltipTrigger asChild>{pill}</TooltipTrigger>
{agent.description && (
<TooltipContent side="top" className="max-w-[240px] text-left">
<div className="space-y-1">
<div className="font-medium">{agent.name}</div>
<p className="text-xs text-muted-foreground">{agent.description}</p>
</div>
</TooltipContent>
)}
</Tooltip>
);
})}
</TooltipProvider>
</div>
</div>
</div>
)}
</div>
</div>
</div>
);
}