DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
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.tsxindex 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><buttontype="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.tsxindex 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.tsxindex 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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\)/,+ );+});