@data-club/ai-hub 0.0.4 → 0.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@data-club/ai-hub",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "React package for the data-club ai-hub: chat UI, login + change-password, admin UI, AIHub.* primitives, defineWebComponent helper, client SDK. See docs/SPECIFICATIONS.md §7.",
   "license": "UNLICENSED",
   "type": "module",

package/src/auth/locales/cs.ts

@@ -340,6 +340,12 @@ export const csTexts: AIHubTexts = {
     rotatingModalCreateButton: "Vytvořit",
     rotatingModalSaveButton: "Uložit",
     rotatingModalSubmittingButton: "Ukládání…",
+    rotatingDisplaySectionLabel: "Zobrazené části výstupu",
+    rotatingDisplayHelper:
+      "Vyberte, které části připravené odpovědi agenta uživatelé uvidí. Skryté části se z Letty nemažou — jsou jen skryté v ai-hubu.",
+    rotatingDisplayNormalAlways: "Běžný výstup (vždy zobrazen)",
+    rotatingDisplayReasoning: "Uvažování (thinking)",
+    rotatingDisplayToolCalls: "Volání nástrojů",
     /* Sessions overview. */
     sessionsOverviewHeading: "Konverzace",
     sessionsOverviewSearchPlaceholder: "Hledat v názvech…",
@@ -425,6 +431,15 @@ export const csTexts: AIHubTexts = {
     settingsLanguageLockedHelper:
       "Když je zapnuto, přepínač jazyka je skrytý a všichni uživatelé vidí výchozí jazyk. Když je vypnuto, uživatelé si mohou zvolit vlastní jazyk a jejich volba se zapamatuje na jejich zařízení.",
     settingsSaveLanguageButton: "Uložit jazyk",
+    settingsAgentsSectionHeading: "Agenti",
+    settingsAgentsDefaultLabel: "Výchozí agent",
+    settingsAgentsDefaultNone: "Žádný — zobrazit seznam agentů",
+    settingsAgentsDefaultHelper:
+      "Když je nastaven, uživatelům se rovnou otevře tento agent místo výběru. Prostředí s jediným agentem vždy otevře tohoto jednoho agenta bez ohledu na toto nastavení.",
+    settingsAgentsSwitcherEnabledLabel: "Povolit uživatelům přepínat agenty",
+    settingsAgentsSwitcherEnabledHelper:
+      "Když je vypnuto, odkaz „← Agenti“ je skrytý a uživatelé zůstanou u svého agenta. Skrytý je také vždy, když existuje jen jeden agent.",
+    settingsSaveAgentsButton: "Uložit agenty",
     settingsTogglesSectionHeading: "Přepínače funkcí UI",
     settingsTogglesGroupSessions: "Panel konverzací",
     settingsTogglesGroupInput: "Vstup",

package/src/auth/locales/sk.ts

@@ -340,6 +340,12 @@ export const skTexts: AIHubTexts = {
     rotatingModalCreateButton: "Vytvoriť",
     rotatingModalSaveButton: "Uložiť",
     rotatingModalSubmittingButton: "Ukladanie…",
+    rotatingDisplaySectionLabel: "Zobrazené časti výstupu",
+    rotatingDisplayHelper:
+      "Vyberte, ktoré časti pripravenej odpovede agenta používatelia uvidia. Skryté časti sa z Letty nemažú — sú len skryté v ai-hube.",
+    rotatingDisplayNormalAlways: "Bežný výstup (vždy zobrazený)",
+    rotatingDisplayReasoning: "Uvažovanie (thinking)",
+    rotatingDisplayToolCalls: "Volania nástrojov",
     /* Sessions overview. */
     sessionsOverviewHeading: "Konverzácie",
     sessionsOverviewSearchPlaceholder: "Hľadať v názvoch…",
@@ -425,6 +431,15 @@ export const skTexts: AIHubTexts = {
     settingsLanguageLockedHelper:
       "Keď je zapnuté, prepínač jazyka je skrytý a všetci používatelia vidia predvolený jazyk. Keď je vypnuté, používatelia si môžu zvoliť vlastný jazyk a ich voľba sa zapamätá na ich zariadení.",
     settingsSaveLanguageButton: "Uložiť jazyk",
+    settingsAgentsSectionHeading: "Agenti",
+    settingsAgentsDefaultLabel: "Predvolený agent",
+    settingsAgentsDefaultNone: "Žiadny — zobraziť zoznam agentov",
+    settingsAgentsDefaultHelper:
+      "Keď je nastavený, používateľom sa rovno otvorí tento agent namiesto výberu. Prostredie s jediným agentom vždy otvorí tohto jedného agenta bez ohľadu na toto nastavenie.",
+    settingsAgentsSwitcherEnabledLabel: "Povoliť používateľom prepínať agentov",
+    settingsAgentsSwitcherEnabledHelper:
+      "Keď je vypnuté, odkaz „← Agenti“ je skrytý a používatelia zostanú pri svojom agentovi. Skrytý je tiež vždy, keď existuje iba jeden agent.",
+    settingsSaveAgentsButton: "Uložiť agentov",
     settingsTogglesSectionHeading: "Prepínače funkcií UI",
     settingsTogglesGroupSessions: "Panel konverzácií",
     settingsTogglesGroupInput: "Vstup",

package/src/auth/texts.ts

@@ -688,6 +688,16 @@ export interface AIHubAdminTexts {
   rotatingModalSaveButton: string;
   /** In-flight submit button label. */
   rotatingModalSubmittingButton: string;
+  /** Heading for the "which output parts to display" group in the editor. */
+  rotatingDisplaySectionLabel: string;
+  /** Helper under the group — explains hide-not-delete. */
+  rotatingDisplayHelper: string;
+  /** Always-on row label for normal assistant text. */
+  rotatingDisplayNormalAlways: string;
+  /** Toggle label — show the agent's reasoning / thinking. */
+  rotatingDisplayReasoning: string;
+  /** Toggle label — show tool calls. */
+  rotatingDisplayToolCalls: string;
 
   /* ── Step 12 — Sessions overview ([07-admin-sessions-overview.md]) ─ */
   /** Page heading. */
@@ -814,6 +824,16 @@ export interface AIHubAdminTexts {
   settingsLanguageLockedHelper: string;
   settingsSaveLanguageButton: string;
 
+  /* Agents section. */
+  settingsAgentsSectionHeading: string;
+  settingsAgentsDefaultLabel: string;
+  /** First `<option>` — no default agent (show the picker). */
+  settingsAgentsDefaultNone: string;
+  settingsAgentsDefaultHelper: string;
+  settingsAgentsSwitcherEnabledLabel: string;
+  settingsAgentsSwitcherEnabledHelper: string;
+  settingsSaveAgentsButton: string;
+
   /* Feature toggles section. */
   settingsTogglesSectionHeading: string;
   settingsTogglesGroupSessions: string;
@@ -1194,6 +1214,12 @@ export const defaultAIHubTexts: AIHubTexts = Object.freeze({
     rotatingModalCreateButton: "Create",
     rotatingModalSaveButton: "Save",
     rotatingModalSubmittingButton: "Saving…",
+    rotatingDisplaySectionLabel: "Displayed output parts",
+    rotatingDisplayHelper:
+      "Choose which parts of the agent's prepared reply users see. Hidden parts are not deleted from Letta — only hidden in ai-hub.",
+    rotatingDisplayNormalAlways: "Normal output (always shown)",
+    rotatingDisplayReasoning: "Thinking (reasoning)",
+    rotatingDisplayToolCalls: "Tool calls",
     /* Step 12 — Sessions overview. */
     sessionsOverviewHeading: "Sessions",
     sessionsOverviewSearchPlaceholder: "Search titles…",
@@ -1280,6 +1306,15 @@ export const defaultAIHubTexts: AIHubTexts = Object.freeze({
     settingsLanguageLockedHelper:
       "When on, the language switcher is hidden and every user sees the default language. When off, users can pick their own language and their choice is remembered on their device.",
     settingsSaveLanguageButton: "Save language",
+    settingsAgentsSectionHeading: "Agents",
+    settingsAgentsDefaultLabel: "Default agent",
+    settingsAgentsDefaultNone: "No default — show the agent list",
+    settingsAgentsDefaultHelper:
+      "When set, users open straight into this agent instead of the picker. A deployment with a single agent always opens that one regardless of this setting.",
+    settingsAgentsSwitcherEnabledLabel: "Allow users to switch agents",
+    settingsAgentsSwitcherEnabledHelper:
+      "When off, the “← Agents” back link is hidden so users stay on their agent. It is also hidden whenever only one agent exists.",
+    settingsSaveAgentsButton: "Save agents",
     settingsTogglesSectionHeading: "UI feature toggles",
     settingsTogglesGroupSessions: "Sessions panel",
     settingsTogglesGroupInput: "Input",

package/src/client/AIHubClient.ts

@@ -428,6 +428,14 @@ export interface AdminRotatingMessageView {
   next_rotation_at: string;
   /** Soft-hide flag. */
   is_archived: boolean;
+  /**
+   * Whether the agent's reasoning is shown in the seeded opening of sessions
+   * forked from this rotating message. When false, ai-hub hides it at display
+   * time (not deleted from Letta). Normal assistant text is always shown.
+   */
+  reasoning_visible: boolean;
+  /** Same, for the seeded opening's tool calls. */
+  tool_calls_visible: boolean;
   /** ISO-8601 timestamp. */
   created_at: string;
   /** ISO-8601 timestamp. */
@@ -446,6 +454,10 @@ export interface CreateAdminRotatingMessageBody {
   dailyTime?: string | null;
   /** Required when `scheduleKind === "cron"` (5-field cron). */
   cronExpression?: string | null;
+  /** Show reasoning in the seeded opening. Defaults to true server-side. */
+  reasoningVisible?: boolean;
+  /** Show tool calls in the seeded opening. Defaults to true server-side. */
+  toolCallsVisible?: boolean;
 }
 
 /** Body for `patchAdminRotatingMessage`. Each field independently optional. */
@@ -458,6 +470,8 @@ export interface PatchAdminRotatingMessageBody {
   dailyTime?: string | null;
   cronExpression?: string | null;
   isArchived?: boolean;
+  reasoningVisible?: boolean;
+  toolCallsVisible?: boolean;
 }
 
 /** Response from `rotateAdminRotatingMessageNow`. */
@@ -583,6 +597,13 @@ export interface AdminSettingsView {
     default: AIHubLanguage;
     user_locked: boolean;
   };
+  /** Agent-picker settings, stored as separate columns server-side. */
+  agents: {
+    /** Default ai-hub agent id auto-opened on load, or `null` for the picker. */
+    default_id: string | null;
+    /** Whether users may switch agents (the "← Agents" back link). */
+    switcher_enabled: boolean;
+  };
   /** The flat §8.4 feature-toggles blob. */
   feature_toggles: AIHubFeatureToggles;
   /** ISO-8601 of the last signing-key rotation. `null` until first rotation. */
@@ -611,6 +632,12 @@ export interface PatchAdminSettingsBody {
     default?: AIHubLanguage;
     userLocked?: boolean;
   };
+  /** Agent-picker partial — either or both fields. */
+  agents?: {
+    /** Agent id to default to; `null` / `""` clears (→ show the picker). */
+    defaultId?: string | null;
+    switcherEnabled?: boolean;
+  };
 }
 
 /** Response from `rotateAdminMetricsToken` — the new token returned **once**. */
@@ -1330,6 +1357,8 @@ export class AIHubClient {
     if (body.intervalSeconds !== undefined) wire.interval_seconds = body.intervalSeconds;
     if (body.dailyTime !== undefined) wire.daily_time = body.dailyTime;
     if (body.cronExpression !== undefined) wire.cron_expression = body.cronExpression;
+    if (body.reasoningVisible !== undefined) wire.reasoning_visible = body.reasoningVisible;
+    if (body.toolCallsVisible !== undefined) wire.tool_calls_visible = body.toolCallsVisible;
     return this.requestJson<AdminRotatingMessageView>(
       "POST",
       "/admin/rotating-messages",
@@ -1360,6 +1389,8 @@ export class AIHubClient {
     if (body.dailyTime !== undefined) wire.daily_time = body.dailyTime;
     if (body.cronExpression !== undefined) wire.cron_expression = body.cronExpression;
     if (body.isArchived !== undefined) wire.is_archived = body.isArchived;
+    if (body.reasoningVisible !== undefined) wire.reasoning_visible = body.reasoningVisible;
+    if (body.toolCallsVisible !== undefined) wire.tool_calls_visible = body.toolCallsVisible;
     return this.requestJson<AdminRotatingMessageView>(
       "PATCH",
       `/admin/rotating-messages/${encodeURIComponent(id)}`,
@@ -1505,6 +1536,16 @@ export class AIHubClient {
       }
       wire.language = languageWire;
     }
+    if (body.agents !== undefined) {
+      const agentsWire: Record<string, unknown> = {};
+      if (body.agents.defaultId !== undefined) {
+        agentsWire.default_id = body.agents.defaultId;
+      }
+      if (body.agents.switcherEnabled !== undefined) {
+        agentsWire.switcher_enabled = body.agents.switcherEnabled;
+      }
+      wire.agents = agentsWire;
+    }
     return this.requestJson<AdminSettingsView>("PATCH", "/admin/settings", {
       body: wire,
     });

package/src/components/ChatShell/index.tsx

@@ -13,7 +13,7 @@
  * @see ui-sketches/00-shell.md, ui-sketches/03-chat.md
  */
 
-import { useEffect, useMemo, type ReactNode } from "react";
+import { useEffect, useMemo, useRef, type ReactNode } from "react";
 
 import {
   type AIHubTexts,
@@ -21,6 +21,7 @@ import {
 } from "../../auth/texts.js";
 import { useResolvedTexts } from "../../context/useAIHubTexts.js";
 import { useAIHub } from "../../context/useAIHub.js";
+import { useAIHubAuth } from "../../context/useAIHubAuth.js";
 import {
   resolveAffordanceFlags,
   type AIHubAffordanceFlags,
@@ -171,9 +172,13 @@ export function ChatShell(props: ChatShellProps): ReactNode {
     setActiveSession,
     featureToggles,
   } = useAIHub();
+  const { deployment } = useAIHubAuth();
   const texts = useResolvedTexts(props.texts);
   const productName = props.productName ?? "ai-hub";
   const showAgentsPicker = props.showAgentsPicker ?? true;
+  // §7.x agent-picker deployment config: when switching is off the "← Agents"
+  // back link is hidden; a single-agent deployment hides it too (see below).
+  const agentSwitcherEnabled = deployment?.agent_switcher_enabled ?? true;
   const sessionsPanelPosition = props.sessionsPanelPosition ?? "left";
   const sessionsPanelWidthPercent = props.sessionsPanelWidthPercent ?? 25;
 
@@ -214,6 +219,31 @@ export function ChatShell(props: ChatShellProps): ReactNode {
     }
   }, [autoSelectOnlyAgent, agents, setActiveAgent]);
 
+  // Deployment default agent (multi-agent deployments): open it once on first
+  // agents-load instead of showing the picker. A deep-link `initialAgentId`
+  // wins (handled by its own effect above). Guarded by a ref so that, when
+  // switching is enabled, clicking "← Agents" genuinely returns to the picker
+  // rather than snapping straight back to the default.
+  const appliedDefaultAgentRef = useRef(false);
+  useEffect(() => {
+    if (appliedDefaultAgentRef.current) return;
+    if (props.initialAgentId) return;
+    if (agentsLoading || agents.length <= 1) return;
+    appliedDefaultAgentRef.current = true;
+    if (activeAgentId) return;
+    const defaultId = deployment?.default_agent_id ?? null;
+    if (defaultId && agents.some((a) => a.id === defaultId)) {
+      setActiveAgent(defaultId);
+    }
+  }, [
+    agents,
+    agentsLoading,
+    activeAgentId,
+    props.initialAgentId,
+    deployment,
+    setActiveAgent,
+  ]);
+
   const inPicker = showAgentsPicker && !activeAgentId;
 
   const rootClass = props.className
@@ -259,7 +289,9 @@ export function ChatShell(props: ChatShellProps): ReactNode {
               />
             ) : null}
             <MainColumn
-              showBackToAgents={showAgentsPicker}
+              showBackToAgents={
+                showAgentsPicker && agentSwitcherEnabled && agents.length > 1
+              }
               showTurnStatus={flags.turnStatusVisible}
               {...(props.texts !== undefined ? { texts: props.texts } : {})}
               {...(props.customHeaderContent !== undefined

package/src/components/DataClubAIHubAdmin/RotatingMessageEditorModal.tsx

@@ -33,6 +33,8 @@ export interface RotatingEditorInitial {
   intervalSeconds: number | null;
   dailyTime: string | null;
   cronExpression: string | null;
+  reasoningVisible: boolean;
+  toolCallsVisible: boolean;
 }
 
 /** Submit body passed up to the parent page. */
@@ -44,6 +46,8 @@ export interface RotatingEditorSubmitBody {
   intervalSeconds: number | null;
   dailyTime: string | null;
   cronExpression: string | null;
+  reasoningVisible: boolean;
+  toolCallsVisible: boolean;
 }
 
 /** Props for `<RotatingMessageEditorModal />`. */
@@ -90,6 +94,13 @@ export function RotatingMessageEditorModal(
   const [intervalUnit, setIntervalUnit] = useState<"hours" | "days">(initialInterval.unit);
   const [dailyTime, setDailyTime] = useState(props.initial?.dailyTime ?? "06:00");
   const [cronExpression, setCronExpression] = useState(props.initial?.cronExpression ?? "0 6 * * *");
+  // Which output parts the seeded opening shows. Normal text is always shown.
+  const [reasoningVisible, setReasoningVisible] = useState(
+    props.initial?.reasoningVisible ?? true,
+  );
+  const [toolCallsVisible, setToolCallsVisible] = useState(
+    props.initial?.toolCallsVisible ?? true,
+  );
 
   const [nameError, setNameError] = useState<string | null>(null);
   const [promptError, setPromptError] = useState<string | null>(null);
@@ -172,6 +183,8 @@ export function RotatingMessageEditorModal(
         prompt: trimmedPrompt,
         lettaAgentId: trimmedAgent,
         ...schedule.body,
+        reasoningVisible,
+        toolCallsVisible,
       });
     } catch (err) {
       if (err instanceof AIHubRequestError) {
@@ -377,6 +390,44 @@ export function RotatingMessageEditorModal(
             ) : null}
           </fieldset>
 
+          <fieldset className="data-club-ai-hub-admin__radio-group">
+            <legend className="data-club-ai-hub-admin__form-label">
+              {props.texts.rotatingDisplaySectionLabel}
+            </legend>
+            <label className="data-club-ai-hub-admin__checkbox">
+              <input
+                type="checkbox"
+                checked
+                disabled
+                data-testid="admin-rotating-display-normal"
+              />
+              <span>{props.texts.rotatingDisplayNormalAlways}</span>
+            </label>
+            <label className="data-club-ai-hub-admin__checkbox">
+              <input
+                type="checkbox"
+                data-testid="admin-rotating-display-reasoning"
+                checked={reasoningVisible}
+                onChange={(event) => setReasoningVisible(event.target.checked)}
+                disabled={submitting}
+              />
+              <span>{props.texts.rotatingDisplayReasoning}</span>
+            </label>
+            <label className="data-club-ai-hub-admin__checkbox">
+              <input
+                type="checkbox"
+                data-testid="admin-rotating-display-tool-calls"
+                checked={toolCallsVisible}
+                onChange={(event) => setToolCallsVisible(event.target.checked)}
+                disabled={submitting}
+              />
+              <span>{props.texts.rotatingDisplayToolCalls}</span>
+            </label>
+            <span className="data-club-ai-hub-admin__form-helper">
+              {props.texts.rotatingDisplayHelper}
+            </span>
+          </fieldset>
+
           {banner !== null ? (
             <div className="data-club-ai-hub-admin__error" role="alert" data-testid="admin-rotating-modal-banner">
               {banner}

package/src/components/DataClubAIHubAdmin/RotatingMessagesPage.tsx

@@ -135,6 +135,8 @@ export function AdminRotatingMessagesPage(
       intervalSeconds: body.intervalSeconds,
       dailyTime: body.dailyTime,
       cronExpression: body.cronExpression,
+      reasoningVisible: body.reasoningVisible,
+      toolCallsVisible: body.toolCallsVisible,
     });
     upsert(created);
     setEditor({ kind: "closed" });
@@ -152,6 +154,8 @@ export function AdminRotatingMessagesPage(
       intervalSeconds: body.intervalSeconds,
       dailyTime: body.dailyTime,
       cronExpression: body.cronExpression,
+      reasoningVisible: body.reasoningVisible,
+      toolCallsVisible: body.toolCallsVisible,
     });
     upsert(updated);
     setEditor({ kind: "closed" });
@@ -362,6 +366,8 @@ export function AdminRotatingMessagesPage(
             intervalSeconds: editor.row.interval_seconds,
             dailyTime: editor.row.daily_time,
             cronExpression: editor.row.cron_expression,
+            reasoningVisible: editor.row.reasoning_visible,
+            toolCallsVisible: editor.row.tool_calls_visible,
           }}
           texts={props.texts}
           onSubmit={(body) => handleEditSubmit(editor.row, body)}

package/src/components/DataClubAIHubAdmin/SettingsPage.tsx

@@ -27,7 +27,10 @@
 import { useEffect, useState, type ReactNode } from "react";
 
 import type { AIHubAdminTexts, AIHubLanguage } from "../../auth/texts.js";
-import type { AdminSettingsView } from "../../client/AIHubClient.js";
+import type {
+  AdminAgentView,
+  AdminSettingsView,
+} from "../../client/AIHubClient.js";
 import { useAIHub } from "../../context/useAIHub.js";
 import { useAIHubAuth } from "../../context/useAIHubAuth.js";
 import {
@@ -188,6 +191,11 @@ export function AdminSettingsPage(props: AdminSettingsPageProps): ReactNode {
             texts={props.texts}
             onSaved={handleSectionSaved}
           />
+          <AgentsSection
+            settings={settings}
+            texts={props.texts}
+            onSaved={handleSectionSaved}
+          />
           <FeatureTogglesSection
             settings={settings}
             texts={props.texts}
@@ -646,6 +654,142 @@ function LanguageSection(props: LanguageSectionProps): ReactNode {
   );
 }
 
+/* ────────────────────────────────────────────────────────────────────────── */
+/*  Section: Agents                                                            */
+/* ────────────────────────────────────────────────────────────────────────── */
+
+interface AgentsSectionProps extends SectionProps {
+  onSaved: (next: AdminSettingsView) => void;
+}
+
+function AgentsSection(props: AgentsSectionProps): ReactNode {
+  const { client } = useAIHub();
+  const [defaultAgentId, setDefaultAgentId] = useState<string>(
+    props.settings.agents.default_id ?? "",
+  );
+  const [switcherEnabled, setSwitcherEnabled] = useState(
+    props.settings.agents.switcher_enabled,
+  );
+  // Non-archived agents to populate the default-agent <select>.
+  const [agents, setAgents] = useState<AdminAgentView[] | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [flash, setFlash] = useState<{ tone: "success" | "error"; text: string } | null>(
+    null,
+  );
+
+  useEffect(() => {
+    let cancelled = false;
+    void (async () => {
+      try {
+        const rows = await client.listAdminAgents();
+        if (cancelled) return;
+        setAgents(rows.filter((a) => !a.is_archived));
+      } catch {
+        if (!cancelled) setAgents([]);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [client]);
+
+  async function handleSave(event: React.FormEvent): Promise<void> {
+    event.preventDefault();
+    setSaving(true);
+    setFlash(null);
+    try {
+      const next = await client.patchAdminSettings({
+        agents: { defaultId: defaultAgentId, switcherEnabled },
+      });
+      props.onSaved(next);
+      setFlash({ tone: "success", text: props.texts.settingsSaveSuccessFlash });
+    } catch (err) {
+      setFlash({
+        tone: "error",
+        text:
+          err instanceof Error && err.message.length > 0
+            ? err.message
+            : props.texts.settingsSaveGenericError,
+      });
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  return (
+    <section
+      className="data-club-ai-hub-admin__settings-section"
+      data-testid="admin-settings-agents-section"
+    >
+      <h2 className="data-club-ai-hub-admin__settings-section-heading">
+        {props.texts.settingsAgentsSectionHeading}
+      </h2>
+      <form onSubmit={(event) => void handleSave(event)} noValidate>
+        <label
+          className="data-club-ai-hub-admin__form-label"
+          htmlFor="admin-settings-default-agent"
+        >
+          {props.texts.settingsAgentsDefaultLabel}
+        </label>
+        <select
+          id="admin-settings-default-agent"
+          className="data-club-ai-hub-admin__form-input"
+          data-testid="admin-settings-default-agent"
+          value={defaultAgentId}
+          onChange={(event) => setDefaultAgentId(event.target.value)}
+          disabled={saving || agents === null}
+        >
+          <option value="">{props.texts.settingsAgentsDefaultNone}</option>
+          {(agents ?? []).map((agent) => (
+            <option key={agent.id} value={agent.id}>
+              {agent.display_name}
+            </option>
+          ))}
+        </select>
+        <p className="data-club-ai-hub-admin__form-helper">
+          {props.texts.settingsAgentsDefaultHelper}
+        </p>
+        <label className="data-club-ai-hub-admin__checkbox">
+          <input
+            type="checkbox"
+            data-testid="admin-settings-agent-switcher-enabled"
+            checked={switcherEnabled}
+            onChange={(event) => setSwitcherEnabled(event.target.checked)}
+            disabled={saving}
+          />
+          <span>{props.texts.settingsAgentsSwitcherEnabledLabel}</span>
+        </label>
+        <p className="data-club-ai-hub-admin__form-helper">
+          {props.texts.settingsAgentsSwitcherEnabledHelper}
+        </p>
+        {flash !== null ? (
+          <div
+            className={
+              flash.tone === "success"
+                ? "data-club-ai-hub-admin__flash data-club-ai-hub-admin__flash--success"
+                : "data-club-ai-hub-admin__flash data-club-ai-hub-admin__flash--error"
+            }
+            data-testid="admin-settings-agents-flash"
+            role={flash.tone === "error" ? "alert" : "status"}
+          >
+            {flash.text}
+          </div>
+        ) : null}
+        <button
+          type="submit"
+          className="data-club-ai-hub-admin__button data-club-ai-hub-admin__button--primary"
+          data-testid="admin-settings-agents-save"
+          disabled={saving}
+        >
+          {saving
+            ? props.texts.settingsSaveSavingButton
+            : props.texts.settingsSaveAgentsButton}
+        </button>
+      </form>
+    </section>
+  );
+}
+
 /* ────────────────────────────────────────────────────────────────────────── */
 /*  Section: Feature toggles                                                   */
 /* ────────────────────────────────────────────────────────────────────────── */

package/src/types.ts

@@ -112,6 +112,17 @@ export interface AIHubDeployment {
    * per-device choice.
    */
   user_language_locked: boolean;
+  /**
+   * ai-hub agent id auto-opened on load (skipping the agents picker). `null` =
+   * no default → the picker is shown. Ignored when only one agent exists (that
+   * one always opens). A dangling id falls back to the picker.
+   */
+  default_agent_id: string | null;
+  /**
+   * When `false`, users can't switch agents — the "← Agents" back link is
+   * hidden. (Also hidden whenever only one agent exists, regardless of this.)
+   */
+  agent_switcher_enabled: boolean;
   /**
    * Browser-facing URL of the self-hosted Letta ADE — only present when the
    * caller's role is `power_user` or higher. Absent for `user`-role callers.