feat(chat): valide le routing cellKind=chat côté frontend et corrige UX

- Ajoute cellKind dans AgentChatHandle et vérifie que launchAgentChat reçoit cellKind:chat
- Rejette avec erreur STRUCTURED_ROUTED_TO_PTY si le backend route vers PTY
- Ajoute cellKind:chat dans MockAgentGateway.launchAgentChat
- Corrige l'overflow du layout CustomAgentChatView (bounded shell avec scroll + composer fixe)
- Dédouble les prompts utilisateur quand le stream les echo
- Ajoute les tests launchAgentChat returns handle only when confirms chat et launchAgentChat rejects PTY-routed launch
- Ajoute les tests does not duplicate user prompt when echoed et keeps chat shell bounded

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

frontend/src/adapters/agent.test.ts

@@ -170,4 +170,77 @@ describe("TauriAgentGateway invoke payloads", () => {
     });
     expect(invoke).not.toHaveBeenCalledWith("close_agent_session", expect.anything());
   });
+
+  it("launchAgentChat returns a handle only when launch_agent confirms cellKind chat", async () => {
+    invoke.mockResolvedValueOnce({
+      sessionId: "chat-session-1",
+      cwd: "/repo",
+      rows: 24,
+      cols: 80,
+      cellKind: "chat",
+      assignedConversationId: "conversation-1",
+    });
+
+    const out = await new TauriAgentGateway().launchAgentChat("proj-1", "agent-2", {
+      cwd: "/repo",
+      rows: 24,
+      cols: 80,
+      conversationId: "conversation-0",
+      nodeId: "node-3",
+    });
+
+    expect(invoke).toHaveBeenCalledWith("launch_agent", {
+      request: {
+        projectId: "proj-1",
+        agentId: "agent-2",
+        rows: 24,
+        cols: 80,
+        cellKind: "chat",
+        conversationId: "conversation-0",
+        nodeId: "node-3",
+      },
+      onOutput: expect.anything(),
+    });
+    expect(out).toEqual({
+      sessionId: "chat-session-1",
+      cellKind: "chat",
+      assignedConversationId: "conversation-1",
+    });
+  });
+
+  it("launchAgentChat rejects a PTY-routed launch before returning a fake structured session", async () => {
+    const log = vi.spyOn(console, "error").mockImplementation(() => {});
+    invoke.mockResolvedValueOnce({
+      sessionId: "pty-session-1",
+      cwd: "/repo",
+      rows: 24,
+      cols: 80,
+      cellKind: "pty",
+    });
+
+    await expect(
+      new TauriAgentGateway().launchAgentChat("proj-1", "agent-2", {
+        cwd: "/repo",
+        rows: 24,
+        cols: 80,
+        nodeId: "node-3",
+      }),
+    ).rejects.toEqual({
+      code: "STRUCTURED_ROUTED_TO_PTY",
+      message:
+        "custom CLI launch for agent agent-2 in project proj-1 returned cellKind=pty; expected chat. sessionId=pty-session-1; nodeId=node-3",
+    });
+    expect(log).toHaveBeenCalledWith(
+      "[ticket149] launchAgentChat:routed-to-non-chat",
+      expect.objectContaining({
+        projectId: "proj-1",
+        agentId: "agent-2",
+        response: expect.objectContaining({
+          sessionId: "pty-session-1",
+          cellKind: "pty",
+        }),
+      }),
+    );
+    log.mockRestore();
+  });
 });

frontend/src/adapters/agent.ts

@@ -18,6 +18,7 @@ import type {
   Agent,
   AgentContextDocument,
   EffortSelection,
+  GatewayError,
   ReplyChunk,
   ResumableAgent,
   TerminalSession,
@@ -42,10 +43,28 @@ interface LaunchAgentResponse {
   cwd: string;
   rows: number;
   cols: number;
+  /** Backend-derived routing: `chat` for structured sessions, `pty` for native TUI. */
+  cellKind?: "chat" | "pty";
   /** Conversation id minted by this launch (omitted when nothing was assigned). */
   assignedConversationId?: string;
 }
 
+function structuredLaunchRoutedToPtyError(
+  projectId: string,
+  agentId: string,
+  options: OpenTerminalOptions,
+  response: LaunchAgentResponse,
+): GatewayError {
+  const actual = response.cellKind ?? "missing";
+  return {
+    code: "STRUCTURED_ROUTED_TO_PTY",
+    message:
+      `custom CLI launch for agent ${agentId} in project ${projectId} ` +
+      `returned cellKind=${actual}; expected chat. ` +
+      `sessionId=${response.sessionId}; nodeId=${options.nodeId ?? "none"}`,
+  };
+}
+
 export class TauriAgentGateway implements AgentGateway {
   listAgents(projectId: string): Promise<Agent[]> {
     return invoke<Agent[]>("list_agents", { projectId });
@@ -194,13 +213,32 @@ export class TauriAgentGateway implements AgentGateway {
         agentId,
         rows: options.rows,
         cols: options.cols,
+        cellKind: "chat",
         conversationId: options.conversationId ?? null,
         nodeId: options.nodeId ?? null,
       },
       onOutput: channel,
     });
+    if (res.cellKind !== "chat") {
+      const error = structuredLaunchRoutedToPtyError(projectId, agentId, options, res);
+      console.error("[ticket149] launchAgentChat:routed-to-non-chat", {
+        projectId,
+        agentId,
+        request: {
+          rows: options.rows,
+          cols: options.cols,
+          cellKind: "chat",
+          conversationId: options.conversationId ?? null,
+          nodeId: options.nodeId ?? null,
+        },
+        response: res,
+        error,
+      });
+      throw error;
+    }
     return {
       sessionId: res.sessionId,
+      cellKind: "chat",
       ...(res.assignedConversationId
         ? { assignedConversationId: res.assignedConversationId }
         : {}),

frontend/src/adapters/mock/index.ts

@@ -801,6 +801,7 @@ export class MockAgentGateway implements AgentGateway {
     }
     return {
       sessionId,
+      cellKind: "chat",
       ...(!options.conversationId
         ? { assignedConversationId: `mock-conversation-${sessionId}` }
         : {}),