From d98a63ce17519983dcf58c27432723e2f4b96e75 Mon Sep 17 00:00:00 2001
From: Adam Malczewski <github@tradam.dev>
Date: Sun, 21 Jun 2026 02:19:54 +0900
Subject: feat(chat): message queue + steering — mid-turn injection at
 tool-result boundaries
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Consume the message-queue + steering handoff (wire@0.8.0, transport-contract@0.12.0).
Re-pinned file: deps + re-mirrored .dispatch/*.reference.md.

- fold steering AgentEvent into the transcript as a provisional user bubble
  (after the tool-result it followed; no de-dup — the queue surface carried it)
- add rendererId: "message-queue" custom renderer (pure parser + MessageQueueList)
  rendered as a compact panel above the Composer (hidden when queue is empty)
- add ChatStore.queueMessage / AppStore.queueMessage — sends chat.queue WS op
  (trim/validate non-empty; auto-starts a turn if idle)
- Composer switches to chat.queue while generating (button → Queue, placeholder
  → Steer the conversation...)
- exhaustiveness guards updated for steering + chat.queue
- carry-to-new-turn needs no special handling (normal new turn)

664 tests green.
---
 .../surface-host/logic/message-queue.test.ts       | 48 ++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 src/features/surface-host/logic/message-queue.test.ts

(limited to 'src/features/surface-host/logic/message-queue.test.ts')

diff --git a/src/features/surface-host/logic/message-queue.test.ts b/src/features/surface-host/logic/message-queue.test.ts
new file mode 100644
index 0000000..ce078d9
--- /dev/null
+++ b/src/features/surface-host/logic/message-queue.test.ts
@@ -0,0 +1,48 @@
+import type { QueuedMessage } from "@dispatch/wire";
+import { describe, expect, it } from "vitest";
+import { parseMessageQueuePayload } from "./message-queue";
+
+const msg = (id: string, text: string, queuedAt = 1_700_000_000_000): QueuedMessage => ({
+	id,
+	text,
+	queuedAt,
+});
+
+describe("parseMessageQueuePayload", () => {
+	it("parses a well-formed payload with messages", () => {
+		const data = parseMessageQueuePayload({
+			messages: [msg("m1", "steer left"), msg("m2", "actually, go right")],
+		});
+		expect(data).toEqual({
+			messages: [msg("m1", "steer left"), msg("m2", "actually, go right")],
+		});
+	});
+
+	it("parses an empty-messages payload (queue is empty)", () => {
+		expect(parseMessageQueuePayload({ messages: [] })).toEqual({ messages: [] });
+	});
+
+	it("preserves message order", () => {
+		const data = parseMessageQueuePayload({
+			messages: [msg("a", "first"), msg("b", "second"), msg("c", "third")],
+		});
+		expect(data?.messages.map((m) => m.id)).toEqual(["a", "b", "c"]);
+	});
+
+	it.each([
+		["null", null],
+		["a number", 7],
+		["a string", "nope"],
+		["missing messages key", { foo: [] }],
+		["messages not an array", { messages: "x" }],
+		["entry not an object", { messages: ["x"] }],
+		["entry missing id", { messages: [{ text: "x", queuedAt: 1 }] }],
+		["entry with non-string id", { messages: [{ id: 1, text: "x", queuedAt: 1 }] }],
+		["entry missing text", { messages: [{ id: "m1", queuedAt: 1 }] }],
+		["entry with non-string text", { messages: [{ id: "m1", text: 1, queuedAt: 1 }] }],
+		["entry missing queuedAt", { messages: [{ id: "m1", text: "x" }] }],
+		["entry with non-finite queuedAt", { messages: [msg("m1", "x", Number.NaN)] }],
+	])("returns null for invalid payload: %s", (_label, payload) => {
+		expect(parseMessageQueuePayload(payload)).toBeNull();
+	});
+});
-- 
cgit v1.2.3