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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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> = {}): TEffect.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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsxindex 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.tsdeleted file mode 100644index 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.tsindex 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.tsindex 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.jsonindex 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.tsnew file mode 100644index 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.tssimilarity index 66%rename from apps/web/src/truncateTitle.tsrename to packages/shared/src/String.tsindex 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)}...`;}