@data-club/ai-hub 0.0.11 → 0.0.13

package/dist/util/exportConversation.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Conversation → Markdown export helpers.
+ *
+ * Pure functions — the `<MainColumn />` export button calls
+ * `buildConversationMarkdown` on the already-loaded `useAIHub().messages`
+ * array and hands the result to a Blob download. Keeping the serialization
+ * here (instead of inline in the component) makes the export rules
+ * unit-testable without a DOM.
+ *
+ * Export rules:
+ *
+ * - Only `user` and `assistant` messages are exported. `system` rows (the
+ *   compiled system prompt travels in the transcript as `role: "system"`)
+ *   and `tool` rows never appear in the file.
+ * - Assistant messages with no text content (tool-call-only / reasoning-only
+ *   bubbles) are skipped — the export is the human-readable dialog, not the
+ *   agent trace.
+ * - Rotating-message sessions need no special casing: the rotation runner
+ *   deletes its own prompt's `user_message` from the Letta conversation, so
+ *   the transcript (and therefore the export) opens with the agent's reply.
+ *
+ * @see ../components/MainColumn/index.tsx — the export button
+ * @see SPECIFICATIONS.md §8.4 — `export_conversation_enabled` toggle
+ */
+import type { AIHubMessage } from "../types.js";
+/** Inputs for {@link buildConversationMarkdown}. */
+export interface ConversationExportArgs {
+    /** The session's user-supplied title; used as the document heading. */
+    sessionTitle: string;
+    /** Agent display name; rendered as the assistant speaker label. */
+    agentDisplayName: string;
+    /** Speaker label for `user` messages (localized, e.g. "You"). */
+    userLabel: string;
+    /** The transcript, chronologically sorted (as served by the provider). */
+    messages: ReadonlyArray<AIHubMessage>;
+    /** Export timestamp; injected so tests are deterministic. */
+    exportedAt: Date;
+}
+/**
+ * Serializes a conversation to a Markdown document.
+ *
+ * Format: an `# <title>` heading plus an "exported" byline, then one
+ * `## <speaker>` section per user/assistant message with the message's
+ * (already-markdown) content verbatim underneath.
+ *
+ * @param args - see {@link ConversationExportArgs}.
+ * @returns the Markdown document text (trailing newline included).
+ */
+export declare function buildConversationMarkdown(args: ConversationExportArgs): string;
+/**
+ * Derives a safe `.md` filename from the session title.
+ *
+ * Lowercases, strips diacritics (Czech/Slovak titles are common here),
+ * collapses every non-alphanumeric run to a single `-`, and appends the
+ * export date so repeated exports don't shadow each other in the user's
+ * downloads folder. Falls back to `conversation` for titles that reduce
+ * to nothing.
+ *
+ * @param sessionTitle - the session's title.
+ * @param exportedAt - export timestamp (date part is used).
+ * @returns e.g. `muj-rozhovor-2026-07-17.md`.
+ */
+export declare function conversationExportFilename(sessionTitle: string, exportedAt: Date): string;
+//# sourceMappingURL=exportConversation.d.ts.map

package/dist/util/exportConversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportConversation.d.ts","sourceRoot":"","sources":["../../src/util/exportConversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACtC,6DAA6D;IAC7D,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAqB9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,IAAI,GACf,MAAM,CAUR"}

package/dist/util/exportConversation.js

