1 files changed, 22 insertions, 0 deletions
diff --git a/packages/transport-http/src/logic.ts b/packages/transport-http/src/logic.ts
index c97f320..c703049 100644
--- a/packages/transport-http/src/logic.ts
+++ b/packages/transport-http/src/logic.ts
@@ -56,6 +56,16 @@ export interface ChatCommand {
   readonly reasoningEffort?: ReasoningEffort;
   readonly workspaceId?: string;
   /**
+   * A human-readable title for the conversation tab, set at creation time.
+   * Parsed from the `ChatRequest.title` field; trimmed server-side. A
+   * whitespace-only value is treated as absent (omitted) so the auto-derived
+   * title applies. Forwarded to the orchestrator, which persists it via the
+   * conversation store's `setConversationTitle` AFTER the new-conversation
+   * workspace setup (so workspace assignment / first-turn system-prompt
+   * construction are not skipped) and before the first message append.
+   */
+  readonly title?: string;
+  /**
    * Images attached to this turn (data URLs or http URLs). Parsed from the
    * `ChatRequest.images` field; forwarded to the orchestrator which converts
    * them to `image` chunks on the user message. Each entry must have a non-empty
@@ -128,6 +138,18 @@ export function parseChatBody(body: unknown, generateId: () => string): ParseRes
     (result as { workspaceId?: string }).workspaceId = obj.workspaceId;
   }
 
+  if (obj.title !== undefined) {
+    if (typeof obj.title !== "string") {
+      return { error: "Field 'title' must be a string" };
+    }
+    const title = obj.title.trim();
+    // A whitespace-only title is treated as absent so the auto-derived title
+    // applies (mirrors omitting the field) — never persist an empty title.
+    if (title.length > 0) {
+      (result as { title?: string }).title = title;
+    }
+  }
+
   if (obj.images !== undefined) {
     if (!Array.isArray(obj.images)) {
       return { error: "Field 'images' must be an array" };