@agentdeck/bridge 0.2.2 → 1.0.0

package/dist/session-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-activity.js","sourceRoot":"","sources":["../src/session-activity.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,6DAA6D;AAC7D,6EAA6E;AAC7E,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,6EAA6E;AAC7E,2FAA2F;AAC3F,EAAE;AACF,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC;;qEAEqE;AACrE,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;QACnE,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAChF,CAAC;AAED,iEAAiE;AACjE,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,GAAG,GAA2B;QAClC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;QAChF,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS;QACpE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU;KACxF,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,CAAkB;IAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IAC5B,4EAA4E;IAC5E,kEAAkE;IAClE,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACpE,OAAO,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,mFAAmF;IACnF,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,+DAA+D;QAC/D,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAChF,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,SAAS,CAAC;AACnB,CAAC;AAID,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;AACnC,IAAI,WAAW,GAAmB,IAAI,CAAC,CAAC,wBAAwB;AAChE,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEzC,SAAS,SAAS,CAAC,CAAkB;IACnC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,eAAe,GACnB,2FAA2F;IAC3F,+FAA+F;IAC/F,2EAA2E,CAAC;AAE9E,SAAS,YAAY,CAAC,CAAkB;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9E,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,wFAAwF;AACxF,SAAS,cAAc,CAAC,CAAkB;IACxC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,kBAAkB;IAChE,IAAI,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,EAAE,GAAG,yBAAyB;QAAE,OAAO,CAAC,iBAAiB;IAC/F,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAAE,OAAO;IAC/B,sDAAsD;IACtD,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO;IAE9F,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnB,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,IAAI,WAAW,KAAK,IAAI;gBAAE,WAAW,GAAG,CAAC,MAAM,2BAA2B,EAAE,CAAC,CAAC,SAAS,CAAC;YACxF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,8BAA8B;gBAC5F,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,0BAA0B,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YAChF,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,MAAM,EAAE,4CAA4C,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7G,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,CAAkB;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/B,cAAc,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACnF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,4BAA4B;IAC1C,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/dist/session-aggregator.d.ts

@@ -1,5 +1,6 @@
 import { type SessionEntry } from './session-registry.js';
 import type { AgentType } from './types.js';
