Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.
Python agentaichatgptdeepseekfine-tuninggemmaimage-generationllamallmllmsopenaipythonqwenreinforcement-learningself-hostedstable-diffusiontext-to-speechttsuiunsloth
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
import {
CONVERSATION_MARKDOWN_EXTENSION,
CONVERSATION_MARKDOWN_MIME_TYPE,
type ConversationMarkdownMessage,
buildConversationMarkdown,
} from "./conversation-markdown.ts";
import { parseExternalModelId } from "../external-providers.ts";
import { modelDisplayName } from "../../hub/lib/model-identity.ts";
import { stripSearchImageTokens } from "../search-images/search-images.ts";
type StoredConversationMessage = {
readonly role: unknown;
};
type ConversationMarkdownExportDependencies<
Message extends StoredConversationMessage,
> = {
readonly loadMessages: (
threadId: string,
) => Promise<readonly Message[] | null>;
readonly renderMessage: (message: Message) => string;
readonly download: (
content: string,
filename: string,
mimeType: string,
) => Promise<void>;
readonly exportBasename: (threadId: string) => Promise<string>;
readonly notifyNoContent: () => void;
};
export function createConversationMarkdownBuilder<
Message extends StoredConversationMessage,
>({
loadMessages,
renderMessage,
}: Pick<
ConversationMarkdownExportDependencies<Message>,
"loadMessages" | "renderMessage"
>): (threadId: string) => Promise<string | null> {
return async (threadId) => {
const messages = await loadMessages(threadId);
if (!messages) {
return null;
}
const normalizedMessages: ConversationMarkdownMessage[] = messages.map(
(message) => ({
role: String(message.role ?? ""),
// Strip renderer tokens here, not in the exporter, so the copy chord strips them too.
content: stripSearchImageTokens(renderMessage(message)),
}),
);
return buildConversationMarkdown(normalizedMessages, {
includeImportMetadata: true,
});
};
}
// UTF-8 bytes, leaving room under the usual 255-byte name limit for " (YYYY-MM-DD).jsonl".
const MAX_EXPORT_BASENAME_BYTES = 200;
function filenamePart(text: string): string {
return (
text
.replace(/\s+/g, " ")
// Bidi controls too: `x\u202egpj.exe` would display as `xexe.jpg`.
// eslint-disable-next-line no-control-regex
.replace(/[\\/:*?"<>|\u0000-\u001f\u007f\u061c\u200e\u200f\u202a-\u202e\u2066-\u2069]/g, "_")
.trim()
);
}
function localDateStamp(date: Date): string {
const pad = (n: number) => String(n).padStart(2, "0");
return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
}
/** `<model> - <title> (YYYY-MM-DD)`, dropping a missing part; model = its display name. */
export function conversationExportBasename(
thread:
| { readonly title?: string | null; readonly modelId?: string | null }
| null
| undefined,
date: Date,
): string {
const modelId = parseExternalModelId(thread?.modelId)?.modelId ?? thread?.modelId ?? "";
// Not split("/"): a Windows local path has no "/" and would put the whole path in the name.
const model = filenamePart(modelDisplayName(modelId));
const title = filenamePart(thread?.title ?? "");
const name = [model, title].filter(Boolean).join(" - ") || "conversation";
// Cut on a code point (no lone surrogate); Windows refuses a trailing dot or space.
const encoder = new TextEncoder();
let capped = "";
let bytes = 0;
for (const char of name) {
bytes += encoder.encode(char).length;
if (bytes > MAX_EXPORT_BASENAME_BYTES) break;
capped += char;
}
capped = capped.replace(/[. ]+$/, "");
return `${capped || "conversation"} (${localDateStamp(date)})`;
}
/** A title safe to interpolate into a heading: a line break would end it. */
function headingText(title: string): string {
return title.replace(/\s+/g, " ").trim();
}
/** Named headings so the two halves of a compare row can be told apart. */
export async function buildNamedConversationsMarkdown(
conversations: readonly { readonly id: string; readonly title: string }[],
build: (threadId: string) => Promise<string | null>,
): Promise<string> {
const parts: string[] = [];
for (const conversation of conversations) {
const markdown = await build(conversation.id);
if (!markdown) continue;
parts.push(
conversations.length > 1
? `# ${headingText(conversation.title)}\n\n${markdown}`
: markdown,
);
}
return parts.join("\n---\n\n");
}
export function createConversationMarkdownExporter<
Message extends StoredConversationMessage,
>({
loadMessages,
renderMessage,
download,
exportBasename,
notifyNoContent,
}: ConversationMarkdownExportDependencies<Message>): (
threadId: string,
) => Promise<void> {
const build = createConversationMarkdownBuilder({
loadMessages,
renderMessage,
});
return async (threadId) => {
const markdown = await build(threadId);
if (markdown === null) return;
if (!markdown) {
notifyNoContent();
return;
}
await download(
markdown,
`${await exportBasename(threadId)}.${CONVERSATION_MARKDOWN_EXTENSION}`,
CONVERSATION_MARKDOWN_MIME_TYPE,
);
};
}