Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

20.9 KB
Raw Blame
'use client';

import { useState, type ReactNode } from 'react';

import { Icon } from '../../icons/Icon.js';
import type { AgentSkill, AgentSpec, ModelSelection } from '../../server/types.js';
import { useSlot } from '../../theme/SlotsProvider.js';
import { auiButtonClass } from '../lib/buttonClasses.js';
import { cn } from '../lib/cn.js';
import { ResponsiveDropdownMenu } from '../primitives/ResponsiveDropdownMenu.js';
import { Tooltip } from '../primitives/Tooltip.js';
import type { AgentConfigEditor } from './AgentConfigEditors.js';
import { initialUserMessagesFromSpec } from './agentConfigMessages.js';
import {
  editableMountsFromSpec,
  enabledToolsFromMount,
  preloadFromMount,
  withPreload,
  type EditableMount,
} from './agentConfigMounts.js';
import { displayModelLabel, ProviderMark } from './DraftModelCatalogPanel.js';
import { modelParamSummary } from './modelParamsSummary.js';
import { runtimeConfigSummary, runtimeConfigValueClassName } from './runtimeConfigSummary.js';
import { skillFamilyId, skillVersion } from './SkillVersionSelector.js';

const DEFAULT_INSTRUCTIONS =
  'Enter detailed instructions for your agent. E.g. You are a helpful assistant that helps users plan trips. Always ask clarifying questions before making suggestions...';

export type AgentConfigPanelProps = {
  spec: AgentSpec;
  model?: ModelSelection;
  models: ModelSelection[];
  modelsLoading: boolean;
  modelsError: string | null;
  skills?: AgentSkill[];
  skillsAvailable: boolean;
  webSearchAvailable?: boolean;
  instructions: string;
  onOpenEditor: (editor: AgentConfigEditor) => void;
  onChange?: (spec: AgentSpec) => void;
  onClose?: () => void;
  disabled?: boolean;
};

function formatTokens(value: number): string {
  return Intl.NumberFormat('en', { notation: 'compact', maximumFractionDigits: 1 }).format(value);
}

function McpServerChip({
  item,
  onRemove,
  onTogglePreload,
}: {
  item: EditableMount;
  onRemove?: () => void;
  onTogglePreload?: () => void;
}) {
  const enabled = enabledToolsFromMount(item.value);
  const preload = preloadFromMount(item.value);
  const toolsLabel = enabled === 'all' ? 'All tools' : `${enabled.length} tools`;

  return (
    <span className="flex items-center overflow-hidden rounded-md border border-border text-xs">
      {onTogglePreload ? (
        <Tooltip
          side="bottom"
          dismissOnClick={false}
          triggerClassName="self-stretch"
          className="w-64 whitespace-normal p-3 text-left shadow-lg"
          content={
            <span className="flex flex-col gap-1.5">
              <span className="flex items-center justify-between gap-3">
                <span className="font-semibold">Preload tools</span>
                <span className="text-primary-button-bg text-[0.625rem] font-semibold tracking-wide uppercase">
                  {preload ? 'ON' : 'OFF'}
                </span>
              </span>
              <span className="text-text-secondary text-xs leading-snug">
                Load MCP tool definitions in the agent context upfront. When off, the agent discovers tools dynamically
                (uses less context upfront).
              </span>
            </span>
          }
        >
          <button
            type="button"
            aria-pressed={preload}
            aria-label={`Preload tools for ${item.name}`}
            className={cn(
              'flex h-full items-center justify-center border-r border-border px-1.5 transition-colors',
              preload
                ? 'bg-primary-button-bg text-primary-button-text'
                : 'text-text-secondary hover:bg-ghost-button-hover',
            )}
            onClick={event => {
              event.stopPropagation();
              onTogglePreload();
            }}
          >
            <Icon name="book-open" className="size-3.5" />
          </button>
        </Tooltip>
      ) : null}
      <span className="py-1 pl-2">{item.name}</span>
      <span className="text-text-secondary ml-1 py-1">{toolsLabel}</span>
      {onRemove ? (
        <button
          type="button"
          aria-label={`Remove ${item.name}`}
          className={auiButtonClass({
            variant: 'ghost',
            size: 'icon',
            className: 'mx-1 size-5',
          })}
          onClick={event => {
            event.stopPropagation();
            onRemove();
          }}
        >
          <Icon name="xmark" className="size-3" />
        </button>
      ) : (
        <span className="pr-2" />
      )}
    </span>
  );
}

