@@ -970,6 +970,175 @@ lifecycleLayer("CodexAdapterLive lifecycle", (it) => {
970970 } ) ,
971971 ) ;
972972
973+ const usageLimitErrorCases = [
974+ [ "plan-limit" , "You've hit your usage limit. Your limit will reset at 6:00 PM." ] ,
975+ [
976+ "workspace-credits" ,
977+ "Your workspace is out of credits. Ask your workspace owner to refill in order to continue." ,
978+ ] ,
979+ ] as const ;
980+
981+ for ( const [ label , message ] of usageLimitErrorCases ) {
982+ it . effect (
983+ `maps a ${ label } usage-limit error to runtime.warning with the provider message` ,
984+ ( ) =>
985+ Effect . gen ( function * ( ) {
986+ const { adapter, runtime } = yield * startLifecycleRuntime ( ) ;
987+ const firstEventFiber = yield * Stream . runHead ( adapter . streamEvents ) . pipe (
988+ Effect . forkChild ,
989+ ) ;
990+
991+ yield * runtime . emit ( {
992+ id : asEventId ( `evt-usage-limit-${ label } ` ) ,
993+ kind : "notification" ,
994+ provider : ProviderDriverKind . make ( "codex" ) ,
995+ threadId : asThreadId ( "thread-1" ) ,
996+ createdAt : "2026-01-01T00:00:00.000Z" ,
997+ method : "error" ,
998+ turnId : asTurnId ( "turn-1" ) ,
999+ payload : {
1000+ threadId : "thread-1" ,
1001+ turnId : "turn-1" ,
1002+ error : { message, codexErrorInfo : "usageLimitExceeded" } ,
1003+ willRetry : false ,
1004+ } ,
1005+ } satisfies ProviderEvent ) ;
1006+
1007+ const firstEvent = yield * Fiber . join ( firstEventFiber ) ;
1008+
1009+ NodeAssert . equal ( firstEvent . _tag , "Some" ) ;
1010+ if ( firstEvent . _tag !== "Some" ) {
1011+ return ;
1012+ }
1013+ NodeAssert . equal ( firstEvent . value . type , "runtime.warning" ) ;
1014+ if ( firstEvent . value . type !== "runtime.warning" ) {
1015+ return ;
1016+ }
1017+ NodeAssert . equal ( firstEvent . value . turnId , "turn-1" ) ;
1018+ NodeAssert . equal ( firstEvent . value . payload . message , message ) ;
1019+ } ) ,
1020+ ) ;
1021+ }
1022+
1023+ it . effect ( "keeps non-usage-limit Codex error notifications as runtime.error" , ( ) =>
1024+ Effect . gen ( function * ( ) {
1025+ const { adapter, runtime } = yield * startLifecycleRuntime ( ) ;
1026+ const firstEventFiber = yield * Stream . runHead ( adapter . streamEvents ) . pipe ( Effect . forkChild ) ;
1027+
1028+ yield * runtime . emit ( {
1029+ id : asEventId ( "evt-provider-error" ) ,
1030+ kind : "notification" ,
1031+ provider : ProviderDriverKind . make ( "codex" ) ,
1032+ threadId : asThreadId ( "thread-1" ) ,
1033+ createdAt : "2026-01-01T00:00:00.000Z" ,
1034+ method : "error" ,
1035+ turnId : asTurnId ( "turn-1" ) ,
1036+ payload : {
1037+ threadId : "thread-1" ,
1038+ turnId : "turn-1" ,
1039+ error : { message : "Stream disconnected" , codexErrorInfo : "internalServerError" } ,
1040+ willRetry : false ,
1041+ } ,
1042+ } satisfies ProviderEvent ) ;
1043+
1044+ const firstEvent = yield * Fiber . join ( firstEventFiber ) ;
1045+
1046+ NodeAssert . equal ( firstEvent . _tag , "Some" ) ;
1047+ if ( firstEvent . _tag !== "Some" ) {
1048+ return ;
1049+ }
1050+ NodeAssert . equal ( firstEvent . value . type , "runtime.error" ) ;
1051+ if ( firstEvent . value . type !== "runtime.error" ) {
1052+ return ;
1053+ }
1054+ NodeAssert . equal ( firstEvent . value . payload . class , "provider_error" ) ;
1055+ NodeAssert . equal ( firstEvent . value . payload . message , "Stream disconnected" ) ;
1056+ } ) ,
1057+ ) ;
1058+
1059+ it . effect ( "ends a usage-limited turn as cancelled without an error message" , ( ) =>
1060+ Effect . gen ( function * ( ) {
1061+ const { adapter, runtime } = yield * startLifecycleRuntime ( ) ;
1062+ const firstEventFiber = yield * Stream . runHead ( adapter . streamEvents ) . pipe ( Effect . forkChild ) ;
1063+
1064+ yield * runtime . emit ( {
1065+ id : asEventId ( "evt-usage-limit-turn-completed" ) ,
1066+ kind : "notification" ,
1067+ provider : ProviderDriverKind . make ( "codex" ) ,
1068+ threadId : asThreadId ( "thread-1" ) ,
1069+ createdAt : "2026-01-01T00:00:00.000Z" ,
1070+ method : "turn/completed" ,
1071+ turnId : asTurnId ( "turn-1" ) ,
1072+ payload : {
1073+ threadId : "thread-1" ,
1074+ turn : {
1075+ id : "turn-1" ,
1076+ status : "failed" ,
1077+ items : [ ] ,
1078+ error : {
1079+ message :
1080+ "Your workspace is out of credits. Ask your workspace owner to refill in order to continue." ,
1081+ codexErrorInfo : "usageLimitExceeded" ,
1082+ } ,
1083+ } ,
1084+ } ,
1085+ } satisfies ProviderEvent ) ;
1086+
1087+ const firstEvent = yield * Fiber . join ( firstEventFiber ) ;
1088+
1089+ NodeAssert . equal ( firstEvent . _tag , "Some" ) ;
1090+ if ( firstEvent . _tag !== "Some" ) {
1091+ return ;
1092+ }
1093+ NodeAssert . equal ( firstEvent . value . type , "turn.completed" ) ;
1094+ if ( firstEvent . value . type !== "turn.completed" ) {
1095+ return ;
1096+ }
1097+ NodeAssert . equal ( firstEvent . value . turnId , "turn-1" ) ;
1098+ NodeAssert . equal ( firstEvent . value . payload . state , "cancelled" ) ;
1099+ NodeAssert . equal ( firstEvent . value . payload . errorMessage , undefined ) ;
1100+ } ) ,
1101+ ) ;
1102+
1103+ it . effect ( "keeps other failed turns failed with their error message" , ( ) =>
1104+ Effect . gen ( function * ( ) {
1105+ const { adapter, runtime } = yield * startLifecycleRuntime ( ) ;
1106+ const firstEventFiber = yield * Stream . runHead ( adapter . streamEvents ) . pipe ( Effect . forkChild ) ;
1107+
1108+ yield * runtime . emit ( {
1109+ id : asEventId ( "evt-failed-turn-completed" ) ,
1110+ kind : "notification" ,
1111+ provider : ProviderDriverKind . make ( "codex" ) ,
1112+ threadId : asThreadId ( "thread-1" ) ,
1113+ createdAt : "2026-01-01T00:00:00.000Z" ,
1114+ method : "turn/completed" ,
1115+ turnId : asTurnId ( "turn-1" ) ,
1116+ payload : {
1117+ threadId : "thread-1" ,
1118+ turn : {
1119+ id : "turn-1" ,
1120+ status : "failed" ,
1121+ items : [ ] ,
1122+ error : { message : "Stream disconnected" , codexErrorInfo : "internalServerError" } ,
1123+ } ,
1124+ } ,
1125+ } satisfies ProviderEvent ) ;
1126+
1127+ const firstEvent = yield * Fiber . join ( firstEventFiber ) ;
1128+
1129+ NodeAssert . equal ( firstEvent . _tag , "Some" ) ;
1130+ if ( firstEvent . _tag !== "Some" ) {
1131+ return ;
1132+ }
1133+ NodeAssert . equal ( firstEvent . value . type , "turn.completed" ) ;
1134+ if ( firstEvent . value . type !== "turn.completed" ) {
1135+ return ;
1136+ }
1137+ NodeAssert . equal ( firstEvent . value . payload . state , "failed" ) ;
1138+ NodeAssert . equal ( firstEvent . value . payload . errorMessage , "Stream disconnected" ) ;
1139+ } ) ,
1140+ ) ;
1141+
9731142 it . effect ( "maps retryable Codex error notifications to runtime.warning" , ( ) =>
9741143 Effect . gen ( function * ( ) {
9751144 const { adapter, runtime } = yield * startLifecycleRuntime ( ) ;
0 commit comments