+import { type PromptOption } from '@agentdeck/shared';
 export interface EnrichedSession {
     id: string;
     port: number;
@@ -14,8 +15,28 @@ export interface EnrichedSession {
     controlMode?: 'managed' | 'observed';
     cwd?: string;
     currentTask?: string;
+    /** One-line gist of the session's purpose (first user prompt). */
+    goal?: string;
+    currentTool?: string;
     contextPercent?: number;
     totalTokens?: number;
+    question?: string;
+    requestId?: string;
+    promptType?: 'yes_no' | 'yes_no_always' | 'multi_select' | 'diff_review';
+    options?: PromptOption[];
+    /** Seconds since startedAt — derived at broadcast time so NTP-less devices (ESP32) render elapsed per session. */
+    elapsedSec?: number;
+    /** Daemon-synthesized "what is this agent doing right now" one-liner (heuristic,
+     *  upgraded to a Foundation Models summary when available). Shared by X3 + TRMNL. */
+    activity?: string;
+    /** Daemon-computed latest MILESTONE timeline row for this session (TIMELINE
+     *  parity for glance devices — IPS10 cards render "HH:MM task • text" from
+     *  these instead of their tiny reboot-empty on-device timeline ring). */
+    lastEventText?: string;
+    /** Resolved enclosing-task label for that row ("" / absent when none). */
+    lastEventTask?: string;
+    /** Host-local "HH:MM" of that row (boards are NTP-UTC or clockless). */
+    lastEventHm?: string;
 }
 /** Update push-channel cache (called from daemon-server when session_push_state arrives) */
 export declare function updatePushState(sessionId: string, state: string, modelName?: string, effortLevel?: string): void;
@@ -36,6 +57,10 @@ export declare function clearSiblingStateCache(sessionId: string): void;
 export declare function enrichSessionsWithState(sessions: SessionEntry[], ownSessionId: string, ownState: string, ownModelName?: string, ownEffortLevel?: string): Promise<EnrichedSession[]>;
 /**
  * Build an enriched sessions list for multi-session display.
+ *
+ * Includes the own session so single-session mode (`agentdeck claude` without a daemon)
+ * still surfaces the active session. The daemon-server enricher overrides this list in
+ * multi-session setups, so per-session bridges keeping their own entry is safe.
  */
 export declare function buildEnrichedSessionsList(ownSessionId: string, ownState: string, ownModelName?: string, ownEffortLevel?: string): Promise<EnrichedSession[]>;
 //# sourceMappingURL=session-aggregator.d.ts.map

package/dist/session-aggregator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-aggregator.d.ts","sourceRoot":"","sources":["../src/session-aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhH;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAKvH;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAG9D;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EAAE,EACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CA8B5B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAI5B"}
+{"version":3,"file":"session-aggregator.d.ts","sourceRoot":"","sources":["../src/session-aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,CAAC;IACzE,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,kHAAkH;IAClH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;yFACqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;6EAEyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAaD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhH;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAUvH;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAG9D;AAoBD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EAAE,EACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAsC5B;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAI5B"}

package/dist/session-aggregator.js

@@ -1,22 +1,31 @@
 import { listActive as listActiveSessions } from './session-registry.js';
 import { sortSessions } from '@agentdeck/shared';
-/** Cache last-known sibling state to avoid propagating undefined on transient fetch failures */
+/** Cache last-known sibling state to avoid propagating undefined on transient fetch failures.
+ * `updatedAt` bounds how long a vanished session may ride its last-known state: once the
+ * cache ages past LIVENESS_GRACE_MS without a successful probe/push, we stop treating it as
+ * alive so devices (TRMNL e-ink, ESP32, Pixoo) prune ended sessions instead of showing them
+ * forever (the registry only prunes on PID death, which lingers when the parent shell lives). */
 const siblingStateCache = new Map();
+const LIVENESS_GRACE_MS = 20_000;
 /** Push-channel state cache — populated by DaemonWsClient session_push_state messages */
 const pushStateCache = new Map();
 /** Update push-channel cache (called from daemon-server when session_push_state arrives) */
 export function updatePushState(sessionId, state, modelName, effortLevel) {
     pushStateCache.set(sessionId, { state, modelName, effortLevel, updatedAt: Date.now() });
     // Also update sibling cache so it stays consistent
-    siblingStateCache.set(sessionId, { state, modelName, effortLevel });
+    siblingStateCache.set(sessionId, { state, modelName, effortLevel, updatedAt: Date.now() });
 }
 /** Check if push-channel has fresh state (< 30s old) */
 export function getPushState(sessionId) {
     const entry = pushStateCache.get(sessionId);
     if (!entry)
         return undefined;
-    if (Date.now() - entry.updatedAt > 30_000)
-        return undefined; // stale
+    if (Date.now() - entry.updatedAt > 30_000) {
+        // Drop the stale entry instead of merely skipping it, so the map doesn't
+        // accumulate dead sessions over a long-running daemon's lifetime.
+        pushStateCache.delete(sessionId);
+        return undefined;
+    }
     return { state: entry.state, modelName: entry.modelName, effortLevel: entry.effortLevel };
 }
 /** Clear cache entry when a session is removed (call from session-registry cleanup) */
@@ -24,6 +33,25 @@ export function clearSiblingStateCache(sessionId) {
     siblingStateCache.delete(sessionId);
     pushStateCache.delete(sessionId);
 }
+/**
+ * Drop cache entries for sessions that are no longer active. `siblingStateCache`
+ * has no TTL (it's the last-known fallback for a still-live session whose
+ * /health probe transiently failed), so without this sweep a session that dies
+ * without a clean `deregister()` (SIGKILL, daemon crash) would leave its state
+ * cached forever. Called from the enricher with the current active id set.
+ * Observed sessions never populate these caches, so pruning to the managed set
+ * is safe.
+ */
+function sweepStaleCacheEntries(activeIds) {
+    for (const id of siblingStateCache.keys()) {
+        if (!activeIds.has(id))
+            siblingStateCache.delete(id);
+    }
+    for (const id of pushStateCache.keys()) {
+        if (!activeIds.has(id))
+            pushStateCache.delete(id);
+    }
+}
 /**
  * Enrich sibling sessions with state from their /health endpoint.
  * For the own session (matched by ownSessionId), uses ownState directly.
@@ -31,6 +59,9 @@ export function clearSiblingStateCache(sessionId) {
  * transient undefined propagation to all clients.
  */
 export async function enrichSessionsWithState(sessions, ownSessionId, ownState, ownModelName, ownEffortLevel) {
+    // Prune cache entries for sessions that have dropped out of the active set
+    // (the registry already pruned dead PIDs before handing us this list).
+    sweepStaleCacheEntries(new Set(sessions.map((s) => s.id)));
     return Promise.all(sessions.map(async (s) => {
         const base = {
             id: s.id,
@@ -53,24 +84,32 @@ export async function enrichSessionsWithState(sessions, ownSessionId, ownState,
             const res = await fetch(`http://127.0.0.1:${s.port}/health`, { signal: AbortSignal.timeout(2000) });
             const data = await res.json();
             if (data.state) {
-                siblingStateCache.set(s.id, { state: data.state, modelName: data.modelName, effortLevel: data.effortLevel });
+                siblingStateCache.set(s.id, { state: data.state, modelName: data.modelName, effortLevel: data.effortLevel, updatedAt: Date.now() });
             }
             return { ...base, state: data.state, modelName: data.modelName, effortLevel: data.effortLevel };
         }
         catch {
+            // Probe failed. Within the grace window keep the last-known state alive so a
+            // transient blip doesn't flicker a healthy session off the deck; past it,
+            // mark the session dead so devices prune the ended session.
             const cached = siblingStateCache.get(s.id);
-            if (cached)
+            if (cached && Date.now() - cached.updatedAt < LIVENESS_GRACE_MS) {
                 return { ...base, state: cached.state, modelName: cached.modelName, effortLevel: cached.effortLevel };
-            return base;
+            }
+            return { ...base, alive: false, state: cached?.state ?? 'disconnected' };
         }
     }));
 }
 /**
  * Build an enriched sessions list for multi-session display.
+ *
+ * Includes the own session so single-session mode (`agentdeck claude` without a daemon)
+ * still surfaces the active session. The daemon-server enricher overrides this list in
+ * multi-session setups, so per-session bridges keeping their own entry is safe.
  */
 export async function buildEnrichedSessionsList(ownSessionId, ownState, ownModelName, ownEffortLevel) {
-    const siblings = listActiveSessions().filter(s => s.agentType !== 'daemon' && s.id !== ownSessionId);
-    const enriched = await enrichSessionsWithState(siblings, ownSessionId, ownState, ownModelName, ownEffortLevel);
+    const all = listActiveSessions().filter(s => s.agentType !== 'daemon');
+    const enriched = await enrichSessionsWithState(all, ownSessionId, ownState, ownModelName, ownEffortLevel);
     return sortSessions(enriched);
 }
 //# sourceMappingURL=session-aggregator.js.map

package/dist/session-aggregator.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-aggregator.js","sourceRoot":"","sources":["../src/session-aggregator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-aggregator.js","sourceRoot":"","sources":["../src/session-aggregator.ts"],"names":[],"mappings":"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"}

package/dist/session-focus-relay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-focus-relay.d.ts","sourceRoot":"","sources":["../src/session-focus-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuB7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAE7D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAS;IAEvB,yEAAyE;IACzE,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIjD,uCAAuC;IACvC,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAIpC,gEAAgE;IAChE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAqB9B,+BAA+B;IAC/B,OAAO,IAAI,IAAI;IAaf,uEAAuE;IACvE,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAYzC,2BAA2B;IAC3B,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,OAAO;CAkChB"}
+{"version":3,"file":"session-focus-relay.d.ts","sourceRoot":"","sources":["../src/session-focus-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuB7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAE7D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAS;IAEvB,yEAAyE;IACzE,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIjD,uCAAuC;IACvC,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAIpC,gEAAgE;IAChE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAqB9B,+BAA+B;IAC/B,OAAO,IAAI,IAAI;IAaf,uEAAuE;IACvE,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAYzC,2BAA2B;IAC3B,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,OAAO;CAwChB"}

package/dist/session-focus-relay.js

@@ -108,7 +108,13 @@ export class SessionFocusRelay {
                 const evt = JSON.parse(raw.toString());
                 if (RELAYED_EVENTS.has(evt.type)) {
                     debug(TAG, `Relay ${evt.type} from session ${sessionId}`);
-                    this.onEvent?.(evt);
+                    // prompt_options used to be source-less, allowing a late event from
+                    // the previous focus to become buttons for the newly selected session.
+                    // Stamp the captured relay identity before it leaves this boundary.
+                    const tagged = evt.type === 'prompt_options' && sessionId
+                        ? { ...evt, sessionId, focusedSessionId: sessionId }
+                        : evt;
+                    this.onEvent?.(tagged);
                 }
             }
             catch {

package/dist/session-focus-relay.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-focus-relay.js","sourceRoot":"","sources":["../src/session-focus-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,GAAG,GAAG,aAAa,CAAC;AAE1B,4DAA4D;AAC5D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,cAAc;IACd,gBAAgB;IAChB,cAAc;CACf,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,SAAS;IACT,WAAW;IACX,QAAQ;IACR,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,aAAa;CACd,CAAC,CAAC;AAIH,MAAM,OAAO,iBAAiB;IACpB,EAAE,GAAqB,IAAI,CAAC;IAC5B,gBAAgB,GAAkB,IAAI,CAAC;IACvC,WAAW,GAAkB,IAAI,CAAC;IAClC,OAAO,GAA6B,IAAI,CAAC;IACzC,MAAM,GAAG,KAAK,CAAC;IAEvB,yEAAyE;IACzE,eAAe,CAAC,OAA0B;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,uCAAuC;IACvC,mBAAmB;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,SAAiB;QACrB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAClF,KAAK,CAAC,GAAG,EAAE,sBAAsB,SAAS,EAAE,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;QACnF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,EAAE,WAAW,SAAS,yBAAyB,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;QAChC,KAAK,CAAC,GAAG,EAAE,oBAAoB,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,+BAA+B;IAC/B,OAAO;QACL,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,EAAE,qBAAqB,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,uEAAuE;IACvE,YAAY,CAAC,GAAkB;QAC7B,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,CAAC,IAAI,cAAc,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7C,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,kBAAkB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAExC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACjB,KAAK,CAAC,GAAG,EAAE,wBAAwB,SAAS,YAAY,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAoB,EAAE,EAAE;YACxC,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;gBAAE,OAAO;YAEhD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAgB,CAAC;gBACtD,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjC,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,CAAC,IAAI,iBAAiB,SAAS,EAAE,CAAC,CAAC;oBAC1D,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACxC,KAAK,CAAC,GAAG,EAAE,WAAW,SAAS,YAAY,CAAC,CAAC;gBAC7C,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"session-focus-relay.js","sourceRoot":"","sources":["../src/session-focus-relay.ts"],"names":[],"mappings":"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"}

package/dist/session-registry.d.ts

@@ -2,8 +2,9 @@
  * Ordered list of data directories this process should READ from.
  *
  * The App Store macOS build writes its `daemon.json` / `sessions.json`
- * into `~/Library/Group Containers/group.bound.serendipity.agentdeck.dashboard`
- * (sandbox forces it), whereas the Node CLI writes to `~/.agentdeck`.
+ * inside its sandbox container, whereas the Node CLI writes to
+ * `~/.agentdeck`. Older App Store candidates used an App Group container,
+ * so reads keep that path as a legacy fallback.
  * Without cross-reads, `agentdeck claude` launched from Terminal can't
  * see the Swift daemon that's already listening on 9120, and session
  * bridges end up orphaned.
@@ -11,7 +12,8 @@
  * Order:
  *   1. `AGENTDECK_DATA_DIR` env override (tests, explicit pinning)
  *   2. `~/.agentdeck`                   (CLI / Homebrew / Node default)
- *   3. App Store group container        (macOS App Store build)
+ *   3. App Store sandbox container      (macOS App Store build)
+ *   4. Legacy App Store group container (pre-1.0 App Store candidates)
  *
  * Writes stay in the process's own dir via `getDataDir()`. Only reads
  * iterate this list.
@@ -23,7 +25,12 @@ export declare function getCandidateDataDirs(): string[];
  * generate a shell snippet with the same discovery order.
  */
 export declare function getCandidateDaemonJsonPaths(): string[];
+/** Where THIS process persists the device timeline. Reads may come from any
+ *  candidate dir (see `latestTimelinePath`), but the daemon writes only here. */
+export declare function getOwnTimelineFile(): string;
 export declare const DAEMON_DEFAULT_PORT = 9120;
+/** Documented daemon port window (docs/daemon.md) — scanned for cross-implementation discovery. */
+export declare const DAEMON_PORT_WINDOW: readonly [number, number];
 export interface DaemonInfo {
     port: number;
     pid: number;
@@ -41,8 +48,31 @@ export interface SessionEntry {
     parentTty?: string;
     startedAt: string;
 }
+/** Check if a PID is alive */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Decide whether a daemon that just lost the bind race for its requested port
+ * should concede (exit) to the process currently answering `/health` there.
+ *
+ * Concede ONLY when the occupant is a verified, distinct, live daemon:
+ *  - `mode !== 'daemon'` → a non-daemon (e.g. a session bridge) holds it; do
+ *    not concede (caller falls back to a fresh port, preserving prior behavior).
+ *  - `mode === 'daemon'` with a numeric `pid` → concede only if that PID is a
+ *    live process other than ourselves. A forged or stale `mode:'daemon'`
+ *    response with a dead/own/missing-but-claimed PID must NOT evict us.
+ *  - `mode === 'daemon'` with no `pid` → trust the mode (e.g. the Swift App
+ *    Store daemon omits `pid`), so cross-implementation coexistence still
+ *    hands the port over.
+ *
+ * `aliveCheck` is injectable for tests; defaults to the real PID liveness probe.
+ */
+export declare function shouldConcedePortToOccupant(occupant: {
+    mode?: string;
+    pid?: number;
+} | null, selfPid: number, aliveCheck?: (pid: number) => boolean): boolean;
 export declare function register(entry: SessionEntry): void;
 export declare function deregister(id: string): void;
+export declare function removeDaemonSession(entry: Pick<SessionEntry, 'pid' | 'port'>): void;
 export declare function listActive(): SessionEntry[];
 /** Find an existing live daemon session, if any */
 export declare function findExistingDaemon(): SessionEntry | null;
@@ -77,7 +107,48 @@ export declare function readDaemonInfo(): DaemonInfo | null;
 export declare function probeDaemonHealth(port: number): Promise<{
     mode?: string;
     pid?: number;
+    isSwift?: boolean;
 } | null>;
+/**
+ * Sweep the daemon port window for live daemons that file-based discovery
+ * cannot see. Two blind spots make this necessary:
+ *  - The App Store Swift daemon writes `daemon.json` into its private sandbox
+ *    container, which `getCandidateDataDirs()` cannot read.
+ *  - Transient 9120 contention can bump a daemon to a fallback port (9121+),
+ *    where the default-port probe never looks.
+ * Probes all window ports concurrently (localhost refusals resolve instantly)
+ * and returns every occupant whose `/health` reports `mode: 'daemon'`.
+ */
+export declare function scanDaemonPortWindow(skip?: ReadonlySet<number>, window?: readonly [number, number]): Promise<Array<{
+    port: number;
+    health: {
+        mode?: string;
+        pid?: number;
+        isSwift?: boolean;
+    };
+}>>;
+/**
+ * Poll a port's `/health` until the daemon there stops answering, or the
+ * timeout expires. Used after `requestDaemonShutdown()` instead of a fixed
+ * sleep: the Swift daemon tears down device modules (serial, ADB reverse,
+ * BLE) during shutdown, and taking over before it finishes leaves two owners
+ * briefly contending for the same tty / adb reverse mapping.
+ * Returns true once the daemon is gone.
+ */
+export declare function waitForDaemonExit(port: number, timeoutMs?: number): Promise<boolean>;
+/**
+ * Request another daemon to shutdown (used to clear Swift daemon when CLI starts)
+ */
+export declare function requestDaemonShutdown(port: number): Promise<void>;
+/**
+ * Ask an app-owned Swift in-process daemon to YIELD the canonical port (POST
+ * /stand-down) so this CLI daemon can take over with the full feature set.
+ * Unlike `/shutdown`, this keeps the macOS app running — it just demotes its
+ * daemon to a client of the incoming CLI daemon. Returns true if the daemon
+ * acknowledged (HTTP 2xx). The caller should then `waitForDaemonExit()` for the
+ * port to clear before binding.
+ */
+export declare function requestDaemonStandDown(port: number): Promise<boolean>;
 /**
  * Find the daemon port for client connections.
  * Priority: daemon.json (fast) → sessions.json fallback.

package/dist/session-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../src/session-registry.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAW/C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAEtD;AAID,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAIxC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAwDD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAOlD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO3C;AAED,wBAAgB,UAAU,IAAI,YAAY,EAAE,CAQ3C;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,IAAI,YAAY,GAAG,IAAI,CAGxD;AAcD,wBAAsB,iBAAiB,CAAC,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAY3F;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAWtD;AAID,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAOtD;AAED;wEACwE;AACxE,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,UAAU,GAAG,IAAI,CAmBlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiB/F;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAU9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAwB/F"}
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../src/session-registry.ts"],"names":[],"mappings":"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"}

package/dist/session-registry.js

@@ -14,8 +14,9 @@ function getDataDir() {
  * Ordered list of data directories this process should READ from.
  *
  * The App Store macOS build writes its `daemon.json` / `sessions.json`
- * into `~/Library/Group Containers/group.bound.serendipity.agentdeck.dashboard`
- * (sandbox forces it), whereas the Node CLI writes to `~/.agentdeck`.
+ * inside its sandbox container, whereas the Node CLI writes to
+ * `~/.agentdeck`. Older App Store candidates used an App Group container,
+ * so reads keep that path as a legacy fallback.
  * Without cross-reads, `agentdeck claude` launched from Terminal can't
  * see the Swift daemon that's already listening on 9120, and session
  * bridges end up orphaned.
@@ -23,7 +24,8 @@ function getDataDir() {
  * Order:
  *   1. `AGENTDECK_DATA_DIR` env override (tests, explicit pinning)
  *   2. `~/.agentdeck`                   (CLI / Homebrew / Node default)
- *   3. App Store group container        (macOS App Store build)
+ *   3. App Store sandbox container      (macOS App Store build)
+ *   4. Legacy App Store group container (pre-1.0 App Store candidates)
  *
  * Writes stay in the process's own dir via `getDataDir()`. Only reads
  * iterate this list.
@@ -33,7 +35,11 @@ export function getCandidateDataDirs() {
         return [process.env.AGENTDECK_DATA_DIR];
     const dirs = [join(homedir(), '.agentdeck')];
     if (process.platform === 'darwin') {
-        const groupContainer = join(homedir(), 'Library/Group Containers/group.bound.serendipity.agentdeck.dashboard');
+        // Avoid reading the App Store sandbox container directly from non-sandboxed
+        // Node CLI/daemon, as macOS TCC will block the process and cause it to hang
+        // waiting for a permissions dialog that never shows.
+        // Instead, rely on port scan/health checks for cross-talk.
+        const groupContainer = join(homedir(), 'Library/Group Containers/group.bound.serendipity.agent.deck');
         if (!dirs.includes(groupContainer))
             dirs.push(groupContainer);
     }
@@ -48,10 +54,15 @@ export function getCandidateDaemonJsonPaths() {
     return getCandidateDataDirs().map((d) => join(d, 'daemon.json'));
 }
 function getSessionsFile() { return join(getDataDir(), 'sessions.json'); }
+/** Where THIS process persists the device timeline. Reads may come from any
+ *  candidate dir (see `latestTimelinePath`), but the daemon writes only here. */
+export function getOwnTimelineFile() { return join(getDataDir(), 'timeline.json'); }
 function getDaemonFile() { return join(getDataDir(), 'daemon.json'); }
 export const DAEMON_DEFAULT_PORT = 9120;
 const BASE_PORT = 9120;
 const MAX_PORT = 9139;
+/** Documented daemon port window (docs/daemon.md) — scanned for cross-implementation discovery. */
+export const DAEMON_PORT_WINDOW = [BASE_PORT, MAX_PORT];
 function ensureDir() {
     const dir = getDataDir();
     if (!existsSync(dir)) {
@@ -91,7 +102,7 @@ function writeSessions(sessions) {
     renameSync(tmpFile, getSessionsFile());
 }
 /** Check if a PID is alive */
-function isProcessAlive(pid) {
+export function isProcessAlive(pid) {
     try {
         process.kill(pid, 0);
         return true;
@@ -100,6 +111,30 @@ function isProcessAlive(pid) {
         return false;
     }
 }
+/**
+ * Decide whether a daemon that just lost the bind race for its requested port
+ * should concede (exit) to the process currently answering `/health` there.
+ *
+ * Concede ONLY when the occupant is a verified, distinct, live daemon:
+ *  - `mode !== 'daemon'` → a non-daemon (e.g. a session bridge) holds it; do
+ *    not concede (caller falls back to a fresh port, preserving prior behavior).
+ *  - `mode === 'daemon'` with a numeric `pid` → concede only if that PID is a
+ *    live process other than ourselves. A forged or stale `mode:'daemon'`
+ *    response with a dead/own/missing-but-claimed PID must NOT evict us.
+ *  - `mode === 'daemon'` with no `pid` → trust the mode (e.g. the Swift App
+ *    Store daemon omits `pid`), so cross-implementation coexistence still
+ *    hands the port over.
+ *
+ * `aliveCheck` is injectable for tests; defaults to the real PID liveness probe.
+ */
+export function shouldConcedePortToOccupant(occupant, selfPid, aliveCheck = isProcessAlive) {
+    if (occupant?.mode !== 'daemon')
+        return false;
+    const pid = typeof occupant.pid === 'number' ? occupant.pid : null;
+    if (pid === null)
+        return true;
+    return pid !== selfPid && aliveCheck(pid);
+}
 /** Remove dead sessions (PID no longer alive) */
 function pruneDeadSessions(sessions) {
     return sessions.filter((s) => isProcessAlive(s.pid));
@@ -120,6 +155,14 @@ export function deregister(id) {
     import('./session-aggregator.js').then(m => m.clearSiblingStateCache(id)).catch(() => { });
     debug('SessionRegistry', `Deregistered session ${id}`);
 }
+export function removeDaemonSession(entry) {
+    const sessions = readSessions();
+    const filtered = sessions.filter((s) => !(s.agentType === 'daemon' && s.pid === entry.pid && s.port === entry.port));
+    if (filtered.length !== sessions.length) {
+        writeSessions(filtered);
+        debug('SessionRegistry', `Removed stale daemon session on port ${entry.port} pid=${entry.pid}`);
+    }
+}
 export function listActive() {
     const sessions = readSessions();
     const alive = pruneDeadSessions(sessions);
@@ -134,7 +177,14 @@ export function findExistingDaemon() {
     const sessions = listActive(); // prunes dead PIDs
     return sessions.find((s) => s.agentType === 'daemon') ?? null;
 }
-/** Try to bind a TCP server to a port to verify it's actually free */
+/**
+ * Try to bind a TCP server to a port to verify it's actually free.
+ * Binds on 0.0.0.0 (all interfaces) — the same address the WebSocket server uses —
+ * so a port held by another process on any interface is correctly detected as busy.
+ * The original 127.0.0.1 bind missed ports already occupied on 0.0.0.0 (e.g. zombie
+ * session bridges), causing findAvailablePort to hand out ports that immediately
+ * caused EADDRINUSE on the real server start.
+ */
 function isPortFree(port) {
     return new Promise((resolve) => {
         const server = createServer();
@@ -142,7 +192,7 @@ function isPortFree(port) {
         server.once('listening', () => {
             server.close(() => resolve(true));
         });
-        server.listen(port, '127.0.0.1');
+        server.listen(port, '0.0.0.0');
     });
 }
 export async function findAvailablePort(opts) {
@@ -259,6 +309,88 @@ export function probeDaemonHealth(port) {
         req.on('timeout', () => { req.destroy(); resolve(null); });
     });
 }
+/**
+ * Sweep the daemon port window for live daemons that file-based discovery
+ * cannot see. Two blind spots make this necessary:
+ *  - The App Store Swift daemon writes `daemon.json` into its private sandbox
+ *    container, which `getCandidateDataDirs()` cannot read.
+ *  - Transient 9120 contention can bump a daemon to a fallback port (9121+),
+ *    where the default-port probe never looks.
+ * Probes all window ports concurrently (localhost refusals resolve instantly)
+ * and returns every occupant whose `/health` reports `mode: 'daemon'`.
+ */
+export async function scanDaemonPortWindow(skip = new Set(), window = DAEMON_PORT_WINDOW) {
+    const ports = [];
+    for (let p = window[0]; p <= window[1]; p++) {
+        if (!skip.has(p))
+            ports.push(p);
+    }
+    const probes = await Promise.all(ports.map(async (port) => ({ port, health: await probeDaemonHealth(port) })));
+    return probes.filter((r) => r.health?.mode === 'daemon');
+}
+/**
+ * Poll a port's `/health` until the daemon there stops answering, or the
+ * timeout expires. Used after `requestDaemonShutdown()` instead of a fixed
+ * sleep: the Swift daemon tears down device modules (serial, ADB reverse,
+ * BLE) during shutdown, and taking over before it finishes leaves two owners
+ * briefly contending for the same tty / adb reverse mapping.
+ * Returns true once the daemon is gone.
+ */
+export async function waitForDaemonExit(port, timeoutMs = 5000) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        if (!(await probeDaemonHealth(port)))
+            return true;
+        if (Date.now() >= deadline)
+            return false;
+        await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+}
+/**
+ * Request another daemon to shutdown (used to clear Swift daemon when CLI starts)
+ */
+export function requestDaemonShutdown(port) {
+    return new Promise((resolve) => {
+        const req = http.request({
+            hostname: '127.0.0.1',
+            port,
+            path: '/shutdown',
+            method: 'POST',
+            timeout: 2000
+        }, (res) => {
+            res.on('data', () => { });
+            res.on('end', () => { resolve(); });
+        });
+        req.on('error', () => resolve());
+        req.on('timeout', () => { req.destroy(); resolve(); });
+        req.end();
+    });
+}
+/**
+ * Ask an app-owned Swift in-process daemon to YIELD the canonical port (POST
+ * /stand-down) so this CLI daemon can take over with the full feature set.
+ * Unlike `/shutdown`, this keeps the macOS app running — it just demotes its
+ * daemon to a client of the incoming CLI daemon. Returns true if the daemon
+ * acknowledged (HTTP 2xx). The caller should then `waitForDaemonExit()` for the
+ * port to clear before binding.
+ */
+export function requestDaemonStandDown(port) {
+    return new Promise((resolve) => {
+        const req = http.request({
+            hostname: '127.0.0.1',
+            port,
+            path: '/stand-down',
+            method: 'POST',
+            timeout: 2000,
+        }, (res) => {
+            res.on('data', () => { });
+            res.on('end', () => { resolve((res.statusCode ?? 500) < 300); });
+        });
+        req.on('error', () => resolve(false));
+        req.on('timeout', () => { req.destroy(); resolve(false); });
+        req.end();
+    });
+}
 /**
  * Find the daemon port for client connections.
  * Priority: daemon.json (fast) → sessions.json fallback.
@@ -303,7 +435,7 @@ export async function findDaemonPortAsync() {
     // 2. Port scan fallback — covers the "App Store daemon is up but its
     //    daemon.json sits in a dir this process can't read" case. Narrow
     //    range (9120-9139) matches the documented daemon port window.
-    for (let p = 9120; p <= 9139; p++) {
+    for (let p = DAEMON_PORT_WINDOW[0]; p <= DAEMON_PORT_WINDOW[1]; p++) {
         const health = await probeDaemonHealth(p);
         if (health?.mode === 'daemon') {
             return { port: p };