@data-club/ai-hub 0.0.8 → 0.0.10

package/src/components/DataClubAIHubAdmin/SettingsPage.tsx

@@ -2,20 +2,19 @@
  * `<AdminSettingsPage />` — the super_admin-only Settings sub-page mounted
  * inside `<DataClubAIHubAdmin />` ([08-admin-settings.md]).
  *
- * Five independent sections, each with its own Save button — per the spec,
- * "Don't make the user save all five sections together":
+ * Independent sections, each with its own Save button — per the spec,
+ * "Don't make the user save all sections together":
  *
- * 1. **Letta connection** — base URL, ADE URL, API key (masked + replaceable).
- * 2. **Theme** — default theme + switcher-enabled checkbox.
- * 3. **UI feature toggles** — the §8.4 toggle blob.
- * 4. **Signing key** — rotate with `ROTATE`-typing friction. Rotating
+ * 1. **Theme** — default theme + switcher-enabled checkbox.
+ * 2. **UI feature toggles** — the §8.4 toggle blob.
+ * 3. **Signing key** — rotate with `ROTATE`-typing friction. Rotating
  *    invalidates every JWT, including the calling super-admin's.
- * 5. **Metrics scrape token** — rotate with the same friction. The new token
+ * 4. **Metrics scrape token** — rotate with the same friction. The new token
  *    is shown ONCE via a reveal modal; subsequent settings reads no longer
  *    expose it. Does NOT invalidate the calling JWT.
  *
  * Each section owns its own dirty-state and save handler; sibling sections
- * never share state. This means a half-typed Letta URL won't be pushed when
+ * never share state. This means a half-typed value won't be pushed when
  * the admin clicks `Save toggles` in a different section.
  *
  * Visible to `super_admin` only — the parent shell hides the nav item for
