@data-club/ai-hub 0.0.4 → 0.0.5

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.