From 7ff9f94c41a9870e124a50133cd74b42295ab9ac Mon Sep 17 00:00:00 2001
From: Adam Malczewski <github@tradam.dev>
Date: Mon, 22 Jun 2026 00:08:21 +0900
Subject: feat: conversation lifecycle status (active/idle/closed) for tab
 persistence
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Implement roadmap item 9: tab persistence across devices.

Wire (0.10.0):
- Add ConversationStatus type (active | idle | closed)
- Add status field to ConversationMeta

Transport-contract (0.14.0):
- Add conversation.statusChanged WS message to WsServerMessage union
- Re-export ConversationStatus

Conversation-store:
- Track status in ConversationMetaRow (default: idle)
- getConversationStatus / setConversationStatus methods
- listConversations accepts { status: ConversationStatus[] } filter
- Old meta rows without status default to idle on read

Session-orchestrator:
- conversationStatusChanged hook descriptor
- Emit on transitions: idle→active (turn start), active→idle (turn settle),
  →closed (closeConversation)
- Persist status to store as fire-and-forget side effect
- Declare hook in manifest contributes.hooks

Transport-ws:
- Subscribe to conversationStatusChanged hook
- Broadcast conversation.statusChanged WS message to all clients

Transport-http:
- GET /conversations?status=active,idle filter (parseStatusFilter pure helper)
- POST /conversations/:id/close now sets status to closed

CLI:
- dispatch list defaults to active,idle (excludes closed)
- --status <state> flag to filter by single status
- --all flag to include closed

FE handoff: frontend-conversation-lifecycle-handoff.md
---
 packages/wire/src/index.ts | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

(limited to 'packages/wire/src')

diff --git a/packages/wire/src/index.ts b/packages/wire/src/index.ts
index 72b5e43..53f1f02 100644
--- a/packages/wire/src/index.ts
+++ b/packages/wire/src/index.ts
@@ -499,15 +499,26 @@ export interface TurnSteeringEvent {
 
 // ─── Conversation metadata ───────────────────────────────────────────────────
 
+/**
+ * The lifecycle status of a conversation, used for tab persistence across
+ * devices. `active` = an agent is currently generating; `idle` = exists but not
+ * generating; `closed` = user dismissed the tab (hidden from the tab bar, not
+ * deleted). New conversations start as `idle`; transitions to `active` on
+ * turn-start, back to `idle` on turn done/error, and to `closed` on user close.
+ */
+export type ConversationStatus = "active" | "idle" | "closed";
+
 /**
  * Metadata for a conversation, returned by `GET /conversations` (the list
  * endpoint). The title defaults to the first user message (truncated) and can
  * be set via `PUT /conversations/:id/title`. `createdAt` is set on first write;
- * `lastActivityAt` is updated on every append.
+ * `lastActivityAt` is updated on every append. `status` tracks the tab lifecycle
+ * for cross-device persistence.
  */
 export interface ConversationMeta {
 	readonly id: string;
 	readonly createdAt: number;
 	readonly lastActivityAt: number;
 	readonly title: string;
+	readonly status: ConversationStatus;
 }
-- 
cgit v1.2.3