@@ -176,11 +175,6 @@ export function AdminSettingsPage(props: AdminSettingsPageProps): ReactNode {
       ) : null}
       {settings !== null ? (
         <>
-          <LettaConnectionSection
-            settings={settings}
-            texts={props.texts}
-            onSaved={handleSectionSaved}
-          />
           <ThemeSection
             settings={settings}
             texts={props.texts}
@@ -230,7 +224,7 @@ export function AdminSettingsPage(props: AdminSettingsPageProps): ReactNode {
 }
 
 /* ────────────────────────────────────────────────────────────────────────── */
-/*  Section: Letta connection                                                  */
+/*  Section: Theme                                                             */
 /* ────────────────────────────────────────────────────────────────────────── */
 
 interface SectionProps {
@@ -238,189 +232,6 @@ interface SectionProps {
   texts: AIHubAdminTexts;
 }
 
-interface LettaConnectionSectionProps extends SectionProps {
-  onSaved: (next: AdminSettingsView) => void;
-}
-
-function LettaConnectionSection(props: LettaConnectionSectionProps): ReactNode {
-  const { client } = useAIHub();
-  const [baseUrl, setBaseUrl] = useState(props.settings.letta_base_url ?? "");
-  const [adeUrl, setAdeUrl] = useState(props.settings.letta_ade_url ?? "");
-  // Empty string = leave-as-is; non-empty = replace.
-  const [apiKey, setApiKey] = useState("");
-  const [saving, setSaving] = useState(false);
-  const [flash, setFlash] = useState<{ tone: "success" | "error"; text: string } | null>(
-    null,
-  );
-
-  async function handleSave(event: React.FormEvent): Promise<void> {
-    event.preventDefault();
-    setSaving(true);
-    setFlash(null);
-    try {
-      const body: Parameters<typeof client.patchAdminSettings>[0] = {};
-      // Compare against current to avoid stomping the existing value with the
-      // identical one. The server treats null + value identically, but the
-      // schema forbids `null + ""` so we coerce explicitly.
-      if (baseUrl !== (props.settings.letta_base_url ?? "")) {
-        body.lettaBaseUrl = baseUrl === "" ? null : baseUrl;
-      }
-      if (adeUrl !== (props.settings.letta_ade_url ?? "")) {
-        body.lettaAdeUrl = adeUrl === "" ? null : adeUrl;
-      }
-      if (apiKey !== "") body.lettaApiKey = apiKey;
-      const next = await client.patchAdminSettings(body);
-      props.onSaved(next);
-      setApiKey("");
-      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);
-    }
-  }
-
-  // Clears the DB column (sends `letta_api_key: ""`), which makes the
-  // server fall back to env.LETTA_API_KEY at runtime per the
-  // resolveApiKey precedence in letta/client.ts. Same code path as the
-  // base/ADE URL nulling — only it targets the API-key column.
-  async function handleClearApiKeyOverride(): Promise<void> {
-    setSaving(true);
-    setFlash(null);
-    try {
-      const next = await client.patchAdminSettings({ lettaApiKey: "" });
-      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-letta-section"
-    >
-      <h2 className="data-club-ai-hub-admin__settings-section-heading">
-        {props.texts.settingsLettaSectionHeading}
-      </h2>
-      <form onSubmit={(event) => void handleSave(event)} noValidate>
-        <label className="data-club-ai-hub-admin__form-field">
-          <span className="data-club-ai-hub-admin__form-label">
-            {props.texts.settingsLettaBaseUrlLabel}
-          </span>
-          <input
-            type="url"
-            className="data-club-ai-hub-admin__form-input"
-            data-testid="admin-settings-letta-base-url"
-            value={baseUrl}
-            onChange={(event) => setBaseUrl(event.target.value)}
-            disabled={saving}
-          />
-        </label>
-        <label className="data-club-ai-hub-admin__form-field">
-          <span className="data-club-ai-hub-admin__form-label">
-            {props.texts.settingsLettaAdeUrlLabel}
-          </span>
-          <input
-            type="url"
-            className="data-club-ai-hub-admin__form-input"
-            data-testid="admin-settings-letta-ade-url"
-            value={adeUrl}
-            onChange={(event) => setAdeUrl(event.target.value)}
-            disabled={saving}
-          />
-          <span className="data-club-ai-hub-admin__form-helper">
-            {props.texts.settingsLettaAdeUrlHelper}
-          </span>
-        </label>
-        <label className="data-club-ai-hub-admin__form-field">
-          <span className="data-club-ai-hub-admin__form-label">
-            {props.texts.settingsLettaApiKeyLabel}
-          </span>
-          <input
-            type="password"
-            className="data-club-ai-hub-admin__form-input"
-            data-testid="admin-settings-letta-api-key"
-            value={apiKey}
-            placeholder={
-              props.settings.letta_api_key_source === "db"
-                ? props.texts.settingsLettaApiKeyPlaceholder
-                : ""
-            }
-            onChange={(event) => setApiKey(event.target.value)}
-            disabled={saving}
-            autoComplete="new-password"
-          />
-          <span
-            className="data-club-ai-hub-admin__form-helper"
-            data-testid="admin-settings-letta-api-key-helper"
-            data-source={props.settings.letta_api_key_source}
-          >
-            {props.settings.letta_api_key_source === "db"
-              ? props.texts.settingsLettaApiKeyDbHelper
-              : props.settings.letta_api_key_source === "env"
-                ? props.texts.settingsLettaApiKeyEnvHelper
-                : props.texts.settingsLettaApiKeyNoneHelper}
-          </span>
-          {props.settings.letta_api_key_source === "db" ? (
-            <button
-              type="button"
-              className="data-club-ai-hub-admin__button"
-              data-testid="admin-settings-letta-api-key-clear"
-              onClick={() => void handleClearApiKeyOverride()}
-              disabled={saving}
-            >
-              {props.texts.settingsLettaApiKeyClearOverrideButton}
-            </button>
-          ) : null}
-        </label>
-        {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-letta-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-letta-save"
-          disabled={saving}
-        >
-          {saving
-            ? props.texts.settingsSaveSavingButton
-            : props.texts.settingsSaveLettaButton}
-        </button>
-      </form>
-    </section>
-  );
-}
-
-/* ────────────────────────────────────────────────────────────────────────── */
-/*  Section: Theme                                                             */
-/* ────────────────────────────────────────────────────────────────────────── */
-
 interface ThemeSectionProps extends SectionProps {
   onSaved: (next: AdminSettingsView) => void;
 }

package/src/components/DataClubAIHubAdmin/index.tsx

@@ -8,7 +8,7 @@
  * `user`-role caller the component returns `null` outright.
  *
  * The shell **renders its own `<ShellHeader />`** so the user-menu (log
- * out, theme toggle, Open Letta ADE, ← Back to chat) stays available
+ * out, theme toggle, ← Back to chat) stays available
  * from inside the admin view too — [00-shell.md] makes the shell header
  * part of every authenticated page. The component is identical to the
  * one ChatShell renders.

package/src/components/MessageList/index.tsx

@@ -54,7 +54,6 @@ import type {
   AIHubMessageBubbleRenderer,
 } from "../../types.js";
 
-import { CacheBadge } from "../CacheBadge/index.js";
 import { MarkdownRenderer } from "../MarkdownRenderer/index.js";
 import { ReasoningView } from "../ReasoningView/index.js";
 import { ScrollToPresentButton } from "../ScrollToPresentButton/index.js";
@@ -713,9 +712,6 @@ function MessageBubble(props: {
           message.content.trim()
         )}
       </span>
-      {isAssistant && message.usage ? (
-        <CacheBadge usage={message.usage} />
-      ) : null}
       {props.isFailedAssistant ? (
         <div className={cls.bubbleActions}>
           <span>{props.failedLabel}</span>

package/src/context/AIHubProvider.tsx

@@ -108,7 +108,7 @@ function mergeOptimisticAffordances(
 ): AIHubMessage[] {
   const optimisticById = new Map<string, AIHubMessage>();
   for (const m of optimistic) {
-    if (m.role === "assistant" && (m.reasoning || m.tool_calls?.length || m.usage)) {
+    if (m.role === "assistant" && (m.reasoning || m.tool_calls?.length)) {
       optimisticById.set(m.id, m);
     }
   }
@@ -123,13 +123,6 @@ function mergeOptimisticAffordances(
     if ((!next.tool_calls || next.tool_calls.length === 0) && o.tool_calls?.length) {
       next.tool_calls = o.tool_calls;
     }
-    // Usage rides through too — if the canonical refetch happens
-    // before the server stamped `message_usage` (small race window),
-    // the live `usage` event we already handled keeps the badge
-    // rendered until the next refresh confirms it.
-    if (!next.usage && o.usage) {
-      next.usage = o.usage;
-    }
     return next;
   });
 }
@@ -828,30 +821,6 @@ export function AIHubProvider(props: AIHubProviderProps): ReactNode {
           setStreamingReasoning(null);
           setStreamingToolCalls([]);
           sawAssistantOutput = true;
-        } else if (event.event === "usage") {
-          // Live usage stamp — the runner emits this right before
-          // `stream_end{done}` carrying the cache-hit/write counts for
-          // the turn. We attach it to the matching assistant bubble so
-          // `<CacheBadge />` appears immediately (without waiting for
-          // the post-stream `/messages` refetch). The refetch path
-          // also stamps the same `usage` from the persisted
-          // `message_usage` row, so refresh + history retrieval show
-          // the badge too.
-          const targetId = event.data.letta_message_id;
-          if (typeof targetId === "string") {
-            const usage = {
-              input: event.data.input ?? null,
-              output: event.data.output ?? null,
-              cache_read: event.data.cache_read ?? null,
-              cache_write: event.data.cache_write ?? null,
-              reasoning: event.data.reasoning ?? null,
-              context: event.data.context ?? null,
-              total: event.data.total ?? null,
-            };
-            setMessages((prev) =>
-              prev.map((m) => (m.id === targetId ? { ...m, usage } : m)),
-            );
-          }
         } else if (event.event === "error") {
           setLastTurnError(event.data.message);
           sawError = true;

package/src/index.ts

@@ -26,7 +26,6 @@ export type {
   Session,
   AIHubMessage,
   AIHubMessageOverride,
-  AIHubMessageUsage,
   AIHubToolCallRecord,
   TurnStatus,
   RunningPhase,
@@ -232,13 +231,6 @@ export type {
 } from "./components/ToolCallView/index.js";
 export { formatToolContentForDisplay } from "./components/ToolCallView/formatContent.js";
 
-export { CacheBadge, computeCacheHitRatio } from "./components/CacheBadge/index.js";
-export type {
-  CacheBadgeProps,
-  CacheBadgeClassNames,
-  CacheBadgeTexts,
-} from "./components/CacheBadge/index.js";
-
 export { ScrollToPresentButton } from "./components/ScrollToPresentButton/index.js";
 export type {
   ScrollToPresentButtonProps,

package/src/state/stateReducer.ts

@@ -125,7 +125,6 @@ export function reduceAIHubState(
     case "tool_call_dispatched":
     case "tool_call_progress":
     case "tool_call_result":
-    case "usage":
       return next;
   }
 }

package/src/styles/CLASSES.md

@@ -177,7 +177,7 @@ block and modifier.
 | `data-club-ai-hub__user-menu__header` | Header row inside the dropdown (username + role). |
 | `data-club-ai-hub__user-menu__username-large` | Larger username text in the dropdown header. |
 | `data-club-ai-hub__user-menu__role` | Role label below the username. |
-| `data-club-ai-hub__user-menu__item` | A menu item (Sign out today; Theme / Admin / Letta ADE in Steps 10–11). |
+| `data-club-ai-hub__user-menu__item` | A menu item (Sign out today; Theme / Admin in Steps 10–11). |
 
 ### Agents picker — Step 9 (`ui-sketches/03-chat.md`)
 

package/src/styles/default.css

@@ -660,10 +660,6 @@
   background-color: color-mix(in srgb, var(--dc-aih-accent) 12%, transparent);
 }
 
-.data-club-ai-hub__user-menu__item--link {
-  text-decoration: none;
-}
-
 /* ── Language switcher (left of the user menu in the shell header) ────── */
 
 .data-club-ai-hub__language-switcher {
@@ -2264,69 +2260,6 @@
   letter-spacing: 0.04em;
 }
 
-/* ─────────────────────────────────────────────────────────────────── */
-/*  Cache badge — per-assistant-message prompt-cache hit indicator       */
-/*                                                                       */
-/*  Renders as a small chip in the bottom-right corner of the assistant  */
-/*  bubble, showing the cache-hit % over the prompt-side tokens. The     */
-/*  `data-cache-state` attribute (none|cold|warm|hot) drives the color   */
-/*  so skinners can override per-state via the CSS-vars without          */
-/*  duplicating the layout rules.                                        */
-/* ─────────────────────────────────────────────────────────────────── */
-.data-club-ai-hub__cache-badge {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.25em;
-  margin-top: 0.4em;
-  margin-left: auto;
-  align-self: flex-end;
-  padding: 0.1em 0.5em;
-  font-size: 0.75em;
-  line-height: 1.2;
-  border-radius: 999px;
-  background: var(--dc-aih-cache-badge-bg, rgba(127, 127, 127, 0.12));
-  color: var(--dc-aih-cache-badge-fg, var(--dc-aih-text-muted, #888));
-  border: 1px solid var(--dc-aih-cache-badge-border, transparent);
-  cursor: help; /* signals the title-attribute tooltip */
-  user-select: none;
-  transition: background 0.15s ease, border-color 0.15s ease;
-}
-.data-club-ai-hub__cache-badge[data-cache-state="hot"] {
-  background: var(--dc-aih-cache-badge-hot-bg, rgba(40, 180, 99, 0.14));
-  color: var(--dc-aih-cache-badge-hot-fg, #28b463);
-}
-.data-club-ai-hub__cache-badge[data-cache-state="warm"] {
-  background: var(--dc-aih-cache-badge-warm-bg, rgba(255, 142, 78, 0.14));
-  color: var(--dc-aih-cache-badge-warm-fg, #ff8e4e);
-}
-.data-club-ai-hub__cache-badge[data-cache-state="cold"] {
-  background: var(--dc-aih-cache-badge-cold-bg, rgba(160, 160, 160, 0.14));
-  color: var(--dc-aih-cache-badge-cold-fg, #888);
-}
-.data-club-ai-hub__cache-badge[data-cache-state="miss"] {
-  /* Full cache miss — provider had to reinitialize the whole prompt.
-     Red-tinted to signal "nothing cached this turn". */
-  background: var(--dc-aih-cache-badge-miss-bg, rgba(216, 44, 246, 0.12));
-  color: var(--dc-aih-cache-badge-miss-fg, #d82cf6);
-}
-.data-club-ai-hub__cache-badge[data-cache-state="priming"] {
-  /* This turn WROTE to the provider's cache. Next turn benefits.
-     Blue-tinted to distinguish from cold miss. */
-  background: var(--dc-aih-cache-badge-priming-bg, rgba(41, 189, 239, 0.14));
-  color: var(--dc-aih-cache-badge-priming-fg, #29bdef);
-}
-.data-club-ai-hub__cache-badge[data-cache-state="none"] {
-  font-style: italic;
-  opacity: 0.7;
-}
-.data-club-ai-hub__cache-badge__icon {
-  font-size: 0.9em;
-}
-.data-club-ai-hub__cache-badge__label {
-  font-variant-numeric: tabular-nums;
-  font-weight: 600;
-}
-
 /* ────────────────────────────────────────────────────────────────────────── */
 /*  Step 12 — admin Agents / Sessions overview / Settings sub-pages           */
 /* ────────────────────────────────────────────────────────────────────────── */

package/src/types.ts

@@ -81,10 +81,6 @@ export interface AIHubUser {
  * `user.theme_preference + deployment.{theme_default, theme_switcher_enabled}`
  * per §7.6 (two lines in the React provider).
  *
- * `letta_ade_url` is included only when the caller's role is `power_user`
- * or higher; for `user`-role callers the field is absent — by design
- * (§6.3.4: the URL is an admin-surface concern).
- *
  * @see SPECIFICATIONS.md §6.3.4 — `GET /auth/me`
  * @see SPECIFICATIONS.md §7.6 — theme resolution
  */
@@ -123,11 +119,6 @@ export interface AIHubDeployment {
    * 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.
-   */
-  letta_ade_url?: string;
 }
 
 /**
@@ -261,16 +252,6 @@ export interface AIHubMessage {
    * @see ui-sketches/03-chat.md — tool_call_card
    */
   tool_calls?: AIHubToolCallRecord[] | null;
-  /**
-   * Provider-reported token usage for the turn that produced this
-   * message. Set on the LAST assistant message of each turn (the
-   * `usage_statistics` event is per-run, not per-message; we stamp it
-   * on the visible final bubble). Renders as a small cache-status
-   * badge in the chat UI; hover for the full breakdown.
-   *
-   * @see AIHubMessageUsage
-   */
-  usage?: AIHubMessageUsage | null;
 }
 
 /**
@@ -638,61 +619,6 @@ export interface AIHubSystemNoticeEvent extends AIHubEventBase {
   };
 }
 
-/**
- * System: per-turn token-usage counters propagated from Letta. Stamped
- * on the LAST assistant message of the turn — the React reducer uses
- * `letta_message_id` to attach the badge to the right bubble. Also
- * persisted server-side so a refresh keeps the badge.
- *
- * @see SPECIFICATIONS.md §9.4
- * @see docs/server/chat-sse.md
- */
-export interface AIHubSystemUsageEvent extends AIHubEventBase {
-  event: "usage";
-  data: {
-    /**
-     * Letta message id this usage attaches to (the turn's last assistant
-     * message). The reducer joins this against the chat history to put
-     * the cache badge on the right bubble. Optional for forward
-     * compatibility with future per-message usage events.
-     */
-    letta_message_id?: string;
-    /** Non-cached input-token count (prompt_tokens). */
-    input?: number;
-    /** Output-token count (completion_tokens). */
-    output?: number;
-    /** Cache-read-token count — Anthropic / OpenAI / Gemini all report. */
-    cache_read?: number;
-    /** Cache-write-token count — Anthropic only; null elsewhere. */
-    cache_write?: number;
-    /** Reasoning / thinking tokens for models that produce them. */
-    reasoning?: number;
-    /** Letta's rolling context-window-size estimate post-turn. */
-    context?: number;
-    /** Sum reported by provider (may differ from input+output when reasoning is counted separately). */
-    total?: number;
-  };
-}
-
-/**
- * Per-assistant-message cache + token usage, attached to the
- * historical chat record. Returned from `GET /sessions/{id}/messages`
- * via `AIHubMessage.usage`. Same shape as the live wire event's
- * `data` minus the `letta_message_id` (which is already the message
- * itself).
- *
- * @see AIHubSystemUsageEvent
- */
-export interface AIHubMessageUsage {
-  input?: number | null;
-  output?: number | null;
-  cache_read?: number | null;
-  cache_write?: number | null;
-  reasoning?: number | null;
-  context?: number | null;
-  total?: number | null;
-}
-
 /**
  * System: non-recoverable error. Followed by `stream_end {reason: "error"}`.
  * The turn transitions to `failed`; the session remains usable.
@@ -734,7 +660,6 @@ export type AIHubEvent =
   | AIHubToolCallProgressEvent
   | AIHubToolCallResultEvent
   | AIHubSystemNoticeEvent
-  | AIHubSystemUsageEvent
   | AIHubSystemErrorEvent;
 
 /* ────────────────────────────────────────────────────────────────────────── */