function SkillChip({
  item,
  preloadAvailable,
  onRemove,
  onTogglePreload,
}: {
  item: EditableMount;
  preloadAvailable: boolean;
  onRemove?: () => void;
  onTogglePreload?: () => void;
}) {
  const preload = preloadFromMount(item.value);

  return (
    <span className="flex items-center overflow-hidden rounded-md border border-border text-xs">
      {preloadAvailable && onTogglePreload ? (
        <Tooltip
          side="bottom"
          dismissOnClick={false}
          triggerClassName="self-stretch"
          className="w-64 whitespace-normal p-3 text-left shadow-lg"
          content={
            <span className="flex flex-col gap-1.5">
              <span className="flex items-center justify-between gap-3">
                <span className="font-semibold">Preload skill</span>
                <span className="text-primary-button-bg text-[0.625rem] font-semibold tracking-wide uppercase">
                  {preload ? 'ON' : 'OFF'}
                </span>
              </span>
              <span className="text-text-secondary text-xs leading-snug">
                Inline SKILL.md in the agent context upfront. When off, the agent loads the skill dynamically.
              </span>
            </span>
          }
        >
          <button
            type="button"
            aria-pressed={preload}
            aria-label={`Preload skill ${item.name}`}
            className={cn(
              'flex h-full items-center justify-center border-r border-border px-1.5 transition-colors',
              preload
                ? 'bg-primary-button-bg text-primary-button-text'
                : 'text-text-secondary hover:bg-ghost-button-hover',
            )}
            onClick={event => {
              event.stopPropagation();
              onTogglePreload();
            }}
          >
            <Icon name="book-open" className="size-3.5" />
          </button>
        </Tooltip>
      ) : null}
      <span className="py-1 pl-2">{item.name}</span>
      {onRemove ? (
        <button
          type="button"
          aria-label={`Remove ${item.name}`}
          className={auiButtonClass({
            variant: 'ghost',
            size: 'icon',
            className: 'mx-1 size-5',
          })}
          onClick={event => {
            event.stopPropagation();
            onRemove();
          }}
        >
          <Icon name="xmark" className="size-3" />
        </button>
      ) : (
        <span className="pr-2" />
      )}
    </span>
  );
}

export function AgentConfigSection({
  title,
  description,
  icon,
  actionIcon = 'pencil',
  actionLabel,
  onEdit,
  children,
}: {
  title?: string;
  description?: string;
  icon?: string;
  actionIcon?: string;
  actionLabel?: string;
  onEdit?: () => void;
  children?: ReactNode;
}) {
  const action = actionLabel ?? `Edit ${title}`;

  return (
    <section
      className={cn('group border-b border-border px-4 py-4', onEdit ? 'cursor-pointer' : null)}
      role={onEdit ? 'button' : undefined}
      tabIndex={onEdit ? 0 : undefined}
      onClick={onEdit}
      // Enter/Space activate the block like a native button. Keys aimed at nested
      // controls must pass through, or preventDefault here cancels their activation.
      onKeyDown={
        onEdit
          ? event => {
              if (event.target !== event.currentTarget) return;
              if (event.key !== 'Enter' && event.key !== ' ') return;
              event.preventDefault();
              onEdit();
            }
          : undefined
      }
    >
      {title && (
        <div className={cn('flex items-start justify-between gap-3', children ? 'mb-3' : null)}>
          <div className="flex min-w-0 items-start gap-2">
            {icon ? <Icon name={icon} className="text-text-secondary mt-0.5 size-4 shrink-0" /> : null}
            <div className="min-w-0">
              <h3 className="text-text-primary text-sm font-semibold">{title}</h3>
              {description ? <p className="text-text-secondary mt-0.5 text-xs">{description}</p> : null}
            </div>
          </div>
          {onEdit ? (
            <button
              type="button"
              aria-label={action}
              title={action}
              className={auiButtonClass({
                variant: 'ghost',
                size: 'icon',
                className: 'size-7 opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100',
              })}
              onClick={event => {
                event.stopPropagation();
                onEdit();
              }}
            >
              <Icon name={actionIcon} className="size-3.5" />
            </button>
          ) : null}
        </div>
      )}
      {children}
    </section>
  );
}