@@ -0,0 +1,78 @@
+/**
+ * Conversation → Markdown export helpers.
+ *
+ * Pure functions — the `<MainColumn />` export button calls
+ * `buildConversationMarkdown` on the already-loaded `useAIHub().messages`
+ * array and hands the result to a Blob download. Keeping the serialization
+ * here (instead of inline in the component) makes the export rules
+ * unit-testable without a DOM.
+ *
+ * Export rules:
+ *
+ * - Only `user` and `assistant` messages are exported. `system` rows (the
+ *   compiled system prompt travels in the transcript as `role: "system"`)
+ *   and `tool` rows never appear in the file.
+ * - Assistant messages with no text content (tool-call-only / reasoning-only
+ *   bubbles) are skipped — the export is the human-readable dialog, not the
+ *   agent trace.
+ * - Rotating-message sessions need no special casing: the rotation runner
+ *   deletes its own prompt's `user_message` from the Letta conversation, so
+ *   the transcript (and therefore the export) opens with the agent's reply.
+ *
+ * @see ../components/MainColumn/index.tsx — the export button
+ * @see SPECIFICATIONS.md §8.4 — `export_conversation_enabled` toggle
+ */
+/**
+ * Serializes a conversation to a Markdown document.
+ *
+ * Format: an `# <title>` heading plus an "exported" byline, then one
+ * `## <speaker>` section per user/assistant message with the message's
+ * (already-markdown) content verbatim underneath.
+ *
+ * @param args - see {@link ConversationExportArgs}.
+ * @returns the Markdown document text (trailing newline included).
+ */
+export function buildConversationMarkdown(args) {
+    const lines = [];
+    lines.push(`# ${args.sessionTitle}`);
+    lines.push("");
+    lines.push(`> ${args.agentDisplayName} — exported ${args.exportedAt.toISOString()}`);
+    for (const msg of args.messages) {
+        if (msg.role !== "user" && msg.role !== "assistant")
+            continue;
+        const content = msg.content.trim();
+        if (content.length === 0)
+            continue;
+        const speaker = msg.role === "user" ? args.userLabel : args.agentDisplayName;
+        lines.push("");
+        lines.push(`## ${speaker}`);
+        lines.push("");
+        lines.push(content);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Derives a safe `.md` filename from the session title.
+ *
+ * Lowercases, strips diacritics (Czech/Slovak titles are common here),
+ * collapses every non-alphanumeric run to a single `-`, and appends the
+ * export date so repeated exports don't shadow each other in the user's
+ * downloads folder. Falls back to `conversation` for titles that reduce
+ * to nothing.
+ *
+ * @param sessionTitle - the session's title.
+ * @param exportedAt - export timestamp (date part is used).
+ * @returns e.g. `muj-rozhovor-2026-07-17.md`.
+ */
+export function conversationExportFilename(sessionTitle, exportedAt) {
+    const slug = sessionTitle
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+    const date = exportedAt.toISOString().slice(0, 10);
+    return `${slug.length > 0 ? slug : "conversation"}-${date}.md`;
+}
+//# sourceMappingURL=exportConversation.js.map

package/dist/util/exportConversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportConversation.js","sourceRoot":"","sources":["../../src/util/exportConversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAkBH;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAA4B;IACpE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,KAAK,IAAI,CAAC,gBAAgB,eAAe,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CACzE,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,MAAM,OAAO,GACX,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAAoB,EACpB,UAAgB;IAEhB,MAAM,IAAI,GAAG,YAAY;SACtB,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,IAAI,KAAK,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@data-club/ai-hub",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "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

@@ -68,7 +68,12 @@ export const csTexts: AIHubTexts = {
     collapseSessionsPanel: "Sbalit panel konverzací",
     expandSessionsPanel: "Zobrazit panel konverzací",
     backToAgentsLink: "← Agenti",
+    exportConversationButton: "Export .md",
+    exportConversationAriaLabel: "Exportovat konverzaci jako Markdown",
+    exportUserLabel: "Vy",
+    exportAssistantFallbackLabel: "Asistent",
     untitledSessionFallback: "(bez názvu)",
+    autoCreatedSessionTitle: "Nová konverzace",
     noActiveSessionHint:
       "Vyberte konverzaci vlevo nebo začněte novou.",
     emptyConversationHint:

package/src/auth/locales/sk.ts

@@ -68,7 +68,12 @@ export const skTexts: AIHubTexts = {
     collapseSessionsPanel: "Zbaliť panel konverzácií",
     expandSessionsPanel: "Zobraziť panel konverzácií",
     backToAgentsLink: "← Agenti",
+    exportConversationButton: "Export .md",
+    exportConversationAriaLabel: "Exportovať konverzáciu ako Markdown",
+    exportUserLabel: "Vy",
+    exportAssistantFallbackLabel: "Asistent",
     untitledSessionFallback: "(bez názvu)",
+    autoCreatedSessionTitle: "Nová konverzácia",
     noActiveSessionHint:
       "Vyberte konverzáciu vľavo alebo začnite novú.",
     emptyConversationHint:

package/src/auth/texts.ts

@@ -154,8 +154,21 @@ export interface AIHubChatTexts {
   expandSessionsPanel: string;
   /** `[← Agents]` back-to-picker link in the chat header. */
   backToAgentsLink: string;
+  /** Export-conversation (.md) button label in the chat header. */
+  exportConversationButton: string;
+  /** `aria-label` / tooltip on the export-conversation button. */
+  exportConversationAriaLabel: string;
+  /** Speaker heading for the user's messages in the exported Markdown. */
+  exportUserLabel: string;
+  /** Assistant speaker heading in the export when no agent name resolves. */
+  exportAssistantFallbackLabel: string;
   /** Fallback title for a session somehow rendered without one. */
   untitledSessionFallback: string;
+  /**
+   * Title given to the session auto-created on page load when
+   * `load_last_session_enabled` is on and the caller has no sessions yet.
+   */
+  autoCreatedSessionTitle: string;
   /** Body shown when no session is selected yet. */
   noActiveSessionHint: string;
   /** Body shown when the user opens a session with zero messages. */
@@ -921,7 +934,12 @@ export const defaultAIHubTexts: AIHubTexts = Object.freeze({
     collapseSessionsPanel: "Collapse sessions panel",
     expandSessionsPanel: "Show sessions panel",
     backToAgentsLink: "← Agents",
+    exportConversationButton: "Export .md",
+    exportConversationAriaLabel: "Export conversation as Markdown",
+    exportUserLabel: "You",
+    exportAssistantFallbackLabel: "Assistant",
     untitledSessionFallback: "(untitled)",
+    autoCreatedSessionTitle: "New chat",
     noActiveSessionHint:
       "Pick a chat from the left or start a new one to begin.",
     emptyConversationHint:

package/src/components/ChatShell/index.tsx

@@ -74,6 +74,10 @@ export interface ChatShellProps {
   showSessionsPanel?: boolean;
   /** sessions_panel_collapsible default. */
   sessionsPanelCollapsible?: boolean;
+  /** sessions_panel_default_collapsed default (false — panel starts extended). */
+  sessionsPanelDefaultCollapsed?: boolean;
+  /** load_last_session_enabled default (false — show the "pick a chat" hint). */
+  loadLastSession?: boolean;
   /** sessions_panel_resizable default. */
   sessionsPanelResizable?: boolean;
   /** Layout-only (not a §8.4 toggle). */
@@ -100,6 +104,8 @@ export interface ChatShellProps {
   showScrollToPresentButton?: boolean;
   /** turn_status_visible default. */
   showTurnStatus?: boolean;
+  /** export_conversation_enabled default. */
+  showExportButton?: boolean;
   /** Whether the ThemeSwitcher renders in the user menu (server override wins). */
   showThemeSwitcher?: boolean;
 
@@ -134,6 +140,10 @@ function buildPropOverrides(
     out.sessionsPanelResizable = props.sessionsPanelResizable;
   if (props.sessionsPanelCollapsible !== undefined)
     out.sessionsPanelCollapsible = props.sessionsPanelCollapsible;
+  if (props.sessionsPanelDefaultCollapsed !== undefined)
+    out.sessionsPanelDefaultCollapsed = props.sessionsPanelDefaultCollapsed;
+  if (props.loadLastSession !== undefined)
+    out.loadLastSessionEnabled = props.loadLastSession;
   if (props.showCreateSessionButton !== undefined)
     out.createSessionButtonEnabled = props.showCreateSessionButton;
   if (props.showInput !== undefined) out.userInputEnabled = props.showInput;
@@ -153,6 +163,8 @@ function buildPropOverrides(
     out.scrollToPresentVisible = props.showScrollToPresentButton;
   if (props.showTurnStatus !== undefined)
     out.turnStatusVisible = props.showTurnStatus;
+  if (props.showExportButton !== undefined)
+    out.exportConversationEnabled = props.showExportButton;
   return out;
 }
 
@@ -170,6 +182,9 @@ export function ChatShell(props: ChatShellProps): ReactNode {
     setActiveAgent,
     activeSessionId,
     setActiveSession,
+    sessions,
+    sessionsLoading,
+    createSession,
     featureToggles,
   } = useAIHub();
   const { deployment } = useAIHubAuth();
@@ -244,6 +259,56 @@ export function ChatShell(props: ChatShellProps): ReactNode {
     setActiveAgent,
   ]);
 
+  // load_last_session_enabled (§8.4): once the sessions list for the opened
+  // agent has actually loaded and nothing is selected, open the most
+  // recently updated non-archived session — or create a brand-new one when
+  // the caller has none — instead of showing the "pick a chat" hint.
+  //
+  // Two refs guard the flow:
+  // - `sessionsFetchSeenRef` — on agent open the provider still holds the
+  //   *previous* agent's list until its fetch resolves, so we only act after
+  //   observing a loading cycle for the current agent.
+  // - `autoOpenedAgentRef` — apply at most once per opened agent, so closing
+  //   a session later doesn't snap it back open.
+  const sessionsFetchSeenRef = useRef(false);
+  const autoOpenedAgentRef = useRef<string | null>(null);
+  useEffect(() => {
+    sessionsFetchSeenRef.current = false;
+    if (!activeAgentId) autoOpenedAgentRef.current = null;
+  }, [activeAgentId]);
+  useEffect(() => {
+    if (sessionsLoading) sessionsFetchSeenRef.current = true;
+  }, [sessionsLoading]);
+  useEffect(() => {
+    if (!flags.loadLastSessionEnabled) return;
+    if (!activeAgentId || activeSessionId) return;
+    if (props.initialSessionId) return; // deep-link wins
+    if (sessionsLoading || !sessionsFetchSeenRef.current) return;
+    if (autoOpenedAgentRef.current === activeAgentId) return;
+    autoOpenedAgentRef.current = activeAgentId;
+    // Server orders by updated_at DESC — the first non-archived row is the
+    // caller's most recent session.
+    const last = sessions.find((s) => !s.is_archived);
+    if (last) {
+      setActiveSession(last.id);
+    } else {
+      createSession(texts.chat.autoCreatedSessionTitle).catch(() => {
+        // Best-effort — on failure the user still gets the manual hint.
+        autoOpenedAgentRef.current = null;
+      });
+    }
+  }, [
+    flags.loadLastSessionEnabled,
+    activeAgentId,
+    activeSessionId,
+    props.initialSessionId,
+    sessions,
+    sessionsLoading,
+    setActiveSession,
+    createSession,
+    texts.chat.autoCreatedSessionTitle,
+  ]);
+
   const inPicker = showAgentsPicker && !activeAgentId;
 
   const rootClass = props.className
@@ -279,6 +344,7 @@ export function ChatShell(props: ChatShellProps): ReactNode {
               <SessionsPanel
                 showCreateButton={flags.createSessionButtonEnabled}
                 collapsible={flags.sessionsPanelCollapsible}
+                defaultCollapsed={flags.sessionsPanelDefaultCollapsed}
                 {...(props.texts !== undefined ? { texts: props.texts } : {})}
                 {...(props.customSidebarHeader !== undefined
                   ? { customHeader: props.customSidebarHeader }
@@ -293,6 +359,7 @@ export function ChatShell(props: ChatShellProps): ReactNode {
                 showAgentsPicker && agentSwitcherEnabled && agents.length > 1
               }
               showTurnStatus={flags.turnStatusVisible}
+              showExportButton={flags.exportConversationEnabled}
               {...(props.texts !== undefined ? { texts: props.texts } : {})}
               {...(props.customHeaderContent !== undefined
                 ? { customHeaderContent: props.customHeaderContent }

package/src/components/DataClubAIHub/index.tsx

@@ -90,8 +90,12 @@ export interface DataClubAIHubProps {
   sessionsPanelWidthPercent?: number;
   /** Default for sessions_panel_collapsible. Default true. */
   sessionsPanelCollapsible?: boolean;
+  /** Default for sessions_panel_default_collapsed. Default **false** (extended). */
+  sessionsPanelDefaultCollapsed?: boolean;
   /** Default for create_session_button_enabled. Default true. */
   showCreateSessionButton?: boolean;
+  /** Default for load_last_session_enabled. Default **false**. */
+  loadLastSession?: boolean;
 
   /* ── Input controls (§8.4) ─────────────────────────────────────── */
   /** Default for user_input_enabled. Default true. */
@@ -114,6 +118,8 @@ export interface DataClubAIHubProps {
   showScrollToPresentButton?: boolean;
   /** Default for turn_status_visible. Default true. */
   showTurnStatus?: boolean;
+  /** Default for export_conversation_enabled. Default true. */
+  showExportButton?: boolean;
 
   /* ── Theming (§7.6) ────────────────────────────────────────────── */
   /**
@@ -263,6 +269,12 @@ function AuthedShell({ props }: { props: DataClubAIHubProps }): ReactNode {
       {...(props.sessionsPanelCollapsible !== undefined
         ? { sessionsPanelCollapsible: props.sessionsPanelCollapsible }
         : {})}
+      {...(props.sessionsPanelDefaultCollapsed !== undefined
+        ? { sessionsPanelDefaultCollapsed: props.sessionsPanelDefaultCollapsed }
+        : {})}
+      {...(props.loadLastSession !== undefined
+        ? { loadLastSession: props.loadLastSession }
+        : {})}
       {...(props.sessionsPanelResizable !== undefined
         ? { sessionsPanelResizable: props.sessionsPanelResizable }
         : {})}
@@ -300,6 +312,9 @@ function AuthedShell({ props }: { props: DataClubAIHubProps }): ReactNode {
       {...(props.showTurnStatus !== undefined
         ? { showTurnStatus: props.showTurnStatus }
         : {})}
+      {...(props.showExportButton !== undefined
+        ? { showExportButton: props.showExportButton }
+        : {})}
       {...(props.showThemeSwitcher !== undefined
         ? { showThemeSwitcher: props.showThemeSwitcher }
         : {})}

package/src/components/DataClubAIHubAdmin/SettingsPage.tsx

@@ -43,7 +43,9 @@ const ALL_TOGGLE_KEYS: ReadonlyArray<keyof AIHubFeatureToggles> = [
   "sessions_panel_enabled",
   "sessions_panel_resizable",
   "sessions_panel_collapsible",
+  "sessions_panel_default_collapsed",
   "create_session_button_enabled",
+  "load_last_session_enabled",
   "user_input_enabled",
   "stop_button_enabled",
   "tool_calls_visible",
@@ -53,6 +55,7 @@ const ALL_TOGGLE_KEYS: ReadonlyArray<keyof AIHubFeatureToggles> = [
   "effort_control_visible",
   "scroll_to_present_visible",
   "turn_status_visible",
+  "export_conversation_enabled",
 ];
 
 /** Toggles grouped by the §8.4 visual grouping (purely organizational). */
@@ -66,7 +69,9 @@ const TOGGLE_GROUPS: ReadonlyArray<{
       "sessions_panel_enabled",
       "sessions_panel_resizable",
       "sessions_panel_collapsible",
+      "sessions_panel_default_collapsed",
       "create_session_button_enabled",
+      "load_last_session_enabled",
     ],
   },
   {
@@ -83,13 +88,24 @@ const TOGGLE_GROUPS: ReadonlyArray<{
       "tpm_notice_visible",
       "scroll_to_present_visible",
       "turn_status_visible",
+      "export_conversation_enabled",
     ],
   },
 ];
 
-/** Toggle defaults — every toggle is on by default per §8.4. */
-function defaultToggleValue(): boolean {
-  return true;
+/**
+ * Built-in defaults per §8.4 — most toggles are on by default; the two
+ * opt-in behaviors below default to off. Must mirror
+ * `DEFAULT_AFFORDANCE_FLAGS` in `state/affordances.ts`.
+ */
+const OFF_BY_DEFAULT: ReadonlySet<keyof AIHubFeatureToggles> = new Set([
+  "sessions_panel_default_collapsed",
+  "load_last_session_enabled",
+] as const);
+
+/** Built-in default for one toggle key. */
+function defaultToggleValue(key: keyof AIHubFeatureToggles): boolean {
+  return !OFF_BY_DEFAULT.has(key);
 }
 
 /** Format ISO date as `<localized date> (<localized N days ago>)`. */
@@ -614,12 +630,12 @@ function FeatureTogglesSection(props: FeatureTogglesSectionProps): ReactNode {
   // The server's blob may omit keys (meaning "fall through to defaults"). The
   // UI shows the effective value for the user — fill in defaults for any
   // missing key. Save only sends the keys the user actually has toggled (in
-  // our case all of them, since the blob always carries all 13 once saved).
+  // our case all of them, since the blob always carries all 16 once saved).
   const [values, setValues] = useState<Record<string, boolean>>(() => {
     const initial: Record<string, boolean> = {};
     for (const key of ALL_TOGGLE_KEYS) {
       const fromServer = props.settings.feature_toggles[key];
-      initial[key] = typeof fromServer === "boolean" ? fromServer : defaultToggleValue();
+      initial[key] = typeof fromServer === "boolean" ? fromServer : defaultToggleValue(key);
     }
     return initial;
   });

package/src/components/MainColumn/index.tsx

@@ -22,6 +22,10 @@ import {
 } from "../../auth/texts.js";
 import { useResolvedTexts } from "../../context/useAIHubTexts.js";
 import { useAIHub } from "../../context/useAIHub.js";
+import {
+  buildConversationMarkdown,
+  conversationExportFilename,
+} from "../../util/exportConversation.js";
 
 import { TurnStatusIndicator } from "../TurnStatusIndicator/index.js";
 
@@ -37,6 +41,8 @@ export interface MainColumnClassNames {
   back: string;
   /** Agent display-name text. */
   title: string;
+  /** Export-conversation (.md) button. */
+  export: string;
   /** Wrapper for slot content on the right side of the header. */
   extras: string;
   /** Children container (messages + input live here). */
@@ -48,6 +54,7 @@ const DEFAULT_CLASS_NAMES: MainColumnClassNames = Object.freeze({
   header: "data-club-ai-hub__chat-header",
   back: "data-club-ai-hub__chat-header__back",
   title: "data-club-ai-hub__chat-header__title",
+  export: "data-club-ai-hub__chat-header__export",
   extras: "data-club-ai-hub__chat-header__extras",
   body: "data-club-ai-hub__main-column__body",
 }) as MainColumnClassNames;
@@ -68,6 +75,12 @@ export interface MainColumnProps {
    * default). Defaults to true.
    */
   showTurnStatus?: boolean;
+  /**
+   * Whether the export-conversation (.md) button renders in the chat
+   * header. Receives the resolved §8.4 `export_conversation_enabled`
+   * flag. Defaults to true.
+   */
+  showExportButton?: boolean;
   /** Slot rendered on the right side of the chat header. */
   customHeaderContent?: ReactNode;
   /** The children — `<MessageList />` + `<MessageInput />` (or whatever). */
@@ -87,17 +100,75 @@ export interface MainColumnProps {
  * @returns the rendered column.
  */
 export function MainColumn(props: MainColumnProps): ReactNode {
-  const { agents, activeAgentId, setActiveAgent } = useAIHub();
+  const {
+    agents,
+    activeAgentId,
+    setActiveAgent,
+    sessions,
+    activeSessionId,
+    messages,
+  } = useAIHub();
   const texts = useResolvedTexts(props.texts);
   const cls = { ...DEFAULT_CLASS_NAMES, ...(props.classNames ?? {}) };
   const showBack = props.showBackToAgents ?? true;
   const showTurnStatus = props.showTurnStatus ?? true;
+  const showExportButton = props.showExportButton ?? true;
 
   const activeAgent = useMemo(
     () => agents.find((a) => a.id === activeAgentId) ?? null,
     [agents, activeAgentId],
   );
 
+  const activeSession = useMemo(
+    () => (sessions ?? []).find((s) => s.id === activeSessionId) ?? null,
+    [sessions, activeSessionId],
+  );
+
+  // Whether the export button has anything to export — at least one
+  // user/assistant message with text content (mirrors the serializer's
+  // skip rules so we never download an empty document).
+  const hasExportableMessages = useMemo(
+    () =>
+      (messages ?? []).some(
+        (m) =>
+          (m.role === "user" || m.role === "assistant") &&
+          m.content.trim().length > 0,
+      ),
+    [messages],
+  );
+
+  /**
+   * Serializes the visible conversation to Markdown and triggers a
+   * client-side download. System-prompt rows (`role: "system"`) and tool
+   * rows are excluded by the serializer; rotating-message sessions open
+   * with the agent's reply because the rotation runner already deleted
+   * its own prompt server-side.
+   */
+  function handleExport(): void {
+    const exportedAt = new Date();
+    const sessionTitle =
+      activeSession?.title && activeSession.title.trim().length > 0
+        ? activeSession.title
+        : texts.chat.untitledSessionFallback;
+    const markdown = buildConversationMarkdown({
+      sessionTitle,
+      agentDisplayName:
+        activeAgent?.display_name ?? texts.chat.exportAssistantFallbackLabel,
+      userLabel: texts.chat.exportUserLabel,
+      messages: messages ?? [],
+      exportedAt,
+    });
+    const blob = new Blob([markdown], { type: "text/markdown;charset=utf-8" });
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement("a");
+    anchor.href = url;
+    anchor.download = conversationExportFilename(sessionTitle, exportedAt);
+    document.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    URL.revokeObjectURL(url);
+  }
+
   const rootClass = props.className
     ? `${cls.root} ${props.className}`
     : cls.root;
@@ -119,6 +190,19 @@ export function MainColumn(props: MainColumnProps): ReactNode {
           {activeAgent?.display_name ?? ""}
         </h2>
         {showTurnStatus ? <TurnStatusIndicator /> : null}
+        {showExportButton && activeSessionId !== null ? (
+          <button
+            type="button"
+            className={cls.export}
+            onClick={handleExport}
+            disabled={!hasExportableMessages}
+            aria-label={texts.chat.exportConversationAriaLabel}
+            title={texts.chat.exportConversationAriaLabel}
+            data-testid="chat-header-export"
+          >
+            {texts.chat.exportConversationButton}
+          </button>
+        ) : null}
         {props.customHeaderContent ? (
           <div className={cls.extras} data-testid="chat-header-extras">
             {props.customHeaderContent}

package/src/components/SessionsPanel/index.tsx

@@ -114,6 +114,11 @@ export interface SessionsPanelProps {
   showCreateButton?: boolean;
   /** Whether the panel can be collapsed. Defaults to true. */
   collapsible?: boolean;
+  /**
+   * Whether the panel starts collapsed (until the user toggles it).
+   * Defaults to false — panel starts extended.
+   */
+  defaultCollapsed?: boolean;
   /** Top-of-panel slot. */
   customHeader?: ReactNode;
   /** Bottom-of-panel slot, rendered above the archived-filter toggle. */
@@ -149,7 +154,12 @@ export function SessionsPanel(props: SessionsPanelProps): ReactNode {
   const showCreate = props.showCreateButton ?? true;
   const collapsible = props.collapsible ?? true;
 
-  const [collapsed, setCollapsed] = useState(false);
+  // `null` = the user hasn't toggled yet — follow `defaultCollapsed`. This
+  // matters because the server's feature-toggle blob resolves async: a
+  // late-arriving `sessions_panel_default_collapsed=true` still applies as
+  // long as the user hasn't made an explicit choice.
+  const [userCollapsed, setUserCollapsed] = useState<boolean | null>(null);
+  const collapsed = userCollapsed ?? props.defaultCollapsed ?? false;
   const [modalOpen, setModalOpen] = useState(false);
   const [editingSessionId, setEditingSessionId] = useState<string | null>(null);
 
@@ -176,7 +186,7 @@ export function SessionsPanel(props: SessionsPanelProps): ReactNode {
         <button
           type="button"
           className={cls.reveal}
-          onClick={() => setCollapsed(false)}
+          onClick={() => setUserCollapsed(false)}
           aria-label={texts.chat.expandSessionsPanel}
           data-testid="sessions-panel-reveal"
         >
@@ -243,7 +253,7 @@ export function SessionsPanel(props: SessionsPanelProps): ReactNode {
         <button
           type="button"
           className={cls.collapseToggle}
-          onClick={() => setCollapsed(true)}
+          onClick={() => setUserCollapsed(true)}
           aria-label={texts.chat.collapseSessionsPanel}
           data-testid="sessions-panel-collapse"
         >