Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

feat(partners): export group conversations as Markdown

AoHanBei909ddaee8790
diff --git a/web/app/(workspace)/partners/groups/[groupId]/page.tsx b/web/app/(workspace)/partners/groups/[groupId]/page.tsx
index 954b00e91..198a11763 100644
--- a/web/app/(workspace)/partners/groups/[groupId]/page.tsx
+++ b/web/app/(workspace)/partners/groups/[groupId]/page.tsx
@@ -1,10 +1,11 @@
"use client";
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
import Link from "next/link";
import { useParams, useRouter } from "next/navigation";
import {
ArrowLeft,
+ Download,
Loader2,
PanelRight,
Pencil,
@@ -27,8 +28,11 @@ import {
partnerGroupSessionKey,
setPartnerGroupSessionKey,
type PartnerGroup,
+ type PartnerGroupMessage,
} from "@/lib/partner-groups-api";
import { listPartners, type PartnerInfo } from "@/lib/partners-api";
+import { downloadChatMarkdown } from "@/lib/chat-export";
+import { toPartnerGroupExportMessages } from "@/lib/partner-group-export";
export default function PartnerGroupPage() {
const { t } = useTranslation();
@@ -42,6 +46,21 @@ export default function PartnerGroupPage() {
const [editing, setEditing] = useState(false);
const [panelOpen, setPanelOpen] = useState(false);
const [sessionKey, setSessionKey] = useState("");
+ const [sessionTitle, setSessionTitle] = useState("");
+ const [groupMessages, setGroupMessages] = useState<PartnerGroupMessage[]>([]);
+
+ const exportMessages = useMemo(
+ () => toPartnerGroupExportMessages(groupMessages),
+ [groupMessages],
+ );
+ const exportTitle = group
+ ? `${group.name} — ${sessionTitle || t("New discussion")}`
+ : sessionTitle;
+
+ const handleDownload = useCallback(() => {
+ if (!exportMessages.length) return;
+ downloadChatMarkdown(exportMessages, { title: exportTitle });
+ }, [exportMessages, exportTitle]);
const load = useCallback(async () => {
setLoading(true);
@@ -139,8 +158,19 @@ export default function PartnerGroupPage() {
onCreate={() =>
setSessionKey(createPartnerGroupSessionKey(groupId))
}
+ onTitleChange={setSessionTitle}
/>
) : null}
+ <button
+ type="button"
+ onClick={handleDownload}
+ disabled={!groupMessages.length}
+ title={t("Download chat history as Markdown")}
+ aria-label={t("Download Markdown")}
+ className="rounded-md p-1.5 text-[var(--muted-foreground)] transition-colors hover:bg-[var(--muted)] hover:text-[var(--foreground)] disabled:cursor-not-allowed disabled:opacity-40"
+ >
+ <Download className="h-4 w-4" />
+ </button>
<button
type="button"
onClick={() => setPanelOpen((value) => !value)}
@@ -170,6 +200,7 @@ export default function PartnerGroupPage() {
panelOpen={panelOpen}
onOpenPanel={() => setPanelOpen(true)}
onClosePanel={() => setPanelOpen(false)}
+ onMessagesChange={setGroupMessages}
/>
{editing ? (
diff --git a/web/components/partners/group/GroupSessionPicker.tsx b/web/components/partners/group/GroupSessionPicker.tsx
index e1858279c..9b56cb83c 100644
--- a/web/components/partners/group/GroupSessionPicker.tsx
+++ b/web/components/partners/group/GroupSessionPicker.tsx
@@ -23,11 +23,13 @@ export default function GroupSessionPicker({
sessionKey,
onSelect,
onCreate,
+ onTitleChange,
}: {
groupId: string;
sessionKey: string;
onSelect: (key: string) => void;
onCreate: () => void;
+ onTitleChange?: (title: string) => void;
}) {
const { t } = useTranslation();
const [open, setOpen] = useState(false);
@@ -66,6 +68,10 @@ export default function GroupSessionPicker({
const current = sessions.find((item) => item.session_key === sessionKey);
const label = current?.title || t("New discussion");
+ useEffect(() => {
+ onTitleChange?.(label);
+ }, [label, onTitleChange]);
+
const remove = async (key: string) => {
setBusy(key);
try {
diff --git a/web/components/partners/group/PartnerGroupChat.tsx b/web/components/partners/group/PartnerGroupChat.tsx
index 624edac4a..473fbff0e 100644
--- a/web/components/partners/group/PartnerGroupChat.tsx
+++ b/web/components/partners/group/PartnerGroupChat.tsx
@@ -9,6 +9,7 @@ import { TurnNavigator } from "@/components/chat/home/TurnNavigator";
import {
getPartnerGroupWhiteboard,
type PartnerGroup,
+ type PartnerGroupMessage,
type WhiteboardEntry,
} from "@/lib/partner-groups-api";
@@ -36,6 +37,7 @@ export default function PartnerGroupChat({
panelOpen,
onOpenPanel,
onClosePanel,
+ onMessagesChange,
embedded = false,
consultationActive = false,
}: {
@@ -48,6 +50,8 @@ export default function PartnerGroupChat({
panelOpen: boolean;
onOpenPanel: () => void;
onClosePanel: () => void;
+ /** Lift the settled transcript to page-level export controls. */
+ onMessagesChange?: (messages: PartnerGroupMessage[]) => void;
}) {
const { t } = useTranslation();
const [quote, setQuote] = useState<QuotedSpeech | null>(null);
@@ -56,6 +60,7 @@ export default function PartnerGroupChat({
const [traceFocus, setTraceFocus] = useState<TraceFocus | null>(null);
const {
+ messages,
rounds,
reportConsultationActivity,
running,
@@ -72,6 +77,13 @@ export default function PartnerGroupChat({
cancel,
} = useGroupSession(group, sessionKey);
+ // Match direct Partner chat: export only persisted messages, never a
+ // token-by-token draft. Clear the lifted transcript while another thread
+ // is loading so the header cannot download the previous discussion.
+ useEffect(() => {
+ onMessagesChange?.(loading ? [] : messages);
+ }, [loading, messages, onMessagesChange]);
+
const draftRef = useRef(false);
const lastInteraction = useRef(0);
const reportInteraction = useCallback(() => {
diff --git a/web/components/partners/group/useGroupSession.ts b/web/components/partners/group/useGroupSession.ts
index daf3cbda3..03d00155c 100644
--- a/web/components/partners/group/useGroupSession.ts
+++ b/web/components/partners/group/useGroupSession.ts
@@ -555,6 +555,7 @@ export function useGroupSession(group: PartnerGroup, sessionKey: string) {
}, [live, messages]);
return {
+ messages,
rounds,
reportConsultationActivity,
running: Boolean(live),
diff --git a/web/lib/chat-export.ts b/web/lib/chat-export.ts
index 6c84fa37a..443fe199c 100644
--- a/web/lib/chat-export.ts
+++ b/web/lib/chat-export.ts
@@ -12,6 +12,8 @@ export interface ExportableAttachment {
export interface ExportableMessage {
role: string;
content: string;
+ /** Optional human-readable author for multi-speaker conversations. */
+ speaker?: string;
capability?: string;
attachments?: ExportableAttachment[];
}
@@ -22,6 +24,13 @@ function roleHeading(role: string): string {
return "System";
}
+function messageHeading(message: ExportableMessage): string {
+ // Keep an untrusted display name on one Markdown heading line. Markdown
+ // punctuation is harmless here, but line breaks could forge extra blocks.
+ const speaker = message.speaker?.trim().replace(/\s+/g, " ");
+ return speaker || roleHeading(message.role);
+}
+
function formatAttachments(attachments?: ExportableAttachment[]): string {
if (!attachments?.length) return "";
const items = attachments
@@ -47,7 +56,7 @@ export function buildChatMarkdown(
const header = `# ${title}\n\n_Exported: ${exportedAt}_\n\n---\n\n`;
const body = messages
.map((msg) => {
- const role = roleHeading(msg.role);
+ const role = messageHeading(msg);
const cap = msg.capability ? ` _(${msg.capability})_` : "";
const attachments = formatAttachments(msg.attachments);
const content = (msg.content ?? "").trim();
diff --git a/web/lib/partner-group-export.ts b/web/lib/partner-group-export.ts
new file mode 100644
index 000000000..8b28ba8df
--- /dev/null
+++ b/web/lib/partner-group-export.ts
@@ -0,0 +1,24 @@
+import type { ExportableMessage } from "@/lib/chat-export";
+import type { PartnerGroupMessage } from "@/lib/partner-groups-api";
+
+/**
+ * Adapt a persisted Partner Group transcript to the shared Markdown exporter.
+ *
+ * Group history calls assistant messages `partner`; the shared exporter calls
+ * them `assistant`. Preserve each Partner's visible name so a panel discussion
+ * remains attributable after it leaves the app.
+ */
+export function toPartnerGroupExportMessages(
+ messages: PartnerGroupMessage[],
+): ExportableMessage[] {
+ return messages
+ .filter((message) => message.kind !== "round_stopped")
+ .map((message) => ({
+ role: message.role === "partner" ? "assistant" : "user",
+ content: message.content,
+ speaker:
+ message.role === "partner"
+ ? message.author_name.trim() || "Partner"
+ : undefined,
+ }));
+}
diff --git a/web/tests/partner-group-export.test.ts b/web/tests/partner-group-export.test.ts
new file mode 100644
index 000000000..fd1a35a2e
--- /dev/null
+++ b/web/tests/partner-group-export.test.ts
@@ -0,0 +1,119 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+
+import { buildChatMarkdown } from "../lib/chat-export";
+import { toPartnerGroupExportMessages } from "../lib/partner-group-export";
+import type { PartnerGroupMessage } from "../lib/partner-groups-api";
+
+function message(
+ role: "user" | "partner",
+ content: string,
+ authorName = "",
+ kind = "message",
+): PartnerGroupMessage {
+ return {
+ event_id: `${role}-${content}`,
+ turn_id: "turn-1",
+ session_key: "group-session",
+ role,
+ content,
+ author_id: role === "user" ? "user" : authorName.toLowerCase(),
+ author_name: authorName,
+ created_at: "2026-09-23T00:00:00Z",
+ mentions: [],
+ error: false,
+ kind,
+ events: [],
+ invocation_id: "",
+ invocation: null,
+ };
+}
+
+test("group export preserves transcript order and Partner attribution", () => {
+ const messages = toPartnerGroupExportMessages([
+ message("user", "Compare both approaches."),
+ message("partner", "The first favors recall.", "Ada"),
+ message("partner", "The second favors precision.", "Turing"),
+ ]);
+
+ assert.deepEqual(
+ messages.map(({ role, content, speaker }) => ({ role, content, speaker })),
+ [
+ { role: "user", content: "Compare both approaches.", speaker: undefined },
+ {
+ role: "assistant",
+ content: "The first favors recall.",
+ speaker: "Ada",
+ },
+ {
+ role: "assistant",
+ content: "The second favors precision.",
+ speaker: "Turing",
+ },
+ ],
+ );
+
+ const markdown = buildChatMarkdown(messages, {
+ title: "Research panel — Retrieval",
+ exportedAt: new Date("2026-09-23T08:00:00Z"),
+ });
+ assert.match(markdown, /^# Research panel — Retrieval/);
+ assert.match(markdown, /_Exported: 2026-09-23T08:00:00\.000Z_/);
+ assert.match(markdown, /## User\n\nCompare both approaches\./);
+ assert.match(markdown, /## Ada\n\nThe first favors recall\./);
+ assert.match(markdown, /## Turing\n\nThe second favors precision\./);
+ assert.ok(markdown.indexOf("## Ada") < markdown.indexOf("## Turing"));
+});
+
+test("group export keeps untrusted speaker names on one heading line", () => {
+ const [exported] = toPartnerGroupExportMessages([
+ message("partner", "Still one message.", "Ada\n## Forged"),
+ ]);
+ const markdown = buildChatMarkdown([exported], {
+ exportedAt: new Date("2026-09-23T08:00:00Z"),
+ });
+ assert.match(markdown, /## Ada ## Forged\n\nStill one message\./);
+ assert.doesNotMatch(markdown, /## Ada\n## Forged/);
+});
+
+test("group export omits persisted round metadata", () => {
+ const messages = toPartnerGroupExportMessages([
+ message("user", "Start a panel."),
+ message("partner", "Cancelled", "", "round_stopped"),
+ ]);
+
+ assert.deepEqual(messages, [
+ {
+ role: "user",
+ content: "Start a panel.",
+ speaker: undefined,
+ },
+ ]);
+});
+
+test("group page exposes a disabled-until-ready Markdown download control", () => {
+ const pageSource = readFileSync(
+ path.resolve(
+ process.cwd(),
+ "app/(workspace)/partners/groups/[groupId]/page.tsx",
+ ),
+ "utf8",
+ );
+ const chatSource = readFileSync(
+ path.resolve(
+ process.cwd(),
+ "components/partners/group/PartnerGroupChat.tsx",
+ ),
+ "utf8",
+ );
+
+ assert.match(pageSource, /downloadChatMarkdown\(exportMessages/);
+ assert.match(pageSource, /disabled=\{!groupMessages\.length\}/);
+ assert.match(pageSource, /onMessagesChange=\{setGroupMessages\}/);
+ assert.match(
+ chatSource,
+ /onMessagesChange\?\.\(loading \? \[\] : messages\)/,
+ );
+});