@@ -22,6 +22,7 @@ import {
2222 TurnId ,
2323} from "@t3tools/contracts" ;
2424import * as Effect from "effect/Effect" ;
25+ import * as Deferred from "effect/Deferred" ;
2526import * as Exit from "effect/Exit" ;
2627import * as Layer from "effect/Layer" ;
2728import * as ManagedRuntime from "effect/ManagedRuntime" ;
@@ -145,6 +146,9 @@ describe("ProviderCommandReactor", () => {
145146 readonly threadModelSelection ?: ModelSelection ;
146147 readonly sessionModelSwitch ?: "unsupported" | "in-session" ;
147148 readonly requiresNewThreadForModelChange ?: boolean ;
149+ readonly startSessionEffect ?: (
150+ session : ProviderSession ,
151+ ) => Effect . Effect < ProviderSession , ProviderAdapterRequestError > ;
148152 } ) {
149153 const now = "2026-01-01T00:00:00.000Z" ;
150154 const baseDir =
@@ -159,6 +163,7 @@ describe("ProviderCommandReactor", () => {
159163 instanceId : ProviderInstanceId . make ( "codex" ) ,
160164 model : "gpt-5-codex" ,
161165 } ;
166+ const startSessionEffect = input ?. startSessionEffect ;
162167 const startSession = vi . fn ( ( _ : unknown , input : unknown ) => {
163168 const sessionIndex = nextSessionIndex ++ ;
164169 const resumeCursor =
@@ -212,8 +217,13 @@ describe("ProviderCommandReactor", () => {
212217 createdAt : now ,
213218 updatedAt : now ,
214219 } ;
215- runtimeSessions . push ( session ) ;
216- return Effect . succeed ( session ) ;
220+ return ( startSessionEffect ?.( session ) ?? Effect . succeed ( session ) ) . pipe (
221+ Effect . tap ( ( startedSession ) =>
222+ Effect . sync ( ( ) => {
223+ runtimeSessions . push ( startedSession ) ;
224+ } ) ,
225+ ) ,
226+ ) ;
217227 } ) ;
218228 const sendTurn = vi . fn ( ( _ : unknown ) =>
219229 Effect . succeed ( {
@@ -463,9 +473,120 @@ describe("ProviderCommandReactor", () => {
463473 const readModel = await harness . readModel ( ) ;
464474 const thread = readModel . threads . find ( ( entry ) => entry . id === ThreadId . make ( "thread-1" ) ) ;
465475 expect ( thread ?. session ?. threadId ) . toBe ( "thread-1" ) ;
476+ expect ( thread ?. session ?. status ) . toBe ( "starting" ) ;
466477 expect ( thread ?. session ?. runtimeMode ) . toBe ( "approval-required" ) ;
467478 } ) ;
468479
480+ effectIt . effect ( "projects starting before a slow provider session finishes" , ( ) =>
481+ Effect . gen ( function * ( ) {
482+ const releaseStart = yield * Deferred . make < void > ( ) ;
483+ const harness = yield * Effect . promise ( ( ) =>
484+ createHarness ( {
485+ startSessionEffect : ( session ) => Deferred . await ( releaseStart ) . pipe ( Effect . as ( session ) ) ,
486+ } ) ,
487+ ) ;
488+ const now = "2026-01-01T00:00:00.000Z" ;
489+
490+ yield * harness . engine . dispatch ( {
491+ type : "thread.turn.start" ,
492+ commandId : CommandId . make ( "cmd-turn-start-slow-provider" ) ,
493+ threadId : ThreadId . make ( "thread-1" ) ,
494+ message : {
495+ messageId : asMessageId ( "user-message-slow-provider" ) ,
496+ role : "user" ,
497+ text : "start slowly" ,
498+ attachments : [ ] ,
499+ } ,
500+ interactionMode : DEFAULT_PROVIDER_INTERACTION_MODE ,
501+ runtimeMode : "approval-required" ,
502+ createdAt : now ,
503+ } ) ;
504+
505+ yield * Effect . promise ( ( ) => waitFor ( ( ) => harness . startSession . mock . calls . length === 1 ) ) ;
506+ const duringStartup = yield * Effect . promise ( ( ) => harness . readModel ( ) ) ;
507+ expect (
508+ duringStartup . threads . find ( ( entry ) => entry . id === ThreadId . make ( "thread-1" ) ) ?. session
509+ ?. status ,
510+ ) . toBe ( "starting" ) ;
511+ expect ( harness . sendTurn ) . not . toHaveBeenCalled ( ) ;
512+
513+ yield * Deferred . succeed ( releaseStart , undefined ) ;
514+ yield * Effect . promise ( ( ) => waitFor ( ( ) => harness . sendTurn . mock . calls . length === 1 ) ) ;
515+ } ) ,
516+ ) ;
517+
518+ effectIt . effect ( "settles a failed provider startup and allows a clean retry" , ( ) =>
519+ Effect . gen ( function * ( ) {
520+ let failStartup = true ;
521+ const harness = yield * Effect . promise ( ( ) =>
522+ createHarness ( {
523+ startSessionEffect : ( session ) =>
524+ failStartup
525+ ? Effect . fail (
526+ new ProviderAdapterRequestError ( {
527+ provider : "codex" ,
528+ method : "thread.start" ,
529+ detail : "deterministic startup failure" ,
530+ } ) ,
531+ )
532+ : Effect . succeed ( session ) ,
533+ } ) ,
534+ ) ;
535+ const now = "2026-01-01T00:00:00.000Z" ;
536+
537+ yield * harness . engine . dispatch ( {
538+ type : "thread.turn.start" ,
539+ commandId : CommandId . make ( "cmd-turn-start-provider-failure" ) ,
540+ threadId : ThreadId . make ( "thread-1" ) ,
541+ message : {
542+ messageId : asMessageId ( "user-message-provider-failure" ) ,
543+ role : "user" ,
544+ text : "fail once" ,
545+ attachments : [ ] ,
546+ } ,
547+ interactionMode : DEFAULT_PROVIDER_INTERACTION_MODE ,
548+ runtimeMode : "approval-required" ,
549+ createdAt : now ,
550+ } ) ;
551+
552+ yield * Effect . promise ( ( ) =>
553+ waitFor ( async ( ) => {
554+ const readModel = await harness . readModel ( ) ;
555+ return (
556+ readModel . threads . find ( ( entry ) => entry . id === ThreadId . make ( "thread-1" ) ) ?. session
557+ ?. status === "error"
558+ ) ;
559+ } ) ,
560+ ) ;
561+ let readModel = yield * Effect . promise ( ( ) => harness . readModel ( ) ) ;
562+ let thread = readModel . threads . find ( ( entry ) => entry . id === ThreadId . make ( "thread-1" ) ) ;
563+ expect ( thread ?. session ?. lastError ) . toContain ( "deterministic startup failure" ) ;
564+ expect ( harness . sendTurn ) . not . toHaveBeenCalled ( ) ;
565+
566+ failStartup = false ;
567+ yield * harness . engine . dispatch ( {
568+ type : "thread.turn.start" ,
569+ commandId : CommandId . make ( "cmd-turn-start-provider-retry" ) ,
570+ threadId : ThreadId . make ( "thread-1" ) ,
571+ message : {
572+ messageId : asMessageId ( "user-message-provider-retry" ) ,
573+ role : "user" ,
574+ text : "retry" ,
575+ attachments : [ ] ,
576+ } ,
577+ interactionMode : DEFAULT_PROVIDER_INTERACTION_MODE ,
578+ runtimeMode : "approval-required" ,
579+ createdAt : "2026-01-01T00:00:01.000Z" ,
580+ } ) ;
581+
582+ yield * Effect . promise ( ( ) => waitFor ( ( ) => harness . sendTurn . mock . calls . length === 1 ) ) ;
583+ readModel = yield * Effect . promise ( ( ) => harness . readModel ( ) ) ;
584+ thread = readModel . threads . find ( ( entry ) => entry . id === ThreadId . make ( "thread-1" ) ) ;
585+ expect ( thread ?. session ?. status ) . toBe ( "starting" ) ;
586+ expect ( thread ?. session ?. lastError ) . toBeNull ( ) ;
587+ } ) ,
588+ ) ;
589+
469590 it ( "generates a thread title on the first turn" , async ( ) => {
470591 const harness = await createHarness ( ) ;
471592 const now = "2026-01-01T00:00:00.000Z" ;
0 commit comments