@data-club/ai-hub 0.0.11 → 0.0.12

package/src/state/affordances.ts

@@ -67,6 +67,8 @@ export interface AIHubAffordanceFlags {
   scrollToPresentVisible: boolean;
   /** Whether the turn-status indicator renders in the chat header. Default true. */
   turnStatusVisible: boolean;
+  /** Whether the export-conversation (.md) button renders in the chat header. Default true. */
+  exportConversationEnabled: boolean;
 }
 
 /** Built-in defaults — applied when neither server nor React prop sets a value. */
@@ -84,6 +86,7 @@ export const DEFAULT_AFFORDANCE_FLAGS: AIHubAffordanceFlags = Object.freeze({
   effortControlVisible: true,
   scrollToPresentVisible: true,
   turnStatusVisible: true,
+  exportConversationEnabled: true,
 }) as AIHubAffordanceFlags;
 
 /**
@@ -107,6 +110,7 @@ export const FEATURE_TOGGLE_KEY_MAP: ReadonlyArray<
   ["effort_control_visible", "effortControlVisible"],
   ["scroll_to_present_visible", "scrollToPresentVisible"],
   ["turn_status_visible", "turnStatusVisible"],
+  ["export_conversation_enabled", "exportConversationEnabled"],
 ]);
 
 /**
@@ -134,7 +138,7 @@ function resolveOne(
 }
 
 /**
- * Composes the three layers into a flat resolved record of all 13
+ * Composes the three layers into a flat resolved record of all 14
  * affordance booleans.
  *
  * Per §8.4: server toggle wins; falling through, the React prop wins;

package/src/styles/default.css

@@ -1492,6 +1492,27 @@
   white-space: nowrap;
 }
 
+.data-club-ai-hub__chat-header__export {
+  padding: var(--dc-aih-space-xs) var(--dc-aih-space-sm);
+  font: inherit;
+  font-size: var(--dc-aih-font-size-sm);
+  color: var(--dc-aih-fg-muted);
+  background: transparent;
+  border: 1px solid var(--dc-aih-border);
+  border-radius: var(--dc-aih-radius-sm);
+  white-space: nowrap;
+}
+
+.data-club-ai-hub__chat-header__export:hover:not(:disabled) {
+  color: var(--dc-aih-fg);
+  background-color: color-mix(in srgb, var(--dc-aih-fg) 6%, transparent);
+}
+
+.data-club-ai-hub__chat-header__export:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
 .data-club-ai-hub__chat-header__extras {
   display: flex;
   align-items: center;

package/src/types.ts

@@ -716,6 +716,8 @@ export interface AIHubFeatureToggles {
   scroll_to_present_visible?: boolean;
   /** Overrides `showTurnStatus` prop. */
   turn_status_visible?: boolean;
+  /** Overrides `showExportButton` prop. */
+  export_conversation_enabled?: boolean;
 }
 
 /* ────────────────────────────────────────────────────────────────────────── */

package/src/util/exportConversation.ts

@@ -0,0 +1,101 @@
+/**
+ * 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 function buildConversationMarkdown(args: ConversationExportArgs): string {
+  const lines: string[] = [];
+  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: string,
+  exportedAt: Date,
+): string {
+  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`;
+}