@@ -7,25 +7,31 @@ import { describe, expect, it } from "@effect/vitest";
77import Constants from "expo-constants" ;
88import * as Cause from "effect/Cause" ;
99import * as Effect from "effect/Effect" ;
10+ import * as Deferred from "effect/Deferred" ;
1011import * as Exit from "effect/Exit" ;
1112import * as Fiber from "effect/Fiber" ;
1213import * as Layer from "effect/Layer" ;
1314import { Cookies , FetchHttpClient , HttpClientRequest , HttpClientResponse } from "effect/http" ;
1415import { ManagedRelay } from "@t3tools/client-runtime/relay" ;
1516
17+ import type { EnvironmentId , ThreadId } from "@t3tools/contracts" ;
18+ import type { RelayAgentActivityAggregateState } from "@t3tools/contracts/relay" ;
1619import { verifyDpopProof } from "@t3tools/shared/dpop" ;
1720import * as Dpop from "../cloud/dpop" ;
1821import * as ManagedRelayLayer from "../cloud/managedRelayLayer" ;
1922import {
2023 clearAgentAwarenessRegistrationRecord ,
2124 loadAgentAwarenessRegistrationRecord ,
2225 loadOrCreateAgentAwarenessDeviceId ,
26+ loadPreferences ,
2327 saveAgentAwarenessRegistrationRecord ,
2428} from "../../persistence/imperative" ;
29+ import type { Preferences } from "../../persistence/mobile-preferences" ;
2530import { makeRelayDeviceRegistrationRequest } from "./registrationPayload" ;
2631import {
2732 __resetAgentAwarenessRemoteRegistrationForTest ,
2833 getAgentAwarenessRegistrationStatus ,
34+ refreshActiveLiveActivityRemoteRegistration ,
2935 refreshAgentAwarenessRegistration ,
3036 registerLiveActivityPushToken ,
3137 releaseAgentAwarenessRelayTokenProvider ,
@@ -49,6 +55,7 @@ const widgetMocks = vi.hoisted(() => ({
4955 getInstances : vi . fn ( ( ) => [ ] ) ,
5056 start : vi . fn ( ( ) => ( { } ) ) ,
5157} ) ) ;
58+ const publishWidgetMock = vi . hoisted ( ( ) => vi . fn ( ( _source : unknown ) => Promise . resolve ( ) ) ) ;
5259const environmentConfigsMock = vi . hoisted ( ( ) => ( {
5360 configs : new Map <
5461 string ,
@@ -85,6 +92,10 @@ vi.mock("expo-widgets", () => ({
8592 addPushToStartTokenListener : vi . fn ( ( ) => ( { remove : vi . fn ( ) } ) ) ,
8693} ) ) ;
8794
95+ vi . mock ( "../../widgets/publishAgentActivityWidget" , ( ) => ( {
96+ publishAgentActivityWidget : publishWidgetMock ,
97+ } ) ) ;
98+
8899vi . mock ( "./agentLiveActivity" , ( ) => ( {
89100 dismissEndedAgentLiveActivities : widgetMocks . dismissEnded ,
90101 getAgentLiveActivities : widgetMocks . getInstances ,
@@ -252,6 +263,7 @@ describe("makeRelayDeviceRegistrationRequest", () => {
252263 widgetMocks . getInstances . mockReset ( ) ;
253264 widgetMocks . getInstances . mockReturnValue ( [ ] ) ;
254265 widgetMocks . start . mockClear ( ) ;
266+ publishWidgetMock . mockClear ( ) ;
255267 widgetMocks . dismissEnded . mockReset ( ) ;
256268 environmentConfigsMock . configs . clear ( ) ;
257269 } ) ;
@@ -520,12 +532,14 @@ describe("makeRelayDeviceRegistrationRequest", () => {
520532 return Effect . gen ( function * ( ) {
521533 yield * runBackgroundOperations ( ) ;
522534
523- expect ( fetchMock ) . toHaveBeenCalledTimes ( 2 ) ;
524- const [ request , init ] = fetchMock . mock . calls [ 1 ] as unknown as [
525- unknown ,
526- RequestInit | undefined ,
527- ] ;
528- const url = request instanceof Request ? request . url : String ( request ) ;
535+ const requestUrl = ( request : unknown ) =>
536+ request instanceof Request ? request . url : String ( request ) ;
537+ const deviceCalls = fetchMock . mock . calls . filter ( ( [ request ] ) =>
538+ requestUrl ( request ) . endsWith ( "/v1/mobile/devices" ) ,
539+ ) ;
540+ expect ( deviceCalls ) . toHaveLength ( 1 ) ;
541+ const [ request , init ] = deviceCalls [ 0 ] as unknown as [ unknown , RequestInit | undefined ] ;
542+ const url = requestUrl ( request ) ;
529543 const method = request instanceof Request ? request . method : init ?. method ;
530544 const headers = request instanceof Request ? request . headers : new Headers ( init ?. headers ) ;
531545 const dpop = headers . get ( "dpop" ) ;
@@ -597,9 +611,12 @@ describe("makeRelayDeviceRegistrationRequest", () => {
597611 } ,
598612 } ;
599613
614+ // Sign-in first reads the widget snapshot, then registers the device; fail
615+ // both lookups so the queued registration is the one that must recover.
600616 const tokenProvider = vi
601617 . fn < ( ) => Promise < string | null > > ( )
602618 . mockRejectedValueOnce ( new Error ( "auth unavailable" ) )
619+ . mockRejectedValueOnce ( new Error ( "auth unavailable" ) )
603620 . mockResolvedValue ( "clerk-token-user-a" ) ;
604621 setAgentAwarenessRelayTokenProvider ( tokenProvider ) ;
605622 const tokenListener = vi . mocked ( Notifications . addPushTokenListener ) . mock . calls . at ( - 1 ) ?. [ 0 ] ;
@@ -610,7 +627,7 @@ describe("makeRelayDeviceRegistrationRequest", () => {
610627 yield * runBackgroundOperations ( ) ;
611628
612629 expect ( backgroundRuntime . pending ) . toHaveLength ( 0 ) ;
613- expect ( tokenProvider ) . toHaveBeenCalledTimes ( 2 ) ;
630+ expect ( tokenProvider ) . toHaveBeenCalledTimes ( 3 ) ;
614631 } ) . pipe ( Effect . provide ( layerRelayTest ) ) ;
615632 } ) ;
616633
@@ -728,4 +745,255 @@ describe("makeRelayDeviceRegistrationRequest", () => {
728745 } ) . pipe ( Effect . provide ( layerRelayTest ) ) ;
729746 } ,
730747 ) ;
748+
749+ describe ( "home-screen widget" , ( ) => {
750+ // These cover the widget path only, so keep the Live Activity from priming.
751+ beforeEach ( ( ) => {
752+ vi . mocked ( loadPreferences ) . mockResolvedValue ( { liveActivitiesEnabled : false } as Preferences ) ;
753+ } ) ;
754+
755+ const aggregate : RelayAgentActivityAggregateState = {
756+ title : "T3 Code" ,
757+ subtitle : "Agent work in progress" ,
758+ activeCount : 1 ,
759+ updatedAt : "2026-10-18T10:00:00.000Z" ,
760+ activities : [
761+ {
762+ environmentId : "env-1" as EnvironmentId ,
763+ threadId : "thread-1" as ThreadId ,
764+ projectTitle : "t3code" ,
765+ threadTitle : "Fix the widget" ,
766+ modelTitle : "GPT-5.5" ,
767+ phase : "running" ,
768+ status : "Working" ,
769+ updatedAt : "2026-10-18T10:00:00.000Z" ,
770+ deepLink : "/threads/env-1/thread-1" ,
771+ } ,
772+ ] ,
773+ } ;
774+
775+ // The shared fetch-backed relay layer keeps the first test's fetch stub,
776+ // so these tests answer the snapshot read through a fake client instead.
777+ function fakeRelay (
778+ getAgentActivitySnapshot : ( ) => Effect . Effect <
779+ { readonly aggregate : typeof aggregate } ,
780+ ManagedRelay . ManagedRelayRequestFailedError
781+ > ,
782+ ) {
783+ Constants . expoConfig ! . extra = { relay : { url : "https://relay.example.test/" } } ;
784+ const unexpected = ( ) => Effect . die ( "Unexpected relay request" ) ;
785+ return Layer . succeed (
786+ ManagedRelay . ManagedRelayClient ,
787+ ManagedRelay . ManagedRelayClient . of ( {
788+ relayUrl : "https://relay.example.test" ,
789+ listEnvironments : unexpected ,
790+ listDevices : unexpected ,
791+ getT3ChatLink : unexpected ,
792+ createT3ChatLinkRequest : unexpected ,
793+ unlinkT3Chat : unexpected ,
794+ createEnvironmentLinkChallenge : unexpected ,
795+ linkEnvironment : unexpected ,
796+ unlinkEnvironment : unexpected ,
797+ getEnvironmentStatus : unexpected ,
798+ connectEnvironment : unexpected ,
799+ registerDevice : unexpected ,
800+ unregisterDevice : unexpected ,
801+ registerLiveActivity : unexpected ,
802+ getAgentActivitySnapshot,
803+ resetTokenCache : Effect . void ,
804+ } ) ,
805+ ) ;
806+ }
807+
808+ it . effect ( "registers an existing Live Activity before waiting on the widget read" , ( ) => {
809+ const order : Array < string > = [ ] ;
810+ const activity = {
811+ getId : ( ) => "activity-1" ,
812+ getPushToken : vi . fn ( ( ) => {
813+ order . push ( "push-token" ) ;
814+ return Promise . resolve ( null ) ;
815+ } ) ,
816+ addPushTokenListener : vi . fn ( ) ,
817+ } ;
818+ widgetMocks . getInstances . mockReturnValue ( [ activity ] as never ) ;
819+ const relay = fakeRelay ( ( ) =>
820+ Effect . sync ( ( ) => {
821+ order . push ( "widget-snapshot" ) ;
822+ return { aggregate } ;
823+ } ) ,
824+ ) ;
825+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token" ) , "user-a" ) ;
826+
827+ return Effect . gen ( function * ( ) {
828+ yield * refreshActiveLiveActivityRemoteRegistration ( ) ;
829+
830+ expect ( order ) . toEqual ( [ "push-token" , "widget-snapshot" ] ) ;
831+ expect ( publishWidgetMock ) . toHaveBeenLastCalledWith ( {
832+ kind : "snapshot" ,
833+ aggregate,
834+ } ) ;
835+ } ) . pipe ( Effect . provide ( relay ) ) ;
836+ } ) ;
837+
838+ it . effect ( "keeps the newest rows when an older overlapping read finishes last" , ( ) =>
839+ Effect . gen ( function * ( ) {
840+ const newer = { ...aggregate , activeCount : 2 } ;
841+ const olderRequested = yield * Deferred . make < void > ( ) ;
842+ const olderResponse = yield * Deferred . make < { readonly aggregate : typeof aggregate } > ( ) ;
843+ let reads = 0 ;
844+ const relay = fakeRelay ( ( ) => {
845+ reads ++ ;
846+ return reads === 1
847+ ? Deferred . succeed ( olderRequested , undefined ) . pipe (
848+ Effect . andThen ( Deferred . await ( olderResponse ) ) ,
849+ )
850+ : Effect . succeed ( { aggregate : newer } ) ;
851+ } ) ;
852+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token" ) , "user-a" ) ;
853+
854+ const older = yield * Effect . forkChild (
855+ refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ,
856+ ) ;
857+ yield * Deferred . await ( olderRequested ) ;
858+ yield * refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ;
859+ yield * Deferred . succeed ( olderResponse , { aggregate } ) ;
860+ yield * Fiber . join ( older ) ;
861+
862+ expect ( publishWidgetMock ) . toHaveBeenLastCalledWith ( {
863+ kind : "snapshot" ,
864+ aggregate : newer ,
865+ } ) ;
866+ } ) ,
867+ ) ;
868+
869+ it . effect ( "an obsolete refresh does not discard the next account's read" , ( ) =>
870+ Effect . gen ( function * ( ) {
871+ let markTokenRequested = ( ) => { } ;
872+ const tokenRequested = new Promise < void > ( ( resolve ) => {
873+ markTokenRequested = resolve ;
874+ } ) ;
875+ let releaseToken = ( ) => { } ;
876+ widgetMocks . getInstances . mockReturnValueOnce ( [
877+ {
878+ getId : ( ) => "activity-a" ,
879+ getPushToken : ( ) => {
880+ markTokenRequested ( ) ;
881+ return new Promise < null > ( ( resolve ) => {
882+ releaseToken = ( ) => resolve ( null ) ;
883+ } ) ;
884+ } ,
885+ addPushTokenListener : vi . fn ( ) ,
886+ } ,
887+ ] as never ) ;
888+ const requested = yield * Deferred . make < void > ( ) ;
889+ const response = yield * Deferred . make < { readonly aggregate : typeof aggregate } > ( ) ;
890+ const relay = fakeRelay ( ( ) =>
891+ Deferred . succeed ( requested , undefined ) . pipe ( Effect . andThen ( Deferred . await ( response ) ) ) ,
892+ ) ;
893+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token-a" ) , "user-a" ) ;
894+
895+ const refreshA = yield * Effect . forkChild (
896+ refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ,
897+ ) ;
898+ yield * Effect . promise ( ( ) => tokenRequested ) ;
899+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token-b" ) , "user-b" ) ;
900+ const refreshB = yield * Effect . forkChild (
901+ refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ,
902+ ) ;
903+ yield * Deferred . await ( requested ) ;
904+ releaseToken ( ) ;
905+ yield * Fiber . join ( refreshA ) ;
906+ yield * Deferred . succeed ( response , { aggregate } ) ;
907+ yield * Fiber . join ( refreshB ) ;
908+
909+ expect ( publishWidgetMock ) . toHaveBeenLastCalledWith ( {
910+ kind : "snapshot" ,
911+ aggregate,
912+ } ) ;
913+ } ) ,
914+ ) ;
915+
916+ it . effect ( "does not prime a Live Activity from a read a newer one replaced" , ( ) =>
917+ Effect . gen ( function * ( ) {
918+ let markRequested = ( ) => { } ;
919+ const requested = new Promise < void > ( ( resolve ) => {
920+ markRequested = resolve ;
921+ } ) ;
922+ let resolvePreferences = ( _preferences : Preferences ) => { } ;
923+ vi . mocked ( loadPreferences ) . mockImplementationOnce ( ( ) => {
924+ markRequested ( ) ;
925+ return new Promise ( ( resolve ) => {
926+ resolvePreferences = resolve ;
927+ } ) ;
928+ } ) ;
929+ const idle = { ...aggregate , activeCount : 0 , activities : [ ] } ;
930+ let reads = 0 ;
931+ const relay = fakeRelay ( ( ) =>
932+ Effect . succeed ( { aggregate : ++ reads === 1 ? aggregate : idle } ) ,
933+ ) ;
934+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token" ) , "user-a" ) ;
935+
936+ const older = yield * Effect . forkChild (
937+ refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ,
938+ ) ;
939+ yield * Effect . promise ( ( ) => requested ) ;
940+ yield * refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ;
941+ resolvePreferences ( { liveActivitiesEnabled : true } as Preferences ) ;
942+ yield * Fiber . join ( older ) ;
943+
944+ expect ( widgetMocks . start ) . not . toHaveBeenCalled ( ) ;
945+ } ) ,
946+ ) ;
947+
948+ it . effect ( "drops a snapshot that arrives after a sign-out, even on re-sign-in" , ( ) =>
949+ Effect . gen ( function * ( ) {
950+ const requested = yield * Deferred . make < void > ( ) ;
951+ const response = yield * Deferred . make < { readonly aggregate : typeof aggregate } > ( ) ;
952+ const relay = fakeRelay ( ( ) =>
953+ Deferred . succeed ( requested , undefined ) . pipe ( Effect . andThen ( Deferred . await ( response ) ) ) ,
954+ ) ;
955+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token-a" ) , "user-a" ) ;
956+
957+ const refresh = yield * Effect . forkChild (
958+ refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ,
959+ ) ;
960+ yield * Deferred . await ( requested ) ;
961+ setAgentAwarenessRelayTokenProvider ( null ) ;
962+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token-a" ) , "user-a" ) ;
963+ publishWidgetMock . mockClear ( ) ;
964+ yield * Deferred . succeed ( response , { aggregate } ) ;
965+ yield * Fiber . join ( refresh ) ;
966+
967+ expect ( publishWidgetMock ) . not . toHaveBeenCalled ( ) ;
968+ } ) ,
969+ ) ;
970+
971+ it . effect ( "does not prime a Live Activity after sign-out during the preference read" , ( ) =>
972+ Effect . gen ( function * ( ) {
973+ let markRequested = ( ) => { } ;
974+ const requested = new Promise < void > ( ( resolve ) => {
975+ markRequested = resolve ;
976+ } ) ;
977+ let resolvePreferences = ( _preferences : Preferences ) => { } ;
978+ vi . mocked ( loadPreferences ) . mockImplementationOnce ( ( ) => {
979+ markRequested ( ) ;
980+ return new Promise ( ( resolve ) => {
981+ resolvePreferences = resolve ;
982+ } ) ;
983+ } ) ;
984+ const relay = fakeRelay ( ( ) => Effect . succeed ( { aggregate } ) ) ;
985+ setAgentAwarenessRelayTokenProvider ( ( ) => Promise . resolve ( "clerk-token" ) , "user-a" ) ;
986+
987+ const refresh = yield * Effect . forkChild (
988+ refreshActiveLiveActivityRemoteRegistration ( ) . pipe ( Effect . provide ( relay ) ) ,
989+ ) ;
990+ yield * Effect . promise ( ( ) => requested ) ;
991+ setAgentAwarenessRelayTokenProvider ( null ) ;
992+ resolvePreferences ( { liveActivitiesEnabled : true } as Preferences ) ;
993+ yield * Fiber . join ( refresh ) ;
994+
995+ expect ( widgetMocks . start ) . not . toHaveBeenCalled ( ) ;
996+ } ) ,
997+ ) ;
998+ } ) ;
731999} ) ;
0 commit comments