Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

feat(threads): auto-generate first-turn thread titles (#1375)

maria5513845fd56a
diff --git a/apps/server/integration/OrchestrationEngineHarness.integration.ts b/apps/server/integration/OrchestrationEngineHarness.integration.ts
index 115d18d02..1a8f802d7 100644
--- a/apps/server/integration/OrchestrationEngineHarness.integration.ts
+++ b/apps/server/integration/OrchestrationEngineHarness.integration.ts
@@ -306,7 +306,8 @@ export const makeOrchestrationIntegrationHarness = (
Effect.succeed({ branch: input.newBranch }),
} as unknown as GitCoreShape);
const textGenerationLayer = Layer.succeed(TextGeneration, {
- generateBranchName: () => Effect.succeed({ branch: null }),
+ generateBranchName: () => Effect.succeed({ branch: "update" }),
+ generateThreadTitle: () => Effect.succeed({ title: "New thread" }),
} as unknown as TextGenerationShape);
const providerCommandReactorLayer = ProviderCommandReactorLive.pipe(
Layer.provideMerge(runtimeServicesLayer),
diff --git a/apps/server/src/git/Layers/ClaudeTextGeneration.test.ts b/apps/server/src/git/Layers/ClaudeTextGeneration.test.ts
index 29ae4796f..084713469 100644
--- a/apps/server/src/git/Layers/ClaudeTextGeneration.test.ts
+++ b/apps/server/src/git/Layers/ClaudeTextGeneration.test.ts
@@ -5,6 +5,7 @@ import { expect } from "vitest";
import { ServerConfig } from "../../config.ts";
import { TextGeneration } from "../Services/TextGeneration.ts";
+import { sanitizeThreadTitle } from "../Utils.ts";
import { ClaudeTextGenerationLive } from "./ClaudeTextGeneration.ts";
import { ServerSettingsService } from "../../serverSettings.ts";
@@ -247,4 +248,62 @@ it.layer(ClaudeTextGenerationTestLayer)("ClaudeTextGenerationLive", (it) => {
}),
),
);
+
+ it.effect("generates thread titles through the Claude provider", () =>
+ withFakeClaudeEnv(
+ {
+ output: JSON.stringify({
+ structured_output: {
+ title:
+ ' "Reconnect failures after restart because the session state does not recover" ',
+ },
+ }),
+ stdinMustContain: "You write concise thread titles for coding conversations.",
+ },
+ Effect.gen(function* () {
+ const textGeneration = yield* TextGeneration;
+
+ const generated = yield* textGeneration.generateThreadTitle({
+ cwd: process.cwd(),
+ message: "Please investigate reconnect failures after restarting the session.",
+ modelSelection: {
+ provider: "claudeAgent",
+ model: "claude-sonnet-4-6",
+ },
+ });
+
+ expect(generated.title).toBe(
+ sanitizeThreadTitle(
+ '"Reconnect failures after restart because the session state does not recover"',
+ ),
+ );
+ }),
+ ),
+ );
+
+ it.effect("falls back when Claude thread title normalization becomes whitespace-only", () =>
+ withFakeClaudeEnv(
+ {
+ output: JSON.stringify({
+ structured_output: {
+ title: ' """ """ ',
+ },
+ }),
+ },
+ Effect.gen(function* () {
+ const textGeneration = yield* TextGeneration;
+
+ const generated = yield* textGeneration.generateThreadTitle({
+ cwd: process.cwd(),
+ message: "Name this thread.",
+ modelSelection: {
+ provider: "claudeAgent",
+ model: "claude-sonnet-4-6",
+ },
+ });
+
+ expect(generated.title).toBe("New thread");
+ }),
+ ),
+ );
});
diff --git a/apps/server/src/git/Layers/ClaudeTextGeneration.ts b/apps/server/src/git/Layers/ClaudeTextGeneration.ts
index 919c3a323..f4d383362 100644
--- a/apps/server/src/git/Layers/ClaudeTextGeneration.ts
+++ b/apps/server/src/git/Layers/ClaudeTextGeneration.ts
@@ -20,11 +20,13 @@ import {
buildBranchNamePrompt,
buildCommitMessagePrompt,
buildPrContentPrompt,
+ buildThreadTitlePrompt,
} from "../Prompts.ts";
import {
normalizeCliError,
sanitizeCommitSubject,
sanitizePrTitle,
+ sanitizeThreadTitle,
toJsonSchemaObject,
} from "../Utils.ts";
import { normalizeClaudeModelOptions } from "../../provider/Layers/ClaudeProvider.ts";
@@ -70,7 +72,11 @@ const makeClaudeTextGeneration = Effect.gen(function* () {
outputSchemaJson,
modelSelection,
}: {
- operation: "generateCommitMessage" | "generatePrContent" | "generateBranchName";
+ operation:
+ | "generateCommitMessage"
+ | "generatePrContent"
+ | "generateBranchName"
+ | "generateThreadTitle";
cwd: string;
prompt: string;
outputSchemaJson: S;
@@ -299,10 +305,39 @@ const makeClaudeTextGeneration = Effect.gen(function* () {
};
});
+ const generateThreadTitle: TextGenerationShape["generateThreadTitle"] = Effect.fn(
+ "ClaudeTextGeneration.generateThreadTitle",
+ )(function* (input) {
+ const { prompt, outputSchema } = buildThreadTitlePrompt({
+ message: input.message,
+ attachments: input.attachments,
+ });
+
+ if (input.modelSelection.provider !== "claudeAgent") {
+ return yield* new TextGenerationError({
+ operation: "generateThreadTitle",
+ detail: "Invalid model selection.",
+ });
+ }
+
+ const generated = yield* runClaudeJson({
+ operation: "generateThreadTitle",
+ cwd: input.cwd,
+ prompt,
+ outputSchemaJson: outputSchema,
+ modelSelection: input.modelSelection,
+ });
+
+ return {
+ title: sanitizeThreadTitle(generated.title),
+ };
+ });
+
return {
generateCommitMessage,
generatePrContent,
generateBranchName,
+ generateThreadTitle,
} satisfies TextGenerationShape;
});
diff --git a/apps/server/src/git/Layers/CodexTextGeneration.test.ts b/apps/server/src/git/Layers/CodexTextGeneration.test.ts
index 1b07d87d9..21a97eec9 100644
--- a/apps/server/src/git/Layers/CodexTextGeneration.test.ts
+++ b/apps/server/src/git/Layers/CodexTextGeneration.test.ts
@@ -358,6 +358,70 @@ it.layer(CodexTextGenerationTestLayer)("CodexTextGenerationLive", (it) => {
),
);
+ it.effect("generates thread titles and trims them for sidebar use", () =>
+ withFakeCodexEnv(
+ {
+ output: JSON.stringify({
+ title:
+ ' "Investigate websocket reconnect regressions after worktree restore" \nignored line',
+ }),
+ },
+ Effect.gen(function* () {
+ const textGeneration = yield* TextGeneration;
+
+ const generated = yield* textGeneration.generateThreadTitle({
+ cwd: process.cwd(),
+ message: "Please investigate websocket reconnect regressions after a worktree restore.",
+ modelSelection: DEFAULT_TEST_MODEL_SELECTION,
+ });
+
+ expect(generated.title).toBe("Investigate websocket reconnect regressions aft...");
+ }),
+ ),
+ );
+
+ it.effect("falls back when thread title normalization becomes whitespace-only", () =>
+ withFakeCodexEnv(
+ {
+ output: JSON.stringify({
+ title: ' """ """ ',
+ }),
+ },
+ Effect.gen(function* () {
+ const textGeneration = yield* TextGeneration;
+
+ const generated = yield* textGeneration.generateThreadTitle({
+ cwd: process.cwd(),
+ message: "Name this thread.",
+ modelSelection: DEFAULT_TEST_MODEL_SELECTION,
+ });
+
+ expect(generated.title).toBe("New thread");
+ }),
+ ),
+ );
+
+ it.effect("trims whitespace exposed after quote removal in thread titles", () =>
+ withFakeCodexEnv(
+ {
+ output: JSON.stringify({
+ title: ` "' hello world '" `,
+ }),
+ },
+ Effect.gen(function* () {
+ const textGeneration = yield* TextGeneration;
+
+ const generated = yield* textGeneration.generateThreadTitle({
+ cwd: process.cwd(),
+ message: "Name this thread.",
+ modelSelection: DEFAULT_TEST_MODEL_SELECTION,
+ });
+
+ expect(generated.title).toBe("hello world");
+ }),
+ ),
+ );
+
it.effect("omits attachment metadata section when no attachments are provided", () =>
withFakeCodexEnv(
{
diff --git a/apps/server/src/git/Layers/CodexTextGeneration.ts b/apps/server/src/git/Layers/CodexTextGeneration.ts
index 8f332bf13..c82923f93 100644
--- a/apps/server/src/git/Layers/CodexTextGeneration.ts
+++ b/apps/server/src/git/Layers/CodexTextGeneration.ts
@@ -11,6 +11,7 @@ import { ServerConfig } from "../../config.ts";
import { TextGenerationError } from "../Errors.ts";
import {
type BranchNameGenerationInput,
+ type ThreadTitleGenerationResult,
type TextGenerationShape,
TextGeneration,
} from "../Services/TextGeneration.ts";
@@ -18,11 +19,13 @@ import {
buildBranchNamePrompt,
buildCommitMessagePrompt,
buildPrContentPrompt,
+ buildThreadTitlePrompt,
} from "../Prompts.ts";
import {
normalizeCliError,
sanitizeCommitSubject,
sanitizePrTitle,
+ sanitizeThreadTitle,
toJsonSchemaObject,
} from "../Utils.ts";
import { normalizeCodexModelOptions } from "../../provider/Layers/CodexProvider.ts";
@@ -30,7 +33,6 @@ import { ServerSettingsService } from "../../serverSettings.ts";
const CODEX_GIT_TEXT_GENERATION_REASONING_EFFORT = "low";
const CODEX_TIMEOUT_MS = 180_000;
-
const makeCodexTextGeneration = Effect.gen(function* () {
const fileSystem = yield* FileSystem.FileSystem;
const path = yield* Path.Path;
@@ -83,7 +85,11 @@ const makeCodexTextGeneration = Effect.gen(function* () {
fileSystem.remove(filePath).pipe(Effect.catch(() => Effect.void));
const materializeImageAttachments = (
- _operation: "generateCommitMessage" | "generatePrContent" | "generateBranchName",
+ _operation:
+ | "generateCommitMessage"
+ | "generatePrContent"
+ | "generateBranchName"
+ | "generateThreadTitle",
attachments: BranchNameGenerationInput["attachments"],
): Effect.Effect<MaterializedImageAttachments, TextGenerationError> =>
Effect.gen(function* () {
@@ -124,7 +130,11 @@ const makeCodexTextGeneration = Effect.gen(function* () {
cleanupPaths = [],
modelSelection,
}: {
- operation: "generateCommitMessage" | "generatePrContent" | "generateBranchName";
+ operation:
+ | "generateCommitMessage"
+ | "generatePrContent"
+ | "generateBranchName"
+ | "generateThreadTitle";
cwd: string;
prompt: string;
outputSchemaJson: S;
@@ -363,10 +373,44 @@ const makeCodexTextGeneration = Effect.gen(function* () {
};
});
+ const generateThreadTitle: TextGenerationShape["generateThreadTitle"] = Effect.fn(
+ "CodexTextGeneration.generateThreadTitle",
+ )(function* (input) {
+ const { imagePaths } = yield* materializeImageAttachments(
+ "generateThreadTitle",
+ input.attachments,
+ );
+ const { prompt, outputSchema } = buildThreadTitlePrompt({
+ message: input.message,
+ attachments: input.attachments,
+ });
+
+ if (input.modelSelection.provider !== "codex") {
+ return yield* new TextGenerationError({
+ operation: "generateThreadTitle",
+ detail: "Invalid model selection.",
+ });
+ }
+
+ const generated = yield* runCodexJson({
+ operation: "generateThreadTitle",
+ cwd: input.cwd,
+ prompt,
+ outputSchemaJson: outputSchema,
+ imagePaths,
+ modelSelection: input.modelSelection,
+ });
+
+ return {
+ title: sanitizeThreadTitle(generated.title),
+ } satisfies ThreadTitleGenerationResult;
+ });
+
return {
generateCommitMessage,
generatePrContent,
generateBranchName,
+ generateThreadTitle,
} satisfies TextGenerationShape;
});
diff --git a/apps/server/src/git/Layers/GitManager.test.ts b/apps/server/src/git/Layers/GitManager.test.ts
index 57d6853c4..d13c389fc 100644
--- a/apps/server/src/git/Layers/GitManager.test.ts
+++ b/apps/server/src/git/Layers/GitManager.test.ts
@@ -6,7 +6,7 @@ import * as NodeServices from "@effect/platform-node/NodeServices";
import { it } from "@effect/vitest";
import { Effect, FileSystem, Layer, PlatformError, Scope } from "effect";
import { expect } from "vitest";
-import type { GitActionProgressEvent } from "@t3tools/contracts";
+import type { GitActionProgressEvent, ModelSelection } from "@t3tools/contracts";
import { GitCommandError, GitHubCliError, TextGenerationError } from "../Errors.ts";
import { type GitManagerShape } from "../Services/GitManager.ts";
@@ -49,6 +49,7 @@ interface FakeGitTextGeneration {
stagedSummary: string;
stagedPatch: string;
includeBranch?: boolean;
+ modelSelection: ModelSelection;
}) => Effect.Effect<
{ subject: string; body: string; branch?: string | undefined },
TextGenerationError
@@ -60,11 +61,18 @@ interface FakeGitTextGeneration {
commitSummary: string;
diffSummary: string;
diffPatch: string;
+ modelSelection: ModelSelection;
}) => Effect.Effect<{ title: string; body: string }, TextGenerationError>;
generateBranchName: (input: {
cwd: string;
message: string;
+ modelSelection: ModelSelection;
}) => Effect.Effect<{ branch: string }, TextGenerationError>;
+ generateThreadTitle: (input: {
+ cwd: string;
+ message: string;
+ modelSelection: ModelSelection;
+ }) => Effect.Effect<{ title: string }, TextGenerationError>;
}
type FakePullRequest = NonNullable<FakeGhScenario["pullRequest"]>;
@@ -168,6 +176,10 @@ function createTextGeneration(overrides: Partial<FakeGitTextGeneration> = {}): T
Effect.succeed({
branch: "update-workflow",
}),
+ generateThreadTitle: () =>
+ Effect.succeed({
+ title: "Update workflow",
+ }),
...overrides,
};
@@ -205,6 +217,17 @@ function createTextGeneration(overrides: Partial<FakeGitTextGeneration> = {}): T
}),
),
),
+ generateThreadTitle: (input) =>
+ implementation.generateThreadTitle(input).pipe(
+ Effect.mapError(
+ (cause) =>
+ new TextGenerationError({
+ operation: "generateThreadTitle",
+ detail: "fake text generation failed",
+ ...(cause !== undefined ? { cause } : {}),
+ }),
+ ),
+ ),
};
}
diff --git a/apps/server/src/git/Layers/RoutingTextGeneration.ts b/apps/server/src/git/Layers/RoutingTextGeneration.ts
index 791513138..dee12a3e0 100644
--- a/apps/server/src/git/Layers/RoutingTextGeneration.ts
+++ b/apps/server/src/git/Layers/RoutingTextGeneration.ts
@@ -47,6 +47,7 @@ const makeRoutingTextGeneration = Effect.gen(function* () {
route(input.modelSelection.provider).generateCommitMessage(input),
generatePrContent: (input) => route(input.modelSelection.provider).generatePrContent(input),
generateBranchName: (input) => route(input.modelSelection.provider).generateBranchName(input),
+ generateThreadTitle: (input) => route(input.modelSelection.provider).generateThreadTitle(input),
} satisfies TextGenerationShape;
});
diff --git a/apps/server/src/git/Prompts.test.ts b/apps/server/src/git/Prompts.test.ts
index 23c3eca55..7951e78b3 100644
--- a/apps/server/src/git/Prompts.test.ts
+++ b/apps/server/src/git/Prompts.test.ts
@@ -4,8 +4,9 @@ import {
buildBranchNamePrompt,
buildCommitMessagePrompt,
buildPrContentPrompt,
+ buildThreadTitlePrompt,
} from "./Prompts.ts";
-import { normalizeCliError } from "./Utils.ts";
+import { normalizeCliError, sanitizeThreadTitle } from "./Utils.ts";
import { TextGenerationError } from "./Errors.ts";
describe("buildCommitMessagePrompt", () => {
@@ -103,6 +104,48 @@ describe("buildBranchNamePrompt", () => {
});
});
+describe("buildThreadTitlePrompt", () => {
+ it("includes the user message in the prompt", () => {
+ const result = buildThreadTitlePrompt({
+ message: "Investigate reconnect regressions after session restore",
+ });
+
+ expect(result.prompt).toContain("User message:");
+ expect(result.prompt).toContain("Investigate reconnect regressions after session restore");
+ expect(result.prompt).not.toContain("Attachment metadata:");
+ });
+
+ it("includes attachment metadata when attachments are provided", () => {
+ const result = buildThreadTitlePrompt({
+ message: "Name this thread from the screenshot",
+ attachments: [
+ {
+ type: "image" as const,
+ id: "att-456",
+ name: "thread.png",
+ mimeType: "image/png",
+ sizeBytes: 67890,
+ },
+ ],
+ });
+
+ expect(result.prompt).toContain("Attachment metadata:");
+ expect(result.prompt).toContain("thread.png");
+ expect(result.prompt).toContain("image/png");
+ expect(result.prompt).toContain("67890 bytes");
+ });
+});
+
+describe("sanitizeThreadTitle", () => {
+ it("truncates long titles with the shared sidebar-safe limit", () => {
+ expect(
+ sanitizeThreadTitle(
+ ' "Reconnect failures after restart because the session state does not recover" ',
+ ),
+ ).toBe("Reconnect failures after restart because the se...");
+ });
+});
+
describe("normalizeCliError", () => {
it("detects 'Command not found' and includes CLI name in the message", () => {
const error = normalizeCliError(
diff --git a/apps/server/src/git/Prompts.ts b/apps/server/src/git/Prompts.ts
index 2eacf370e..409235882 100644
--- a/apps/server/src/git/Prompts.ts
+++ b/apps/server/src/git/Prompts.ts
@@ -119,19 +119,24 @@ export interface BranchNamePromptInput {
attachments?: ReadonlyArray<ChatAttachment> | undefined;
}
-export function buildBranchNamePrompt(input: BranchNamePromptInput) {
+interface PromptFromMessageInput {
+ instruction: string;
+ responseShape: string;
+ rules: ReadonlyArray<string>;
+ message: string;
+ attachments?: ReadonlyArray<ChatAttachment> | undefined;
+}
+
+function buildPromptFromMessage(input: PromptFromMessageInput): string {
const attachmentLines = (input.attachments ?? []).map(
(attachment) => `- ${attachment.name} (${attachment.mimeType}, ${attachment.sizeBytes} bytes)`,
);
const promptSections = [
- "You generate concise git branch names.",
- "Return a JSON object with key: branch.",
+ input.instruction,
+ input.responseShape,
"Rules:",
- "- Branch should describe the requested work from the user message.",
- "- Keep it short and specific (2-6 words).",
- "- Use plain words only, no issue prefixes and no punctuation-heavy text.",
- "- If images are attached, use them as primary context for visual/UI issues.",
+ ...input.rules.map((rule) => `- ${rule}`),
"",
"User message:",
limitSection(input.message, 8_000),
@@ -144,10 +149,54 @@ export function buildBranchNamePrompt(input: BranchNamePromptInput) {
);
}
- const prompt = promptSections.join("\n");
+ return promptSections.join("\n");
+}
+
+export function buildBranchNamePrompt(input: BranchNamePromptInput) {
+ const prompt = buildPromptFromMessage({
+ instruction: "You generate concise git branch names.",
+ responseShape: "Return a JSON object with key: branch.",
+ rules: [
+ "Branch should describe the requested work from the user message.",
+ "Keep it short and specific (2-6 words).",
+ "Use plain words only, no issue prefixes and no punctuation-heavy text.",
+ "If images are attached, use them as primary context for visual/UI issues.",
+ ],
+ message: input.message,
+ attachments: input.attachments,
+ });
const outputSchema = Schema.Struct({
branch: Schema.String,
});
return { prompt, outputSchema };
}
+
+// ---------------------------------------------------------------------------
+// Thread title
+// ---------------------------------------------------------------------------
+
+export interface ThreadTitlePromptInput {
+ message: string;
+ attachments?: ReadonlyArray<ChatAttachment> | undefined;
+}
+
+export function buildThreadTitlePrompt(input: ThreadTitlePromptInput) {
+ const prompt = buildPromptFromMessage({
+ instruction: "You write concise thread titles for coding conversations.",
+ responseShape: "Return a JSON object with key: title.",
+ rules: [
+ "Title should summarize the user's request, not restate it verbatim.",
+ "Keep it short and specific (3-8 words).",
+ "Avoid quotes, filler, prefixes, and trailing punctuation.",
+ "If images are attached, use them as primary context for visual/UI issues.",
+ ],
+ message: input.message,
+ attachments: input.attachments,
+ });
+ const outputSchema = Schema.Struct({
+ title: Schema.String,
+ });
+
+ return { prompt, outputSchema };
+}
diff --git a/apps/server/src/git/Services/TextGeneration.ts b/apps/server/src/git/Services/TextGeneration.ts
index e9f2230f4..0df2fff62 100644
--- a/apps/server/src/git/Services/TextGeneration.ts
+++ b/apps/server/src/git/Services/TextGeneration.ts
@@ -61,12 +61,25 @@ export interface BranchNameGenerationResult {
branch: string;
}
+export interface ThreadTitleGenerationInput {
+ cwd: string;
+ message: string;
+ attachments?: ReadonlyArray<ChatAttachment> | undefined;
+ /** What model and provider to use for generation. */
+ modelSelection: ModelSelection;
+}
+
+export interface ThreadTitleGenerationResult {
+ title: string;
+}
+
export interface TextGenerationService {
generateCommitMessage(
input: CommitMessageGenerationInput,
): Promise<CommitMessageGenerationResult>;
generatePrContent(input: PrContentGenerationInput): Promise<PrContentGenerationResult>;
generateBranchName(input: BranchNameGenerationInput): Promise<BranchNameGenerationResult>;
+ generateThreadTitle(input: ThreadTitleGenerationInput): Promise<ThreadTitleGenerationResult>;
}
/**
@@ -93,6 +106,13 @@ export interface TextGenerationShape {
readonly generateBranchName: (
input: BranchNameGenerationInput,
) => Effect.Effect<BranchNameGenerationResult, TextGenerationError>;
+
+ /**
+ * Generate a concise thread title from a user's first message.
+ */
+ readonly generateThreadTitle: (
+ input: ThreadTitleGenerationInput,
+ ) => Effect.Effect<ThreadTitleGenerationResult, TextGenerationError>;
}
/**
diff --git a/apps/server/src/git/Utils.ts b/apps/server/src/git/Utils.ts
index eb208decc..8f0321fd5 100644
--- a/apps/server/src/git/Utils.ts
+++ b/apps/server/src/git/Utils.ts
@@ -53,6 +53,27 @@ export function sanitizePrTitle(raw: string): string {
return "Update project changes";
}
+/** Normalise a raw thread title to a compact single-line sidebar-safe label. */
+export function sanitizeThreadTitle(raw: string): string {
+ const normalized = raw
+ .trim()
+ .split(/\r?\n/g)[0]
+ ?.trim()
+ .replace(/^['"`]+|['"`]+$/g, "")
+ .trim()
+ .replace(/\s+/g, " ");
+
+ if (!normalized || normalized.trim().length === 0) {
+ return "New thread";
+ }
+
+ if (normalized.length <= 50) {
+ return normalized;
+ }
+
+ return `${normalized.slice(0, 47).trimEnd()}...`;
+}
+
/** CLI name to human-readable label, e.g. "codex" → "Codex CLI (`codex`)" */
function cliLabel(cliName: string): string {
const capitalized = cliName.charAt(0).toUpperCase() + cliName.slice(1);
diff --git a/apps/server/src/orchestration/Layers/ProviderCommandReactor.test.ts b/apps/server/src/orchestration/Layers/ProviderCommandReactor.test.ts
index 834ab9be9..4e87390eb 100644
--- a/apps/server/src/orchestration/Layers/ProviderCommandReactor.test.ts
+++ b/apps/server/src/orchestration/Layers/ProviderCommandReactor.test.ts
@@ -176,7 +176,7 @@ describe("ProviderCommandReactor", () => {
: "renamed-branch",
}),
);
- const generateBranchName = vi.fn(() =>
+ const generateBranchName = vi.fn<TextGenerationShape["generateBranchName"]>((_) =>
Effect.fail(
new TextGenerationError({
operation: "generateBranchName",
@@ -184,6 +184,14 @@ describe("ProviderCommandReactor", () => {
}),
),
);
+ const generateThreadTitle = vi.fn<TextGenerationShape["generateThreadTitle"]>((_) =>
+ Effect.fail(
+ new TextGenerationError({
+ operation: "generateThreadTitle",
+ detail: "disabled in test harness",
+ }),
+ ),
+ );
const unsupported = () => Effect.die(new Error("Unsupported provider call in test")) as never;
const service: ProviderServiceShape = {
@@ -213,7 +221,10 @@ describe("ProviderCommandReactor", () => {
Layer.provideMerge(Layer.succeed(ProviderService, service)),
Layer.provideMerge(Layer.succeed(GitCore, { renameBranch } as unknown as GitCoreShape)),
Layer.provideMerge(
- Layer.succeed(TextGeneration, { generateBranchName } as unknown as TextGenerationShape),
+ Layer.mock(TextGeneration, {
+ generateBranchName,
+ generateThreadTitle,
+ }),
),
Layer.provideMerge(ServerSettingsService.layerTest()),
Layer.provideMerge(ServerConfig.layerTest(process.cwd(), baseDir)),
@@ -264,6 +275,7 @@ describe("ProviderCommandReactor", () => {
stopSession,
renameBranch,
generateBranchName,
+ generateThreadTitle,
stateDir,
drain,
};
@@ -308,6 +320,199 @@ describe("ProviderCommandReactor", () => {
expect(thread?.session?.runtimeMode).toBe("approval-required");
});
+ it("generates a thread title on the first turn", async () => {
+ const harness = await createHarness();
+ const now = new Date().toISOString();
+ const seededTitle = "Please investigate reconnect failures after restar...";
+ harness.generateThreadTitle.mockReturnValue(Effect.succeed({ title: "Generated title" }));
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.meta.update",
+ commandId: CommandId.makeUnsafe("cmd-thread-title-seed"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ title: seededTitle,
+ }),
+ );
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.turn.start",
+ commandId: CommandId.makeUnsafe("cmd-turn-start-title"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ message: {
+ messageId: asMessageId("user-message-title"),
+ role: "user",
+ text: "Please investigate reconnect failures after restarting the session.",
+ attachments: [],
+ },
+ titleSeed: seededTitle,
+ interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
+ runtimeMode: "approval-required",
+ createdAt: now,
+ }),
+ );
+
+ await waitFor(() => harness.generateThreadTitle.mock.calls.length === 1);
+ expect(harness.generateThreadTitle.mock.calls[0]?.[0]).toMatchObject({
+ message: "Please investigate reconnect failures after restarting the session.",
+ });
+
+ await waitFor(async () => {
+ const readModel = await Effect.runPromise(harness.engine.getReadModel());
+ return (
+ readModel.threads.find((entry) => entry.id === ThreadId.makeUnsafe("thread-1"))?.title ===
+ "Generated title"
+ );
+ });
+ const readModel = await Effect.runPromise(harness.engine.getReadModel());
+ const thread = readModel.threads.find((entry) => entry.id === ThreadId.makeUnsafe("thread-1"));
+ expect(thread?.title).toBe("Generated title");
+ });
+
+ it("does not overwrite an existing custom thread title on the first turn", async () => {
+ const harness = await createHarness();
+ const now = new Date().toISOString();
+ const seededTitle = "Please investigate reconnect failures after restar...";
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.meta.update",
+ commandId: CommandId.makeUnsafe("cmd-thread-title-custom"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ title: "Keep this custom title",
+ }),
+ );
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.turn.start",
+ commandId: CommandId.makeUnsafe("cmd-turn-start-title-preserve"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ message: {
+ messageId: asMessageId("user-message-title-preserve"),
+ role: "user",
+ text: "Please investigate reconnect failures after restarting the session.",
+ attachments: [],
+ },
+ titleSeed: seededTitle,
+ interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
+ runtimeMode: "approval-required",
+ createdAt: now,
+ }),
+ );
+
+ await waitFor(() => harness.sendTurn.mock.calls.length === 1);
+ expect(harness.generateThreadTitle).not.toHaveBeenCalled();
+
+ const readModel = await Effect.runPromise(harness.engine.getReadModel());
+ const thread = readModel.threads.find((entry) => entry.id === ThreadId.makeUnsafe("thread-1"));
+ expect(thread?.title).toBe("Keep this custom title");
+ });
+
+ it("matches the client-seeded title even when the outgoing prompt is reformatted", async () => {
+ const harness = await createHarness();
+ const now = new Date().toISOString();
+ const seededTitle = "Fix reconnect spinner on resume";
+ harness.generateThreadTitle.mockReturnValue(
+ Effect.succeed({
+ title: "Reconnect spinner resume bug",
+ }),
+ );
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.meta.update",
+ commandId: CommandId.makeUnsafe("cmd-thread-title-formatted-seed"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ title: seededTitle,
+ }),
+ );
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.turn.start",
+ commandId: CommandId.makeUnsafe("cmd-turn-start-title-formatted"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ message: {
+ messageId: asMessageId("user-message-title-formatted"),
+ role: "user",
+ text: "[effort:high]\\n\\nFix reconnect spinner on resume",
+ attachments: [],
+ },
+ titleSeed: seededTitle,
+ interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
+ runtimeMode: "approval-required",
+ createdAt: now,
+ }),
+ );
+
+ await waitFor(() => harness.generateThreadTitle.mock.calls.length === 1);
+ await waitFor(async () => {
+ const readModel = await Effect.runPromise(harness.engine.getReadModel());
+ return (
+ readModel.threads.find((entry) => entry.id === ThreadId.makeUnsafe("thread-1"))?.title ===
+ "Reconnect spinner resume bug"
+ );
+ });
+
+ const readModel = await Effect.runPromise(harness.engine.getReadModel());
+ const thread = readModel.threads.find((entry) => entry.id === ThreadId.makeUnsafe("thread-1"));
+ expect(thread?.title).toBe("Reconnect spinner resume bug");
+ });
+
+ it("generates a worktree branch name for the first turn", async () => {
+ const harness = await createHarness();
+ const now = new Date().toISOString();
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.meta.update",
+ commandId: CommandId.makeUnsafe("cmd-thread-branch"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ branch: "t3code/1234abcd",
+ worktreePath: "/tmp/provider-project-worktree",
+ }),
+ );
+
+ harness.generateBranchName.mockImplementation((input: unknown) =>
+ Effect.succeed({
+ branch:
+ typeof input === "object" &&
+ input !== null &&
+ "modelSelection" in input &&
+ typeof input.modelSelection === "object" &&
+ input.modelSelection !== null &&
+ "model" in input.modelSelection &&
+ typeof input.modelSelection.model === "string"
+ ? `feature/${input.modelSelection.model}`
+ : "feature/generated",
+ }),
+ );
+
+ await Effect.runPromise(
+ harness.engine.dispatch({
+ type: "thread.turn.start",
+ commandId: CommandId.makeUnsafe("cmd-turn-start-branch-model"),
+ threadId: ThreadId.makeUnsafe("thread-1"),
+ message: {
+ messageId: asMessageId("user-message-branch-model"),
+ role: "user",
+ text: "Add a safer reconnect backoff.",
+ attachments: [],
+ },
+ interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
+ runtimeMode: "approval-required",
+ createdAt: now,
+ }),
+ );
+
+ await waitFor(() => harness.generateBranchName.mock.calls.length === 1);
+ expect(harness.generateBranchName.mock.calls[0]?.[0]).toMatchObject({
+ message: "Add a safer reconnect backoff.",
+ });
+ });
+
it("forwards codex model options through session start and turn send", async () => {
const harness = await createHarness();
const now = new Date().toISOString();
diff --git a/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts b/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts
index 7c522e579..f65137f4b 100644
--- a/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts
+++ b/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts
@@ -73,6 +73,19 @@ const HANDLED_TURN_START_KEY_TTL = Duration.minutes(30);
const DEFAULT_RUNTIME_MODE: RuntimeMode = "full-access";
const WORKTREE_BRANCH_PREFIX = "t3code";
const TEMP_WORKTREE_BRANCH_PATTERN = new RegExp(`^${WORKTREE_BRANCH_PREFIX}\\/[0-9a-f]{8}$`);
+const DEFAULT_THREAD_TITLE = "New thread";
+
+function canReplaceThreadTitle(currentTitle: string, titleSeed?: string): boolean {
+ const trimmedCurrentTitle = currentTitle.trim();
+ if (trimmedCurrentTitle === DEFAULT_THREAD_TITLE) {
+ return true;
+ }
+
+ const trimmedTitleSeed = titleSeed?.trim();
+ return trimmedTitleSeed !== undefined && trimmedTitleSeed.length > 0
+ ? trimmedCurrentTitle === trimmedTitleSeed
+ : false;
+}
function isUnknownPendingApprovalRequestError(cause: Cause.Cause<ProviderServiceError>): boolean {
const error = Cause.squash(cause);
@@ -400,7 +413,6 @@ const make = Effect.gen(function* () {
readonly threadId: ThreadId;
readonly branch: string | null;
readonly worktreePath: string | null;
- readonly messageId: string;
readonly messageText: string;
readonly attachments?: ReadonlyArray<ChatAttachment>;
}) {
@@ -411,16 +423,6 @@ const make = Effect.gen(function* () {
return;
}
- const thread = yield* resolveThread(input.threadId);
- if (!thread) {
- return;
- }
-
- const userMessages = thread.messages.filter((message) => message.role === "user");
- if (userMessages.length !== 1 || userMessages[0]?.id !== input.messageId) {
- return;
- }
-
const oldBranch = input.branch;
const cwd = input.worktreePath;
const attachments = input.attachments ?? [];
@@ -459,6 +461,49 @@ const make = Effect.gen(function* () {
);
});
+ const maybeGenerateThreadTitleForFirstTurn = Effect.fnUntraced(function* (input: {
+ readonly threadId: ThreadId;
+ readonly cwd: string;
+ readonly messageText: string;
+ readonly attachments?: ReadonlyArray<ChatAttachment>;
+ readonly titleSeed?: string;
+ }) {
+ const attachments = input.attachments ?? [];
+ yield* Effect.gen(function* () {
+ const { textGenerationModelSelection: modelSelection } =
+ yield* serverSettingsService.getSettings;
+
+ const generated = yield* textGeneration.generateThreadTitle({
+ cwd: input.cwd,
+ message: input.messageText,
+ ...(attachments.length > 0 ? { attachments } : {}),
+ modelSelection,
+ });
+ if (!generated) return;
+
+ const thread = yield* resolveThread(input.threadId);
+ if (!thread) return;
+ if (!canReplaceThreadTitle(thread.title, input.titleSeed)) {
+ return;
+ }
+
+ yield* orchestrationEngine.dispatch({
+ type: "thread.meta.update",
+ commandId: serverCommandId("thread-title-rename"),
+ threadId: input.threadId,
+ title: generated.title,
+ });
+ }).pipe(
+ Effect.catchCause((cause) =>
+ Effect.logWarning("provider command reactor failed to generate or rename thread title", {
+ threadId: input.threadId,
+ cwd: input.cwd,
+ cause: Cause.pretty(cause),
+ }),
+ ),
+ );
+ });
+
const processTurnStartRequested = Effect.fnUntraced(function* (
event: Extract<ProviderIntentEvent, { type: "thread.turn-start-requested" }>,
) {
@@ -485,14 +530,35 @@ const make = Effect.gen(function* () {
return;
}
- yield* maybeGenerateAndRenameWorktreeBranchForFirstTurn({
- threadId: event.payload.threadId,
- branch: thread.branch,
- worktreePath: thread.worktreePath,
- messageId: message.id,
- messageText: message.text,
- ...(message.attachments !== undefined ? { attachments: message.attachments } : {}),
- }).pipe(Effect.forkScoped);
+ const isFirstUserMessageTurn =
+ thread.messages.filter((entry) => entry.role === "user").length === 1;
+ if (isFirstUserMessageTurn) {
+ const generationCwd =
+ resolveThreadWorkspaceCwd({
+ thread,
+ projects: (yield* orchestrationEngine.getReadModel()).projects,
+ }) ?? process.cwd();
+ const generationInput = {
+ messageText: message.text,
+ ...(message.attachments !== undefined ? { attachments: message.attachments } : {}),
+ ...(event.payload.titleSeed !== undefined ? { titleSeed: event.payload.titleSeed } : {}),
+ };
+
+ yield* maybeGenerateAndRenameWorktreeBranchForFirstTurn({
+ threadId: event.payload.threadId,
+ branch: thread.branch,
+ worktreePath: thread.worktreePath,
+ ...generationInput,
+ }).pipe(Effect.forkScoped);
+
+ if (canReplaceThreadTitle(thread.title, event.payload.titleSeed)) {
+ yield* maybeGenerateThreadTitleForFirstTurn({
+ threadId: event.payload.threadId,
+ cwd: generationCwd,
+ ...generationInput,
+ }).pipe(Effect.forkScoped);
+ }
+ }
yield* sendTurnForThread({
threadId: event.payload.threadId,
diff --git a/apps/server/src/orchestration/decider.ts b/apps/server/src/orchestration/decider.ts
index c70194bef..22f5bcb28 100644
--- a/apps/server/src/orchestration/decider.ts
+++ b/apps/server/src/orchestration/decider.ts
@@ -16,7 +16,6 @@ import {
} from "./commandInvariants.ts";
const nowIso = () => new Date().toISOString();
-
const defaultMetadata: Omit<OrchestrationEvent, "sequence" | "type" | "payload"> = {
eventId: crypto.randomUUID() as OrchestrationEvent["eventId"],
aggregateKind: "thread",
@@ -376,6 +375,7 @@ export const decideOrchestrationCommand = Effect.fn("decideOrchestrationCommand"
...(command.modelSelection !== undefined
? { modelSelection: command.modelSelection }
: {}),
+ ...(command.titleSeed !== undefined ? { titleSeed: command.titleSeed } : {}),
runtimeMode: targetThread.runtimeMode,
interactionMode: targetThread.interactionMode,
...(sourceProposedPlan !== undefined ? { sourceProposedPlan } : {}),
diff --git a/apps/web/src/components/ChatView.tsx b/apps/web/src/components/ChatView.tsx
index 1d926bf30..e572f3c47 100644
--- a/apps/web/src/components/ChatView.tsx
+++ b/apps/web/src/components/ChatView.tsx
@@ -22,6 +22,7 @@ import {
RuntimeMode,
} from "@t3tools/contracts";
import { applyClaudePromptEffortPrefix, normalizeModelSlug } from "@t3tools/shared/model";
+import { truncate } from "@t3tools/shared/String";
import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { useDebouncedValue } from "@tanstack/react-pacer";
@@ -69,7 +70,6 @@ import {
proposedPlanTitle,
resolvePlanFollowUpSubmission,
} from "../proposedPlan";
-import { truncateTitle } from "../truncateTitle";
import {
DEFAULT_INTERACTION_MODE,
DEFAULT_RUNTIME_MODE,
@@ -2625,7 +2625,7 @@ export default function ChatView({ threadId }: ChatViewProps) {
titleSeed = "New thread";
}
}
- const title = truncateTitle(titleSeed);
+ const title = truncate(titleSeed);
const threadCreateModelSelection: ModelSelection = {
provider: selectedProvider,
model:
@@ -2710,6 +2710,7 @@ export default function ChatView({ threadId }: ChatViewProps) {
attachments: turnAttachments,
},
modelSelection: selectedModelSelection,
+ titleSeed: title,
runtimeMode,
interactionMode,
createdAt: messageCreatedAt,
@@ -2991,6 +2992,7 @@ export default function ChatView({ threadId }: ChatViewProps) {
attachments: [],
},
modelSelection: selectedModelSelection,
+ titleSeed: activeThread.title,
runtimeMode,
interactionMode: nextInteractionMode,
...(nextInteractionMode === "default" && activeProposedPlan
@@ -3070,7 +3072,7 @@ export default function ChatView({ threadId }: ChatViewProps) {
effort: selectedPromptEffort,
text: implementationPrompt,
});
- const nextThreadTitle = truncateTitle(buildPlanImplementationThreadTitle(planMarkdown));
+ const nextThreadTitle = truncate(buildPlanImplementationThreadTitle(planMarkdown));
const nextThreadModelSelection: ModelSelection = selectedModelSelection;
sendInFlightRef.current = true;
@@ -3106,6 +3108,7 @@ export default function ChatView({ threadId }: ChatViewProps) {
attachments: [],
},
modelSelection: selectedModelSelection,
+ titleSeed: nextThreadTitle,
runtimeMode,
interactionMode: "default",
createdAt,
diff --git a/apps/web/src/truncateTitle.test.ts b/apps/web/src/truncateTitle.test.ts
deleted file mode 100644
index d7d61c5da..000000000
--- a/apps/web/src/truncateTitle.test.ts
+++ /dev/null
@@ -1,17 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import { truncateTitle } from "./truncateTitle";
-
-describe("truncateTitle", () => {
- it("trims surrounding whitespace", () => {
- expect(truncateTitle(" hello world ")).toBe("hello world");
- });
-
- it("returns trimmed text when within max length", () => {
- expect(truncateTitle("alpha", 10)).toBe("alpha");
- });
-
- it("appends ellipsis when text exceeds max length", () => {
- expect(truncateTitle("abcdefghij", 5)).toBe("abcde...");
- });
-});
diff --git a/packages/contracts/src/orchestration.test.ts b/packages/contracts/src/orchestration.test.ts
index 59c023e62..06bb35038 100644
--- a/packages/contracts/src/orchestration.test.ts
+++ b/packages/contracts/src/orchestration.test.ts
@@ -319,6 +319,25 @@ it.effect("accepts provider-scoped model options in thread.turn.start", () =>
}),
);
+it.effect("accepts a title seed in thread.turn.start", () =>
+ Effect.gen(function* () {
+ const parsed = yield* decodeThreadTurnStartCommand({
+ type: "thread.turn.start",
+ commandId: "cmd-turn-title-seed",
+ threadId: "thread-1",
+ message: {
+ messageId: "msg-title-seed",
+ role: "user",
+ text: "hello",
+ attachments: [],
+ },
+ titleSeed: "Investigate reconnect failures",
+ createdAt: "2026-01-01T00:00:00.000Z",
+ });
+ assert.strictEqual(parsed.titleSeed, "Investigate reconnect failures");
+ }),
+);
+
it.effect("accepts a source proposed plan reference in thread.turn.start", () =>
Effect.gen(function* () {
const parsed = yield* decodeThreadTurnStartCommand({
@@ -378,6 +397,18 @@ it.effect("decodes thread.turn-start-requested source proposed plan metadata whe
}),
);
+it.effect("decodes thread.turn-start-requested title seed when present", () =>
+ Effect.gen(function* () {
+ const parsed = yield* decodeThreadTurnStartRequestedPayload({
+ threadId: "thread-2",
+ messageId: "msg-2",
+ titleSeed: "Investigate reconnect failures",
+ createdAt: "2026-01-01T00:00:00.000Z",
+ });
+ assert.strictEqual(parsed.titleSeed, "Investigate reconnect failures");
+ }),
+);
+
it.effect("decodes latest turn source proposed plan metadata when present", () =>
Effect.gen(function* () {
const parsed = yield* decodeOrchestrationLatestTurn({
diff --git a/packages/contracts/src/orchestration.ts b/packages/contracts/src/orchestration.ts
index 31631666e..a780a55c7 100644
--- a/packages/contracts/src/orchestration.ts
+++ b/packages/contracts/src/orchestration.ts
@@ -42,6 +42,7 @@ export const ProviderSandboxMode = Schema.Literals([
"danger-full-access",
]);
export type ProviderSandboxMode = typeof ProviderSandboxMode.Type;
+
export const DEFAULT_PROVIDER_KIND: ProviderKind = "codex";
export const CodexModelSelection = Schema.Struct({
@@ -398,6 +399,7 @@ export const ThreadTurnStartCommand = Schema.Struct({
attachments: Schema.Array(ChatAttachment),
}),
modelSelection: Schema.optional(ModelSelection),
+ titleSeed: Schema.optional(TrimmedNonEmptyString),
runtimeMode: RuntimeMode.pipe(Schema.withDecodingDefault(() => DEFAULT_RUNTIME_MODE)),
interactionMode: ProviderInteractionMode.pipe(
Schema.withDecodingDefault(() => DEFAULT_PROVIDER_INTERACTION_MODE),
@@ -417,6 +419,7 @@ const ClientThreadTurnStartCommand = Schema.Struct({
attachments: Schema.Array(UploadChatAttachment),
}),
modelSelection: Schema.optional(ModelSelection),
+ titleSeed: Schema.optional(TrimmedNonEmptyString),
runtimeMode: RuntimeMode,
interactionMode: ProviderInteractionMode,
sourceProposedPlan: Schema.optional(SourceProposedPlanReference),
@@ -711,7 +714,7 @@ export const ThreadTurnStartRequestedPayload = Schema.Struct({
threadId: ThreadId,
messageId: MessageId,
modelSelection: Schema.optional(ModelSelection),
- assistantDeliveryMode: Schema.optional(AssistantDeliveryMode),
+ titleSeed: Schema.optional(TrimmedNonEmptyString),
runtimeMode: RuntimeMode.pipe(Schema.withDecodingDefault(() => DEFAULT_RUNTIME_MODE)),
interactionMode: ProviderInteractionMode.pipe(
Schema.withDecodingDefault(() => DEFAULT_PROVIDER_INTERACTION_MODE),
diff --git a/packages/shared/package.json b/packages/shared/package.json
index d34d1ce45..40ffbf35c 100644
--- a/packages/shared/package.json
+++ b/packages/shared/package.json
@@ -35,6 +35,10 @@
"./Struct": {
"types": "./src/Struct.ts",
"import": "./src/Struct.ts"
+ },
+ "./String": {
+ "types": "./src/String.ts",
+ "import": "./src/String.ts"
}
},
"scripts": {
diff --git a/packages/shared/src/String.test.ts b/packages/shared/src/String.test.ts
new file mode 100644
index 000000000..d70bfe840
--- /dev/null
+++ b/packages/shared/src/String.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+
+import { truncate } from "./String";
+
+describe("truncate", () => {
+ it("trims surrounding whitespace", () => {
+ expect(truncate(" hello world ")).toBe("hello world");
+ });
+
+ it("returns shorter strings unchanged", () => {
+ expect(truncate("alpha", 10)).toBe("alpha");
+ });
+
+ it("truncates long strings and appends an ellipsis", () => {
+ expect(truncate("abcdefghij", 5)).toBe("abcde...");
+ });
+});
diff --git a/apps/web/src/truncateTitle.ts b/packages/shared/src/String.ts
similarity index 66%
rename from apps/web/src/truncateTitle.ts
rename to packages/shared/src/String.ts
index bce554528..c93d0c90c 100644
--- a/apps/web/src/truncateTitle.ts
+++ b/packages/shared/src/String.ts
@@ -1,7 +1,8 @@
-export function truncateTitle(text: string, maxLength = 50): string {
+export function truncate(text: string, maxLength = 50): string {
const trimmed = text.trim();
if (trimmed.length <= maxLength) {
return trimmed;
}
+
return `${trimmed.slice(0, maxLength)}...`;
}