export function AgentConfigPanel({
  spec,
  model,
  models,
  modelsLoading,
  modelsError,
  skills: catalogSkills = [],
  skillsAvailable,
  webSearchAvailable = false,
  instructions,
  onOpenEditor,
  onChange,
  onClose,
  disabled = false,
}: AgentConfigPanelProps) {
  const Section = useSlot('AgentConfigSection');
  const AgentModelEditorContent = useSlot('AgentModelEditorContent');
  const AgentModelSettingsContent = useSlot('AgentModelSettingsContent');
  const [modelMenuOpen, setModelMenuOpen] = useState(false);
  const [modelSettingsMenuOpen, setModelSettingsMenuOpen] = useState(false);
  const [modelQuery, setModelQuery] = useState('');
  const mcp = editableMountsFromSpec(spec.mcpServers);
  const skillMounts = editableMountsFromSpec(spec.skills);
  const modelParams = modelParamSummary(spec.model.params);
  const runtimeConfig = runtimeConfigSummary(spec.config, { webSearchAvailable });
  const instructionPreview = instructions.trim();
  const userMessageCount = initialUserMessagesFromSpec(spec).length;
  const modelInfo = [
    model?.properties.contextLength === undefined ? null : formatTokens(model.properties.contextLength),
  ].filter((value): value is string => value !== null);
  const modelInfoTitle = [
    model?.properties.contextLength === undefined
      ? null
      : `Context: ${model.properties.contextLength.toLocaleString()} tokens`,
    model?.properties.maxOutputTokens === undefined
      ? null
      : `Maximum output: ${model.properties.maxOutputTokens.toLocaleString()} tokens`,
  ]
    .filter((value): value is string => value !== null)
    .join('\n');

  return (
    <div className="bg-card-bg text-text-primary flex h-full min-h-0 flex-col">
      <header className="flex min-h-14 shrink-0 items-center gap-1 border-b border-border bg-topbar-bg px-3 py-1.5">
        <Icon name="sliders" className="size-4" />
        <h2 className="text-sm font-semibold">Agent Config</h2>
        <span className="min-w-0 flex-1" />
        {onClose ? (
          <button
            type="button"
            aria-label="Close agent config"
            className={auiButtonClass({ variant: 'ghost', size: 'icon', className: 'size-8' })}
            onClick={onClose}
          >
            <Icon name="xmark" />
          </button>
        ) : null}
      </header>
      <div className="min-h-0 flex-1 overflow-y-auto">
        <Section>
          <div className="flex w-full items-center gap-1">
            <ResponsiveDropdownMenu
              open={modelMenuOpen}
              onOpenChange={open => {
                setModelMenuOpen(open);
                if (!open) setModelQuery('');
              }}
              closeOnClick={false}
              align="start"
              sheetLabel="Select model"
              containerClassName="flex min-w-0 flex-1"
              className="w-[min(44rem,calc(100vw-2rem))] overflow-hidden p-0"
              trigger={
                <button
                  type="button"
                  aria-label="Edit Model"
                  title="Edit Model"
                  disabled={disabled}
                  className="flex w-full cursor-pointer items-center gap-2 rounded-md py-1 text-left transition-colors"
                >
                  <ProviderMark
                    logo={model?.provider.logo}
                    label={model?.provider.name ?? spec.model.name}
                    className="size-4 text-[0.5rem]"
                  />
                  <span className="min-w-0 flex-1 truncate text-sm font-medium">
                    {displayModelLabel(spec.model.name)}
                  </span>
                  {modelInfo.length ? (
                    <span
                      title={modelInfoTitle}
                      className="text-text-secondary shrink-0 whitespace-nowrap text-[0.6875rem]"
                    >
                      {modelInfo.join(' · ')}
                    </span>
                  ) : null}
                  <Icon name="chevrons-up-down" className="text-text-secondary size-3.5 shrink-0" />
                </button>
              }
            >
              <AgentModelEditorContent
                spec={spec}
                models={models}
                loading={modelsLoading}
                error={modelsError}
                query={modelQuery}
                onQueryChange={setModelQuery}
                onChange={next => {
                  onChange?.(next);
                  setModelMenuOpen(false);
                  setModelQuery('');
                }}
              />
            </ResponsiveDropdownMenu>
            <ResponsiveDropdownMenu
              open={modelSettingsMenuOpen}
              onOpenChange={setModelSettingsMenuOpen}
              closeOnClick={false}
              align="start"
              sheetLabel="Model settings"
              className="w-[min(36rem,calc(100vw-2rem))] overflow-hidden p-0"
              trigger={
                <button
                  type="button"
                  aria-label="Model settings"
                  title="Model settings"
                  disabled={disabled}
                  className={auiButtonClass({
                    variant: 'ghost',
                    size: 'icon',
                    className: 'size-7 shrink-0',
                  })}
                >
                  <Icon name="sliders" className="size-3.5" />
                </button>
              }
            >
              <AgentModelSettingsContent spec={spec} model={model} onChange={next => onChange?.(next)} />
            </ResponsiveDropdownMenu>
          </div>
          <button
            type="button"
            disabled={disabled}
            aria-label="Edit model settings"
            // DropdownMenu dismisses on document mousedown; stop it so click can toggle closed without reopen.
            onMouseDown={event => event.stopPropagation()}
            onClick={() => setModelSettingsMenuOpen(open => !open)}
            className="mt-2 flex w-full cursor-pointer flex-col text-left disabled:cursor-not-allowed disabled:opacity-50"
          >
            <dl className="text-text-secondary flex min-w-0 flex-wrap gap-x-3 gap-y-1 text-xs">
              {modelParams.length ? (
                modelParams.map(entry => (
                  <div key={entry.label} className="flex gap-1">
                    <dt>{entry.label}:</dt>
                    <dd className="text-text-primary font-medium">{entry.value}</dd>
                  </div>
                ))
              ) : (
                <div>model settings: defaults</div>
              )}
            </dl>
          </button>
        </Section>

        <Section title="Instructions" description="Define the agent's role, goals, and behavior.">
          <button
            type="button"
            aria-label="Edit Instructions"
            disabled={disabled}
            className="border-border hover:bg-ghost-button-hover flex w-full items-center gap-3 rounded-lg border p-3 text-left transition-colors"
            onClick={() => onOpenEditor('instructions')}
          >
            <div className="min-w-0 flex-1">
              <p
                className={cn(
                  'line-clamp-3 whitespace-pre-wrap text-sm',
                  instructionPreview ? 'text-text-primary' : 'text-text-secondary',
                )}
              >
                {instructionPreview || DEFAULT_INSTRUCTIONS}
              </p>
              {userMessageCount > 0 ? (
                <p className="text-text-secondary mt-2 text-xs">
                  {userMessageCount} user {userMessageCount === 1 ? 'message' : 'messages'}
                </p>
              ) : null}
            </div>
            <Icon name="chevron-right" className="text-text-secondary size-4 shrink-0" />
          </button>
        </Section>

        <Section
          title="Runtime Config"
          description="Control execution and context behavior."
          actionIcon="sliders"
          onEdit={disabled ? undefined : () => onOpenEditor('runtime')}
        >
          <dl className="text-text-secondary flex flex-wrap gap-x-3 gap-y-1 text-xs leading-relaxed">
            {runtimeConfig.map(entry => (
              <div key={entry.label} className="flex gap-1">
                <dt>{entry.label}:</dt>
                <dd className={runtimeConfigValueClassName(entry.value)}>{entry.value}</dd>
              </div>
            ))}
          </dl>
        </Section>

        <Section
          title="MCP Servers"
          icon="mcp-server"
          actionIcon="plus"
          actionLabel="Add MCP server"
          onEdit={disabled ? undefined : () => onOpenEditor('mcp')}
        >
          {mcp.length ? (
            <div className="flex flex-wrap gap-1.5">
              {mcp.map(item => (
                <McpServerChip
                  key={item.id}
                  item={item}
                  onRemove={
                    onChange && !disabled
                      ? () =>
                          onChange({
                            ...spec,
                            mcpServers: mcp.filter(mount => mount.id !== item.id).map(mount => mount.value),
                          })
                      : undefined
                  }
                  onTogglePreload={
                    onChange && !disabled
                      ? () =>
                          onChange({
                            ...spec,
                            mcpServers: mcp.map(mount =>
                              mount.id === item.id
                                ? withPreload(mount.value, !preloadFromMount(mount.value))
                                : mount.value,
                            ),
                          })
                      : undefined
                  }
                />
              ))}
            </div>
          ) : null}
        </Section>

        <Section
          title="Skills"
          icon="lightbulb"
          actionIcon="plus"
          actionLabel="Add skill"
          onEdit={disabled ? undefined : () => onOpenEditor('skills')}
        >
          {!skillsAvailable ? (
            <p className="text-text-secondary text-xs">Skills require an available sandbox.</p>
          ) : skillMounts.length ? (
            <div className="flex flex-wrap gap-1.5">
              {skillMounts.map(item => {
                const preloadAvailable = catalogSkills.some(
                  skill => skillVersion(skill) !== undefined && skillFamilyId(skill.id) === skillFamilyId(item.id),
                );
                return (
                  <SkillChip
                    key={item.id}
                    item={item}
                    preloadAvailable={preloadAvailable}
                    onRemove={
                      onChange && !disabled
                        ? () =>
                            onChange({
                              ...spec,
                              skills: skillMounts.filter(mount => mount.id !== item.id).map(mount => mount.value),
                            })
                        : undefined
                    }
                    onTogglePreload={
                      preloadAvailable && onChange && !disabled
                        ? () =>
                            onChange({
                              ...spec,
                              skills: skillMounts.map(mount =>
                                mount.id === item.id
                                  ? withPreload(mount.value, !preloadFromMount(mount.value))
                                  : mount.value,
                              ),
                            })
                        : undefined
                    }
                  />
                );
              })}
            </div>
          ) : (
            <p className="text-text-secondary text-xs">No skills selected.</p>
          )}
        </Section>
      </div>
    </div>
  );
}

declare module '../../theme/SlotsProvider.js' {
  interface AtomSlots {
    AgentConfigPanel: typeof AgentConfigPanel;
    AgentConfigSection: typeof AgentConfigSection;
  }
}