import type { ChatAttachment } from "@t3tools/contracts";
import { assistantCitationsToPlainText } from "@t3tools/shared/assistantCitations";
import { isAttachmentOnlyBootstrapPrompt } from "@t3tools/shared/composerContextReferences";
export type ThreadTitleMessage = {
readonly role: "user" | "assistant" | "system" | "reasoning";
readonly text: string;
readonly attachments?: ReadonlyArray<ChatAttachment> | undefined;
};
const MAX_CONTEXT = 8_000;
const MAX_MESSAGE = 2_000;
const OMITTED = "[Earlier content truncated]\n\n";
const TRUNCATED = "\n[Content truncated]\n";
export function limitTitleMessage(text: string, budget: number): string {
if (text.length <= budget) return text;
if (budget <= TRUNCATED.length) return "";
const available = budget - TRUNCATED.length;
let head = Math.ceil(available / 2);
let tail = available - head;
// Half an emoji serializes to a lone surrogate escape, which provider JSON parsers reject.
const last = text.charCodeAt(head - 1);
if (last >= 0xd800 && last <= 0xdbff) head -= 1;
const first = text.charCodeAt(text.length - tail);
if (tail > 0 && first >= 0xdc00 && first <= 0xdfff) tail -= 1;
return `${text.slice(0, head)}${TRUNCATED}${tail > 0 ? text.slice(-tail) : ""}`;
}
export function formatThreadTitleContext(messages: ReadonlyArray<ThreadTitleMessage>) {
const sections = messages.flatMap((source, index) => {
const message = isAttachmentOnlyBootstrapPrompt(source.text) ? { ...source, text: "" } : source;
// Thinking traces dwarf answers without identifying the thread subject.
if (
message.role === "system" ||
message.role === "reasoning" ||
(!message.text.trim() && !message.attachments?.length)
)
return [];
return [{ index, message, prefix: `${message.role.toUpperCase()}:\n` }];
});
const formatted = new Map<number, string>();
const contentsFor = (section: (typeof sections)[number]) => {
const cached = formatted.get(section.index);
if (cached !== undefined) return cached;
const text = assistantCitationsToPlainText(section.message.text).trim();
const names = section.message.attachments?.map((attachment) => attachment.name).join(", ");
const contents = [text, ...(names ? [`[Attachments: ${names}]`] : [])]
.filter(Boolean)
.join("\n");
formatted.set(section.index, contents);
return contents;
};
const selected = new Map<number, string>();
let remaining = MAX_CONTEXT - OMITTED.length;
const add = (section: (typeof sections)[number], budget: number) => {
if (selected.has(section.index)) return;
const limit = Math.min(budget, remaining) - section.prefix.length - 2;
if (limit <= TRUNCATED.length) return;
const contents = limitTitleMessage(contentsFor(section), limit);
if (!contents) return;
const text = section.prefix + contents;
selected.set(section.index, text);
remaining -= text.length + 2;
};
const firstUser = sections.find((section) => section.message.role === "user");
if (firstUser) add(firstUser, MAX_MESSAGE);
for (const section of sections.toReversed()) {
if (section.message.role === "user") {
add(section, Math.min(MAX_MESSAGE, remaining - 2_000));
}
}
for (const section of sections.toReversed()) {
if (section.message.role === "assistant") add(section, MAX_MESSAGE);
}
for (const role of ["user", "assistant"] as const) {
for (const section of sections.toReversed()) {
const previous = selected.get(section.index);
if (section.message.role !== role || previous === undefined) continue;
const expanded =
section.prefix +
limitTitleMessage(
contentsFor(section),
previous.length + remaining - section.prefix.length,
);
remaining -= expanded.length - previous.length;
selected.set(section.index, expanded);
}
}
const retained = sections.filter((section) => selected.has(section.index));
const truncated = retained.some(
(section) => selected.get(section.index) !== section.prefix + contentsFor(section),
);
const attachments = retained.flatMap((section) => section.message.attachments ?? []);
const firstAttachment = firstUser?.message.attachments?.[0];
const recentAttachments = attachments.filter(
(attachment) => attachment.id !== firstAttachment?.id,
);
return {
message: `${truncated || retained.length < sections.length ? OMITTED : ""}${retained.map((section) => selected.get(section.index)).join("\n\n")}`,
attachments: [
...(firstAttachment ? [firstAttachment] : []),
...recentAttachments.slice(firstAttachment ? -3 : -4),
],
};
}