Something went wrong. Try again.
My version of https://github.com/vercel-labs/fx
Something went wrong. Try again.
473 kB · 12055 lines
Zig
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463104641046510466104671046810469104701047110472104731047410475104761047710478104791048010481104821048310484104851048610487104881048910490104911049210493104941049510496104971049810499105001050110502105031050410505105061050710508105091051010511105121051310514105151051610517105181051910520105211052210523105241052510526105271052810529105301053110532105331053410535105361053710538105391054010541105421054310544105451054610547105481054910550105511055210553105541055510556105571055810559105601056110562105631056410565105661056710568105691057010571105721057310574105751057610577105781057910580105811058210583105841058510586105871058810589105901059110592105931059410595105961059710598105991060010601106021060310604106051060610607106081060910610106111061210613106141061510616106171061810619106201062110622106231062410625106261062710628106291063010631106321063310634106351063610637106381063910640106411064210643106441064510646106471064810649106501065110652106531065410655106561065710658106591066010661106621066310664106651066610667106681066910670106711067210673106741067510676106771067810679106801068110682106831068410685106861068710688106891069010691106921069310694106951069610697106981069910700107011070210703107041070510706107071070810709107101071110712107131071410715107161071710718107191072010721107221072310724107251072610727107281072910730107311073210733107341073510736107371073810739107401074110742107431074410745107461074710748107491075010751107521075310754107551075610757107581075910760107611076210763107641076510766107671076810769107701077110772107731077410775107761077710778107791078010781107821078310784107851078610787107881078910790107911079210793107941079510796107971079810799108001080110802108031080410805108061080710808108091081010811108121081310814108151081610817108181081910820108211082210823108241082510826108271082810829108301083110832108331083410835108361083710838108391084010841108421084310844108451084610847108481084910850108511085210853108541085510856108571085810859108601086110862108631086410865108661086710868108691087010871108721087310874108751087610877108781087910880108811088210883108841088510886108871088810889108901089110892108931089410895108961089710898108991090010901109021090310904109051090610907109081090910910109111091210913109141091510916109171091810919109201092110922109231092410925109261092710928109291093010931109321093310934109351093610937109381093910940109411094210943109441094510946109471094810949109501095110952109531095410955109561095710958109591096010961109621096310964109651096610967109681096910970109711097210973109741097510976109771097810979109801098110982109831098410985109861098710988109891099010991109921099310994109951099610997109981099911000110011100211003110041100511006110071100811009110101101111012110131101411015110161101711018110191102011021110221102311024110251102611027110281102911030110311103211033110341103511036110371103811039110401104111042110431104411045110461104711048110491105011051110521105311054110551105611057110581105911060110611106211063110641106511066110671106811069110701107111072110731107411075110761107711078110791108011081110821108311084110851108611087110881108911090110911109211093110941109511096110971109811099111001110111102111031110411105111061110711108111091111011111111121111311114111151111611117111181111911120111211112211123111241112511126111271112811129111301113111132111331113411135111361113711138111391114011141111421114311144111451114611147111481114911150111511115211153111541115511156111571115811159111601116111162111631116411165111661116711168111691117011171111721117311174111751117611177111781117911180111811118211183111841118511186111871118811189111901119111192111931119411195111961119711198111991120011201112021120311204112051120611207112081120911210112111121211213112141121511216112171121811219112201122111222112231122411225112261122711228112291123011231112321123311234112351123611237112381123911240112411124211243112441124511246112471124811249112501125111252112531125411255112561125711258112591126011261112621126311264112651126611267112681126911270112711127211273112741127511276112771127811279112801128111282112831128411285112861128711288112891129011291112921129311294112951129611297112981129911300113011130211303113041130511306113071130811309113101131111312113131131411315113161131711318113191132011321113221132311324113251132611327113281132911330113311133211333113341133511336113371133811339113401134111342113431134411345113461134711348113491135011351113521135311354113551135611357113581135911360113611136211363113641136511366113671136811369113701137111372113731137411375113761137711378113791138011381113821138311384113851138611387113881138911390113911139211393113941139511396113971139811399114001140111402114031140411405114061140711408114091141011411114121141311414114151141611417114181141911420114211142211423114241142511426114271142811429114301143111432114331143411435114361143711438114391144011441114421144311444114451144611447114481144911450114511145211453114541145511456114571145811459114601146111462114631146411465114661146711468114691147011471114721147311474114751147611477114781147911480114811148211483114841148511486114871148811489114901149111492114931149411495114961149711498114991150011501115021150311504115051150611507115081150911510115111151211513115141151511516115171151811519115201152111522115231152411525115261152711528115291153011531115321153311534115351153611537115381153911540115411154211543115441154511546115471154811549115501155111552115531155411555115561155711558115591156011561115621156311564115651156611567115681156911570115711157211573115741157511576115771157811579115801158111582115831158411585115861158711588115891159011591115921159311594115951159611597115981159911600116011160211603116041160511606116071160811609116101161111612116131161411615116161161711618116191162011621116221162311624116251162611627116281162911630116311163211633116341163511636116371163811639116401164111642116431164411645116461164711648116491165011651116521165311654116551165611657116581165911660116611166211663116641166511666116671166811669116701167111672116731167411675116761167711678116791168011681116821168311684116851168611687116881168911690116911169211693116941169511696116971169811699117001170111702117031170411705117061170711708117091171011711117121171311714117151171611717117181171911720117211172211723117241172511726117271172811729117301173111732117331173411735117361173711738117391174011741117421174311744117451174611747117481174911750117511175211753117541175511756117571175811759117601176111762117631176411765117661176711768117691177011771117721177311774117751177611777117781177911780117811178211783117841178511786117871178811789117901179111792117931179411795117961179711798117991180011801118021180311804118051180611807118081180911810118111181211813118141181511816118171181811819118201182111822118231182411825118261182711828118291183011831118321183311834118351183611837118381183911840118411184211843118441184511846118471184811849118501185111852118531185411855118561185711858118591186011861118621186311864118651186611867118681186911870118711187211873118741187511876118771187811879118801188111882118831188411885118861188711888118891189011891118921189311894118951189611897118981189911900119011190211903119041190511906119071190811909119101191111912119131191411915119161191711918119191192011921119221192311924119251192611927119281192911930119311193211933119341193511936119371193811939119401194111942119431194411945119461194711948119491195011951119521195311954119551195611957119581195911960119611196211963119641196511966119671196811969119701197111972119731197411975119761197711978119791198011981119821198311984119851198611987119881198911990119911199211993119941199511996119971199811999120001200112002120031200412005120061200712008120091201012011120121201312014120151201612017120181201912020120211202212023120241202512026120271202812029120301203112032120331203412035120361203712038120391204012041120421204312044120451204612047120481204912050120511205212053120541205512056const std = @import("std");const debug_trace = @import("../../core/shared/debug_trace.zig");const display_width = @import("../../core/shared/display_width.zig");const input_action = @import("../../core/input/input_action.zig");const io_mod = @import("../../core/shared/io.zig");const activity_status = @import("../../core/output/activity_status.zig");const activity_runtime = @import("../../core/output/activity_runtime.zig");const transcript_release = @import("../../core/output/transcript_release.zig");const transcript_presentation = @import("../../core/output/transcript_presentation.zig");const worker_status = @import("../../core/output/worker_status.zig");const footer_viewport_runtime = @import("../footer/viewport.zig");const render_request = @import("../render_request.zig");const command_output_runtime = @import("command_output_runtime.zig");const input_visual_layout = @import("../input/visual_layout.zig");const user_message_card = @import("../assistant/user_message_card.zig");const render_engine = @import("../render_engine.zig");const build_checkpoint = @import("../render_engine/build_checkpoint.zig");const transcript_io = @import("io.zig");const transcript_painter = @import("painter.zig");const source_preparation = @import("source_preparation.zig");const tool_group_projection = @import("tool_group_projection.zig");const transcript_store = @import("store.zig");const full_transcript_screen = @import("../full_transcript_screen.zig");const transcript_viewport_runtime = @import("viewport_runtime.zig");const transcript_writer = @import("writer.zig");const ui_render = @import("../render.zig");const types = @import("../../core/shared/types.zig");const command_output_content = @import("../../core/tooling/command_output_content.zig");const captured_command = @import("../../core/tooling/captured_command.zig");const vt_emulator = @import("../../core/terminal/engine.zig");const result_store = @import("../../core/session/result_store.zig");const session_child_store = @import("../../core/session/session_child_store.zig");
const Allocator = std.mem.Allocator;const Layout = types.Layout;const Metrics = types.Metrics;const transcript_blocks = render_engine.transcript_blocks;const viewport_selection = render_engine.viewport_selection;
pub const CommandOutputDisplayState = transcript_blocks.CommandOutputDisplayState;pub const Styles = transcript_blocks.Styles;pub const AssistantTurnSegments = transcript_blocks.AssistantTurnSegments;pub const RawEntryClass = transcript_blocks.RawEntryClass;pub const TranscriptEntry = transcript_blocks.TranscriptEntry;pub const TranscriptPreparationSource = source_preparation.TranscriptPreparationSource;
pub const VisibleTranscriptSnapshot = struct { text: []u8, terminal_rows: u16, terminal_cols: u16, complete: bool,
pub fn deinit(self: *VisibleTranscriptSnapshot, alloc: Allocator) void { alloc.free(self.text); self.* = undefined; }};
pub const ResizeObservationPhase = enum { live, settle_pending, reset_queued,};
pub const ResizeObservationResult = union(enum) { awaiting, measured: i32, unavailable,};
pub const ResizeObservation = struct { layout: types.Layout, apply_after_ms: i64, expected_row: ?u32, result: ResizeObservationResult, phase: ResizeObservationPhase,};
const ViewportSelection = viewport_selection.ViewportSelection;
pub const TranscriptCommitDiagnosticState = enum { invalid, stable, recovering,};
pub const TranscriptCommitDiagnostic = struct { state: TranscriptCommitDiagnosticState, stable_start_line: ?usize = null, visual_offset: u32 = 0, layout_id: u64 = 0, remaining_inline_rows: u32 = 0, remaining_unplanned_scroll_rows: u16 = 0,};
pub const StableTranscriptProjection = struct { selection: ViewportSelection, visual_offset: u32, history_visual_offset: u32, total_visual_rows: u32, flow_unchanged: bool, cursor_row: u16, cursor_col: u16, occupied_last_row: u16, occupied_last_row_blank: bool, layout_id: u64, measured_history_origin: ?transcript_painter.MeasuredHistoryOrigin = null,};
pub const MeasuredResizeProjection = union(enum) { stable, recovering: struct { accepted_visual_offset: u32, source_cols: u16, },};
const CommittedTranscriptAnchor = struct { selection: ViewportSelection, visual_offset: u32, // Footer reflow can move the logical tail without advancing rows into // terminal history. The committed grid projection resumes from this offset. history_visual_offset: u32, total_visual_rows: u32, flow: []u8, cursor_row: u16, cursor_col: u16, occupied_last_row: u16, occupied_last_row_blank: bool, layout_id: u64, measured_history_origin: ?transcript_painter.MeasuredHistoryOrigin = null, row_provenance: []transcript_blocks.RowProvenance = &.{}, normal_buffer_recovery_pending: bool = false, /// Stable-anchor settlement obligation. It is preserved while final rows /// remain ahead of history and cleared once history reaches the viewport. /// The offset gap alone is insufficient because footer displacement can /// create the same shape without content debt. history_catchup_pending: bool = false,
fn deinit(self: *CommittedTranscriptAnchor, alloc: Allocator) void { if (self.flow.len > 0) alloc.free(self.flow); if (self.row_provenance.len > 0) alloc.free(self.row_provenance); self.* = undefined; }};
fn committedProjectionVisualOffset(anchor: CommittedTranscriptAnchor) u32 { return if (anchor.normal_buffer_recovery_pending) anchor.history_visual_offset else anchor.visual_offset;}
const TranscriptRecoveryReceipt = struct { accepted_visual_offset: u32 = 0, accepted_history_visual_offset: u32 = 0, attempt_visual_offset: u32 = 0, attempt_total_visual_rows: u32 = 0, materialized_visual_offset: u32 = 0, materialized_visual_rows: u16 = 0, materialized_flow_len: ?usize = null, remaining_resize_reflow_rows: u16 = 0, remaining_semantic_rows: u32 = 0, // Only this remaining semantic suffix may advance the current projection. remaining_semantic_progress_rows: u32 = 0, remaining_unplanned_scroll_rows: u16 = 0, attempt_cols: u16 = 0, attempt_resize_history_row_delta: ?i32 = null, attempt_resize_history_committed: bool = false, projection_rebase_pending: bool = false, tracks_semantic_progress: bool = false, flow: []u8 = &.{}, flow_owned: bool = true, presentation_resume_bytes: []u8 = &.{}, presentation_pending_wrap: bool = false, presentation_valid: bool = false, cursor_row: u16 = 1, cursor_col: u16 = 1, document_append_committed: bool = false, measured_history_origin: ?transcript_painter.MeasuredHistoryOrigin = null, row_provenance: []transcript_blocks.RowProvenance = &.{}, normal_buffer_recovery_pending: bool = false,
fn deinit(self: *TranscriptRecoveryReceipt, alloc: Allocator) void { if (self.flow_owned and self.flow.len > 0) alloc.free(self.flow); if (self.presentation_resume_bytes.len > 0) alloc.free(self.presentation_resume_bytes); if (self.row_provenance.len > 0) alloc.free(self.row_provenance); self.* = undefined; }};
const TranscriptCommitState = union(enum) { invalid, stable: CommittedTranscriptAnchor, recovering: TranscriptRecoveryReceipt,
fn deinit(self: *TranscriptCommitState, alloc: Allocator) void { switch (self.*) { .invalid => {}, .stable => |*anchor| anchor.deinit(alloc), .recovering => |*receipt| receipt.deinit(alloc), } self.* = .invalid; }};
fn recoveryAppendPrefixMatches( target_flow: []const u8, receipt: TranscriptRecoveryReceipt, materialized_flow_len: usize,) bool { return materialized_flow_len <= receipt.flow.len and materialized_flow_len <= target_flow.len and std.mem.eql( u8, target_flow[0..materialized_flow_len], receipt.flow[0..materialized_flow_len], );}
pub const TranscriptScrollFacts = struct { source_visual_offset: u32 = 0, target_visual_offset: u32 = 0, resize_reflow_rows: u16 = 0, semantic_rows: u32 = 0, semantic_progress_rows: u32 = 0, planned_rows: u16 = 0, source_compatible: bool = false, geometry_rebase: bool = false, recovery_rebase: bool = false, recovery_progress_compatible: bool = false, recovery_tracks_semantic_progress: bool = false, recovery_projection_deferred: bool = false, /// The finality floor withheld release this frame (mutable rows above /// the viewport top), or final rows remain to settle beyond what this /// frame planned. Routes into history_catchup_pending at commit so the /// existing catch-up machinery settles the debt; footer displacement /// (visual ahead of history with nothing to settle) stays unflagged. finality_hold: bool = false,};
pub const RetainedTranscriptBody = render_engine.frame_retention.RetainedTranscriptBody;
pub const TranscriptBodyDisposition = union(enum) { paint, retain_committed: RetainedTranscriptBody,};
fn nextResizeBottomAnchorPending( pending: bool, terminal_reset_commit: bool, resize_reset_commit: bool, tail_kind: ?TranscriptBlockKind, occupied_last_row: u16, content_bottom_row: u16,) bool { const next = if (terminal_reset_commit) resize_reset_commit else pending; if (tail_kind == .cancel_notice and occupied_last_row == content_bottom_row) { return false; } return next;}
test "resize bottom anchor remains pending until a cancel projection reaches it" { const Case = struct { pending: bool, terminal_reset_commit: bool, resize_reset_commit: bool, tail_kind: ?TranscriptBlockKind, occupied_last_row: u16, content_bottom_row: u16, expected: bool, }; const cases = [_]Case{ .{ .pending = false, .terminal_reset_commit = false, .resize_reset_commit = false, .tail_kind = null, .occupied_last_row = 4, .content_bottom_row = 8, .expected = false }, .{ .pending = false, .terminal_reset_commit = true, .resize_reset_commit = true, .tail_kind = null, .occupied_last_row = 4, .content_bottom_row = 8, .expected = true }, .{ .pending = true, .terminal_reset_commit = false, .resize_reset_commit = false, .tail_kind = .assistant_turn, .occupied_last_row = 4, .content_bottom_row = 8, .expected = true }, .{ .pending = true, .terminal_reset_commit = false, .resize_reset_commit = false, .tail_kind = .cancel_notice, .occupied_last_row = 4, .content_bottom_row = 8, .expected = true }, .{ .pending = true, .terminal_reset_commit = false, .resize_reset_commit = false, .tail_kind = .cancel_notice, .occupied_last_row = 8, .content_bottom_row = 8, .expected = false }, .{ .pending = true, .terminal_reset_commit = true, .resize_reset_commit = false, .tail_kind = null, .occupied_last_row = 4, .content_bottom_row = 8, .expected = false }, };
for (cases) |case| { try std.testing.expectEqual( case.expected, nextResizeBottomAnchorPending( case.pending, case.terminal_reset_commit, case.resize_reset_commit, case.tail_kind, case.occupied_last_row, case.content_bottom_row, ), ); }}
const MaterializedEndpoint = struct { visual_offset: u32 = 0, visual_rows: u16 = 0, flow_len: ?usize = null, cursor_row: u16 = 1, cursor_col: u16 = 1,};
pub const TranscriptTransition = struct { scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, document_append: render_engine.frame_scroll_plan.FrameDocumentAppend, /// Final rows exist beyond materialized history that this frame could /// not release; consuming the transition requests a follow-up frame so /// the debt settles promptly instead of waiting for outside activity. history_settle_pending: bool = false, /// Owns `document_append.bytes` when append preparation allocates wire bytes. document_append_bytes: []u8 = &.{}, resize_reflow_rows: u16 = 0, semantic_rows: u32 = 0, semantic_progress_rows: u32 = 0, recovery_rebase: bool = false, recovery_progress_compatible: bool = false, recovery_tracks_semantic_progress: bool = false, recovery_projection_deferred: bool = false, body_disposition: TranscriptBodyDisposition = .paint, target_flow: []u8, target_flow_owned: bool = true, presentation_resume_bytes: []u8 = &.{}, presentation_pending_wrap: bool = false, presentation_valid: bool = false, target_cache: std.ArrayList(u8), target_cache_unchanged: bool = false, target_cache_origin_untrimmed: bool = false, folded_summary_indices: []usize, target_layout: render_engine.frame_layout.CommittedLayoutSnapshot, selection: ViewportSelection, visual_offset: u32, history_visual_offset: u32, source_endpoint_visual_offset: u32 = 0, total_visual_rows: u32, materialized: MaterializedEndpoint = .{}, // The exact transcript endpoint if this frame appends no transcript bytes. materialized_without_append: MaterializedEndpoint, cursor_row: u16, cursor_col: u16, replaceable_last_line: bool, replaceable_start: usize, replaceable_row: u16, trace_transcript_frame: bool, trace_visible_rows: u16, measured_history_origin: ?transcript_painter.MeasuredHistoryOrigin = null, row_provenance: []transcript_blocks.RowProvenance = &.{}, normal_buffer_recovery_pending: bool = false, history_catchup_pending: bool = false, consumed: bool = false,
pub fn deinit(self: *TranscriptTransition, alloc: Allocator) void { if (self.target_flow_owned and self.target_flow.len > 0) alloc.free(self.target_flow); if (self.presentation_resume_bytes.len > 0) alloc.free(self.presentation_resume_bytes); if (self.document_append_bytes.len > 0) { alloc.free(self.document_append_bytes); } self.target_cache.deinit(alloc); if (self.folded_summary_indices.len > 0) alloc.free(self.folded_summary_indices); if (self.row_provenance.len > 0) alloc.free(self.row_provenance); self.* = undefined; }};
const MaterializedTranscriptProjection = struct { raw_flow_exact: bool = false, visual_rows: u16 = 0,};
const TranscriptBlockKind = transcript_blocks.TranscriptBlockKind;const WalkResult = transcript_blocks.WalkResult;const walkText = transcript_blocks.walkText;
fn formatDurationCompact(buf: []u8, duration_ms: u64) []const u8 { const total_seconds = duration_ms / std.time.ms_per_s; if (total_seconds < 60) { return std.fmt.bufPrint(buf, "{d}s", .{total_seconds}) catch "0s"; } if (total_seconds < 60 * 60) { const minutes = total_seconds / 60; const seconds = total_seconds % 60; return std.fmt.bufPrint(buf, "{d}m {d}s", .{ minutes, seconds }) catch "1m 0s"; } const hours = total_seconds / (60 * 60); const minutes = (total_seconds % (60 * 60)) / 60; return std.fmt.bufPrint(buf, "{d}h {d:0>2}m", .{ hours, minutes }) catch "1h 00m";}
fn formatTurnSummaryLine(buf: []u8, summary: types.TurnSummary) []const u8 { var turn_buf: [24]u8 = undefined; const turn = formatDurationCompact(&turn_buf, summary.turn_duration_ms); var out: std.Io.Writer = .fixed(buf); out.print(" {s}", .{turn}) catch return " "; activity_status.appendTokenProgressSuffix(&out, summary.token_progress) catch return out.buffered(); return out.buffered();}
fn lifecycleEventTurnId(event: types.ToolLifecycleEvent) u64 { return switch (event) { .provisional => |payload| payload.id.turn_id, .authoritative_started => |payload| payload.id.turn_id, .progress => |payload| payload.id.turn_id, .terminal => |payload| payload.id.turn_id, .turn_finished => |payload| payload.turn_id, };}
fn admitLifecycleStart( state: *const activity_runtime.ToolActivityState, id: types.ToolLifecycleId,) bool { return switch (state.admitStart(id)) { .accepted => true, .invalid_identity => false, .finalized => |fence| blk: { debug_trace.logf( "ui_activity", "lifecycle rejected by finalized fence turn_id={d} fence={d} kind=start", .{ id.turn_id, fence }, ); break :blk false; }, };}
fn traceLateLifecycleEvent(id: types.ToolLifecycleId, event_kind: []const u8) void { debug_trace.logf( "ui_activity", "late lifecycle event ignored turn_id={d} kind={s}", .{ id.turn_id, event_kind }, );}
fn lifecycleStartLine( alloc: Allocator, tool_name: ?[]const u8,) ![]u8 { var label_buf: [512]u8 = undefined; const label = std.fmt.bufPrint( &label_buf, "● {s}", .{tool_name orelse "tool"}, ) catch "● tool"; return std.fmt.allocPrint( alloc, "{s}{s}\n", .{ label, ui_render.reset_style }, );}
fn lifecycleLine(alloc: Allocator, text: []const u8) ![]u8 { if (std.mem.endsWith(u8, text, "\n")) return alloc.dupe(u8, text); return std.fmt.allocPrint(alloc, "{s}\n", .{text});}
const LifecycleMarker = struct { style: []const u8, glyph: []const u8,};
fn lifecycleMarker(kind: types.ToolOutcomeKind) LifecycleMarker { return switch (kind) { .completed => .{ .style = ui_render.system_notice_text_style, .glyph = "●" }, .failed => .{ .style = ui_render.red_style, .glyph = "●" }, .denied => .{ .style = ui_render.red_style, .glyph = "⊘" }, .cancelled => .{ .style = ui_render.warning_style, .glyph = "■" }, .deferred => .{ .style = ui_render.warning_style, .glyph = "↻" }, };}
fn leadingSgrPrefixEnd(text: []const u8) usize { var index: usize = 0; while (index + 2 <= text.len and text[index] == 0x1b and text[index + 1] == '[') { var end = index + 2; while (end < text.len and (text[end] < 0x40 or text[end] > 0x7e)) : (end += 1) {} if (end == text.len or text[end] != 'm') break; index = end + 1; } return index;}
fn lifecycleTerminalLine( alloc: Allocator, kind: types.ToolOutcomeKind, summary: []const u8,) ![]u8 { const marker = lifecycleMarker(kind); const prefix_end = leadingSgrPrefixEnd(summary); const has_marker = std.mem.startsWith(u8, summary[prefix_end..], "●"); const cancelled = kind == .cancelled; const text_style = if (cancelled) ui_render.hint_style else ""; const text_reset = if (cancelled) ui_render.reset_style else ""; const follow_up = if (cancelled) " · What can fx do differently?" else ""; const normalized = if (has_marker) try std.fmt.allocPrint( alloc, "{s}{s}{s}{s}{s}{s}{s}{s}", .{ marker.style, marker.glyph, ui_render.reset_style, summary[0..prefix_end], text_style, summary[prefix_end + "●".len ..], text_reset, follow_up, }, ) else try std.fmt.allocPrint( alloc, "{s}{s}{s} {s}{s}{s}{s}", .{ marker.style, marker.glyph, ui_render.reset_style, text_style, summary, text_reset, follow_up, }, ); defer alloc.free(normalized); return lifecycleLine(alloc, normalized);}
/// Pure formatter shared by live lifecycle presentation and detached resume/// projection. The caller owns the returned line.pub fn formatHistoricalToolStatusLine( alloc: Allocator, kind: types.ToolOutcomeKind, summary: []const u8,) ![]u8 { return lifecycleTerminalLine(alloc, kind, summary);}
fn lifecycleFallbackLine( alloc: Allocator, outcome: types.TurnPresentationOutcome, was_provisional: bool,) ![]u8 { return switch (outcome) { .completed => lifecycleLine(alloc, if (was_provisional) "● Tool was not executed" else "● Tool completion was not reported"), .interrupted => lifecycleTerminalLine(alloc, .cancelled, "Tool cancelled"), .failed => lifecycleTerminalLine(alloc, .failed, "Tool failed"), .paused => lifecycleLine(alloc, "● Tool state preserved for recovery"), };}
fn lifecycleFallbackDisposition( outcome: types.TurnPresentationOutcome, was_provisional: bool,) ?transcript_blocks.ToolFallbackDisposition { if (outcome != .completed) return null; return if (was_provisional) .not_executed else .completion_unreported;}
fn traceLifecycleFailure( event_kind: []const u8, turn_id: u64, err: anyerror,) void { debug_trace.logf( "ui_activity", "lifecycle transaction failed kind={s} turn_id={d} err={s}", .{ event_kind, turn_id, @errorName(err) }, );}
test "formatTurnSummaryLine renders total duration and tokens" { var buf: [128]u8 = undefined; const line = formatTurnSummaryLine(&buf, .{ .thinking_duration_ms = 15_000, .turn_duration_ms = 130_000, .token_progress = .{ .input_tokens = 10_000, .output_tokens = 5_000 }, }); try std.testing.expectEqualStrings(" 2m 10s (↑10k ↓5k)", line);}
test "formatTurnSummaryLine renders only total duration without token estimate" { var buf: [128]u8 = undefined; const line = formatTurnSummaryLine(&buf, .{ .thinking_duration_ms = 3_000, .turn_duration_ms = 3_600_000, }); try std.testing.expectEqualStrings(" 1h 00m", line);}
test "appendTurnSummaryEntry stores classified dim transcript row" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
_ = try runtime.appendTurnSummaryEntry(alloc, .{ .thinking_duration_ms = 15_000, .turn_duration_ms = 130_000, .token_progress = .{ .input_tokens = 10_000, .output_tokens = 5_000 }, });
try std.testing.expectEqual(@as(usize, 1), runtime.entries.items.len); try std.testing.expect(runtime.entries.items[0] == .raw_bytes); try std.testing.expectEqual(RawEntryClass.turn_summary, runtime.entries.items[0].raw_bytes.class); try std.testing.expect(std.mem.find(u8, runtime.entries.items[0].raw_bytes.bytes, " 2m 10s (↑10k ↓5k)") != null);
const rendered = try renderEntriesToBytes(alloc, runtime.entries.items, runtime.layout.cols, .{}); defer alloc.free(rendered); try std.testing.expectEqualStrings("\x1b[38;5;245m 2m 10s (↑10k ↓5k)\x1b[0m\n", rendered);}
test "recovered route status is transient and final summary stays normal" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
runtime.worker_status.set_route_recovery(.{ .kind = .auto_recovered, .succeeded_attempt = 3, .attempt_limit = 3, }, 1_000);
switch (runtime.activityProjection()) { .turn_thinking => |thinking| { try std.testing.expectEqual(activity_runtime.ActivityProjection.Tone.success, thinking.tone); try std.testing.expectEqualStrings("✓ recovered · attempt 3/3", thinking.label); }, .none, .tool_slot => return error.TestUnexpectedResult, } try std.testing.expect(!runtime.worker_status.expire_transient(2_499)); try std.testing.expect(runtime.worker_status.expire_transient(2_500)); try std.testing.expect(runtime.activityProjection() == .none);
runtime.worker_status.set_route_recovery(.{ .kind = .auto_recovered, .succeeded_attempt = 3, .attempt_limit = 3, }, 3_000); _ = try runtime.appendTurnSummaryEntry(alloc, .{ .thinking_duration_ms = 15_000, .turn_duration_ms = 130_000, .token_progress = .{ .input_tokens = 10_000, .output_tokens = 5_000 }, });
try std.testing.expect(runtime.activityProjection() == .none); try std.testing.expect(std.mem.find(u8, runtime.entries.items[0].raw_bytes.bytes, ui_render.dim_style) != null); try std.testing.expect(std.mem.find(u8, runtime.entries.items[0].raw_bytes.bytes, " 2m 10s (↑10k ↓5k)") != null); try std.testing.expect(std.mem.find(u8, runtime.entries.items[0].raw_bytes.bytes, "✓ recovered") == null);}
test "appendTurnSummaryEntry leaves terminal route status visible" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
runtime.worker_status.set_route_recovery(.{ .kind = .content_filter }, 0); _ = try runtime.appendTurnSummaryEntry(alloc, .{ .thinking_duration_ms = 15_000, .turn_duration_ms = 130_000, .token_progress = .{ .input_tokens = 10_000, .output_tokens = 5_000 }, });
switch (runtime.activityProjection()) { .turn_thinking => |thinking| try std.testing.expectEqualStrings("⚠ blocked · content filter", thinking.label), .none, .tool_slot => return error.TestUnexpectedResult, } try std.testing.expect(std.mem.find(u8, runtime.entries.items[0].raw_bytes.bytes, " 2m 10s (↑10k ↓5k)") != null);}
test "full transcript projection opens without folded command output" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
try std.testing.expect(try runtime.setTranscriptPresentationDepth(alloc, .review)); try std.testing.expect(runtime.fullTranscriptActive());}
test "full transcript viewport snapshot restores reading position" { var source = TranscriptRuntime{ .full_transcript = .{ .depth = .review, .scroll_rows = 37, .follow_tail = false, .anchor_entry_id = 19, .anchor_pending = true, }, }; defer source.deinit(std.testing.allocator); const snapshot = source.snapshotFullTranscriptViewport();
var restored = TranscriptRuntime{}; defer restored.deinit(std.testing.allocator); restored.restoreFullTranscriptViewport(snapshot);
try std.testing.expect(std.meta.eql( snapshot, restored.snapshotFullTranscriptViewport(), ));}
test "full transcript code copy frame clears through dirty scroll and close" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .full_transcript = .{ .depth = .review } }; defer runtime.deinit(alloc);
if (comptime @hasDecl(TranscriptRuntime, "commitCodeCopyFrame") and @hasDecl(TranscriptRuntime, "codeCopyHit")) { const commit = @field(TranscriptRuntime, "commitCodeCopyFrame"); const hit = @field(TranscriptRuntime, "codeCopyHit");
var dirty_frame: full_transcript_screen.CodeCopyInteractionFrame = .{}; defer dirty_frame.deinit(alloc); try dirty_frame.targets.append(alloc, .{ .entry_id = 1, .row = 4, .first_col = 10, .last_col = 13, }); commit(&runtime, alloc, &dirty_frame); try std.testing.expectEqual(@as(?u32, 1), hit(&runtime, 4, 11)); runtime.markTranscriptDirty(); try std.testing.expectEqual(@as(?u32, null), hit(&runtime, 4, 11));
var scroll_frame: full_transcript_screen.CodeCopyInteractionFrame = .{}; defer scroll_frame.deinit(alloc); try scroll_frame.targets.append(alloc, .{ .entry_id = 2, .row = 5, .first_col = 20, .last_col = 23, }); commit(&runtime, alloc, &scroll_frame); runtime.scrollFullTranscript(.up, .wheel); try std.testing.expectEqual(@as(?u32, null), hit(&runtime, 5, 21));
var close_frame: full_transcript_screen.CodeCopyInteractionFrame = .{}; defer close_frame.deinit(alloc); try close_frame.targets.append(alloc, .{ .entry_id = 3, .row = 6, .first_col = 30, .last_col = 33, }); commit(&runtime, alloc, &close_frame); runtime.closeFullTranscriptState(); try std.testing.expectEqual(@as(?u32, null), hit(&runtime, 6, 31)); } else { return error.TestUnexpectedResult; }}
test "opening the full transcript leaves compact command projection unchanged" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{}; try runtime.writeCommandOutputChunk(alloc, &metrics, styles, .stdout, "first\n", true); try runtime.writeCommandOutputChunk(alloc, &metrics, styles, .stdout, "second\n", true); try runtime.flushCommandOutputSummary(alloc, &metrics, styles, true); var compact_before = try runtime.prepareTranscriptSource(alloc, null); defer compact_before.deinit(alloc); try std.testing.expectEqual(@as(usize, 0), compact_before.bytes.len);
_ = try runtime.setTranscriptPresentationDepth(alloc, .review); var compact_after = try runtime.prepareTranscriptSource(alloc, null); defer compact_after.deinit(alloc); try std.testing.expectEqualStrings(compact_before.bytes, compact_after.bytes);}
test "full transcript staging paints its selected wheel viewport without reselection" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .owned_top_row = 1, .full_transcript = .{ .depth = .review, .scroll_rows = 3, .follow_tail = false, }, }; defer runtime.deinit(alloc);
_ = try runtime.appendRawTranscriptEntryClassified( alloc, "row-0\nrow-1\nrow-2\nrow-3\nrow-4\nrow-5\nrow-6\nrow-7\n", .unknown_raw, ); var projection = try runtime.buildFullTranscriptProjection(alloc, null); defer projection.deinit(alloc); var metrics: Metrics = .{}; var staged = try runtime.prepareFullTranscriptSurfacePaint( alloc, &metrics, &projection, null, .{ .top = 1, .bottom = 4 }, ); defer staged.source.deinit(alloc); defer staged.prepared.deinit(alloc); defer staged.code_copy_frame.deinit(alloc);
try std.testing.expectEqual(@as(u32, 3), runtime.full_transcript.scroll_rows); try std.testing.expect(!runtime.full_transcript.follow_tail); try std.testing.expectEqual(@as(usize, 0), staged.prepared.selection.start_line); try std.testing.expect(std.mem.find(u8, staged.source.bytes, "row-3") != null); try std.testing.expect(std.mem.find(u8, staged.source.bytes, "row-0") == null);}
test "full transcript staging carries visible code copy targets" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 12, .cols = 80, .content_bottom = 8, .divider_top_row = 9, .input_row = 10, .divider_bottom_row = 11, .hint_row = 12, }, .owned_top_row = 1, .full_transcript = .{ .depth = .review }, }; defer runtime.deinit(alloc);
var language: ?[]u8 = try alloc.dupe(u8, "zig"); errdefer if (language) |bytes| alloc.free(bytes); var code: ?[]u8 = try alloc.dupe(u8, "const value = 1;"); errdefer if (code) |bytes| alloc.free(bytes); _ = try runtime.appendAssistantCodeBlockOwned(alloc, .{ .language = language.?, .code = code.?, }); language = null; code = null; var projection = try runtime.buildFullTranscriptProjection(alloc, null); defer projection.deinit(alloc); var metrics: Metrics = .{}; var staged = try runtime.prepareFullTranscriptSurfacePaint( alloc, &metrics, &projection, null, .{ .top = 2, .bottom = 8 }, ); defer staged.source.deinit(alloc); defer staged.prepared.deinit(alloc); defer staged.code_copy_frame.deinit(alloc);
if (comptime @hasField(TranscriptRuntime.FullTranscriptSurfacePaint, "code_copy_frame")) { const frame = @field(staged, "code_copy_frame"); try std.testing.expectEqual(@as(usize, 1), frame.targets.items.len); try std.testing.expectEqual(@as(u16, 2), frame.targets.items[0].row); } else { return error.TestUnexpectedResult; }}
test "full transcript projection cache survives navigation and invalidates on content change" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .owned_top_row = 1, .full_transcript = .{ .depth = .review }, }; defer runtime.deinit(alloc); _ = try runtime.appendRawTranscriptEntryClassified( alloc, "row-0\nrow-1\nrow-2\nrow-3\nrow-4\n", .unknown_raw, );
var compact = try runtime.cachedTranscriptSource(alloc); defer compact.deinit(alloc); const cached_compact = runtime.compact_transcript_source_cache.find( runtime.full_transcript_content_revision, runtime.layout.cols, runtime.has_committed_frame, ).?; const compact_bytes = cached_compact.bytes.ptr; try std.testing.expect(cached_compact.hard_line_starts.len > 0); try std.testing.expectEqual( cached_compact.hard_line_starts.len, cached_compact.transcript_visible_lines.len, ); try std.testing.expectEqual( cached_compact.hard_line_starts.len, cached_compact.transcript_line_visual_rows.len, ); try std.testing.expectEqual( cached_compact.transcript_visible_lines.len, compact.transcript_visible_lines.len, ); runtime.markTranscriptDirty(); var same_compact = try runtime.cachedTranscriptSource(alloc); defer same_compact.deinit(alloc); try std.testing.expectEqual(compact_bytes, runtime.compact_transcript_source_cache.find( runtime.full_transcript_content_revision, runtime.layout.cols, runtime.has_committed_frame, ).?.bytes.ptr); runtime.has_committed_frame = true; try std.testing.expectEqual(@as(?*TranscriptPreparationSource, null), runtime.compact_transcript_source_cache.find( runtime.full_transcript_content_revision, runtime.layout.cols, runtime.has_committed_frame, )); var committed_compact = try runtime.cachedTranscriptSource(alloc); committed_compact.deinit(alloc); runtime.has_committed_frame = false;
const review = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try full_transcript_screen.measureProjectionInterruptible(alloc, review, null, 40, null); try std.testing.expectEqual(@as(?u16, 40), review.measurement_cols); const same_review = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(@as(?u16, 40), same_review.measurement_cols); runtime.full_transcript = runtime.full_transcript.capture_anchor(1); const reanchored_review = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(review, reanchored_review);
for ([_]u16{ 20, 30, 50 }) |cols| { runtime.layout.cols = cols; const resized = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try full_transcript_screen.measureProjectionInterruptible(alloc, resized, null, cols, null); } runtime.layout.cols = 40; const original_width = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(@as(?u16, 40), original_width.measurement_cols);
_ = try runtime.setTranscriptPresentationDepth(alloc, .full); _ = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try runtime.setTranscriptPresentationDepth(alloc, .review); const restored_review = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(@as(?u16, 40), restored_review.measurement_cols);
runtime.markTranscriptCommandOutputDirty(); const review_after_live_output = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(@as(?u16, 40), review_after_live_output.measurement_cols);
_ = try runtime.setTranscriptPresentationDepth(alloc, .full); const full_before_live_output = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try full_transcript_screen.measureProjectionInterruptible(alloc, full_before_live_output, null, 40, null); runtime.markTranscriptCommandOutputDirty(); const full_after_live_output = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(@as(?u16, null), full_after_live_output.measurement_cols);
_ = try runtime.setTranscriptPresentationDepth(alloc, .review); const review_still_cached = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(@as(?u16, 40), review_still_cached.measurement_cols);
runtime.command_output_display.open_command_block = 0; runtime.markTranscriptContentDirty(); const review_during_live_command = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(review_still_cached, review_during_live_command); runtime.command_output_display.open_command_block = null;
runtime.markTranscriptContentDirty(); var rebuilt_compact = try runtime.cachedTranscriptSource(alloc); defer rebuilt_compact.deinit(alloc); try std.testing.expect(compact_bytes != runtime.compact_transcript_source_cache.find( runtime.full_transcript_content_revision, runtime.layout.cols, runtime.has_committed_frame, ).?.bytes.ptr); const rebuilt_review = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expectEqual(@as(?u16, null), rebuilt_review.measurement_cols);}
const CacheBuildProbe = struct { polls: usize = 0, pending_after: ?usize = null,
fn pending(context: *anyopaque) bool { const self: *CacheBuildProbe = @ptrCast(@alignCast(context)); self.polls += 1; return if (self.pending_after) |limit| self.polls >= limit else false; }};
fn cacheTestRuntime(depth: transcript_presentation.Depth, cols: u16) TranscriptRuntime { var layout = testLayoutWithRows(8); layout.cols = cols; return .{ .layout = layout, .owned_top_row = 1, .full_transcript = .{ .depth = depth }, };}
fn appendCacheTestEntries( runtime: *TranscriptRuntime, alloc: Allocator, count: usize,) !void { try runtime.entries.ensureUnusedCapacity(alloc, count); for (0..count) |_| { const bytes = try alloc.dupe(u8, "retained\n"); runtime.entries.appendAssumeCapacity(.{ .raw_bytes = .{ .id = runtime.next_entry_id, .bytes = bytes, } }); runtime.next_entry_id +%= 1; } runtime.markTranscriptContentDirty();}
fn renderCacheTail( alloc: Allocator, runtime: *TranscriptRuntime, projection: *full_transcript_screen.Projection, rows: u16,) ![]u8 { const measurement = try full_transcript_screen.measureProjectionInterruptible( alloc, projection, null, runtime.layout.cols, null, ); return full_transcript_screen.renderProjectionViewportSourceInterruptible( alloc, projection, null, runtime.layout.cols, rows, measurement.total_rows -| rows, null, );}
test "full transcript cache reuses retained entries across append and width changes" { const alloc = std.testing.allocator; for ([_]transcript_presentation.Depth{ .review, .full }) |depth| { var runtime = cacheTestRuntime(depth, 40); defer runtime.deinit(alloc);
try appendCacheTestEntries(&runtime, alloc, 4_500); _ = try runtime.cachedFullTranscriptProjection(alloc, null); if (depth == .review) { runtime.layout.cols = 41; var resize_probe: CacheBuildProbe = .{}; var resize_checkpoint = build_checkpoint.BuildCheckpoint.init( &resize_probe, CacheBuildProbe.pending, ); _ = try runtime.cachedFullTranscriptProjectionInterruptible( alloc, null, &resize_checkpoint, ); try std.testing.expectEqual(@as(usize, 2), resize_probe.polls); runtime.layout.cols = 40; } _ = try runtime.appendRawTranscriptEntryClassified( alloc, "APPENDED_TAIL\n", .unknown_raw, );
var probe: CacheBuildProbe = .{}; var checkpoint = build_checkpoint.BuildCheckpoint.init(&probe, CacheBuildProbe.pending); const projection = try runtime.cachedFullTranscriptProjectionInterruptible( alloc, null, &checkpoint, );
try std.testing.expectEqual(@as(usize, 0), probe.polls); const tail = try renderCacheTail(alloc, &runtime, projection, 2); defer alloc.free(tail); try std.testing.expect(std.mem.find(u8, tail, "APPENDED_TAIL") != null); }}
test "review cache retains block spacing across a hidden tail" { const alloc = std.testing.allocator; var runtime = cacheTestRuntime(.review, 40); defer runtime.deinit(alloc); _ = try runtime.appendRawTranscriptEntryClassified(alloc, "BEFORE\n", .unknown_raw); _ = try runtime.appendRawTranscriptEntryClassified(alloc, "HIDDEN\n", .command_output); _ = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try runtime.appendRawTranscriptEntryClassified(alloc, "AFTER\n", .unknown_raw);
const incremental = try runtime.cachedFullTranscriptProjection(alloc, null); const incremental_tail = try renderCacheTail(alloc, &runtime, incremental, 16); defer alloc.free(incremental_tail); var rebuilt = try runtime.buildFullTranscriptProjection(alloc, null); defer rebuilt.deinit(alloc); const rebuilt_tail = try renderCacheTail(alloc, &runtime, &rebuilt, 16); defer alloc.free(rebuilt_tail);
try std.testing.expectEqualStrings(rebuilt_tail, incremental_tail);}
test "full transcript cache updates only the streamed assistant tail" { const alloc = std.testing.allocator; var runtime = cacheTestRuntime(.review, 40); defer runtime.deinit(alloc); try appendCacheTestEntries(&runtime, alloc, 4_500); var metrics: Metrics = .{}; _ = try runtime.streamAssistantChunk(alloc, &metrics, "assistant"); _ = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try runtime.streamAssistantChunk(alloc, &metrics, " tail");
var probe: CacheBuildProbe = .{}; var checkpoint = build_checkpoint.BuildCheckpoint.init(&probe, CacheBuildProbe.pending); const projection = try runtime.cachedFullTranscriptProjectionInterruptible( alloc, null, &checkpoint, );
try std.testing.expectEqual(@as(usize, 0), probe.polls); const tail = try renderCacheTail(alloc, &runtime, projection, 2); defer alloc.free(tail); try std.testing.expect(std.mem.find(u8, tail, "assistant tail") != null);}
test "command output admission invalidates cached prefixes when reservation trims retention" { const alloc = std.testing.allocator; var runtime = cacheTestRuntime(.full, 40); defer runtime.deinit(alloc);
const payload = try alloc.alloc(u8, 256); defer alloc.free(payload); @memset(payload, 'x'); for (0..8) |_| { _ = try runtime.appendRawTranscriptEntryClassified( alloc, payload, .unknown_raw, ); } runtime.full_transcript.depth = .review; _ = try runtime.cachedFullTranscriptProjection(alloc, null); runtime.full_transcript.depth = .full; _ = try runtime.cachedFullTranscriptProjection(alloc, null); const entry_count_before = runtime.entries.items.len; runtime.max_retained_transcript_bytes = 512;
var metrics: Metrics = .{}; try runtime.writeCommandOutputChunk( alloc, &metrics, .{}, .stdout, "new output\n", true, );
try std.testing.expect(runtime.entries.items.len < entry_count_before + 1); try std.testing.expect( runtime.full_transcript_projection_cache.full.entries[0].?.dirty == .all, ); try std.testing.expect( runtime.full_transcript_projection_cache.review.entries[0].?.dirty == .all, );}
test "command and lifecycle updates reuse measured prefix and publish atomically" { const alloc = std.testing.allocator; var runtime = cacheTestRuntime(.full, 40); defer runtime.deinit(alloc); try appendCacheTestEntries(&runtime, alloc, 4_500);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{}; try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "command", true, ); const command_entry_id = runtime.command_output_blocks.items[0].lines.items[0].entry_id.?; const initial = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try full_transcript_screen.measureProjectionInterruptible(alloc, initial, null, 40, null);
const continuation = try alloc.alloc(u8, 16 * 1024); defer alloc.free(continuation); @memset(continuation, 'x'); try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, continuation, true, ); const dirty_after_append = switch (runtime.full_transcript_projection_cache.full.entries[0].?.dirty) { .entry => |entry| entry.id, .clean, .all => return error.TestExpectedExactCommandDirtyEntry, }; try std.testing.expectEqual(command_entry_id, dirty_after_append);
const updated = try runtime.cachedFullTranscriptProjection(alloc, null); const prefix_before = updated.measurement_prefix orelse return error.TestExpectedMeasurementPrefix; const checkpoints_before = updated.measured_segment_checkpoints.items.len; var probe: CacheBuildProbe = .{ .pending_after = 1 }; var checkpoint = build_checkpoint.BuildCheckpoint.init(&probe, CacheBuildProbe.pending); try std.testing.expectError( error.InputPending, full_transcript_screen.measureProjectionInterruptible( alloc, updated, null, 40, &checkpoint, ), ); try std.testing.expectEqual(@as(?u16, null), updated.measurement_cols); try std.testing.expectEqual( prefix_before.segment_count, updated.measurement_prefix.?.segment_count, ); try std.testing.expectEqual( checkpoints_before, updated.measured_segment_checkpoints.items.len, ); for (0..2) |fail_index| { var failing = std.testing.FailingAllocator.init(alloc, .{ .fail_index = fail_index }); try std.testing.expectError( error.OutOfMemory, full_transcript_screen.measureProjectionInterruptible( failing.allocator(), updated, null, 40, null, ), ); try std.testing.expectEqual( checkpoints_before, updated.measured_segment_checkpoints.items.len, ); }
const resumed = try full_transcript_screen.measureProjectionInterruptible(alloc, updated, null, 40, null); var rebuilt = try runtime.buildFullTranscriptProjection(alloc, null); defer rebuilt.deinit(alloc); const baseline = try full_transcript_screen.measureProjectionInterruptible(alloc, &rebuilt, null, 40, null); try std.testing.expectEqual(baseline.total_rows, resumed.total_rows); try std.testing.expectEqual(baseline.anchor_row, resumed.anchor_row); try std.testing.expectEqualSlices( transcript_presentation.ItemRow, baseline.item_rows, resumed.item_rows, );
try runtime.flushCommandOutputSummary(alloc, &metrics, styles, true); const dirty_after_close = switch (runtime.full_transcript_projection_cache.full.entries[0].?.dirty) { .entry => |entry| entry.id, .clean, .all => return error.TestExpectedExactCommandDirtyEntry, }; try std.testing.expectEqual(command_entry_id, dirty_after_close); const closed = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expect(closed.measurement_prefix != null); const closed_measurement = try full_transcript_screen.measureProjectionInterruptible(alloc, closed, null, 40, null); var rebuilt_closed = try runtime.buildFullTranscriptProjection(alloc, null); defer rebuilt_closed.deinit(alloc); const closed_baseline = try full_transcript_screen.measureProjectionInterruptible( alloc, &rebuilt_closed, null, 40, null, ); try std.testing.expectEqual(closed_baseline.total_rows, closed_measurement.total_rows); try std.testing.expectEqualSlices( transcript_presentation.ItemRow, closed_baseline.item_rows, closed_measurement.item_rows, );
const status_entry_id = try runtime.appendRawTranscriptEntryClassified( alloc, "● Running command\n", .tool_status, ); runtime.entries.items[runtime.entries.items.len - 1].raw_bytes.lifecycle_pinned = true; const before_status_update = try runtime.cachedFullTranscriptProjection(alloc, null); _ = try full_transcript_screen.measureProjectionInterruptible(alloc, before_status_update, null, 40, null); try std.testing.expect(try transcript_store.replacePinnedToolStatusAtomic( &runtime, alloc, status_entry_id, "● Ran command\n", )); const dirty_after_status = switch (runtime.full_transcript_projection_cache.full.entries[0].?.dirty) { .entry => |entry| entry.id, .clean, .all => return error.TestExpectedExactLifecycleDirtyEntry, }; try std.testing.expectEqual(status_entry_id, dirty_after_status); const updated_status = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expect(updated_status.measurement_prefix != null); _ = try full_transcript_screen.measureProjectionInterruptible(alloc, updated_status, null, 40, null);
try transcript_store.clearLifecyclePinsAtomic(&runtime, alloc, &.{status_entry_id}); const dirty_after_cleanup = switch (runtime.full_transcript_projection_cache.full.entries[0].?.dirty) { .entry => |entry| entry.id, .clean, .all => return error.TestExpectedExactLifecycleDirtyEntry, }; try std.testing.expectEqual(status_entry_id, dirty_after_cleanup); const cleaned_status = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expect(cleaned_status.measurement_prefix != null); _ = try full_transcript_screen.measureProjectionInterruptible(alloc, cleaned_status, null, 40, null);}
test "full transcript cache rebuilds a changed tool group without its old prefix" { const alloc = std.testing.allocator; var runtime = cacheTestRuntime(.review, 80); defer runtime.deinit(alloc); try appendCacheTestEntries(&runtime, alloc, 8); var tool_ids: [3]u32 = undefined; for (&tool_ids, 0..) |*entry_id, index| { entry_id.* = try runtime.appendRawTranscriptEntryClassified( alloc, "● Read file.zig\n", .tool_status, ); try runtime.tool_details.append(alloc, .{ .entry_id = entry_id.*, .tool_name = try std.fmt.allocPrint(alloc, "read_{d}", .{index}), .activity_kind = .read, .outcome = .completed, .presentation_group_id = .{ .turn_id = 1, .anchor_step_id = 1 }, }); } _ = try runtime.cachedFullTranscriptProjection(alloc, null);
runtime.tool_details.items[runtime.tool_details.items.len - 1].outcome = .failed; runtime.markTranscriptContentDirtyFrom(tool_ids[2]); const projection = try runtime.cachedFullTranscriptProjection(alloc, null); const tail = try renderCacheTail(alloc, &runtime, projection, 6); defer alloc.free(tail); try std.testing.expect(std.mem.find(u8, tail, "1 failed") != null);}
test "full transcript cancellation preserves the prior cache and viewport for retry" { const alloc = std.testing.allocator; var runtime = cacheTestRuntime(.review, 40); defer runtime.deinit(alloc); try appendCacheTestEntries(&runtime, alloc, 5_000); const previous = try runtime.cachedFullTranscriptProjection(alloc, null); try std.testing.expect(&runtime.full_transcript_projection_cache.review.entries[0].?.projection == previous); runtime.full_transcript.scroll_rows = 7; runtime.full_transcript.follow_tail = false; runtime.full_transcript.bookmark_entry_id = 12; runtime.full_transcript.bookmark_intra_row = 2; const viewport_before = runtime.snapshotFullTranscriptViewport();
try appendCacheTestEntries(&runtime, alloc, 5_000); _ = try runtime.appendRawTranscriptEntryClassified( alloc, "CANCEL_RETRY_TAIL\n", .unknown_raw, ); const Probe = struct { fn pending(_: *anyopaque) bool { return true; } }; var context: u8 = 0; var checkpoint = build_checkpoint.BuildCheckpoint.init(&context, Probe.pending); try std.testing.expectError( error.InputPending, runtime.cachedFullTranscriptProjectionInterruptible( alloc, null, &checkpoint, ), );
try std.testing.expect(&runtime.full_transcript_projection_cache.review.entries[0].?.projection == previous); try std.testing.expect(runtime.full_transcript_projection_cache.review.find( runtime.full_transcript_review_revision, runtime.layout.cols, null, ) == null); try std.testing.expect(std.meta.eql( viewport_before, runtime.snapshotFullTranscriptViewport(), )); const retry = try runtime.cachedFullTranscriptProjection(alloc, null); const tail = try renderCacheTail(alloc, &runtime, retry, 2); defer alloc.free(tail); try std.testing.expect(std.mem.find(u8, tail, "CANCEL_RETRY_TAIL") != null);}
test "cached compact transcript refreshes after streamed assistant text" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .owned_top_row = 1, }; defer runtime.deinit(alloc); _ = try runtime.appendRawTranscriptEntryClassified( alloc, "existing transcript\n", .unknown_raw, );
var before = try runtime.cachedTranscriptSource(alloc); defer before.deinit(alloc); try std.testing.expect(std.mem.find(u8, before.bytes, "streamed assistant") == null);
var metrics = Metrics{}; _ = try runtime.streamAssistantChunk(alloc, &metrics, "streamed assistant\n"); var after = try runtime.cachedTranscriptSource(alloc); defer after.deinit(alloc);
try std.testing.expect(std.mem.find(u8, after.bytes, "streamed assistant") != null);}
test "clearing a transcript releases cached sources and projections" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .owned_top_row = 1, .full_transcript = .{ .depth = .review }, }; defer runtime.deinit(alloc); _ = try runtime.appendRawTranscriptEntryClassified( alloc, "old session transcript\n", .unknown_raw, );
var compact = try runtime.cachedTranscriptSource(alloc); compact.deinit(alloc); _ = try runtime.cachedFullTranscriptProjection(alloc, null); const content_revision = runtime.full_transcript_content_revision; const review_revision = runtime.full_transcript_review_revision; try std.testing.expect(runtime.compact_transcript_source_cache.find( content_revision, runtime.layout.cols, runtime.has_committed_frame, ) != null); try std.testing.expect(runtime.full_transcript_projection_cache.review.find( review_revision, runtime.layout.cols, null, ) != null);
runtime.clearTranscript(alloc);
try std.testing.expect(runtime.compact_transcript_source_cache.find( content_revision, runtime.layout.cols, runtime.has_committed_frame, ) == null); try std.testing.expect(runtime.full_transcript_projection_cache.review.find( review_revision, runtime.layout.cols, null, ) == null);}
test "cached compact transcript preserves pending resume flow" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .owned_top_row = 1, }; defer runtime.deinit(alloc); _ = try runtime.appendRawTranscriptEntryClassified( alloc, "retained tail only\n", .unknown_raw, ); runtime.pending_resume_source = try source_preparation.prepareFullTranscriptViewportSource( &runtime, alloc, try alloc.dupe(u8, "full resume history\nretained tail only\n"), );
var source = try runtime.cachedTranscriptSource(alloc); defer source.deinit(alloc);
try std.testing.expect(std.mem.find(u8, source.bytes, "full resume history") != null);}
test "startup resume view release preserves later structured notices" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
const resume_entry_id = try runtime.appendRawTranscriptEntryClassified( alloc, "cached resume view\n", .unknown_raw, ); _ = try runtime.appendSemanticNotice(alloc, .{ .topic = "recording", .tone = .warning, .body = "terminal capture is active", }); try std.testing.expect(std.mem.find(u8, runtime.transcript.items, "cached resume view") != null); try std.testing.expect(std.mem.find(u8, runtime.transcript.items, "terminal capture is active") != null);
try std.testing.expect(try runtime.releaseStartupResumeViewEntry(alloc, resume_entry_id));
try std.testing.expectEqual(@as(usize, 1), runtime.entries.items.len); try std.testing.expect(runtime.entries.items[0] == .semantic_notice); try std.testing.expect(std.mem.find(u8, runtime.transcript.items, "cached resume view") == null); try std.testing.expect(std.mem.find(u8, runtime.transcript.items, "terminal capture is active") != null); try std.testing.expect(!try runtime.releaseStartupResumeViewEntry(alloc, resume_entry_id));}
test "pending resume source publishes its line index once" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = testLayoutWithRows(8) }; runtime.layout.cols = 40; defer runtime.deinit(alloc);
var flow: std.ArrayList(u8) = .empty; defer flow.deinit(alloc); for (0..5_000) |_| try flow.appendSlice(alloc, "resume row\n"); runtime.pending_resume_source = try source_preparation.prepareFullTranscriptViewportSource( &runtime, alloc, try flow.toOwnedSlice(alloc), ); const flow_ptr = runtime.pendingResumeFlow().ptr;
var cancelled_probe = CacheBuildProbe{ .pending_after = 1 }; var cancelled = build_checkpoint.BuildCheckpoint.init( &cancelled_probe, CacheBuildProbe.pending, ); try std.testing.expectError( error.InputPending, runtime.pendingResumeSourceInterruptible(alloc, &cancelled), ); try std.testing.expectEqual(@as(usize, 0), runtime.pending_resume_source.?.hard_line_starts.len); try std.testing.expectEqual(flow_ptr, runtime.pendingResumeFlow().ptr);
var build_probe = CacheBuildProbe{}; var build = build_checkpoint.BuildCheckpoint.init(&build_probe, CacheBuildProbe.pending); const source = (try runtime.pendingResumeSourceInterruptible(alloc, &build)).?; const source_ptr = source; const index_ptr = source.hard_line_starts.ptr; try std.testing.expect(source.hard_line_starts.len > 0);
runtime.layout.cols = 41; var resize_probe = CacheBuildProbe{ .pending_after = 2 }; var resize = build_checkpoint.BuildCheckpoint.init(&resize_probe, CacheBuildProbe.pending); try std.testing.expectError( error.InputPending, runtime.pendingResumeSourceInterruptible(alloc, &resize), ); try std.testing.expectEqual(source_ptr, &runtime.pending_resume_source.?); try std.testing.expectEqual(@as(u16, 40), runtime.pending_resume_source.?.cols); runtime.layout.cols = 40;
for (0..3) |_| { var reuse_probe = CacheBuildProbe{}; var reuse = build_checkpoint.BuildCheckpoint.init(&reuse_probe, CacheBuildProbe.pending); const reused = (try runtime.pendingResumeSourceInterruptible(alloc, &reuse)).?; try std.testing.expectEqual(source_ptr, reused); try std.testing.expectEqual(index_ptr, reused.hard_line_starts.ptr); try std.testing.expectEqual(@as(usize, 1), reuse_probe.polls); }
var metrics: Metrics = .{}; var prepared = try runtime.prepareTranscriptSurfacePaintFromSourceForArea( alloc, &metrics, source, .{ .top = 1, .bottom = 4 }, ); defer prepared.deinit(alloc); try std.testing.expectEqual(source.transcript_visible_lines.ptr, prepared.sourceVisibleLines().ptr); try std.testing.expectEqual(source.transcript_line_visual_rows.ptr, prepared.sourceVisualRows().ptr); try std.testing.expectEqual( source.transcript_visual_row_offsets[source.transcript_visual_row_offsets.len - 1], prepared.sourceTotalVisualRows(), );}
test "full transcript staging keeps its selected viewport visible during resize recovery" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .owned_top_row = 1, .full_transcript = .{ .depth = .review, .scroll_rows = 3, .follow_tail = false, }, .resize_history_row_delta = 22, }; defer runtime.deinit(alloc);
_ = try runtime.appendRawTranscriptEntryClassified( alloc, "row-0\nrow-1\nrow-2\nrow-3\nrow-4\nrow-5\nrow-6\nrow-7\n", .unknown_raw, ); var projection = try runtime.buildFullTranscriptProjection(alloc, null); defer projection.deinit(alloc); var metrics: Metrics = .{}; var staged = try runtime.prepareFullTranscriptSurfacePaint( alloc, &metrics, &projection, null, .{ .top = 1, .bottom = 4 }, ); defer staged.source.deinit(alloc); defer staged.prepared.deinit(alloc); defer staged.code_copy_frame.deinit(alloc);
try std.testing.expect(std.mem.find(u8, staged.source.bytes, "row-3") != null); try std.testing.expect(std.mem.find(u8, staged.source.bytes, "row-0") == null); try std.testing.expectEqual(@as(?i32, 22), runtime.resize_history_row_delta); try std.testing.expectEqual(@as(usize, 0), staged.prepared.selection.start_line); try std.testing.expect(staged.prepared.selection.last_visible_row >= staged.prepared.selection.top_row);}
test "auto permission notice is retained without changing compact transcript geometry" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
const cursor_row_before = runtime.cursor_row; const cursor_col_before = runtime.cursor_col; const viewport_before = runtime.viewport_top_row;
_ = try runtime.appendSemanticNotice(alloc, .{ .topic = "system", .tone = .information, .body = "Auto agent approved this request: Running command.", .visibility = .full_only, });
try std.testing.expectEqual(@as(usize, 1), runtime.entries.items.len); try std.testing.expect(runtime.entries.items[0] == .semantic_notice); try std.testing.expectEqualStrings("system", runtime.entries.items[0].semantic_notice.topic); try std.testing.expectEqual(types.NoticeTone.information, runtime.entries.items[0].semantic_notice.tone); try std.testing.expectEqualStrings( "Auto agent approved this request: Running command.", runtime.entries.items[0].semantic_notice.body, ); try std.testing.expectEqual(types.NoticeVisibility.full_only, runtime.entries.items[0].semantic_notice.visibility); try std.testing.expectEqual(@as(usize, 0), runtime.transcript.items.len); try std.testing.expectEqual(cursor_row_before, runtime.cursor_row); try std.testing.expectEqual(cursor_col_before, runtime.cursor_col); try std.testing.expectEqual(viewport_before, runtime.viewport_top_row);
_ = try runtime.appendRawTranscriptEntryClassified( alloc, "● Ran printf done\n", .tool_status, ); var compact = try runtime.prepareTranscriptSource(alloc, null); defer compact.deinit(alloc); try std.testing.expect(std.mem.find(u8, compact.bytes, "Auto agent approved") == null); try std.testing.expect(std.mem.find(u8, compact.bytes, "1 tool call") != null); try std.testing.expect(std.mem.find(u8, compact.bytes, "Ran printf done") != null);
var projection = try runtime.buildFullTranscriptProjection(alloc, null); defer projection.deinit(alloc); const full = try full_transcript_screen.renderProjectionViewportSourceInterruptible( alloc, &projection, null, runtime.layout.cols, 20, 0, null, ); defer alloc.free(full); const notice_index = std.mem.find(u8, full, "Auto agent approved") orelse return error.TestExpectedAutoPermissionNotice; const status_index = std.mem.find(u8, full, "Ran printf done") orelse return error.TestExpectedToolStatus; try std.testing.expect(notice_index < status_index);}
fn checkAutoPermissionNoticeAllocationFailures(alloc: Allocator) !void { var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc); const cursor_row_before = runtime.cursor_row; const cursor_col_before = runtime.cursor_col;
_ = runtime.appendSemanticNotice(alloc, .{ .topic = "system", .tone = .information, .body = "Auto agent approved this request: Running command.", .visibility = .full_only, }) catch |err| { try std.testing.expectEqual(@as(usize, 0), runtime.entries.items.len); try std.testing.expectEqual(@as(usize, 0), runtime.transcript.items.len); try std.testing.expectEqual(cursor_row_before, runtime.cursor_row); try std.testing.expectEqual(cursor_col_before, runtime.cursor_col); return switch (err) { error.WriteFailed => error.OutOfMemory, else => err, }; };
try std.testing.expectEqual(@as(usize, 1), runtime.entries.items.len); try std.testing.expectEqual(@as(usize, 0), runtime.transcript.items.len);}
test "auto permission notice write is atomic across allocation failures" { try std.testing.checkAllAllocationFailures( std.testing.allocator, checkAutoPermissionNoticeAllocationFailures, .{}, );}
test "full transcript opening follows the tail instead of consuming its compact anchor" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
_ = try runtime.appendRawTranscriptEntryClassified( alloc, "row-0\nrow-1\nrow-2\n", .unknown_raw, ); const anchor_id = try runtime.appendRawTranscriptEntryClassified( alloc, "anchor\n", .unknown_raw, ); runtime.full_transcript = runtime.full_transcript.capture_anchor(anchor_id).with_depth(.review); _ = try runtime.appendRawTranscriptEntryClassified( alloc, "row-4\nrow-5\nrow-6\nrow-7\n", .unknown_raw, );
var projection = try runtime.buildFullTranscriptProjection(alloc, null); defer projection.deinit(alloc); const measurement = try full_transcript_screen.measureProjectionInterruptible( alloc, &projection, null, runtime.layout.cols, null, ); var metrics: Metrics = .{}; var staged = try runtime.prepareFullTranscriptSurfacePaint( alloc, &metrics, &projection, null, .{ .top = 1, .bottom = 4 }, ); defer staged.source.deinit(alloc); defer staged.prepared.deinit(alloc); defer staged.code_copy_frame.deinit(alloc);
try std.testing.expectEqual(@as(usize, 0), staged.prepared.selection.start_line); try std.testing.expectEqual( measurement.total_rows -| 4, runtime.full_transcript.scroll_rows, ); try std.testing.expect(runtime.full_transcript.follow_tail); try std.testing.expect(std.mem.find(u8, staged.source.bytes, "row-7") != null); try std.testing.expect(std.mem.find(u8, staged.source.bytes, "anchor") == null); try std.testing.expect(std.mem.find(u8, staged.source.bytes, "row-0") == null); try std.testing.expect(!runtime.full_transcript.anchor_pending);}
test "full transcript primary restore repairs resize debt after geometry returns" { var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; runtime.full_transcript_open_content_revision = 7; runtime.full_transcript_content_revision = 7; runtime.full_transcript_open_cols = 80; runtime.full_transcript_open_rows = 24;
try std.testing.expectEqual(FullTranscriptPrimaryRestore.exact, runtime.fullTranscriptPrimaryRestore()); runtime.terminal_reset_pending = true; try std.testing.expectEqual(FullTranscriptPrimaryRestore.resized, runtime.fullTranscriptPrimaryRestore()); runtime.full_transcript_content_revision = 8; try std.testing.expectEqual(FullTranscriptPrimaryRestore.changed_resized, runtime.fullTranscriptPrimaryRestore());}
test "full transcript primary restore consumes the pending settled resize" { var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; runtime.render_requests.completeResizeGeometry(true); runtime.pending_resize_observation = .{ .layout = runtime.layout, .apply_after_ms = 17, .expected_row = null, .result = .unavailable, .phase = .settle_pending, }; runtime.terminal_reset_pending = true; runtime.resize_history_row_delta = 4;
runtime.repaintRestoredPrimaryTranscriptAfterResize();
try std.testing.expect(!runtime.render_requests.pending_settled_width_reflow); try std.testing.expectEqual(@as(?ResizeObservation, null), runtime.pending_resize_observation); try std.testing.expect(!runtime.terminal_reset_pending); try std.testing.expectEqual(@as(?i32, null), runtime.resize_history_row_delta);}
test "full transcript recovery starts at closest visible entry before a hidden anchor" { const provenance = [_]transcript_blocks.LineProvenance{ .{ .entry = .{ .entry_id = 10, .entry_class = .unknown_raw } }, .{ .entry = .{ .entry_id = 10, .entry_class = .unknown_raw } }, .block_separator, .{ .entry = .{ .entry_id = 14, .entry_class = .tool_status } }, .{ .entry = .{ .entry_id = 14, .entry_class = .tool_status } }, .{ .entry = .{ .entry_id = 22, .entry_class = .assistant_turn } }, };
try std.testing.expectEqual( @as(?usize, 3), TranscriptRuntime.fullTranscriptRecoveryPredecessorStartLine(&provenance, 18), ); try std.testing.expectEqual( @as(?usize, 0), TranscriptRuntime.fullTranscriptRecoveryPredecessorStartLine(&provenance, 10), ); try std.testing.expectEqual( @as(?usize, null), TranscriptRuntime.fullTranscriptRecoveryPredecessorStartLine(&provenance, 9), );}
test "authoritative lifecycle detail is retained by its compact status entry" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const id = types.ToolLifecycleId{ .turn_id = 1, .call_id = "read-1" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .presentation_group_id = .{ .turn_id = 1, .anchor_step_id = 4 }, .reconciles_provisional_call_id = null, .tool_name = "read_file", .activity_kind = .read, .arguments_json = "{\"path\":\"README.md\"}", } }); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = id, .outcome = .{ .kind = .completed, .summary = "Read README.md" }, .result = "# README\nfull result", } });
const entry_id = runtime.toolActivityRecord(id).?.entry_id; const detail = runtime.toolDetailForEntry(entry_id).?; try std.testing.expectEqual(types.ToolActivityKind.read, detail.activity_kind.?); try std.testing.expectEqualStrings("{\"path\":\"README.md\"}", detail.arguments_json.?); try std.testing.expectEqualStrings("# README\nfull result", detail.result.?); try std.testing.expectEqual(@as(u64, 1), detail.lifecycle_id.?.turn_id); try std.testing.expectEqualStrings("read-1", detail.lifecycle_id.?.call_id); try std.testing.expect(detail.lifecycle_id.?.call_id.ptr != id.call_id.ptr); try std.testing.expectEqual( types.ToolPresentationGroupId{ .turn_id = 1, .anchor_step_id = 4 }, detail.presentation_group_id.?, );
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); try std.testing.expect(std.mem.find(u8, source.bytes, "Read README.md") != null); try std.testing.expect(std.mem.find(u8, source.bytes, "input") == null); try std.testing.expect(std.mem.find(u8, source.bytes, "full result") == null);}
test "paused tool turn can resume the same lifecycle identity before finalization" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{}; defer runtime.deinit(alloc);
const id = types.ToolLifecycleId{ .turn_id = 41, .call_id = "resume-tool" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "read_file", .activity_kind = .read, } }); _ = try runtime.applyToolLifecycle(alloc, .{ .turn_finished = .{ .turn_id = id.turn_id, .outcome = .paused, } }); try runtime.finishLifecycleBatch(alloc);
try std.testing.expectEqual(@as(u64, 0), runtime.finalizedToolTurnWatermark()); try std.testing.expect(runtime.toolActivityRecord(id) == null); var paused_source = try runtime.prepareTranscriptSource(alloc, null); defer paused_source.deinit(alloc); try std.testing.expect(std.mem.find( u8, paused_source.bytes, "Tool state preserved for recovery", ) != null);
_ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "read_file", .activity_kind = .read, } }); try std.testing.expect(runtime.toolActivityRecord(id) != null); try std.testing.expectEqual(@as(usize, 1), runtime.activeToolActivityCount());
_ = try runtime.applyToolLifecycle(alloc, .{ .turn_finished = .{ .turn_id = id.turn_id, .outcome = .completed, } }); try runtime.finishLifecycleBatch(alloc); try std.testing.expectEqual(id.turn_id, runtime.finalizedToolTurnWatermark());}
test "provisional lifecycle owns semantic detail before authoritative reconciliation" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{}; defer runtime.deinit(alloc);
const id = types.ToolLifecycleId{ .turn_id = 7, .call_id = "provisional-command" }; _ = try runtime.applyToolLifecycle(alloc, .{ .provisional = .{ .id = id, .tool_name = null, .activity_kind = .command, } });
const entry_id = runtime.toolActivityRecord(id).?.entry_id; const initial_detail = runtime.toolDetailForEntry(entry_id); try std.testing.expect(initial_detail != null); try std.testing.expectEqualStrings("tool", initial_detail.?.tool_name); try std.testing.expectEqual(types.ToolActivityKind.command, initial_detail.?.activity_kind.?); try std.testing.expectEqual(@as(u64, 7), initial_detail.?.lifecycle_id.?.turn_id); try std.testing.expectEqualStrings("provisional-command", initial_detail.?.lifecycle_id.?.call_id); try std.testing.expect(initial_detail.?.lifecycle_id.?.call_id.ptr != id.call_id.ptr);
_ = try runtime.applyToolLifecycle(alloc, .{ .provisional = .{ .id = id, .tool_name = "run_command", .activity_kind = .command, } }); const updated_detail = runtime.toolDetailForEntry(entry_id).?; try std.testing.expectEqualStrings("run_command", updated_detail.tool_name); try std.testing.expectEqual(@as(usize, 1), runtime.tool_details.items.len);}
test "nonzero command remains Ran in the current compact projection" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const id = types.ToolLifecycleId{ .turn_id = 1, .call_id = "exit-7" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "terminal", .activity_kind = .command, .arguments_json = "{\"action\":\"exec\",\"command\":\"false\"}", } }); try std.testing.expect(runtime.toolActivityRecord(id).?.captured_command); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = id, .outcome = .{ .kind = .completed, .summary = "Ran false" }, .result_memory = .{ .command_process_presentation = .{ .exit_code = 7 } }, } });
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); try std.testing.expect(std.mem.find(u8, source.bytes, "Ran false") != null); try std.testing.expectEqual(@as(usize, 0), std.mem.count(u8, source.bytes, "│ exit code 7")); try std.testing.expect(std.mem.find(u8, source.bytes, "Failed") == null);}
test "terminal lifecycle records distinguish captured exec from durable actions" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{}; defer runtime.deinit(alloc); const exec_id = types.ToolLifecycleId{ .turn_id = 1, .call_id = "exec" }; const start_id = types.ToolLifecycleId{ .turn_id = 1, .call_id = "start" };
_ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = exec_id, .reconciles_provisional_call_id = null, .tool_name = "terminal", .activity_kind = .command, .arguments_json = "{\"action\":\"exec\",\"command\":\"printf exec\"}", } }); _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = start_id, .reconciles_provisional_call_id = null, .tool_name = "terminal", .activity_kind = .command, .arguments_json = "{\"action\":\"start\",\"command\":\"printf start\"}", } });
try std.testing.expect(runtime.toolActivityRecord(exec_id).?.captured_command); try std.testing.expect(!runtime.toolActivityRecord(start_id).?.captured_command);}
test "nonzero streamed command reuses its active output block" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const id = types.ToolLifecycleId{ .turn_id = 2, .call_id = "streamed-exit-7" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "terminal", .activity_kind = .command, .arguments_json = "{\"action\":\"exec\",\"command\":\"printf lines; exit 7\"}", } }); const started_entry_id = runtime.toolActivityRecord(id).?.entry_id; try std.testing.expect(runtime.toolDetailForEntry(started_entry_id).?.isCapturedCommand()); var metrics: Metrics = .{}; try runtime.writeCommandOutputChunkForLifecycle( alloc, &metrics, styles, id, .stdout, "line-1\nline-2\nline-3\nline-4\nline-5\nline-6\n", true, ); try std.testing.expect(runtime.toolDetailForEntry(started_entry_id).?.isCapturedCommand()); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = id, .outcome = .{ .kind = .completed, .summary = "Ran printf lines; exit 7" }, .result_memory = .{ .command_process_presentation = .{ .exit_code = 7 } }, } });
try std.testing.expectEqual(@as(usize, 1), runtime.command_output_blocks.items.len); try runtime.flushCommandOutputSummaryForLifecycle( alloc, &metrics, styles, id, true, );
const block = runtime.command_output_blocks.items[0]; const status_entry_id = runtime.toolActivityRecord(id).?.entry_id; try std.testing.expect(runtime.toolDetailForEntry(status_entry_id).?.isCapturedCommand()); try std.testing.expectEqual( block.entry_id, runtime.toolDetailForEntry(status_entry_id).?.command_output_entry_id, ); try std.testing.expect(command_output_runtime.processPresentationForBlock(&runtime, block) != null); var projection = try command_output_runtime.renderCompactCommandOutputWithProcessPresentation( alloc, block, .{ .styles = styles }, 80, command_output_runtime.processPresentationForBlock(&runtime, block), ); defer projection.deinit(alloc); try std.testing.expectEqual( @as(usize, command_output_runtime.compact_output_row_limit + 1), std.mem.count(u8, projection.bytes.items, "\n") + 1, ); try std.testing.expect(std.mem.find(u8, projection.bytes.items, "│ line-4") != null); try std.testing.expect(std.mem.find(u8, projection.bytes.items, "│ line-5") == null); try std.testing.expect(std.mem.find(u8, projection.bytes.items, "│ … 2 lines more (ctrl o to view)") != null); try std.testing.expectEqual( @as(usize, 1), std.mem.count(u8, projection.bytes.items, "│ exit code 7"), );
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); try std.testing.expect(std.mem.find(u8, source.bytes, "Ran printf lines; exit 7") != null); try std.testing.expect(std.mem.find(u8, source.bytes, "Failed") == null);}
test "compact run command group stays width safe after resize" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 24, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const id = types.ToolLifecycleId{ .turn_id = 3, .call_id = "long-command-header" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "run_command", .activity_kind = .command, .arguments_json = "{\"command\":\"printf a deliberately long command preview\"}", } }); var metrics: Metrics = .{}; try runtime.writeCommandOutputChunkForLifecycle( alloc, &metrics, styles, id, .stdout, "payload\n", true, ); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = id, .outcome = .{ .kind = .completed, .summary = "Ran printf a deliberately long command preview that exceeds both narrow and normal transcript widths without losing its typed command identity", }, } }); try runtime.flushCommandOutputSummaryForLifecycle( alloc, &metrics, styles, id, true, );
const status_entry_id = runtime.toolActivityRecord(id).?.entry_id; const output_entry_id = runtime.command_output_blocks.items[0].entry_id.?; for ([_]u16{ 24, 80 }) |cols| { runtime.layout.cols = cols; var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc);
var status_line: ?usize = null; var output_line: ?usize = null; var status_line_count: usize = 0; for (source.line_provenance, 0..) |provenance, line_index| { switch (provenance) { .entry => |entry| { if (entry.entry_id == status_entry_id) { if (status_line == null) status_line = line_index; status_line_count += 1; } if (entry.entry_id == output_entry_id and output_line == null) { output_line = line_index; } }, else => {}, } } try std.testing.expectEqual(@as(usize, 2), status_line_count); try std.testing.expect(output_line == null);
try std.testing.expect(status_line != null); var lines = std.mem.splitScalar(u8, source.bytes, '\n'); while (lines.next()) |line| { try std.testing.expect(display_width.visibleWidthIgnoringAnsi(line) <= cols); } try std.testing.expect(std.mem.find(u8, source.bytes, "…") != null); }}
fn checkToolDetailResultReplacementAllocationFailures(alloc: Allocator) !void { var runtime = TranscriptRuntime{}; defer runtime.deinit(alloc);
var tool_name: ?[]u8 = try alloc.dupe(u8, "read_file"); errdefer if (tool_name) |value| alloc.free(value); var previous_result: ?[]u8 = try alloc.dupe(u8, "previous result"); errdefer if (previous_result) |value| alloc.free(value); var previous_artifact: ?[]u8 = try alloc.dupe(u8, "fx-command-previous.log"); errdefer if (previous_artifact) |value| alloc.free(value); try runtime.tool_details.append(alloc, .{ .entry_id = 1, .tool_name = tool_name.?, .result = previous_result.?, .command_artifact_handle = previous_artifact.?, }); tool_name = null; previous_result = null; previous_artifact = null;
runtime.updateToolDetailTerminal( alloc, 1, null, "read_file", .read, .completed, "replacement result", null, "fx-command-replacement.log", null, ) catch |err| { try std.testing.expectEqualStrings( "previous result", runtime.toolDetailForEntry(1).?.result.?, ); try std.testing.expectEqualStrings( "fx-command-previous.log", runtime.toolDetailForEntry(1).?.command_artifact_handle.?, ); return err; }; try std.testing.expectEqualStrings( "replacement result", runtime.toolDetailForEntry(1).?.result.?, ); try std.testing.expectEqualStrings( "fx-command-replacement.log", runtime.toolDetailForEntry(1).?.command_artifact_handle.?, );}
test "tool detail result replacement preserves the prior allocation on failure" { try std.testing.checkAllAllocationFailures( std.testing.allocator, checkToolDetailResultReplacementAllocationFailures, .{}, );}
test "historical tool detail attaches to the exact replayed status entry" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
var metrics: Metrics = .{}; const entry_id = try runtime.writeCompletedToolStatusReturningEntryId( alloc, &metrics, .completed, "Read README.md", true, ); try runtime.attachHistoricalToolDetail( alloc, entry_id, .{ .id = "replayed-read", .name = "read_file", .arguments_json = "{\"path\":\"README.md\"}" }, .read, .{ .tool_call_id = @constCast("replayed-read"), .tool_name = @constCast("read_file"), .status = .success, .output = @constCast("# README\nfull replayed result"), .output_bytes = 29, .stored_output_bytes = 29, }, );
const detail = runtime.toolDetailForEntry(entry_id).?; try std.testing.expectEqualStrings("{\"path\":\"README.md\"}", detail.arguments_json.?); try std.testing.expectEqualStrings("# README\nfull replayed result", detail.result.?); try std.testing.expectEqual(types.ToolOutcomeKind.completed, detail.outcome.?);}
test "historical deferred tool detail keeps the call without result evidence" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{}; defer runtime.deinit(alloc);
var metrics: Metrics = .{}; const entry_id = try runtime.writeCompletedToolStatusReturningEntryId( alloc, &metrics, .deferred, "Context updated: Running cat nested/input.txt", true, ); try runtime.attachHistoricalToolDetail( alloc, entry_id, .{ .id = "deferred-command", .name = "run_command", .arguments_json = "{\"command\":\"cat nested/input.txt\"}", }, .command, .{ .tool_call_id = @constCast("deferred-command"), .tool_name = @constCast("run_command"), .status = .failure, .output = @constCast(types.context_deferred_tool_result_output), .output_handle = @constCast("should-not-be-exposed.txt"), .preview = @constCast("should not be exposed"), .output_bytes = types.context_deferred_tool_result_output.len, .stored_output_bytes = types.context_deferred_tool_result_output.len, .truncated = true, .command_output_replay = .unavailable, .command_process_presentation = .{ .exit_code = 7 }, }, );
const detail = runtime.toolDetailForEntry(entry_id).?; try std.testing.expectEqualStrings("run_command", detail.tool_name); try std.testing.expectEqualStrings("{\"command\":\"cat nested/input.txt\"}", detail.arguments_json.?); try std.testing.expectEqual(types.ToolOutcomeKind.deferred, detail.outcome.?); try std.testing.expect(detail.result == null); try std.testing.expect(detail.result_handle == null); try std.testing.expect(detail.command_artifact_handle == null); try std.testing.expect(detail.command_output_replay == null); try std.testing.expect(detail.command_process_presentation == null); try std.testing.expect(detail.command_output_entry_id == null);
const legacy_entry_id = try runtime.writeCompletedToolStatusReturningEntryId( alloc, &metrics, .denied, "Not executed: Reading stale.txt", true, ); try runtime.attachHistoricalToolDetail( alloc, legacy_entry_id, .{ .id = "legacy-deferred-read", .name = "read_file", .arguments_json = "{\"path\":\"stale.txt\"}", }, .read, .{ .tool_call_id = @constCast("legacy-deferred-read"), .tool_name = @constCast("read_file"), .status = .failure, .output = @constCast(types.deferred_tool_result_output), .output_bytes = types.deferred_tool_result_output.len, .stored_output_bytes = types.deferred_tool_result_output.len, }, ); const legacy_detail = runtime.toolDetailForEntry(legacy_entry_id).?; try std.testing.expectEqual(types.ToolOutcomeKind.denied, legacy_detail.outcome.?); try std.testing.expect(legacy_detail.result == null);
const failed_entry_id = try runtime.writeCompletedToolStatusReturningEntryId( alloc, &metrics, .failed, "Failed printf failure", true, ); try runtime.attachHistoricalToolDetail( alloc, failed_entry_id, .{ .id = "failed-command", .name = "run_command", .arguments_json = "{\"command\":\"printf failure; exit 7\"}", }, .command, .{ .tool_call_id = @constCast("failed-command"), .tool_name = @constCast("run_command"), .status = .failure, .output = @constCast("ordinary failure"), .output_handle = @constCast("ordinary-failure.txt"), .output_bytes = 16, .stored_output_bytes = 16, }, );
const failed_detail = runtime.toolDetailForEntry(failed_entry_id).?; try std.testing.expectEqual(types.ToolOutcomeKind.failed, failed_detail.outcome.?); try std.testing.expectEqualStrings("ordinary failure", failed_detail.result.?); try std.testing.expectEqualStrings("ordinary-failure.txt", failed_detail.result_handle.?);}
test "historical command detail keeps artifact handles after command block attaches" { const alloc = std.testing.allocator; var tmp = std.testing.tmpDir(.{}); defer tmp.cleanup(); try tmp.dir.createDir( io_mod.getIo(), "session", std.Io.File.Permissions.fromMode(0o700), ); var session_dir = try tmp.dir.openDir(io_mod.getIo(), "session", .{ .iterate = true, .follow_symlinks = false, }); defer session_dir.close(io_mod.getIo()); const session_path = try io_mod.dirRealpathAlloc(alloc, tmp.dir, "session"); defer alloc.free(session_path); var capability = try session_child_store.SessionChildCapability.initForTesting( alloc, session_dir, session_path, .writable, .{}, ); defer capability.deinit(); const stored_result = "exit_code=0\n<stdout>\nRESUMED_EXACT_RESULT\n</stdout>\n"; const result_handle = try result_store.storeLargeResultManaged( alloc, &capability, "replayed-command", "run_command", stored_result, ); defer alloc.free(result_handle); defer result_store.deleteManaged(&capability, result_handle) catch {};
var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const raw_preview = "exit_code=0\ntruncated=true\nstdout_bytes=21\nstderr_bytes=0\noutput_file=/tmp/fx-command-replayed.log\n<stdout>RESUMED_EXACT_RESULT\n</stdout>"; const raw_result = try std.fmt.allocPrint( alloc, "<tool_result_preview handle=\"{s}\" stored_bytes=\"{d}\">\n{s}\n</tool_result_preview>\n" ++ "<tool_result_handle>{s}</tool_result_handle>", .{ result_handle, stored_result.len, raw_preview, result_handle }, ); defer alloc.free(raw_result); var metrics: Metrics = .{}; const entry_id = try runtime.writeCompletedToolStatusReturningEntryId( alloc, &metrics, .completed, "Ran printf restored", true, ); try runtime.attachHistoricalToolDetail( alloc, entry_id, .{ .id = "replayed-command", .name = "run_command", .arguments_json = "{\"command\":\"printf restored\"}" }, .command, .{ .tool_call_id = @constCast("replayed-command"), .tool_name = @constCast("run_command"), .status = .success, .output = @constCast(raw_result), .output_handle = result_handle, .preview = @constCast(raw_preview), .output_bytes = stored_result.len, .stored_output_bytes = stored_result.len, .truncated = true, }, );
runtime.attachHistoricalCommandOutput(alloc, entry_id);
const fallback_detail = runtime.toolDetailForEntry(entry_id).?; try std.testing.expect(fallback_detail.command_output_entry_id == null); try std.testing.expectEqualStrings(raw_result, fallback_detail.result.?); try std.testing.expectEqualStrings(result_handle, fallback_detail.result_handle.?); try std.testing.expectEqualStrings("fx-command-replayed.log", fallback_detail.command_artifact_handle.?);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "RESUMED_EXACT_RESULT\n", true, ); try runtime.flushCommandOutputSummary(alloc, &metrics, styles, true);
runtime.attachHistoricalCommandOutput(alloc, entry_id);
const command_detail = runtime.toolDetailForEntry(entry_id).?; try std.testing.expect(command_detail.command_output_entry_id != null); try std.testing.expectEqualStrings(raw_result, command_detail.result.?); try std.testing.expectEqualStrings(result_handle, command_detail.result_handle.?); try std.testing.expectEqualStrings("fx-command-replayed.log", command_detail.command_artifact_handle.?);
runtime.full_transcript.depth = .full; var projection = try runtime.buildFullTranscriptProjection(alloc, null); defer projection.deinit(alloc); const full_source = try full_transcript_screen.renderProjectionViewportSourceInterruptible( alloc, &projection, &capability, runtime.layout.cols, 10, 0, null, ); defer alloc.free(full_source); try std.testing.expectEqual( @as(usize, 1), std.mem.count(u8, full_source, "RESUMED_EXACT_RESULT"), ); try std.testing.expect(std.mem.find(u8, full_source, "exit_code=0") == null); try std.testing.expect(std.mem.find(u8, full_source, "<stdout>") == null); try std.testing.expect(std.mem.find(u8, full_source, "</stdout>") == null);}
test "historical nonzero command keeps replay ownership outside compact sidebands" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
var metrics: Metrics = .{}; const entry_id = try runtime.writeCompletedToolStatusReturningEntryId( alloc, &metrics, .completed, "Ran false", true, ); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "one\ntwo\nthree\nfour\nfive\nsix\n", true, ); try runtime.flushCommandOutputSummary(alloc, &metrics, styles, true); const command_output_entry_id = runtime.latestCommandOutputEntryId().?;
const replay_handle = "fx-command-replay-historical.bin"; try runtime.attachHistoricalToolDetailAfterCommandOutput( alloc, entry_id, .{ .id = "historical-exit", .name = "run_command", .arguments_json = "{\"command\":\"false\"}" }, .command, .{ .tool_call_id = @constCast("historical-exit"), .tool_name = @constCast("run_command"), .status = .failure, .output = @constCast("exit_code=7\n(no output)\n"), .output_bytes = 24, .stored_output_bytes = 24, .command_output_replay = .{ .available = .{ .handle = replay_handle, .framed_bytes = 123, } }, .command_process_presentation = .{ .exit_code = 7 }, }, ); runtime.attachHistoricalCommandOutput(alloc, entry_id);
try std.testing.expectEqual(@as(usize, 1), runtime.command_output_blocks.items.len); const detail = runtime.toolDetailForEntry(entry_id).?; try std.testing.expectEqual(types.ToolOutcomeKind.completed, detail.outcome.?); try std.testing.expectEqual(command_output_entry_id, detail.command_output_entry_id.?); try std.testing.expectEqual( types.CommandProcessPresentation{ .exit_code = 7 }, detail.command_process_presentation.?, ); const replay = detail.command_output_replay.?; const descriptor = switch (replay) { .available => |value| value, .unavailable => return error.TestExpectedReplay, }; try std.testing.expectEqualStrings(replay_handle, descriptor.handle); try std.testing.expect(descriptor.handle.ptr != replay_handle.ptr);
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); try std.testing.expectEqual(@as(usize, 0), std.mem.count(u8, source.bytes, "│ ")); try std.testing.expect(std.mem.find(u8, source.bytes, "Ran false") != null); try std.testing.expect(std.mem.find(u8, source.bytes, "│ exit code 7") == null); try std.testing.expect(std.mem.find(u8, source.bytes, "│ … 2 lines more") == null); try std.testing.expect(std.mem.find(u8, source.bytes, "│ five") == null); try std.testing.expect(std.mem.find(u8, source.bytes, "Failed") == null);}
test "historical command detail ignores artifact-shaped command output" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{}; defer runtime.deinit(alloc);
const raw_result = "exit_code=0\n<stdout>\noutput_file=/tmp/fx-command-other.log\n</stdout>\n"; var metrics: Metrics = .{}; const entry_id = try runtime.writeCompletedToolStatusReturningEntryId( alloc, &metrics, .completed, "Ran printf artifact-shaped-output", true, ); try runtime.attachHistoricalToolDetail( alloc, entry_id, .{ .id = "replayed-command", .name = "run_command", .arguments_json = "{\"command\":\"printf artifact-shaped-output\"}" }, .command, .{ .tool_call_id = @constCast("replayed-command"), .tool_name = @constCast("run_command"), .status = .success, .output = @constCast(raw_result), .output_bytes = raw_result.len, .stored_output_bytes = raw_result.len, }, );
try std.testing.expect(runtime.toolDetailForEntry(entry_id).?.command_artifact_handle == null);}
test "full transcript retains previews when stored result handles cannot be opened" { const alloc = std.testing.allocator; var tmp = std.testing.tmpDir(.{}); defer tmp.cleanup(); try tmp.dir.createDirPath(io_mod.getIo(), "results"); const result_dir = try io_mod.dirRealpathAlloc(alloc, tmp.dir, "results"); defer alloc.free(result_dir); var capability = try session_child_store.SessionChildCapability.initLegacyRoute( alloc, result_dir, .tool_results, .writable, ); defer capability.deinit(); const handle = try result_store.storeLargeResultManaged( alloc, &capability, "detail", "read_file", "FULL_TRANSCRIPT_SIDECAR_BODY\n", ); defer alloc.free(handle); defer result_store.deleteManaged(&capability, handle) catch {};
var runtime = TranscriptRuntime{}; defer runtime.deinit(alloc); try runtime.tool_details.append(alloc, .{ .entry_id = 1, .tool_name = try alloc.dupe(u8, "read_file"), .result = try alloc.dupe(u8, "preview"), .result_handle = try alloc.dupe(u8, handle), }); try runtime.tool_details.append(alloc, .{ .entry_id = 2, .tool_name = try alloc.dupe(u8, "read_file"), .result_handle = try alloc.dupe(u8, "missing-result.txt"), });
try std.testing.expect(runtime.hasStoredResultDetails()); try std.testing.expectEqualStrings( "preview", runtime.toolDetailForEntry(1).?.result.?, ); try std.testing.expect(runtime.toolDetailForEntry(2).?.result == null);}
test "command terminal detail owns the consolidated command output entry" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const id = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-9" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "run_command", .activity_kind = .command, .arguments_json = "{\"command\":\"printf demo\"}", } }); var metrics: Metrics = .{}; try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, id, .stdout, "first\n", true); try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, id, .stdout, "second\n", true); try runtime.flushCommandOutputSummaryForLifecycle( alloc, &metrics, styles, id, true, ); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = id, .outcome = .{ .kind = .completed, .summary = "Ran printf demo" }, .command_artifact_handle = "fx-command-live.log", } });
const status_entry_id = runtime.toolActivityRecord(id).?.entry_id; const detail = runtime.toolDetailForEntry(status_entry_id).?; try std.testing.expectEqual(runtime.command_output_blocks.items[0].entry_id, detail.command_output_entry_id); try std.testing.expectEqualStrings("fx-command-live.log", detail.command_artifact_handle.?);}
test "late command output reopens its completed lifecycle block" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc); var metrics: Metrics = .{}; const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const id = types.ToolLifecycleId{ .turn_id = 7, .call_id = "late-output" };
try runtime.writeCommandOutputChunkForLifecycle( alloc, &metrics, styles, id, .stdout, "one\ntwo\nthree\nfour\nfive\nsix\n", true, ); try runtime.flushCommandOutputSummaryForLifecycle( alloc, &metrics, styles, id, true, ); const entry_id = runtime.command_output_blocks.items[0].entry_id.?;
try runtime.writeCommandOutputChunkForLifecycle( alloc, &metrics, styles, id, .stdout, "seven\neight\n", true, );
try std.testing.expectEqual(@as(usize, 1), runtime.command_output_blocks.items.len); try std.testing.expectEqual(entry_id, runtime.command_output_blocks.items[0].entry_id.?); try std.testing.expectEqual(@as(usize, 8), runtime.command_output_blocks.items[0].total_lines); runtime.resetCommandOutputDisplay(alloc, "worker inactive"); try std.testing.expectEqual(@as(usize, 1), runtime.command_output_blocks.items.len);}
test "command terminal detail resolves split command output source rows" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const id = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-split" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "run_command", .activity_kind = .command, .arguments_json = "{\"command\":\"printf demo\"}", } });
var metrics: Metrics = .{}; try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, id, .stdout, "first\n", true); _ = try runtime.appendRawTranscriptEntryClassified(alloc, "intervening\n", .unknown_raw); try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, id, .stdout, "second\n", true); try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, id, true); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = id, .outcome = .{ .kind = .completed, .summary = "Ran printf demo" }, } });
const status_entry_id = runtime.toolActivityRecord(id).?.entry_id; const block = runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 2), block.source_entry_ids.items.len); try std.testing.expectEqual(status_entry_id, runtime.detailEntryIdForCommandOutputSource(block.source_entry_ids.items[0]).?); try std.testing.expectEqual(status_entry_id, runtime.detailEntryIdForCommandOutputSource(block.source_entry_ids.items[1]).?);}
test "command output consolidation preserves current compact ownership" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 32, .cols = 100, .content_bottom = 28, .divider_top_row = 29, .input_row = 30, .divider_bottom_row = 31, .hint_row = 32, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const id = types.ToolLifecycleId{ .turn_id = 1, .call_id = "streaming-command" }; _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "run_command", .activity_kind = .command, .arguments_json = "{\"command\":\"stream\"}", } }); const status_entry_id = runtime.toolActivityRecord(id).?.entry_id;
var metrics: Metrics = .{}; for (0..80) |index| { var line: [32]u8 = undefined; const text = try std.fmt.bufPrint(&line, "STREAM {d:0>3}\n", .{index + 1}); try runtime.writeCommandOutputChunkForLifecycle( alloc, &metrics, styles, id, .stdout, text, true, ); }
var live = try runtime.prepareTranscriptSourceOmittingEntry(alloc, status_entry_id); defer live.deinit(alloc); try std.testing.expectEqual(@as(usize, 0), live.bytes.len);
try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, id, true);
var compact = try runtime.prepareTranscriptSource(alloc, null); defer compact.deinit(alloc); try std.testing.expect(std.mem.indexOf(u8, compact.bytes, "STREAM 001") == null); try std.testing.expect(std.mem.indexOf(u8, compact.bytes, "1 tool call") != null);
_ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = id, .outcome = .{ .kind = .completed, .summary = "Ran stream" }, } }); var completed = try runtime.prepareTranscriptSource(alloc, null); defer completed.deinit(alloc);
const status_pos = std.mem.indexOf(u8, completed.bytes, "Ran stream") orelse return error.MissingCommandStatus; try std.testing.expect(std.mem.indexOf(u8, completed.bytes, "STREAM 001") == null); try std.testing.expect(status_pos < completed.bytes.len);
const output_entry_id = runtime.command_output_blocks.items[0].entry_id.?; const output_index = entryIndex(&runtime, output_entry_id).?; const status_index = entryIndex(&runtime, status_entry_id).?; try std.testing.expect(status_index < output_index);}
fn entryIndex(runtime: *const TranscriptRuntime, entry_id: u32) ?usize { for (runtime.entries.items, 0..) |entry, index| { if (entry.id() == entry_id) return index; } return null;}
test "command output records span callbacks and keep first-byte ownership" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 40, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{}; try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "hel", true, ); const first_entry_id = runtime.command_output_blocks.items[0].lines.items[0].entry_id.?; const intervening_entry_id = try runtime.appendRawTranscriptEntryClassified( alloc, "intervening\n", .unknown_raw, ); try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "lo\nnext\n", true, );
const block = runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 2), block.lines.items.len); try std.testing.expectEqualStrings("hello", block.lines.items[0].text); try std.testing.expectEqualStrings("next", block.lines.items[1].text); const second_entry_id = block.lines.items[1].entry_id.?; try std.testing.expect(entryIndex(&runtime, first_entry_id).? < entryIndex(&runtime, intervening_entry_id).?); try std.testing.expect(entryIndex(&runtime, intervening_entry_id).? < entryIndex(&runtime, second_entry_id).?);}
test "split utf8 keeps cross-stream first-byte ownership and pure ansi is pruned" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 40, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{};
try runtime.writeCommandOutputChunk(alloc, &metrics, styles, .stdout, "\xe2\x82", true); const stdout_entry_id = runtime.command_output_blocks.items[0].lines.items[0].entry_id.?; try runtime.writeCommandOutputChunk(alloc, &metrics, styles, .stderr, "err\n", true); const stderr_entry_id = runtime.command_output_blocks.items[0].lines.items[1].entry_id.?; try runtime.writeCommandOutputChunk(alloc, &metrics, styles, .stdout, "\xac\n", true); try runtime.writeCommandOutputChunk(alloc, &metrics, styles, .stdout, "\x1b[31m", true); try runtime.flushCommandOutputSummary(alloc, &metrics, styles, true);
const block = runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 2), block.lines.items.len); try std.testing.expectEqualStrings("€", block.lines.items[0].text); try std.testing.expectEqualStrings("err", block.lines.items[1].text); try std.testing.expectEqual(@as(usize, 0), block.lines.items[0].record_ordinal); try std.testing.expectEqual(@as(usize, 1), block.lines.items[1].record_ordinal); try std.testing.expect(entryIndex(&runtime, stdout_entry_id).? < entryIndex(&runtime, stderr_entry_id).?);}
test "prepared canonical command mutation stays bounded across twenty four thousand records" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 72, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{}; for (0..24_000) |_| { try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "record\n", true, ); try std.testing.expect( runtime.retainedStructuredBytesForCommandOutput() <= runtime.max_retained_transcript_bytes, ); } const block = runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 24_000), block.total_lines); try std.testing.expect(block.retention_overflow); try std.testing.expect(block.lines.items.len < block.total_lines); for (block.lines.items, 0..) |line, record_ordinal| { try std.testing.expectEqual(record_ordinal, line.record_ordinal); }}
test "oversized open command record stops growing after overflow" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 72, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .max_retained_transcript_bytes = 8 * 1024, }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{}; var fragment: [4096]u8 = undefined; @memset(&fragment, 'x'); var retained_after_overflow: ?usize = null; var source_entry_id: ?u32 = null; for (0..256) |_| { try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, &fragment, true, ); const block = runtime.command_output_blocks.items[0]; if (source_entry_id == null) source_entry_id = block.lines.items[0].entry_id; try std.testing.expectEqual(source_entry_id, block.lines.items[0].entry_id); try std.testing.expect( runtime.retainedStructuredBytesForCommandOutput() <= runtime.max_retained_transcript_bytes, ); if (block.retention_overflow) { if (retained_after_overflow) |retained| { try std.testing.expectEqual(retained, block.retained_text_bytes); } else { retained_after_overflow = block.retained_text_bytes; } } } try std.testing.expect(retained_after_overflow != null);
var failing = std.testing.FailingAllocator.init(alloc, .{ .fail_index = 0 }); try runtime.writeCommandOutputChunk( failing.allocator(), &metrics, styles, .stdout, &fragment, true, ); try std.testing.expectEqual(@as(usize, 0), failing.allocations);}
test "descriptor capped bare carriage return replaces one dropped record" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 72, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{};
_ = try command_output_runtime.writeCommandOutputChunkUncommitted( &runtime, alloc, &metrics, styles, null, .stdout, "kept\n", true, ); const kept_entry_id = runtime.command_output_blocks.items[0].lines.items[0].entry_id.?; runtime.max_retained_transcript_bytes = runtime.retainedStructuredBytesForCommandOutput();
_ = try command_output_runtime.writeCommandOutputChunkUncommitted( &runtime, alloc, &metrics, styles, null, .stdout, "dropped\rreplacement", true, ); var block = &runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 2), block.total_lines); try std.testing.expectEqual(@as(usize, 1), block.lines.items.len); try std.testing.expectEqual(kept_entry_id, block.lines.items[0].entry_id.?); try std.testing.expect(block.overflow_open_records[0]); try std.testing.expect(block.overflow_record_visible[0]);
_ = try command_output_runtime.writeCommandOutputChunkUncommitted( &runtime, alloc, &metrics, styles, null, .stdout, "\n", true, ); block = &runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 2), block.total_lines); try std.testing.expectEqual(@as(usize, 1), block.lines.items.len); try std.testing.expectEqual(kept_entry_id, block.lines.items[0].entry_id.?); try std.testing.expect(!block.overflow_open_records[0]);}
test "descriptor capped ansi-only prefix keeps later visible overflow record" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 72, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{};
_ = try command_output_runtime.writeCommandOutputChunkUncommitted( &runtime, alloc, &metrics, styles, null, .stdout, "kept\n", true, ); runtime.max_retained_transcript_bytes = runtime.retainedStructuredBytesForCommandOutput();
_ = try command_output_runtime.writeCommandOutputChunkUncommitted( &runtime, alloc, &metrics, styles, null, .stdout, "\x1b[31m", true, ); var block = &runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 2), block.total_lines); try std.testing.expect(block.overflow_open_records[0]); try std.testing.expect(!block.overflow_record_visible[0]); try std.testing.expect(block.decoders[0].isIdle());
_ = try command_output_runtime.writeCommandOutputChunkUncommitted( &runtime, alloc, &metrics, styles, null, .stdout, "visible", true, ); block = &runtime.command_output_blocks.items[0]; try std.testing.expect(block.overflow_record_visible[0]); runtime.max_retained_transcript_bytes = std.math.maxInt(usize);
_ = try command_output_runtime.flushCommandOutputSummaryUncommitted( &runtime, alloc, &metrics, styles, null, true, ); try std.testing.expectEqual( @as(usize, 2), runtime.command_output_blocks.items[0].total_lines, );
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); try std.testing.expectEqual(@as(usize, 0), source.bytes.len);}
test "descriptor capped split osc terminator preserves record boundaries" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 72, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, }; defer runtime.deinit(alloc); const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; var metrics: Metrics = .{};
try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "kept\n", true, ); runtime.max_retained_transcript_bytes = runtime.retainedStructuredBytesForCommandOutput();
try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "\x1b]0;title", true, ); var block = &runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 2), block.total_lines); try std.testing.expect(block.overflow_open_records[0]);
try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "\x07", true, ); try runtime.writeCommandOutputChunk( alloc, &metrics, styles, .stdout, "\nnext\n", true, );
block = &runtime.command_output_blocks.items[0]; try std.testing.expectEqual(@as(usize, 3), block.total_lines); try std.testing.expect(!block.overflow_open_records[0]);}
test "command terminal detail resolves its lifecycle output instead of the latest block" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const first = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-first" }; const second = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-second" }; for ([_]types.ToolLifecycleId{ first, second }) |id| { _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = id, .reconciles_provisional_call_id = null, .tool_name = "run_command", .activity_kind = .command, .arguments_json = "{\"command\":\"printf demo\"}", } }); }
var metrics: Metrics = .{}; try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, first, .stdout, "first\n", true); try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, first, true); try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, second, .stdout, "second\n", true); try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, second, true);
_ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = first, .outcome = .{ .kind = .completed, .summary = "Ran first" }, } }); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = second, .outcome = .{ .kind = .completed, .summary = "Ran second" }, } });
const first_status = runtime.toolActivityRecord(first).?.entry_id; const second_status = runtime.toolActivityRecord(second).?.entry_id; try std.testing.expectEqual(runtime.command_output_blocks.items[0].entry_id, runtime.toolDetailForEntry(first_status).?.command_output_entry_id); try std.testing.expectEqual(runtime.command_output_blocks.items[1].entry_id, runtime.toolDetailForEntry(second_status).?.command_output_entry_id);}
test "command output consolidation keeps compact tool order" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const first = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-first" }; const second = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-second" };
_ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = first, .reconciles_provisional_call_id = null, .tool_name = "run_command", .activity_kind = .command, .arguments_json = "{\"command\":\"printf first\"}", } }); _ = try runtime.applyToolLifecycle(alloc, .{ .authoritative_started = .{ .id = second, .reconciles_provisional_call_id = null, .tool_name = "run_command", .activity_kind = .command, .arguments_json = "{\"command\":\"printf second\"}", } });
var metrics: Metrics = .{}; try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, first, .stdout, "FIRST_OUTPUT\n", true); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = first, .outcome = .{ .kind = .completed, .summary = "Ran first" }, } }); try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, first, true);
try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, second, .stdout, "SECOND_OUTPUT\n", true); _ = try runtime.applyToolLifecycle(alloc, .{ .terminal = .{ .id = second, .outcome = .{ .kind = .completed, .summary = "Ran second" }, } }); try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, second, true);
var compact = try runtime.prepareTranscriptSource(alloc, null); defer compact.deinit(alloc);
const first_status = std.mem.indexOf(u8, compact.bytes, "Ran first") orelse return error.MissingFirstStatus; const second_status = std.mem.indexOf(u8, compact.bytes, "Ran second") orelse return error.MissingSecondStatus;
try std.testing.expect(first_status < second_status); try std.testing.expect(std.mem.indexOf(u8, compact.bytes, "FIRST_OUTPUT") == null); try std.testing.expect(std.mem.indexOf(u8, compact.bytes, "SECOND_OUTPUT") == null);
const first_status_entry = runtime.toolActivityRecord(first).?.entry_id; const second_status_entry = runtime.toolActivityRecord(second).?.entry_id; try std.testing.expectEqual(runtime.command_output_blocks.items[0].entry_id, runtime.toolDetailForEntry(first_status_entry).?.command_output_entry_id); try std.testing.expectEqual(runtime.command_output_blocks.items[1].entry_id, runtime.toolDetailForEntry(second_status_entry).?.command_output_entry_id);}
test "command output completion ignores mismatched lifecycle" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, } }; defer runtime.deinit(alloc);
const styles: Styles = .{ .system_notice_label_style = "", .system_notice_text_style = "", .reset_style = "", .dim_style = "", .red_style = "", }; const first = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-first" }; const second = types.ToolLifecycleId{ .turn_id = 9, .call_id = "command-second" };
var metrics: Metrics = .{}; try runtime.writeCommandOutputChunkForLifecycle(alloc, &metrics, styles, first, .stdout, "first\n", true); try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, null, true); try std.testing.expect(runtime.command_output_display.open_command_block != null); try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, second, true); try std.testing.expect(runtime.command_output_display.open_command_block != null); try std.testing.expect(runtime.command_output_blocks.items[0].entry_id == null);
try runtime.flushCommandOutputSummaryForLifecycle(alloc, &metrics, styles, first, true); try std.testing.expect(runtime.command_output_display.open_command_block == null); try std.testing.expect(runtime.command_output_blocks.items[0].entry_id != null);}
test "retintEntriesForTheme rewrites owned presentation without touching external raw bytes" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, }, .owned_top_row = 1, }; defer runtime.deinit(alloc);
const owned_id = try runtime.appendRawTranscriptEntryClassified( alloc, "\x1b[38;5;252m■\x1b[38;5;255m cancelled\x1b[39m\n", .tool_status, ); const command_id = try runtime.appendRawTranscriptEntryClassified( alloc, "\x1b[38;5;252mcommand\x1b[39m\n", .command_output, ); const unknown_id = try runtime.appendRawTranscriptEntryClassified( alloc, "\x1b[38;5;252munknown\x1b[39m\n", .unknown_raw, ); const assistant_id = try runtime.appendAssistantTurnEntry(alloc); const segments = runtime.lookupAssistantSegments(assistant_id).?; try segments.text.appendSlice(alloc, "\x1b[38;5;245mcode\x1b[39m \x1b[38;5;252m✓\x1b[39m\n");
try runtime.retintEntriesForTheme(alloc, false, true);
try std.testing.expectEqual(owned_id, runtime.entries.items[0].id()); try std.testing.expectEqual(command_id, runtime.entries.items[1].id()); try std.testing.expectEqual(unknown_id, runtime.entries.items[2].id()); try std.testing.expectEqual(assistant_id, runtime.entries.items[3].id()); try std.testing.expectEqualStrings( "\x1b[38;5;238m■\x1b[38;5;235m cancelled\x1b[39m\n", runtime.entries.items[0].raw_bytes.bytes, ); try std.testing.expectEqualStrings( "\x1b[38;5;252mcommand\x1b[39m\n", runtime.entries.items[1].raw_bytes.bytes, ); try std.testing.expectEqualStrings( "\x1b[38;5;252munknown\x1b[39m\n", runtime.entries.items[2].raw_bytes.bytes, ); try std.testing.expectEqualStrings( "\x1b[38;5;247mcode\x1b[39m \x1b[38;5;238m✓\x1b[39m\n", runtime.entries.items[3].assistant_turn.segments.text.items, );}
pub fn wrapAssistantText(alloc: Allocator, text: []const u8, cols: u16) ![]u8 { return transcript_blocks.wrapAssistantText(alloc, text, cols);}
pub const PaintTestMode = enum { none, mutate_backing_after_snapshot,};
const PaintTestModeField = if (@import("builtin").is_test) PaintTestMode else void;const default_max_retained_transcript_bytes: usize = 1024 * 1024;const resume_publication_rows_per_frame: u32 = 64;
pub const PaintTraceState = struct { transcript_top: u16 = 0, transcript_bottom: u16 = 0, transcript_start_line: usize = 0, transcript_total_lines: usize = 0, transcript_visible_rows: u16 = 0, transcript_partial_skip_rows: u16 = 0, transcript_entries: usize = 0, transcript_initialized: bool = false, transcript_log_frame: bool = false,
shimmer_row: ?u16 = null, shimmer_over_footer: bool = false, shimmer_label_hash: u64 = 0,
footer_top: u16 = 0, footer_input_base: u16 = 0, footer_hint: u16 = 0, footer_activity_row: ?u16 = null, footer_activity_reserved: u16 = 0, footer_activity_kind: u8 = 0, footer_initialized: bool = false,};
const CommandOutputBlock = command_output_runtime.CommandOutputBlock;const FoldedCommandBlock = command_output_runtime.FoldedCommandBlock;const CommandOutputRenderPolicy = command_output_runtime.CommandOutputRenderPolicy;
pub const ToolDetailRecord = transcript_blocks.ToolDetailRecord;
const PendingToolDetailStart = struct { tool_name: ?[]u8 = null, captured_command: ?bool = null, activity_kind: ?types.ToolActivityKind = null, arguments_json: ?[]u8 = null, lifecycle_id: ?types.ToolLifecycleId = null, replace_lifecycle: bool = false,
fn deinit(self: *PendingToolDetailStart, alloc: Allocator) void { const tool_name = self.tool_name; const arguments_json = self.arguments_json; const lifecycle_id = self.lifecycle_id; self.* = .{}; if (tool_name) |value| alloc.free(value); if (arguments_json) |value| alloc.free(value); if (lifecycle_id) |id| alloc.free(@constCast(id.call_id)); }};
const PendingToolDetailTerminal = struct { result: ?[]u8 = null, result_handle: ?[]u8 = null, command_artifact_handle: ?[]u8 = null, command_output_replay: ?types.CommandOutputReplay = null, command_process_presentation: ?types.CommandProcessPresentation = null, command_output_entry_id: ?u32 = null, command_process_entry: ?PendingCommandProcessEntry = null,
fn deinit(self: *PendingToolDetailTerminal, alloc: Allocator) void { if (self.result) |value| alloc.free(value); if (self.result_handle) |value| alloc.free(value); if (self.command_artifact_handle) |value| alloc.free(value); if (self.command_output_replay) |replay| { types.freeCommandOutputReplay(alloc, replay); } if (self.command_process_entry) |*entry| entry.deinit(alloc); self.* = .{}; }};
const PendingCommandProcessEntry = struct { entry_id: u32, bytes: ?[]u8 = null, block: ?CommandOutputBlock = null,
fn deinit(self: *PendingCommandProcessEntry, alloc: Allocator) void { if (self.bytes) |value| alloc.free(value); if (self.block) |*value| value.deinit(alloc); self.bytes = null; self.block = null; }};
pub fn renderEntriesToBytes( alloc: Allocator, entries: []const TranscriptEntry, cols: u16, styles: Styles,) ![]u8 { return transcript_blocks.renderEntriesToBytes(alloc, entries, cols, styles);}
pub const FullTranscriptPrimaryRestore = enum { changed, changed_resized, exact, resized,};
const ProjectionCacheDirty = union(enum) { clean, all, entry: struct { id: u32, index: usize, },
fn markEntry(self: *ProjectionCacheDirty, entry_id: u32, entry_index: usize) void { self.* = switch (self.*) { .clean => .{ .entry = .{ .id = entry_id, .index = entry_index } }, .all => .all, .entry => |current| if (entry_index < current.index) .{ .entry = .{ .id = entry_id, .index = entry_index } } else .{ .entry = current }, }; }};
test "projection cache dirtiness follows transcript position instead of entry id" { var dirty: ProjectionCacheDirty = .clean; dirty.markEntry(1, 3); dirty.markEntry(9, 1); const earliest = switch (dirty) { .entry => |entry| entry, .clean, .all => return error.TestExpectedExactDirtyEntry, }; try std.testing.expectEqual(@as(u32, 9), earliest.id); try std.testing.expectEqual(@as(usize, 1), earliest.index);}
const CachedFullTranscriptProjection = struct { projection: full_transcript_screen.Projection, content_revision: u64, entry_count: usize, prefix_last_entry_id: ?u32, cols: u16, resolver: ?full_transcript_screen.FullDiffResolver, dirty: ProjectionCacheDirty = .clean,
fn matches( self: *const CachedFullTranscriptProjection, content_revision: u64, cols: u16, resolver: ?full_transcript_screen.FullDiffResolver, ) bool { return self.content_revision == content_revision and self.cols == cols and sameFullDiffResolver(self.resolver, resolver); }};
const FullTranscriptProjectionCache = struct { review: ProjectionCacheSet = .{}, full: ProjectionCacheSet = .{}, relationships: FullTranscriptRelationshipCache = .{},
fn deinit(self: *FullTranscriptProjectionCache, alloc: Allocator) void { self.review.deinit(alloc); self.full.deinit(alloc); self.relationships.deinit(alloc); self.* = .{}; }};
const CachedFullTranscriptRelationships = struct { projection: tool_group_projection.Projection, content_revision: u64, entry_count: usize, prefix_last_entry_id: ?u32, dirty: ProjectionCacheDirty = .clean,};
fn entryPrefixBoundaryId(entries: []const TranscriptEntry, entry_count: usize) ?u32 { if (entry_count == 0 or entry_count > entries.len) return null; return entries[entry_count - 1].id();}
fn cachedEntryPrefixMatches( entries: []const TranscriptEntry, entry_count: usize, prefix_last_entry_id: ?u32,) bool { if (entry_count > entries.len) return false; return entryPrefixBoundaryId(entries, entry_count) == prefix_last_entry_id;}
test "cached entry prefix rejects retention and lifecycle reposition" { const original = [_]TranscriptEntry{ .{ .raw_bytes = .{ .id = 1, .bytes = "one" } }, .{ .raw_bytes = .{ .id = 2, .bytes = "two" } }, }; const retained = [_]TranscriptEntry{ .{ .raw_bytes = .{ .id = 2, .bytes = "two" } }, .{ .raw_bytes = .{ .id = 3, .bytes = "three" } }, }; const repositioned = [_]TranscriptEntry{ .{ .raw_bytes = .{ .id = 2, .bytes = "two" } }, .{ .raw_bytes = .{ .id = 1, .bytes = "one" } }, };
const boundary = entryPrefixBoundaryId(&original, original.len); try std.testing.expect(cachedEntryPrefixMatches(&original, original.len, boundary)); try std.testing.expect(!cachedEntryPrefixMatches(&retained, original.len, boundary)); try std.testing.expect(!cachedEntryPrefixMatches(&repositioned, original.len, boundary));}
const FullTranscriptRelationshipCache = struct { cached: ?CachedFullTranscriptRelationships = null,
fn deinit(self: *FullTranscriptRelationshipCache, alloc: Allocator) void { if (self.cached) |*cached| cached.projection.deinit(alloc); self.* = .{}; }
fn markDirtyFrom( self: *FullTranscriptRelationshipCache, entry_id: u32, entry_index: usize, ) void { const cached = if (self.cached) |*value| value else return; cached.dirty.markEntry(entry_id, entry_index); }
fn markDirtyAll(self: *FullTranscriptRelationshipCache) void { const cached = if (self.cached) |*value| value else return; cached.dirty = .all; }};
const CachedCompactTranscriptSource = struct { source: TranscriptPreparationSource, content_revision: u64, cols: u16, has_committed_frame: bool,};
const CompactTranscriptSourceCache = struct { const capacity = 4;
entries: [capacity]?CachedCompactTranscriptSource = .{null} ** capacity, next_replacement: usize = 0,
fn deinit(self: *CompactTranscriptSourceCache, alloc: Allocator) void { for (&self.entries) |*entry| { if (entry.*) |*cached| cached.source.deinit(alloc); } self.* = .{}; }
fn find( self: *CompactTranscriptSourceCache, content_revision: u64, cols: u16, has_committed_frame: bool, ) ?*TranscriptPreparationSource { for (&self.entries) |*entry| { if (entry.*) |*cached| { if (cached.content_revision == content_revision and cached.cols == cols and cached.has_committed_frame == has_committed_frame) { return &cached.source; } } } return null; }
fn insert( self: *CompactTranscriptSourceCache, alloc: Allocator, replacement: CachedCompactTranscriptSource, ) *TranscriptPreparationSource { var index = self.next_replacement; for (self.entries, 0..) |entry, candidate| { if (entry == null) { index = candidate; break; } } else { self.next_replacement = (self.next_replacement + 1) % capacity; } if (self.entries[index]) |*cached| cached.source.deinit(alloc); self.entries[index] = replacement; return &self.entries[index].?.source; }};
const ProjectionCacheSet = struct { const capacity = 4;
entries: [capacity]?CachedFullTranscriptProjection = .{null} ** capacity, next_replacement: usize = 0,
fn deinit(self: *ProjectionCacheSet, alloc: Allocator) void { for (&self.entries) |*entry| { if (entry.*) |*cached| cached.projection.deinit(alloc); } self.* = .{}; }
fn markDirtyFrom(self: *ProjectionCacheSet, entry_id: u32, entry_index: usize) void { for (&self.entries) |*entry| { if (entry.*) |*cached| { cached.dirty.markEntry(entry_id, entry_index); } } }
fn markDirtyAll(self: *ProjectionCacheSet) void { for (&self.entries) |*entry| { if (entry.*) |*cached| { cached.dirty = .all; } } }
fn find( self: *ProjectionCacheSet, content_revision: u64, cols: u16, resolver: ?full_transcript_screen.FullDiffResolver, ) ?*full_transcript_screen.Projection { for (&self.entries) |*entry| { if (entry.*) |*cached| { if (cached.matches( content_revision, cols, resolver, )) return &cached.projection; } } return null; }
fn incrementalCandidate( self: *ProjectionCacheSet, cols: u16, resolver: ?full_transcript_screen.FullDiffResolver, ) ?*CachedFullTranscriptProjection { for (&self.entries) |*entry| { if (entry.*) |*cached| { if (cached.cols != cols or !sameFullDiffResolver(cached.resolver, resolver)) continue; switch (cached.dirty) { .entry => return cached, .clean, .all => {}, } } } return null; }
fn insert( self: *ProjectionCacheSet, alloc: Allocator, replacement: CachedFullTranscriptProjection, ) *full_transcript_screen.Projection { var index = self.next_replacement; for (self.entries, 0..) |entry, candidate| { if (entry == null) { index = candidate; break; } } else { self.next_replacement = (self.next_replacement + 1) % capacity; } if (self.entries[index]) |*cached| cached.projection.deinit(alloc); self.entries[index] = replacement; return &self.entries[index].?.projection; }};
fn sameFullDiffResolver( lhs: ?full_transcript_screen.FullDiffResolver, rhs: ?full_transcript_screen.FullDiffResolver,) bool { if (lhs == null or rhs == null) return lhs == null and rhs == null; return lhs.?.context == rhs.?.context and lhs.?.full_for_marker == rhs.?.full_for_marker and lhs.?.has_full_for_lifecycle == rhs.?.has_full_for_lifecycle;}
pub const TranscriptRuntime = struct { stdout_file: std.Io.File = std.Io.File.stdout(), sync_updates_enabled: bool = true, history_reset_uses_ris: bool = false, layout: Layout = undefined, cursor_row: u16 = 1, cursor_col: u16 = 1, /// Top terminal row owned by fx. Rows above this contain pre-fx scrollback /// and must not be touched by fx repaint logic. /// Initialized to the cursor row captured at `initViewport`, and /// decreased as the transcript scrolls until it reaches row 1. viewport_top_row: u16 = 1, /// First row fx is allowed to clear or repaint. This is set after /// launch-time reservation has created fx-owned rows. Rows above it /// belong to pre-fx terminal content and must not be touched by /// resize/layout repair. owned_top_row: u16 = 1, /// Set when a resize leaves no drawable rows below `owned_top_row`. /// The next successful repaint uses natural terminal scroll to /// compact older visible rows into scrollback before drawing the /// latest fx frame. pending_scroll_compact: bool = false, /// Minimum body rows fx should keep available for the visible /// viewport. Startup sets this to the welcome banner height so a /// later resize cannot leave the renderer with a partial banner /// band and stale resize-reflow cells above it. min_visible_viewport_rows: u16 = 0, /// Resize-only guard rows to clear above `viewport_top_row` on the /// next replay. Real terminals can reflow old fx cells just above /// the logical band during a drag; this lets the settled pass erase /// that residue without widening normal streaming paints. reflow_clear_guard_rows: u16 = 0, /// Signed cursor displacement measured across the current settled /// resize. Positive rows entered history; negative rows returned. resize_history_row_delta: ?i32 = null, /// Pre-paint cursor evidence retained from live geometry through the /// matching canonical reset commit. pending_resize_observation: ?ResizeObservation = null, /// Forces the next viewport diff paint to start from a real terminal /// clear. This is reserved for resize/reflow repair; normal streamed /// token paints must diff in place so cleared frames do not enter /// terminal scrollback. viewport_clear_pending: bool = false, /// A settled terminal resize needs a canonical repaint from row one. /// It remains pending until the reset frame commits successfully. terminal_reset_pending: bool = false, /// A committed resize reset established terminal-bottom ownership that /// the next cancellation projection must preserve. resize_bottom_anchor_pending: bool = false, render_requests: render_request.RenderRequestState = .{}, /// Set after the frame commit path has successfully written and fed /// a frame. Resize-time invalid terminal dimensions before this point /// still use the startup error path. has_committed_frame: bool = false, committed_frame_layout: render_engine.frame_layout.CommittedLayoutSnapshot = .{}, transcript_commit_state: TranscriptCommitState = .invalid, /// True while the terminal reports zero, unreadable, or too-small /// dimensions after the first committed frame. Normal painters stay /// idle until a valid resize clears this flag. terminal_dimensions_invalid: bool = false, transcript: std.ArrayList(u8) = .empty, /// Complete historical flow and its immutable line index, retained until /// the first successful terminal publication. pending_resume_source: ?TranscriptPreparationSource = null, folded_command_blocks: std.ArrayList(FoldedCommandBlock) = .empty, command_output_blocks: std.ArrayList(CommandOutputBlock) = .empty, /// Viewer state used only while Ctrl-O owns the alternate screen. /// The compact transcript keeps its independent viewport selection. full_transcript: transcript_presentation.State = .{}, full_transcript_open_content_revision: ?u64 = null, full_transcript_open_cols: u16 = 0, full_transcript_open_rows: u16 = 0, full_transcript_primary_recovery_entry_id: ?u32 = null, full_transcript_projection_cache: FullTranscriptProjectionCache = .{}, full_transcript_code_copy_frame: full_transcript_screen.CodeCopyInteractionFrame = .{}, full_transcript_content_revision: u64 = 0, full_transcript_review_revision: u64 = 0, compact_transcript_source_cache: CompactTranscriptSourceCache = .{}, /// Structured-entry store used to regenerate transcript bytes at the /// current width while retaining the raw byte buffer for append paths /// that still write pre-rendered transcript content. entries: std.ArrayList(TranscriptEntry) = .empty, lifecycle_state: activity_runtime.ToolActivityState = .{}, worker_status: worker_status.State = .none, /// Core-owned producer state and policy for native-history release. transcript_release: transcript_release.State = .{}, /// Sorted by entry id so exact lookup stays bounded as history grows. tool_details: std.ArrayList(ToolDetailRecord) = .empty, /// Monotonically increasing id stamped onto each new entry by the /// `append*Entry` helpers. Starts at 1 so 0 can be reserved as a /// sentinel. Never reset on `clearTranscript` — even after a wipe, /// subsequent ids remain unique within the session, which keeps /// debug traces unambiguous across transcript resets. next_entry_id: u32 = 1, /// Cols at which the transcript byte buffer was last regenerated from /// entries. A cache-origin proof is valid only at this width. /// Zero before the first prepared transcript frame. last_rendered_cols: u16 = 0, /// True only when the visible cache was rebuilt from an untrimmed, /// canonical entry source at `last_rendered_cols`. transcript_cache_origin_untrimmed: bool = false, /// Visible byte-cache cap. This bounds `transcript.items`, which is /// the rendered tail used by viewport paint. Structured entries and /// folded command output are bounded separately by /// `max_retained_transcript_bytes` below. max_transcript_bytes: usize = 256 * 1024, /// Structured retention cap for raw/user/assistant entries plus /// folded command output lines. This model is the source of truth /// for reconstructive paint, resize, and diff restyling, so it gets /// its own conservative budget instead of borrowing the smaller /// visible byte-cache limit. max_retained_transcript_bytes: usize = default_max_retained_transcript_bytes, painting: bool = false, paint_test_mode: PaintTestModeField = if (@import("builtin").is_test) .none else {}, /// Renderer-local cache state set by transcript mutations. The same /// mutation must request `.transcript`; this flag never authorizes a /// frame on its own. transcript_band_dirty: bool = false, /// False until the first non-empty viewport paint has established /// fx's transcript band. Before that point transcript writes are /// model updates only: emitting scroll newlines would move pre-fx /// shell rows before the renderer has had a chance to respect /// `viewport_top_row`. has_painted_transcript: bool = false, footer_viewport: footer_viewport_runtime.FooterViewport = .{}, extra_input_rows: u16 = 0, footer_reserved_base_rows: u16 = 3, command_output_display: CommandOutputDisplayState = .{}, command_output_render: CommandOutputRenderPolicy = .{}, shimmer_active: bool = false, shimmer_row: u16 = 1, shimmer_is_overlay: bool = false, paint_trace: PaintTraceState = .{}, last_visible_transcript_top_row: u16 = 1, last_visible_transcript_start_line: usize = 0, last_visible_transcript_partial_skip_rows: u16 = 0, last_visible_transcript_split_active: bool = false, last_visible_transcript_split_prefix_lines: usize = 0, last_visible_transcript_split_suffix_start_line: usize = 0, last_visible_transcript_last_row: u16 = 0, last_visible_transcript_last_row_blank: bool = false, last_visible_transcript_tail_kind: ?TranscriptBlockKind = null, last_viewport_selection: ?ViewportSelection = null, /// Detached alternate-screen views may request the ordinary compact /// transcript at a stable distance from its tail. Inline chat leaves this /// unset and keeps the existing viewport policy. tail_viewport_request: ?viewport_selection.TailViewportPolicy = null, tail_viewport_resolution: ?viewport_selection.TailOffsetResolution = null, last_paint_bottom_reserved_rows: u16 = 0, replaceable_last_line: bool = false, replaceable_row: u16 = 1, replaceable_start: usize = 0, /// In-process terminal shadow used as the previous state for cell diffs. /// Bootstrap enables it unconditionally; FX_TRACE dumps it at synchronized /// update boundaries. shadow_vt: ?*vt_emulator.Grid = null, shadow_vt_alloc: ?Allocator = null, /// Detached presentations share a physical terminal shadow with their /// owning surface, but retain independent transcript commit state. /// This allocator releases that commit state without claiming ownership /// of the shared shadow grid. detached_commit_alloc: ?Allocator = null, ui_observer: render_engine.ui_observer.UiObserver = .{},
pub fn enableShadowVt(self: *TranscriptRuntime, alloc: Allocator) !void { return transcript_io.enableShadowVt(self, alloc); }
pub fn disableShadowVt(self: *TranscriptRuntime) void { return transcript_io.disableShadowVt(self); }
pub fn bindDetachedCommitAllocator( self: *TranscriptRuntime, alloc: Allocator, ) void { std.debug.assert(self.shadow_vt == null); self.detached_commit_alloc = alloc; }
pub fn deinit(self: *TranscriptRuntime, alloc: Allocator) void { self.disableShadowVt(); self.compact_transcript_source_cache.deinit(alloc); self.full_transcript_projection_cache.deinit(alloc); self.full_transcript_code_copy_frame.deinit(alloc); self.lifecycle_state.deinit(alloc); for (self.tool_details.items) |*detail| detail.deinit(alloc); self.tool_details.deinit(alloc); self.transcript.deinit(alloc); _ = self.releasePendingResumeSource(alloc); for (self.folded_command_blocks.items) |*block| block.deinit(alloc); self.folded_command_blocks.deinit(alloc); for (self.command_output_blocks.items) |*block| block.deinit(alloc); self.command_output_blocks.deinit(alloc); for (self.entries.items) |*entry| entry.deinit(alloc); self.entries.deinit(alloc); self.transcript_commit_state.deinit(alloc); self.footer_viewport.deinit(alloc); self.ui_observer.deinit(alloc); }
fn releasePendingResumeSource(self: *TranscriptRuntime, alloc: Allocator) usize { var source = self.pending_resume_source orelse return 0; const released_bytes = source.bytes.len; source.deinit(alloc); self.pending_resume_source = null; return released_bytes; }
pub fn pendingResumeFlow(self: *const TranscriptRuntime) []const u8 { return if (self.pending_resume_source) |*source| source.bytes else &.{}; }
pub fn committedRowProvenance( self: *const TranscriptRuntime, ) []const transcript_blocks.RowProvenance { return switch (self.transcript_commit_state) { .invalid => &.{}, .stable => |anchor| anchor.row_provenance, .recovering => |receipt| receipt.row_provenance, }; }
pub fn beginPaint(self: *TranscriptRuntime) usize { std.debug.assert(!self.painting); self.painting = true; return self.transcript.items.len; }
pub fn endPaint(self: *TranscriptRuntime, entry_len: usize) void { self.painting = false; const exit_len = self.transcript.items.len; if (exit_len != entry_len) { debug_trace.logf("paint", "transcript mutated during paint: entry_len={d} exit_len={d}", .{ entry_len, exit_len }); } }
pub fn beginPaintSilent(self: *TranscriptRuntime) void { std.debug.assert(!self.painting); self.painting = true; }
pub fn endPaintSilent(self: *TranscriptRuntime) void { self.painting = false; }
pub fn assertCanMutateTranscript(self: *TranscriptRuntime) !void { if (@import("builtin").is_test and self.painting) return error.PaintGuardViolated; std.debug.assert(!self.painting); }
pub fn initBacking(self: *TranscriptRuntime, alloc: Allocator) !void { return transcript_store.initBacking(self, alloc); }
pub fn ensurePaintReservation(self: *TranscriptRuntime, alloc: Allocator) !void { return transcript_store.ensurePaintReservation(self, alloc); }
pub fn rebuildTranscriptFromRendered(self: *TranscriptRuntime, alloc: Allocator, bytes: []const u8, label: []const u8) !void { return transcript_store.rebuildTranscriptFromRendered(self, alloc, bytes, label); }
pub fn replaceableEntryId(self: *const TranscriptRuntime) ?u32 { return transcript_store.replaceableEntryId(self); }
pub fn refreshFoldedCommandSummaryIndices(self: *TranscriptRuntime, alloc: Allocator) !void { return transcript_store.refreshFoldedCommandSummaryIndices(self, alloc); }
pub fn rebuildTranscriptCacheFromEntries(self: *TranscriptRuntime, alloc: Allocator, label: []const u8) !void { return transcript_store.rebuildTranscriptCacheFromEntries(self, alloc, label); }
pub fn rebuildTranscriptCacheAfterStructuredRewrite(self: *TranscriptRuntime, alloc: Allocator, label: []const u8) !void { return transcript_store.rebuildTranscriptCacheAfterStructuredRewrite(self, alloc, label); }
pub fn reconcileDetachedInstallSource( self: *TranscriptRuntime, source: []const u8, ) void { transcript_store.reconcileDetachedInstallSource(self, source); }
pub fn enforceStructuredRetention(self: *TranscriptRuntime, alloc: Allocator, protected_id: ?u32) !void { return transcript_store.enforceStructuredRetention(self, alloc, protected_id); }
pub fn enforceStructuredRetentionAndReport( self: *TranscriptRuntime, alloc: Allocator, protected_id: ?u32, ) !bool { return transcript_store.enforceStructuredRetentionAndReport(self, alloc, protected_id); }
pub fn lifecyclePinCount(self: *const TranscriptRuntime) usize { return transcript_store.lifecyclePinCount(self); }
pub fn isLifecyclePinned(self: *const TranscriptRuntime, entry_id: u32) bool { return transcript_store.isLifecyclePinned(self, entry_id); }
pub fn applyToolLifecycle( self: *TranscriptRuntime, alloc: Allocator, event: types.ToolLifecycleEvent, ) !?types.ToolActivityKind { return self.applyToolLifecycleWithAnchorPolicy(alloc, event, false); }
pub fn applyToolLifecyclePreservingNormalBufferAnchor( self: *TranscriptRuntime, alloc: Allocator, event: types.ToolLifecycleEvent, ) !?types.ToolActivityKind { return self.applyToolLifecycleWithAnchorPolicy(alloc, event, true); }
fn applyToolLifecycleWithAnchorPolicy( self: *TranscriptRuntime, alloc: Allocator, event: types.ToolLifecycleEvent, preserve_normal_buffer_anchor: bool, ) !?types.ToolActivityKind { const result = switch (event) { .provisional => |provisional| self.applyProvisionalLifecycle( alloc, provisional.id, provisional.presentation_group_id, provisional.tool_name, provisional.activity_kind, ), .authoritative_started => |started| self.applyAuthoritativeLifecycle( alloc, started.id, started.presentation_group_id, started.reconciles_provisional_call_id, started.tool_name, started.activity_kind, started.arguments_json, started.place_after_current_transcript, ), .progress => |progress| self.applyProgressLifecycle( alloc, progress.id, progress.text, ), .terminal => |terminal| self.applyTerminalLifecycle( alloc, terminal.id, terminal.outcome, terminal.result, terminal.result_memory, terminal.command_artifact_handle, ), .turn_finished => |finished| self.applyTurnFinishedLifecycle( alloc, finished, preserve_normal_buffer_anchor, ), } catch |err| { traceLifecycleFailure( @tagName(event), lifecycleEventTurnId(event), err, ); return err; }; debug_trace.eventf( "ui_activity", "lifecycle_reduced", .{}, "kind={s} turn_id={d} records={d}", .{ @tagName(event), lifecycleEventTurnId(event), self.lifecycle_state.recordCount(), }, ); return result; }
pub fn finishLifecycleBatch( self: *TranscriptRuntime, alloc: Allocator, ) !void { const watermark = self.lifecycle_state.batch_finalized_turn_watermark orelse return; const entry_ids = try self.lifecycle_state.cleanupEntryIds(alloc, watermark); defer alloc.free(entry_ids); transcript_store.clearLifecyclePinsAtomic(self, alloc, entry_ids) catch |err| { traceLifecycleFailure("batch_cleanup", watermark, err); return err; }; self.lifecycle_state.commitCleanup(alloc, watermark); }
pub fn activityProjection( self: *const TranscriptRuntime, ) activity_runtime.ActivityProjection { if (self.worker_status.projection()) |projection| return projection; const record = self.lifecycle_state.focusedRecord() orelse { return .none; }; const label = transcript_store.toolStatusEntryLabel(self, record.entry_id) orelse { debug_trace.logf( "ui_activity", "focused lifecycle missing transcript entry turn_id={d} entry_id={d}", .{ record.id.turn_id, record.entry_id }, ); return .none; }; return .{ .tool_slot = .{ .entry_id = record.entry_id, .fallback_label = label, .active = record.phase != .terminal, .kind = record.activity_kind, } }; }
pub fn worker_status_state(self: *TranscriptRuntime) *worker_status.State { return &self.worker_status; }
pub fn focusedToolEntryId(self: *const TranscriptRuntime) ?u32 { const record = self.lifecycle_state.focusedRecord() orelse return null; return record.entry_id; }
pub fn focusedToolActivityKind( self: *const TranscriptRuntime, ) ?types.ToolActivityKind { const record = self.lifecycle_state.focusedRecord() orelse return null; return record.activity_kind; }
pub fn toolActivityRecord( self: *const TranscriptRuntime, id: types.ToolLifecycleId, ) ?activity_runtime.ToolPresentationRecord { return self.lifecycle_state.record(id); }
pub fn attachCommandOutputEntryForLifecycle( self: *TranscriptRuntime, lifecycle_id: ?types.ToolLifecycleId, command_output_entry_id: u32, ) void { const id = lifecycle_id orelse return; for (self.tool_details.items) |*detail| { if (!command_output_runtime.sameLifecycleId(detail.lifecycle_id, id)) continue; detail.command_output_entry_id = command_output_entry_id; return; } }
pub fn toolActivityRecordCount(self: *const TranscriptRuntime) usize { return self.lifecycle_state.recordCount(); }
pub fn activeToolActivityCount(self: *const TranscriptRuntime) usize { return self.lifecycle_state.activeCount(); }
pub fn finalizedToolTurnWatermark(self: *const TranscriptRuntime) u64 { return self.lifecycle_state.finalized_turn_watermark; }
pub fn clearTranscript(self: *TranscriptRuntime, alloc: Allocator) void { const pending_resume_bytes = self.releasePendingResumeSource(alloc); if (pending_resume_bytes > 0) { debug_trace.logf( "session", "dropping pending resume flow during transcript clear bytes={d}", .{pending_resume_bytes}, ); } self.lifecycle_state.deinit(alloc); self.worker_status.reset(); self.clearToolDetails(alloc); return transcript_store.clearTranscript(self, alloc); }
pub fn snapshotVisibleTranscriptText( self: *const TranscriptRuntime, alloc: Allocator, max_bytes: usize, ) !?VisibleTranscriptSnapshot { const grid = self.shadow_vt orelse return null; if (!self.has_painted_transcript or self.last_visible_transcript_top_row == 0 or self.last_visible_transcript_last_row < self.last_visible_transcript_top_row) { return null; } const footer_gap_rows = if (!self.committed_frame_layout.footer_area.isEmpty() and self.committed_frame_layout.footer_area.top > self.last_visible_transcript_last_row) self.committed_frame_layout.footer_area.top - self.last_visible_transcript_last_row - 1 else 0; if (footer_gap_rows >= max_bytes) return null; const text_byte_limit = max_bytes - footer_gap_rows; var out: std.ArrayList(u8) = .empty; errdefer out.deinit(alloc); var start_row = self.last_visible_transcript_top_row; const leading_welcome_visible = if (self.entries.items.len > 0 and self.entries.items[0] == .raw_bytes and self.entries.items[0].raw_bytes.class == .welcome and self.last_viewport_selection != null) self.last_viewport_selection.?.start_line == 0 or (self.last_viewport_selection.?.split_active and self.last_viewport_selection.?.split_prefix_lines > 0) else false; if (leading_welcome_visible) { var saw_welcome_text = false; while (start_row <= self.last_visible_transcript_last_row) : (start_row += 1) { var line: std.ArrayList(u8) = .empty; defer line.deinit(grid.alloc); try grid.rowTextTrimmed(start_row, &line); if (line.items.len > 0) { saw_welcome_text = true; } else if (saw_welcome_text) { start_row += 1; break; } } if (!saw_welcome_text or start_row > self.last_visible_transcript_last_row) return null; } var selected_start: ?u16 = null; var selected_bytes: usize = 0; var row = self.last_visible_transcript_last_row; while (true) { var line: std.Io.Writer.Allocating = .init(grid.alloc); defer line.deinit(); try grid.rowStyledTextTrimmed(row, &line.writer); if (line.written().len >= text_byte_limit - selected_bytes) break; selected_bytes += line.written().len + 1; selected_start = row; if (row == start_row) break; row -= 1; } row = selected_start orelse return null; var has_content = false; while (row <= self.last_visible_transcript_last_row) : (row += 1) { var line: std.Io.Writer.Allocating = .init(grid.alloc); defer line.deinit(); try grid.rowStyledTextTrimmed(row, &line.writer); has_content = has_content or line.written().len > 0; try out.appendSlice(alloc, line.written()); try out.append(alloc, '\n'); } if (!has_content) { out.deinit(alloc); return null; } try out.appendNTimes(alloc, '\n', footer_gap_rows); return .{ .text = try out.toOwnedSlice(alloc), .terminal_rows = grid.rows, .terminal_cols = grid.cols, .complete = selected_start.? == start_row, }; }
pub fn resetVisualEpoch(self: *TranscriptRuntime, alloc: Allocator, welcome: []const u8) !void { return transcript_store.resetVisualEpoch(self, alloc, welcome); }
fn replacePinnedLifecycleStatus( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, line: []const u8, place_after_current_transcript: bool, ) !bool { return if (place_after_current_transcript) transcript_store.replacePinnedToolStatusAtEndAtomic( self, alloc, entry_id, line, ) else transcript_store.replacePinnedToolStatusAtomic( self, alloc, entry_id, line, ); }
fn applyProvisionalLifecycle( self: *TranscriptRuntime, alloc: Allocator, id: types.ToolLifecycleId, presentation_group_id: ?types.ToolPresentationGroupId, tool_name: ?[]const u8, activity_kind: types.ToolActivityKind, ) !?types.ToolActivityKind { if (!admitLifecycleStart(&self.lifecycle_state, id)) return null; if (self.lifecycle_state.recordPtr(id)) |record| { if (record.phase == .terminal) { traceLateLifecycleEvent(id, "provisional"); return null; } const name = tool_name orelse return null; var detail_start = try self.prepareToolDetailStart( alloc, record.entry_id, id, name, activity_kind, null, ); defer detail_start.deinit(alloc); const owned_name = try alloc.dupe(u8, name); errdefer alloc.free(owned_name); const line = try lifecycleStartLine(alloc, name); defer alloc.free(line); if (!try self.replacePinnedLifecycleStatus( alloc, record.entry_id, line, false, )) return error.MissingLifecycleTranscriptEntry; activity_runtime.replaceToolName(alloc, record, owned_name); record.activity_kind = activity_kind; self.commitLifecycleToolDetailStart( alloc, id, record.entry_id, &detail_start, ); self.commitToolPresentationGroup(record.entry_id, id, presentation_group_id); return null; } var detail_start = try self.prepareToolDetailStart( alloc, null, id, tool_name orelse "tool", activity_kind, null, ); defer detail_start.deinit(alloc); const entry_id = try self.createToolActivity( alloc, id, tool_name, activity_kind, .provisional, ); self.commitLifecycleToolDetailStart(alloc, id, entry_id, &detail_start); self.commitToolPresentationGroup(entry_id, id, presentation_group_id); return null; }
fn applyAuthoritativeLifecycle( self: *TranscriptRuntime, alloc: Allocator, id: types.ToolLifecycleId, presentation_group_id: ?types.ToolPresentationGroupId, reconciliation_alias: ?[]const u8, tool_name: []const u8, activity_kind: types.ToolActivityKind, arguments_json: ?[]const u8, place_after_current_transcript: bool, ) !?types.ToolActivityKind { if (!admitLifecycleStart(&self.lifecycle_state, id)) return null;
const alias_id: ?types.ToolLifecycleId = if (reconciliation_alias) |call_id| if (call_id.len > 0) .{ .turn_id = id.turn_id, .call_id = call_id } else null else null; const alias_is_distinct = if (alias_id) |alias| alias.turn_id != id.turn_id or !std.mem.eql(u8, alias.call_id, id.call_id) else false;
if (alias_is_distinct) { const alias = alias_id.?; if (self.lifecycle_state.record(alias)) |alias_record| { if (self.lifecycle_state.record(id) != null) { debug_trace.logf( "ui_activity", "lifecycle identity collision turn_id={d} kind=authoritative_started", .{id.turn_id}, ); return error.LifecycleReconciliationCollision; } if (alias_record.phase == .terminal) { traceLateLifecycleEvent(alias, "authoritative_started"); return null; } var detail_start = try self.prepareToolDetailStart( alloc, alias_record.entry_id, id, tool_name, activity_kind, arguments_json, ); defer detail_start.deinit(alloc); try self.lifecycle_state.ensureRecordCapacity(alloc); const owned_call_id = try alloc.dupe(u8, id.call_id); errdefer alloc.free(owned_call_id); const owned_tool_name = try alloc.dupe(u8, tool_name); errdefer alloc.free(owned_tool_name); const line = try lifecycleStartLine(alloc, tool_name); defer alloc.free(line); if (!try self.replacePinnedLifecycleStatus( alloc, alias_record.entry_id, line, place_after_current_transcript, )) return error.MissingLifecycleTranscriptEntry; self.lifecycle_state.rekeyOwned( alloc, alias, .{ .turn_id = id.turn_id, .call_id = owned_call_id }, owned_tool_name, activity_kind, ); self.commitLifecycleToolDetailStart( alloc, id, alias_record.entry_id, &detail_start, ); self.commitToolPresentationGroup(alias_record.entry_id, id, presentation_group_id); return activity_kind; } }
if (self.lifecycle_state.recordPtr(id)) |record| { if (record.phase == .terminal) { traceLateLifecycleEvent(id, "authoritative_started"); return null; } var detail_start = try self.prepareToolDetailStart( alloc, record.entry_id, id, tool_name, activity_kind, arguments_json, ); defer detail_start.deinit(alloc); const owned_tool_name = try alloc.dupe(u8, tool_name); errdefer alloc.free(owned_tool_name); const line = try lifecycleStartLine(alloc, tool_name); defer alloc.free(line); if (!try self.replacePinnedLifecycleStatus( alloc, record.entry_id, line, place_after_current_transcript, )) return error.MissingLifecycleTranscriptEntry; const first_authoritative = self.lifecycle_state.promoteOwned( alloc, record, owned_tool_name, activity_kind, ); self.commitLifecycleToolDetailStart( alloc, id, record.entry_id, &detail_start, ); self.commitToolPresentationGroup(record.entry_id, id, presentation_group_id); return if (first_authoritative) activity_kind else null; }
var detail_start = try self.prepareToolDetailStart( alloc, null, id, tool_name, activity_kind, arguments_json, ); defer detail_start.deinit(alloc); const entry_id = try self.createToolActivity( alloc, id, tool_name, activity_kind, .authoritative, ); self.commitLifecycleToolDetailStart(alloc, id, entry_id, &detail_start); self.commitToolPresentationGroup(entry_id, id, presentation_group_id); return activity_kind; }
fn applyProgressLifecycle( self: *TranscriptRuntime, alloc: Allocator, id: types.ToolLifecycleId, text: []const u8, ) !?types.ToolActivityKind { const record = self.lifecycle_state.recordPtr(id) orelse { if (self.lifecycle_state.isFenced(id.turn_id)) { traceLateLifecycleEvent(id, "progress"); return null; } debug_trace.logf( "ui_activity", "progress without lifecycle turn_id={d}", .{id.turn_id}, ); return error.UnknownToolLifecycleIdentity; }; if (record.phase == .terminal) { traceLateLifecycleEvent(id, "progress"); return null; } const line = try lifecycleLine(alloc, text); defer alloc.free(line); if (!try self.replacePinnedLifecycleStatus( alloc, record.entry_id, line, false, )) return error.MissingLifecycleTranscriptEntry; return null; }
fn applyTerminalLifecycle( self: *TranscriptRuntime, alloc: Allocator, id: types.ToolLifecycleId, outcome: types.ToolOutcome, result: ?[]const u8, result_memory: ?types.ToolResultMemory, command_artifact_handle: ?[]const u8, ) !?types.ToolActivityKind { const record = self.lifecycle_state.recordPtr(id) orelse { if (self.lifecycle_state.isFenced(id.turn_id)) { traceLateLifecycleEvent(id, "terminal"); return null; } debug_trace.logf( "ui_activity", "terminal without lifecycle turn_id={d}", .{id.turn_id}, ); return error.UnknownToolLifecycleIdentity; }; const line = try lifecycleTerminalLine(alloc, outcome.kind, outcome.summary); defer alloc.free(line); var detail_start: ?PendingToolDetailStart = if (self.toolDetailPtr(record.entry_id) == null) try self.prepareToolDetailStart( alloc, record.entry_id, id, record.tool_name orelse "tool", record.activity_kind, null, ) else null; defer if (detail_start) |*pending| pending.deinit(alloc); var detail_update = try self.prepareToolDetailTerminal( alloc, id, record.activity_kind, result, result_memory, command_artifact_handle, null, ); defer detail_update.deinit(alloc); if (!try transcript_store.replacePinnedToolStatusForTerminalAtomic( self, alloc, record.entry_id, line, @intFromBool(detail_start != null), @intFromBool(detail_update.command_process_entry != null), )) return error.MissingLifecycleTranscriptEntry; record.phase = .terminal; if (detail_start) |*pending| { self.commitLifecycleToolDetailStart( alloc, id, record.entry_id, pending, ); } self.commitToolDetailTerminal( alloc, record.entry_id, record.activity_kind, outcome.kind, &detail_update, ); return null; }
fn applyTurnFinishedLifecycle( self: *TranscriptRuntime, alloc: Allocator, finished: types.TurnFinished, preserve_normal_buffer_anchor: bool, ) !?types.ToolActivityKind { if (finished.turn_id == 0) return error.InvalidTurnId; if (!self.lifecycle_state.shouldApplyTurnFinished(finished.turn_id)) return null;
const fallbacks = try self.lifecycle_state.collectFallbackRecords( alloc, finished.turn_id, ); defer alloc.free(fallbacks); const updates = try alloc.alloc( transcript_store.LifecycleEntryUpdate, fallbacks.len, ); defer alloc.free(updates); var lines: std.ArrayList([]u8) = .empty; defer { for (lines.items) |line| alloc.free(line); lines.deinit(alloc); } var detail_starts: std.ArrayList(PendingToolDetailStart) = .empty; defer { for (detail_starts.items) |*detail_start| detail_start.deinit(alloc); detail_starts.deinit(alloc); } var missing_detail_count: usize = 0; try lines.ensureTotalCapacity(alloc, fallbacks.len); try detail_starts.ensureTotalCapacity(alloc, fallbacks.len); for (fallbacks, 0..) |fallback, index| { if (self.toolDetailPtr(fallback.record.entry_id) == null) { missing_detail_count += 1; } detail_starts.appendAssumeCapacity(try self.prepareToolDetailStart( alloc, fallback.record.entry_id, fallback.record.id, fallback.record.tool_name orelse "tool", fallback.record.activity_kind, null, )); const line = try lifecycleFallbackLine( alloc, finished.outcome, fallback.was_provisional, ); lines.append(alloc, line) catch |err| { alloc.free(line); return err; }; updates[index] = .{ .entry_id = fallback.record.entry_id, .bytes = line, }; } const replace_result = if (preserve_normal_buffer_anchor) transcript_store.replacePinnedToolStatusesPreservingNormalBufferAnchorAtomic( self, alloc, updates, missing_detail_count, ) else transcript_store.replacePinnedToolStatusesAtomic( self, alloc, updates, missing_detail_count, ); replace_result catch |err| { traceLifecycleFailure("turn_finished", finished.turn_id, err); return err; }; const fallback_outcome: ?types.ToolOutcomeKind = switch (finished.outcome) { .completed => .completed, .interrupted => .cancelled, .failed => .failed, .paused => null, }; for (fallbacks, detail_starts.items) |fallback, *detail_start| { self.commitToolDetailStart(alloc, fallback.record.entry_id, detail_start); const detail = self.toolDetailPtr(fallback.record.entry_id).?; detail.outcome = fallback_outcome; detail.fallback_disposition = lifecycleFallbackDisposition( finished.outcome, fallback.was_provisional, ); } if (finished.outcome == .paused) { const entry_ids = try self.lifecycle_state.pausedTurnEntryIds( alloc, finished.turn_id, ); defer alloc.free(entry_ids); transcript_store.clearLifecyclePinsAtomic(self, alloc, entry_ids) catch |err| { traceLifecycleFailure("turn_paused", finished.turn_id, err); return err; }; self.lifecycle_state.releasePausedTurn(alloc, finished.turn_id); } else { self.lifecycle_state.commitTurnFinished(finished.turn_id, fallbacks); } return null; }
fn createToolActivity( self: *TranscriptRuntime, alloc: Allocator, id: types.ToolLifecycleId, tool_name: ?[]const u8, activity_kind: types.ToolActivityKind, phase: activity_runtime.ToolLifecyclePhase, ) !u32 { try self.lifecycle_state.ensureRecordCapacity(alloc); const owned_call_id = try alloc.dupe(u8, id.call_id); errdefer alloc.free(owned_call_id); const owned_tool_name = if (tool_name) |name| try alloc.dupe(u8, name) else null; errdefer if (owned_tool_name) |name| alloc.free(name); const line = try lifecycleStartLine(alloc, tool_name); defer alloc.free(line); const entry_id = try transcript_store.appendPinnedToolStatusAtomic( self, alloc, line, ); self.lifecycle_state.putOwnedRecord( .{ .turn_id = id.turn_id, .call_id = owned_call_id }, owned_tool_name, activity_kind, entry_id, phase, ); return entry_id; }
const ToolDetailSearch = struct { index: usize, found: bool, };
fn toolDetailSearch(self: *const TranscriptRuntime, entry_id: u32) ToolDetailSearch { var low: usize = 0; var high = self.tool_details.items.len; while (low < high) { const middle = low + (high - low) / 2; if (self.tool_details.items[middle].entry_id < entry_id) { low = middle + 1; } else { high = middle; } } return .{ .index = low, .found = low < self.tool_details.items.len and self.tool_details.items[low].entry_id == entry_id, }; }
pub fn toolDetailForEntry(self: *const TranscriptRuntime, entry_id: u32) ?*const ToolDetailRecord { const search = self.toolDetailSearch(entry_id); if (!search.found) return null; return &self.tool_details.items[search.index]; }
fn toolDetailPtr(self: *TranscriptRuntime, entry_id: u32) ?*ToolDetailRecord { const search = self.toolDetailSearch(entry_id); if (!search.found) return null; return &self.tool_details.items[search.index]; }
pub fn attachHistoricalToolDetail( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, call: types.ToolCall, activity_kind: types.ToolActivityKind, result: types.PersistedToolResult, ) !void { return self.attachHistoricalToolDetailResolved( alloc, entry_id, call, activity_kind, result, null, null, ); }
pub fn attachHistoricalToolDetailWithLifecycle( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, call: types.ToolCall, activity_kind: types.ToolActivityKind, result: types.PersistedToolResult, lifecycle_id: ?types.ToolLifecycleId, ) !void { return self.attachHistoricalToolDetailResolved( alloc, entry_id, call, activity_kind, result, lifecycle_id, null, ); }
pub fn attachHistoricalToolDetailAfterCommandOutput( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, call: types.ToolCall, activity_kind: types.ToolActivityKind, result: types.PersistedToolResult, ) !void { try self.attachHistoricalToolDetailResolved( alloc, entry_id, call, activity_kind, result, null, self.latestCommandOutputEntryId(), ); if (try command_output_runtime.syncCommandOutputBlockEntries(self, alloc)) { try self.rebuildTranscriptCacheAfterStructuredRewrite( alloc, "historical command process presentation", ); self.recomputeCursorFromTranscript(); self.markTranscriptContentDirty(); } }
pub fn attachHistoricalToolDetailAfterCommandOutputDetached( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, call: types.ToolCall, activity_kind: types.ToolActivityKind, result: types.PersistedToolResult, ) !void { try self.attachHistoricalToolDetailResolved( alloc, entry_id, call, activity_kind, result, null, self.latestCommandOutputEntryId(), ); }
fn attachHistoricalToolDetailResolved( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, call: types.ToolCall, activity_kind: types.ToolActivityKind, result: types.PersistedToolResult, lifecycle_id: ?types.ToolLifecycleId, command_output_entry_id: ?u32, ) !void { const context_deferred = types.isContextDeferredToolResult(result); const deferred = types.isDeferredToolResult(result); const command_artifact_handle = if (!deferred and activity_kind == .command) command_output_runtime.commandArtifactHandleFromResult(result.output) else null; try self.upsertToolDetailStart(alloc, entry_id, lifecycle_id, call.name, activity_kind, call.arguments_json); try self.updateToolDetailTerminal( alloc, entry_id, lifecycle_id, call.name, activity_kind, if (context_deferred) .deferred else if (deferred) .denied else if (result.status == .success or (activity_kind == .command and result.command_process_presentation != null)) .completed else .failed, if (deferred) null else result.output, if (deferred) null else .{ .output_handle = result.output_handle, .preview = result.preview, .output_bytes = result.output_bytes, .stored_output_bytes = result.stored_output_bytes, .truncated = result.truncated, .command_output_replay = result.command_output_replay, .command_process_presentation = result.command_process_presentation, }, command_artifact_handle, if (deferred) null else command_output_entry_id, ); }
pub fn attachHistoricalToolCallWithoutResult( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, call: types.ToolCall, ) !void { try self.upsertToolDetailStart(alloc, entry_id, null, call.name, null, call.arguments_json); if (self.toolDetailPtr(entry_id)) |detail| detail.outcome = .failed; }
pub fn attachHistoricalCommandOutput( self: *TranscriptRuntime, _: Allocator, entry_id: u32, ) void { const detail = self.toolDetailPtr(entry_id) orelse return; const command_output_entry_id = self.latestCommandOutputEntryId() orelse return; detail.command_output_entry_id = command_output_entry_id; }
pub fn attachHistoricalCancelledCommandDetail( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, call: types.ToolCall, command_artifact_handle: ?[]const u8, replayed_output: bool, ) !void { try self.upsertToolDetailStart(alloc, entry_id, null, call.name, .command, call.arguments_json); try self.updateToolDetailTerminal( alloc, entry_id, null, call.name, .command, .cancelled, null, null, command_artifact_handle, if (replayed_output) self.latestCommandOutputEntryId() else null, ); }
fn upsertToolDetailStart( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, lifecycle_id: ?types.ToolLifecycleId, tool_name: []const u8, activity_kind: ?types.ToolActivityKind, arguments_json: ?[]const u8, ) !void { var detail_start = try self.prepareToolDetailStart( alloc, entry_id, lifecycle_id, tool_name, activity_kind, arguments_json, ); defer detail_start.deinit(alloc); self.commitToolDetailStart(alloc, entry_id, &detail_start); }
fn prepareToolDetailStart( self: *TranscriptRuntime, alloc: Allocator, entry_id: ?u32, lifecycle_id: ?types.ToolLifecycleId, tool_name: []const u8, activity_kind: ?types.ToolActivityKind, arguments_json: ?[]const u8, ) !PendingToolDetailStart { const existing = if (entry_id) |id| self.toolDetailPtr(id) else null; if (existing == null) try self.tool_details.ensureUnusedCapacity(alloc, 1);
var pending: PendingToolDetailStart = .{}; errdefer pending.deinit(alloc); pending.tool_name = try alloc.dupe(u8, tool_name); pending.activity_kind = activity_kind; if (arguments_json) |value| { pending.arguments_json = try alloc.dupe(u8, value); pending.captured_command = try captured_command.isToolCall(alloc, tool_name, value); } else if (std.mem.eql(u8, tool_name, "run_command")) { pending.captured_command = true; } if (lifecycle_id) |id| { if (existing == null or !command_output_runtime.sameLifecycleId(existing.?.lifecycle_id, id)) { const owned_call_id = try alloc.dupe(u8, id.call_id); pending.lifecycle_id = .{ .turn_id = id.turn_id, .call_id = owned_call_id, }; pending.replace_lifecycle = true; } } return pending; }
fn commitToolDetailStart( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, pending: *PendingToolDetailStart, ) void { const search = self.toolDetailSearch(entry_id); if (search.found) { const detail = &self.tool_details.items[search.index]; alloc.free(detail.tool_name); detail.tool_name = pending.tool_name.?; pending.tool_name = null; if (pending.captured_command) |value| detail.captured_command = value; if (pending.activity_kind) |kind| detail.activity_kind = kind; if (pending.arguments_json) |arguments_json| { if (detail.arguments_json) |old| alloc.free(old); detail.arguments_json = arguments_json; pending.arguments_json = null; } if (pending.replace_lifecycle) { if (detail.lifecycle_id) |previous| alloc.free(@constCast(previous.call_id)); detail.lifecycle_id = pending.lifecycle_id; pending.lifecycle_id = null; } self.markTranscriptContentDirtyFrom(entry_id); return; }
const detail = ToolDetailRecord{ .entry_id = entry_id, .tool_name = pending.tool_name.?, .captured_command = pending.captured_command orelse false, .activity_kind = pending.activity_kind, .arguments_json = pending.arguments_json, .lifecycle_id = pending.lifecycle_id, }; if (search.index == self.tool_details.items.len) { self.tool_details.appendAssumeCapacity(detail); } else { self.tool_details.insertAssumeCapacity(search.index, detail); } pending.tool_name = null; pending.arguments_json = null; pending.lifecycle_id = null; self.markTranscriptContentDirtyFrom(entry_id); }
fn commitLifecycleToolDetailStart( self: *TranscriptRuntime, alloc: Allocator, lifecycle_id: types.ToolLifecycleId, entry_id: u32, pending: *PendingToolDetailStart, ) void { const classified = pending.captured_command; self.commitToolDetailStart(alloc, entry_id, pending); if (classified) |captured| { if (self.lifecycle_state.recordPtr(lifecycle_id)) |record| { record.captured_command = captured; } } }
fn commitToolPresentationGroup( self: *TranscriptRuntime, entry_id: u32, lifecycle_id: types.ToolLifecycleId, presentation_group_id: ?types.ToolPresentationGroupId, ) void { const incoming = presentation_group_id orelse return; if (incoming.turn_id == 0 or incoming.anchor_step_id == 0 or incoming.turn_id != lifecycle_id.turn_id) { debug_trace.logf( "ui_activity", "invalid tool presentation group ignored turn_id={d} group_turn_id={d} anchor_step_id={d}", .{ lifecycle_id.turn_id, incoming.turn_id, incoming.anchor_step_id }, ); return; } const detail = self.toolDetailPtr(entry_id) orelse return; if (detail.presentation_group_id) |existing| { if (existing.turn_id != incoming.turn_id or existing.anchor_step_id != incoming.anchor_step_id) { debug_trace.logf( "ui_activity", "tool presentation group change ignored turn_id={d} existing_anchor_step_id={d} incoming_anchor_step_id={d}", .{ lifecycle_id.turn_id, existing.anchor_step_id, incoming.anchor_step_id, }, ); } return; } detail.presentation_group_id = incoming; self.markTranscriptContentDirtyFrom(entry_id); }
fn updateToolDetailTerminal( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, lifecycle_id: ?types.ToolLifecycleId, tool_name: []const u8, activity_kind: types.ToolActivityKind, outcome: types.ToolOutcomeKind, result: ?[]const u8, result_memory: ?types.ToolResultMemory, command_artifact_handle: ?[]const u8, command_output_entry_id_override: ?u32, ) !void { var pending = try self.prepareToolDetailTerminal( alloc, lifecycle_id, activity_kind, result, result_memory, command_artifact_handle, command_output_entry_id_override, ); defer pending.deinit(alloc); if (self.toolDetailPtr(entry_id) == null) { try self.upsertToolDetailStart(alloc, entry_id, lifecycle_id, tool_name, activity_kind, null); } self.commitToolDetailTerminal(alloc, entry_id, activity_kind, outcome, &pending); }
fn prepareToolDetailTerminal( self: *TranscriptRuntime, alloc: Allocator, lifecycle_id: ?types.ToolLifecycleId, activity_kind: types.ToolActivityKind, result: ?[]const u8, result_memory: ?types.ToolResultMemory, command_artifact_handle: ?[]const u8, command_output_entry_id_override: ?u32, ) !PendingToolDetailTerminal { var pending: PendingToolDetailTerminal = .{}; errdefer pending.deinit(alloc); if (result) |value| pending.result = try alloc.dupe(u8, value); const result_handle = if (result_memory) |memory| memory.output_handle else null; if (result_handle) |handle| pending.result_handle = try alloc.dupe(u8, handle); if (command_artifact_handle) |handle| { pending.command_artifact_handle = try alloc.dupe(u8, handle); } if (result_memory) |memory| { if (memory.command_output_replay) |replay| { pending.command_output_replay = try types.dupeCommandOutputReplay(alloc, replay); } } pending.command_process_presentation = if (result_memory) |memory| memory.command_process_presentation else null; pending.command_output_entry_id = if (activity_kind == .command) command_output_entry_id_override orelse self.commandOutputEntryIdForLifecycle(lifecycle_id) else null; if (activity_kind == .command and pending.command_process_presentation != null and pending.command_output_entry_id == null) { pending.command_process_entry = try self.prepareCommandProcessPresentationEntry( alloc, lifecycle_id, ); pending.command_output_entry_id = pending.command_process_entry.?.entry_id; } return pending; }
fn commitToolDetailTerminal( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, activity_kind: types.ToolActivityKind, outcome: types.ToolOutcomeKind, pending: *PendingToolDetailTerminal, ) void { if (pending.command_process_entry) |*entry| { self.commitCommandProcessPresentationEntry(entry); pending.command_process_entry = null; } const detail = self.toolDetailPtr(entry_id).?; detail.activity_kind = activity_kind; detail.outcome = outcome; detail.fallback_disposition = null; if (pending.result) |owned| { if (detail.result) |old| alloc.free(old); detail.result = owned; pending.result = null; } if (pending.result_handle) |owned| { if (detail.result_handle) |old| alloc.free(old); detail.result_handle = owned; pending.result_handle = null; } if (pending.command_artifact_handle) |owned| { if (detail.command_artifact_handle) |old| alloc.free(old); detail.command_artifact_handle = owned; pending.command_artifact_handle = null; } if (pending.command_output_replay) |owned| { if (detail.command_output_replay) |old| { types.freeCommandOutputReplay(alloc, old); } detail.command_output_replay = owned; pending.command_output_replay = null; } detail.command_process_presentation = pending.command_process_presentation; if (activity_kind == .command) { detail.command_output_entry_id = pending.command_output_entry_id; } self.markTranscriptContentDirtyFrom(entry_id); }
pub fn hasStoredResultDetails(self: *const TranscriptRuntime) bool { for (self.tool_details.items) |detail| { if (detail.result_handle != null or detail.command_artifact_handle != null or detail.command_output_replay != null) return true; } return false; }
fn commandOutputEntryIdForLifecycle( self: *const TranscriptRuntime, lifecycle_id: ?types.ToolLifecycleId, ) ?u32 { const id = lifecycle_id orelse return null; for (self.command_output_blocks.items) |block| { if (!command_output_runtime.sameLifecycleId(block.lifecycle_id, id)) continue; if (block.entry_id) |entry_id| return entry_id; if (block.live_entry_ids.items.len > 0) return block.live_entry_ids.items[0]; if (block.source_entry_ids.items.len > 0) return block.source_entry_ids.items[0]; for (block.lines.items) |line| { if (line.entry_id) |entry_id| return entry_id; } return null; } return null; }
fn prepareCommandProcessPresentationEntry( self: *TranscriptRuntime, alloc: Allocator, lifecycle_id: ?types.ToolLifecycleId, ) !PendingCommandProcessEntry { var pending: PendingCommandProcessEntry = .{ .entry_id = self.next_entry_id }; errdefer pending.deinit(alloc); pending.bytes = try alloc.alloc(u8, 0);
const line_text = try alloc.alloc(u8, 0); var line_text_owned = true; errdefer if (line_text_owned) alloc.free(line_text); pending.block = .{ .entry_id = pending.entry_id }; const block = &pending.block.?; if (lifecycle_id) |id| { const call_id = try alloc.dupe(u8, id.call_id); block.lifecycle_id = .{ .turn_id = id.turn_id, .call_id = call_id, }; } try block.lines.append(alloc, .{ .stream = .stdout, .text = line_text, .entry_id = pending.entry_id, .visible = false, }); line_text_owned = false; try block.source_entry_ids.append(alloc, pending.entry_id); try self.entries.ensureUnusedCapacity(alloc, 1); try self.command_output_blocks.ensureUnusedCapacity(alloc, 1); return pending; }
fn commitCommandProcessPresentationEntry( self: *TranscriptRuntime, pending: *PendingCommandProcessEntry, ) void { std.debug.assert(self.next_entry_id == pending.entry_id); self.next_entry_id +%= 1; self.entries.appendAssumeCapacity(.{ .raw_bytes = .{ .id = pending.entry_id, .created_at_ms = io_mod.milliTimestamp(), .bytes = pending.bytes.?, .class = .command_output, } }); pending.bytes = null; self.command_output_blocks.appendAssumeCapacity(pending.block.?); pending.block = null; self.markTranscriptContentDirtyFrom(pending.entry_id); }
fn latestCommandOutputEntryId(self: *const TranscriptRuntime) ?u32 { var index = self.command_output_blocks.items.len; while (index > 0) { index -= 1; if (self.command_output_blocks.items[index].entry_id) |entry_id| return entry_id; } return null; }
pub fn detailEntryIdForCommandOutputSource( self: *const TranscriptRuntime, source_entry_id: u32, ) ?u32 { for (self.command_output_blocks.items) |block| { var owns_source = block.entry_id == source_entry_id; if (!owns_source) { for (block.source_entry_ids.items) |source_id| { if (source_id == source_entry_id) { owns_source = true; break; } } } if (!owns_source) { for (block.live_entry_ids.items) |live_entry_id| { if (live_entry_id == source_entry_id) { owns_source = true; break; } } } if (!owns_source) continue; const lifecycle_id = block.lifecycle_id orelse return null; for (self.tool_details.items) |detail| { if (command_output_runtime.sameLifecycleId( detail.lifecycle_id, lifecycle_id, )) return detail.entry_id; } return null; } return null; }
fn clearToolDetails(self: *TranscriptRuntime, alloc: Allocator) void { for (self.tool_details.items) |*detail| detail.deinit(alloc); self.tool_details.clearRetainingCapacity(); }
pub fn pruneToolDetailsForRetainedEntries( self: *TranscriptRuntime, alloc: Allocator, retained_entry_ids: *const transcript_store.EntryIdSet, ) void { var write_index: usize = 0; for (self.tool_details.items, 0..) |detail, read_index| { if (!retained_entry_ids.contains(detail.entry_id)) { var removed = detail; removed.deinit(alloc); continue; } if (write_index != read_index) { self.tool_details.items[write_index] = detail; } write_index += 1; } self.tool_details.items.len = write_index; }
pub fn clearFullTranscriptDetails(self: *TranscriptRuntime, alloc: Allocator) void { self.compact_transcript_source_cache.deinit(alloc); self.full_transcript_projection_cache.deinit(alloc); self.clearToolDetails(alloc); self.full_transcript = self.full_transcript.closed(); }
pub fn resetCommandOutputDisplay(self: *TranscriptRuntime, alloc: Allocator, reason: []const u8) void { return command_output_runtime.resetCommandOutputDisplay(self, alloc, reason); }
pub fn retainedStructuredBytesForCommandOutput( self: *const TranscriptRuntime, ) usize { return transcript_store.retainedStructuredBytes(self); }
/// Append a raw-bytes entry. Takes ownership of `bytes` — the slice /// must have been allocated by `alloc` and must not be freed by the /// caller; the entry is freed on `clearTranscript` or `deinit`. /// Returns the stamped entry id. pub fn appendRawBytesEntry(self: *TranscriptRuntime, alloc: Allocator, bytes: []const u8) !u32 { return transcript_store.appendRawBytesEntry(self, alloc, bytes); }
pub fn appendRawBytesEntryClassified( self: *TranscriptRuntime, alloc: Allocator, bytes: []const u8, class: RawEntryClass, ) !u32 { return transcript_store.appendRawBytesEntryClassified(self, alloc, bytes, class); }
pub fn appendRawBytesEntryClassifiedAt( self: *TranscriptRuntime, alloc: Allocator, bytes: []const u8, class: RawEntryClass, created_at_ms: i64, ) !u32 { return transcript_store.appendRawBytesEntryClassifiedAt( self, alloc, bytes, class, created_at_ms, ); }
pub fn insertRawBytesEntryClassifiedAfter( self: *TranscriptRuntime, alloc: Allocator, after_entry_id: u32, bytes: []const u8, class: RawEntryClass, ) !?u32 { return transcript_store.insertRawBytesEntryClassifiedAfter(self, alloc, after_entry_id, bytes, class); }
pub fn insertRawBytesEntryClassifiedAt( self: *TranscriptRuntime, alloc: Allocator, index: usize, bytes: []const u8, class: RawEntryClass, ) !u32 { return transcript_store.insertRawBytesEntryClassifiedAt(self, alloc, index, bytes, class); }
pub fn rowForEntryId(self: *TranscriptRuntime, entry_id: u32) ?u16 { return transcript_viewport_runtime.rowForEntryId(self, entry_id); }
pub fn toolStatusEntryLabel(self: *const TranscriptRuntime, entry_id: u32) ?[]const u8 { return transcript_store.toolStatusEntryLabel(self, entry_id); }
pub fn transientAssistantGapRows(self: *const TranscriptRuntime) u16 { return transcript_viewport_runtime.transientAssistantGapRows(self); }
pub fn needsIdleFooterBottomReservation(self: *const TranscriptRuntime) bool { return transcript_viewport_runtime.needsIdleFooterBottomReservation(self); }
pub fn idleFooterGapOffset(self: *const TranscriptRuntime) u16 { return transcript_viewport_runtime.idleFooterGapOffset(self); }
pub fn bannerFooterGapOffset(self: *const TranscriptRuntime) u16 { return transcript_viewport_runtime.bannerFooterGapOffset(self); }
pub fn preservedBottomReservationRows(self: *const TranscriptRuntime) u16 { return transcript_viewport_runtime.preservedBottomReservationRows(self); }
pub fn trimTrailingBlankLines(self: *TranscriptRuntime) void { return transcript_store.trimTrailingBlankLines(self); }
pub fn appendRawTranscriptEntry(self: *TranscriptRuntime, alloc: Allocator, text: []const u8) !u32 { return transcript_store.appendRawTranscriptEntry(self, alloc, text); }
pub fn appendRawTranscriptEntryClassified( self: *TranscriptRuntime, alloc: Allocator, text: []const u8, class: RawEntryClass, ) !u32 { return transcript_store.appendRawTranscriptEntryClassified(self, alloc, text, class); }
pub fn releaseStartupResumeViewEntry( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, ) !bool { return transcript_store.releaseStartupResumeViewEntry(self, alloc, entry_id); }
pub fn appendTurnSummaryEntry(self: *TranscriptRuntime, alloc: Allocator, summary: types.TurnSummary) !u32 { var line_buf: [128]u8 = undefined; const line = formatTurnSummaryLine(&line_buf, summary); const entry = try std.fmt.allocPrint(alloc, "{s}{s}{s}\n", .{ ui_render.dim_style, line, ui_render.reset_style }); defer alloc.free(entry); const entry_id = try transcript_store.appendRawTranscriptEntryClassified(self, alloc, entry, .turn_summary); if (self.worker_status.clear_recovered_route()) self.render_requests.request(.footer); return entry_id; }
/// Swap the bytes of the `raw_bytes` entry with `entry_id` to a dup of /// `new_bytes` and regenerate the transcript byte buffer. Returns false /// when no such entry exists (e.g. cleared by `clearTranscript`). pub fn updateRawBytesEntry( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, new_bytes: []const u8, ) !bool { return transcript_store.updateRawBytesEntry(self, alloc, entry_id, new_bytes); }
pub fn setRawEntryClass(self: *TranscriptRuntime, entry_id: u32, class: RawEntryClass) bool { return transcript_store.setRawEntryClass(self, entry_id, class); }
pub fn rawEntryClass(self: *const TranscriptRuntime, entry_id: u32) ?RawEntryClass { return transcript_store.rawEntryClass(self, entry_id); }
/// Renders and records one borrowed user turn as a single transcript /// mutation. The caller retains ownership of `user` and `skill_tokens` /// on success and error. pub fn writeUserPromptCard( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, user: types.UserTurn, has_prior_turns: bool, skill_tokens: []const input_visual_layout.SkillTokenSpan, ) !u32 { return transcript_store.writeUserPromptCard( self, alloc, metrics, user, has_prior_turns, skill_tokens, ); }
/// Consumes `turn` regardless of outcome. All owned slices must use `alloc`; /// the entry owns them on success and this method frees them on failure. /// Returns the stamped entry id. pub fn appendUserTurnOwned(self: *TranscriptRuntime, alloc: Allocator, turn: types.UserTurn) !u32 { return transcript_store.appendUserTurnOwned(self, alloc, turn); }
pub fn appendUserTurnOwnedWithSkillTokens( self: *TranscriptRuntime, alloc: Allocator, turn: types.UserTurn, skill_tokens: []const input_visual_layout.SkillTokenSpan, ) !u32 { return transcript_store.appendUserTurnOwnedWithSkillTokens(self, alloc, turn, skill_tokens); }
/// Open a new assistant-turn entry and return its id. Callers that /// need to extend the segments text should re-resolve the pointer /// with `lookupAssistantSegments(id)` immediately before each use; /// a raw segments pointer held across any subsequent `entries` /// append is invalidated by ArrayList realloc. pub fn appendAssistantTurnEntry(self: *TranscriptRuntime, alloc: Allocator) !u32 { return transcript_store.appendAssistantTurnEntry(self, alloc); }
/// Takes ownership of `table` only when it returns successfully. pub fn appendAssistantTableOwned( self: *TranscriptRuntime, alloc: Allocator, table: @import("../../core/agent/assistant_presentation.zig").TablePayload, ) !u32 { return transcript_store.appendAssistantTableOwned(self, alloc, table); }
/// Takes ownership of `block` only when it returns successfully. pub fn appendAssistantCodeBlockOwned( self: *TranscriptRuntime, alloc: Allocator, block: @import("../../core/agent/assistant_presentation.zig").CodeBlockPayload, ) !u32 { return transcript_store.appendAssistantCodeBlockOwned(self, alloc, block); }
pub fn appendAssistantThematicRule(self: *TranscriptRuntime, alloc: Allocator) !u32 { return transcript_store.appendAssistantThematicRule(self, alloc); }
/// Walk `entries` and return a pointer to the segments of the /// assistant-turn entry with `id`, or null if no such entry exists /// (including when `id` belongs to a `raw_bytes` or `user_turn` /// entry). The returned pointer is stable only until the next /// `entries` append; resolve immediately before use. pub fn lookupAssistantSegments(self: *TranscriptRuntime, id: u32) ?*AssistantTurnSegments { return transcript_store.lookupAssistantSegments(self, id); }
/// Return a pointer to the trailing entry's segments if that entry /// is an assistant turn; otherwise null. Used by the pacer to /// append to the in-progress response instead of opening a new /// turn when mid-stream. pub fn tailAssistantSegments(self: *TranscriptRuntime) ?*AssistantTurnSegments { return transcript_store.tailAssistantSegments(self); }
/// Appends paced text to the trailing assistant entry, creating one if needed, /// and mirrors it into the transcript buffer. Using `writeTranscript` here /// would also create raw entries and double-count content during reflow. pub fn streamAssistantChunk( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8, ) !u32 { return transcript_store.streamAssistantChunk(self, alloc, metrics, text); }
pub fn retintEntriesForTheme( self: *TranscriptRuntime, alloc: Allocator, from_light: bool, to_light: bool, ) !void { return transcript_store.retintEntriesForTheme(self, alloc, from_light, to_light); }
pub fn setTranscriptPresentationDepth( self: *TranscriptRuntime, alloc: Allocator, depth: transcript_presentation.Depth, ) !bool { const current = self.full_transcript.depth; if (current == depth) return false; if (current == .inline_mode and depth != .inline_mode) { self.full_transcript_open_content_revision = self.full_transcript_content_revision; self.full_transcript_open_cols = self.layout.cols; self.full_transcript_open_rows = self.layout.rows; try self.captureFullTranscriptAnchor(alloc); } self.full_transcript = self.full_transcript.with_depth(depth); if (depth == .inline_mode) { self.full_transcript_open_content_revision = null; self.full_transcript_open_cols = 0; self.full_transcript_open_rows = 0; self.full_transcript_primary_recovery_entry_id = null; } self.markTranscriptDirty(); return true; }
pub fn fullTranscriptPrimaryRestore(self: *const TranscriptRuntime) FullTranscriptPrimaryRestore { const open_revision = self.full_transcript_open_content_revision orelse return .changed; const same_geometry = self.full_transcript_open_cols == self.layout.cols and self.full_transcript_open_rows == self.layout.rows; const needs_repair = !same_geometry or self.terminal_reset_pending or self.resize_history_row_delta != null; if (open_revision != self.full_transcript_content_revision) { return if (needs_repair) .changed_resized else .changed; } return if (needs_repair) .resized else .exact; }
pub fn prepareRestoredPrimaryTranscriptRecovery( self: *TranscriptRuntime, alloc: Allocator, ) !?[]u8 { const anchor_entry_id = self.full_transcript_primary_recovery_entry_id orelse { debug_trace.logf( "full_transcript_cache", "primary recovery unavailable reason=missing_entry_id revision={d}", .{self.full_transcript_content_revision}, ); return null; }; var source = try self.prepareTranscriptSourceWithFocusedEntry( alloc, anchor_entry_id, ); defer source.deinit(alloc); try source.ensureLineIndex(alloc); const start_line = source.tracked_entry_start_line orelse fullTranscriptRecoveryPredecessorStartLine( source.line_provenance, anchor_entry_id, ) orelse { debug_trace.logf( "full_transcript_cache", "primary recovery unavailable reason=no_visible_predecessor entry_id={d} revision={d}", .{ anchor_entry_id, self.full_transcript_content_revision }, ); return null; }; if (start_line >= source.transcript_visible_lines.len or source.transcript_visible_lines.len != source.transcript_line_visual_rows.len) { debug_trace.logf( "full_transcript_cache", "primary recovery unavailable reason=line_index entry_id={d} start_line={d} visible_lines={d} visual_rows={d}", .{ anchor_entry_id, start_line, source.transcript_visible_lines.len, source.transcript_line_visual_rows.len, }, ); return null; }
const replay = try transcript_painter.prepareResetReplayDocument( self, alloc, source.bytes, source.transcript_visible_lines[start_line..], source.transcript_line_visual_rows[start_line..], source.hard_lines_end_with_newline, self.layout.rows -| self.layout.content_bottom, ); defer if (replay.len > 0) alloc.free(replay);
const clear_visible = "\x1b[0m\x1b[2J\x1b[H"; const recovery = try alloc.alloc(u8, clear_visible.len + replay.len); @memcpy(recovery[0..clear_visible.len], clear_visible); @memcpy(recovery[clear_visible.len..], replay); debug_trace.logf( "full_transcript_cache", "primary recovery prepared entry_id={d} start_line={d} total_lines={d} bytes={d}", .{ anchor_entry_id, start_line, source.transcript_visible_lines.len, recovery.len }, ); return recovery; }
pub fn retainRestoredPrimaryTranscript(self: *TranscriptRuntime) void { self.transcript_band_dirty = false; self.render_requests.clearReason(.transcript); self.render_requests.request(.footer); debug_trace.logf( "full_transcript_cache", "close reused restored primary transcript revision={d}", .{self.full_transcript_content_revision}, ); }
pub fn repaintRestoredPrimaryTranscriptAfterResize(self: *TranscriptRuntime) void { self.terminal_reset_pending = false; self.resize_history_row_delta = null; self.pending_resize_observation = null; self.render_requests.acknowledgeSettledResizeCommit(); self.invalidateTranscriptAnchor("full transcript restored resized primary"); debug_trace.logf( "full_transcript_cache", "close repaints restored resized primary revision={d} layout={d}x{d}", .{ self.full_transcript_content_revision, self.layout.cols, self.layout.rows }, ); }
fn captureFullTranscriptAnchor(self: *TranscriptRuntime, alloc: Allocator) !void { _ = alloc; self.full_transcript = self.full_transcript.clear_anchor(); const fallback_recovery_entry_id = self.primaryRecoveryFallbackEntryId(); self.full_transcript_primary_recovery_entry_id = fallback_recovery_entry_id; const selection = self.last_viewport_selection orelse return; const provenance = self.committedRowProvenance(); var source: ?transcript_blocks.LineProvenance = null; for (provenance) |row| { if (row.row < selection.top_row) continue; source = row.source; break; } const source_entry_id = switch (source orelse return) { .entry => |entry| entry.entry_id, .folded_command_output => |output| output.entry_id, else => null, }; const anchor_entry_id = if (source_entry_id) |entry_id| self.detailEntryIdForCommandOutputSource(entry_id) orelse entry_id else null; self.full_transcript_primary_recovery_entry_id = source_entry_id orelse fallback_recovery_entry_id; self.full_transcript = self.full_transcript.capture_anchor(anchor_entry_id); }
fn primaryRecoveryFallbackEntryId(self: *const TranscriptRuntime) ?u32 { if (self.entries.items.len == 0) return null; const retained_entries = @min( self.entries.items.len, @max(@as(usize, self.layout.rows), 1), ); return self.entries.items[self.entries.items.len - retained_entries].id(); }
fn fullTranscriptRecoveryPredecessorStartLine( provenance: []const transcript_blocks.LineProvenance, target_entry_id: u32, ) ?usize { var candidate_entry_id: ?u32 = null; var candidate_start_line: ?usize = null; for (provenance, 0..) |source, line_index| { const entry_id = switch (source) { .entry => |entry| entry.entry_id, .folded_command_output => |output| output.entry_id orelse continue, else => continue, }; if (entry_id > target_entry_id) continue; if (candidate_entry_id == null or entry_id > candidate_entry_id.?) { candidate_entry_id = entry_id; candidate_start_line = line_index; } } return candidate_start_line; }
pub fn fullTranscriptActive(self: *const TranscriptRuntime) bool { return self.full_transcript.depth.active(); }
pub fn transcriptPresentationDepth( self: *const TranscriptRuntime, ) transcript_presentation.Depth { return self.full_transcript.depth; }
pub fn snapshotFullTranscriptViewport( self: *const TranscriptRuntime, ) transcript_presentation.Snapshot { return self.full_transcript.snapshot(); }
pub fn restoreFullTranscriptViewport( self: *TranscriptRuntime, snapshot: transcript_presentation.Snapshot, ) void { self.full_transcript = .from_snapshot(snapshot); self.markTranscriptDirty(); }
pub fn requestTailViewport( self: *TranscriptRuntime, request: viewport_selection.TailViewportPolicy, ) void { const changed = if (self.tail_viewport_request) |current| !std.meta.eql(current, request) else true; self.tail_viewport_request = request; self.tail_viewport_resolution = null; const has_committed_anchor = switch (self.transcript_commit_state) { .invalid => false, .stable, .recovering => true, }; if (changed and has_committed_anchor) { self.invalidateTranscriptAnchor("tail viewport changed"); } }
pub fn resolvedTailViewport( self: *const TranscriptRuntime, ) ?viewport_selection.TailOffsetResolution { return self.tail_viewport_resolution; }
pub fn closeFullTranscriptState(self: *TranscriptRuntime) void { self.clearCodeCopyFrame(); self.full_transcript = self.full_transcript.closed(); }
pub fn commitCodeCopyFrame( self: *TranscriptRuntime, alloc: Allocator, candidate: *full_transcript_screen.CodeCopyInteractionFrame, ) void { self.full_transcript_code_copy_frame.deinit(alloc); self.full_transcript_code_copy_frame = candidate.*; candidate.* = .{}; }
pub fn codeCopyHit(self: *const TranscriptRuntime, row: u16, col: u16) ?u32 { return self.full_transcript_code_copy_frame.hitTest(row, col); }
pub fn assistantCodeBlockSource(self: *const TranscriptRuntime, entry_id: u32) ?[]const u8 { for (self.entries.items) |entry| { if (entry.id() != entry_id) continue; return switch (entry) { .assistant_code_block => |code_block| code_block.block.code, else => null, }; } return null; }
fn clearCodeCopyFrame(self: *TranscriptRuntime) void { self.full_transcript_code_copy_frame.clear(); }
pub fn fullTranscriptAnchorEntryId(self: *const TranscriptRuntime) ?u32 { return self.full_transcript.anchor_entry_id; }
pub fn retargetFullTranscriptAnchor(self: *TranscriptRuntime, entry_id: u32) void { self.full_transcript = self.full_transcript.retarget_anchor(entry_id); }
pub fn scrollFullTranscript( self: *TranscriptRuntime, direction: input_action.MouseWheel, unit: FullTranscriptScrollUnit, ) void { self.clearCodeCopyFrame(); const rows = switch (unit) { .wheel => full_transcript_wheel_rows, .page => self.fullTranscriptPageRows(), }; const before = self.full_transcript.scroll_rows; self.full_transcript = self.full_transcript.scroll(switch (direction) { .up => .up, .down => .down, }, rows); debug_trace.logf( "full_transcript_cache", "scroll depth={s} direction={s} unit={s} rows={d} before={d} after={d}", .{ @tagName(self.full_transcript.depth), @tagName(direction), @tagName(unit), rows, before, self.full_transcript.scroll_rows, }, ); }
pub const FullTranscriptScrollUnit = enum { wheel, page, };
const full_transcript_wheel_rows: u32 = 3;
fn fullTranscriptPageRows(self: *const TranscriptRuntime) u32 { const first_row = if (self.owned_top_row == 0) 1 else self.owned_top_row; if (self.layout.content_bottom >= first_row) { return @max(@as(u32, 1), @as(u32, self.layout.content_bottom - first_row + 1)); } return 1; }
pub fn initViewport(self: *TranscriptRuntime, metrics: *Metrics, requested_start_row: u16) !void { return transcript_viewport_runtime.initViewport(self, metrics, requested_start_row); }
pub fn initViewportWithReservedRows(self: *TranscriptRuntime, metrics: *Metrics, requested_start_row: u16, min_body_rows: u16) !void { return transcript_viewport_runtime.initViewportWithReservedRows(self, metrics, requested_start_row, min_body_rows); }
pub fn requestTerminalReset(self: *TranscriptRuntime, metrics: *Metrics) !void { const min_body_rows = self.min_visible_viewport_rows; self.reflow_clear_guard_rows = 0; self.resize_history_row_delta = null; self.viewport_clear_pending = false; // Job-control resume (and other full resets) reanchor at row 1. Drop // pending clears recorded against the pre-reset footer geometry — // e.g. eraseCurrentFrame at owned_top mid-scrollback — or the first // post-reset plan validates them against the new compact bands and // aborts with InvalidInvalidationRange. self.render_requests.clearPendingInvalidations(); self.footer_viewport.has_frame = false; self.footer_viewport.clearExternalInvalidation(); self.terminal_reset_pending = true; try self.initViewportWithReservedRows(metrics, 1, min_body_rows); }
pub fn requestTerminalResetAfterResize( self: *TranscriptRuntime, metrics: *Metrics, history_row_delta: ?i32, ) !void { try self.requestTerminalReset(metrics); self.resize_history_row_delta = history_row_delta; }
pub fn reserveVisibleViewportRows(self: *TranscriptRuntime, min_body_rows: u16) void { return transcript_viewport_runtime.reserveVisibleViewportRows(self, min_body_rows); }
pub fn reanchorTop(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics) !void { return transcript_viewport_runtime.reanchorTop(self, alloc, metrics); }
pub fn footerTopRowForExtra(self: TranscriptRuntime, extra: u16) u16 { return transcript_viewport_runtime.footerTopRowForExtra(self, extra); }
pub fn forgetShimmer(self: *TranscriptRuntime) void { self.shimmer_active = false; self.shimmer_is_overlay = false; self.paint_trace.shimmer_row = null; self.paint_trace.shimmer_over_footer = false; self.paint_trace.shimmer_label_hash = 0; }
pub fn transcriptCommitDiagnostic(self: *const TranscriptRuntime) TranscriptCommitDiagnostic { return switch (self.transcript_commit_state) { .invalid => .{ .state = .invalid }, .stable => |anchor| .{ .state = .stable, .stable_start_line = anchor.selection.start_line, .visual_offset = anchor.visual_offset, .layout_id = anchor.layout_id, }, .recovering => |receipt| .{ .state = .recovering, .visual_offset = receipt.accepted_visual_offset, .remaining_inline_rows = @as(u32, receipt.remaining_resize_reflow_rows) + receipt.remaining_semantic_rows, .remaining_unplanned_scroll_rows = receipt.remaining_unplanned_scroll_rows, }, }; }
pub fn stableTranscriptProjectionForFlow( self: *const TranscriptRuntime, rendered_flow: []const u8, ) ?StableTranscriptProjection { const anchor = switch (self.transcript_commit_state) { .stable => |value| value, .invalid, .recovering => return null, }; if (!std.mem.startsWith(u8, rendered_flow, anchor.flow)) return null; return .{ .selection = anchor.selection, .visual_offset = committedProjectionVisualOffset(anchor), .history_visual_offset = anchor.history_visual_offset, .total_visual_rows = anchor.total_visual_rows, .flow_unchanged = rendered_flow.len == anchor.flow.len, .cursor_row = anchor.cursor_row, .cursor_col = anchor.cursor_col, .occupied_last_row = anchor.occupied_last_row, .occupied_last_row_blank = anchor.occupied_last_row_blank, .layout_id = anchor.layout_id, .measured_history_origin = anchor.measured_history_origin, }; }
pub fn measuredResizeProjectionForFlow( self: *const TranscriptRuntime, rendered_flow: []const u8, ) ?MeasuredResizeProjection { return switch (self.transcript_commit_state) { .invalid => null, .stable => if (self.stableTranscriptProjectionForFlow(rendered_flow) != null) .stable else null, .recovering => |receipt| blk: { if (receipt.attempt_cols == 0 or !std.mem.startsWith(u8, rendered_flow, receipt.flow)) { break :blk null; } break :blk .{ .recovering = .{ .accepted_visual_offset = receipt.accepted_visual_offset, .source_cols = receipt.attempt_cols, } }; }, }; }
pub fn measuredHistoryOriginForFlow( self: *const TranscriptRuntime, rendered_flow: []const u8, ) ?transcript_painter.MeasuredHistoryOriginProjection { return switch (self.transcript_commit_state) { .invalid => null, .stable => |anchor| blk: { if (!std.mem.startsWith(u8, rendered_flow, anchor.flow)) { break :blk null; } const origin = anchor.measured_history_origin orelse break :blk null; break :blk .{ .origin = origin, .current_cols = self.committed_frame_layout.terminal_cols, }; }, .recovering => |receipt| blk: { if (!std.mem.startsWith(u8, rendered_flow, receipt.flow)) { break :blk null; } const origin = receipt.measured_history_origin orelse break :blk null; break :blk .{ .origin = origin, .current_cols = receipt.attempt_cols, }; }, }; }
pub fn invalidateTranscriptAnchor(self: *TranscriptRuntime, reason: []const u8) void { const diagnostic = self.transcriptCommitDiagnostic(); if (diagnostic.state != .invalid) { debug_trace.logf( "scroll", "transcript_anchor_invalidate state={s} stable_start={d} visual_offset={d} reason={s}", .{ @tagName(diagnostic.state), diagnostic.stable_start_line orelse 0, diagnostic.visual_offset, reason, }, ); } const alloc = self.shadow_vt_alloc orelse self.detached_commit_alloc orelse { std.debug.assert(self.transcript_commit_state == .invalid); return; }; self.transcript_commit_state.deinit(alloc); }
pub fn reconcileTranscriptCommitSource( self: *TranscriptRuntime, rendered_flow: []const u8, force_rebase: bool, reason: []const u8, ) void { self.reconcileTranscriptCommitSourceWithRewriteMode( rendered_flow, force_rebase, reason, .strict, ); }
pub fn reconcileTranscriptCommitSourceWithRewriteMode( self: *TranscriptRuntime, rendered_flow: []const u8, force_rebase: bool, reason: []const u8, mode: transcript_store.TranscriptSourceRewriteMode, ) void { switch (self.transcript_commit_state) { .invalid => {}, .stable => |*anchor| { const source_compatible = std.mem.startsWith(u8, rendered_flow, anchor.flow); if (force_rebase or !source_compatible) { if (!force_rebase and mode == .preserve_same_epoch) { if (self.structuredRewritePreserveBlocker(anchor.*, rendered_flow)) |blocker| { debug_trace.logf( "scroll", "transcript_anchor_structured_rewrite_fallback blocker={s} reason={s}", .{ blocker, reason }, ); } else { debug_trace.logf( "scroll", "transcript_anchor_structured_rewrite_preserve stable_start={d} visual_offset={d} reason={s}", .{ anchor.selection.start_line, anchor.visual_offset, reason, }, ); anchor.normal_buffer_recovery_pending = true; return; } } self.invalidateTranscriptAnchor(reason); } }, .recovering => |*receipt| { if (!force_rebase and std.mem.startsWith(u8, rendered_flow, receipt.flow)) { return; } receipt.measured_history_origin = null; if (receipt.projection_rebase_pending and !receipt.tracks_semantic_progress and receipt.remaining_semantic_rows == 0 and receipt.remaining_semantic_progress_rows == 0 and !receipt.document_append_committed) { return; } debug_trace.logf( "scroll", "transcript_recovery_source_rebase remaining_resize_reflow_rows={d} dropped_semantic_rows={d} append_committed={s} reason={s}", .{ receipt.remaining_resize_reflow_rows, receipt.remaining_semantic_rows, if (receipt.document_append_committed) "true" else "false", reason, }, ); receipt.remaining_semantic_rows = 0; receipt.remaining_semantic_progress_rows = 0; receipt.projection_rebase_pending = true; receipt.tracks_semantic_progress = false; receipt.document_append_committed = false; }, } }
fn structuredRewritePreserveBlocker( self: *const TranscriptRuntime, anchor: CommittedTranscriptAnchor, rendered_flow: []const u8, ) ?[]const u8 { if (anchor.flow.len == 0) return "empty_anchor"; if (rendered_flow.len == 0) return "empty_rendered_flow"; if (self.resize_history_row_delta != null) return "resize_history_pending"; if (self.layout.cols == 0 or self.layout.rows == 0) return "empty_runtime_layout";
const committed = self.committed_frame_layout; if (anchor.layout_id != committed.layout_id) return "layout_epoch_mismatch"; if (committed.terminal_cols == 0 or committed.terminal_rows == 0) { return "empty_committed_geometry"; } if (committed.terminal_cols != self.layout.cols or committed.terminal_rows != self.layout.rows) { return "geometry_changed"; } if (committed.transcript_area.isEmpty()) return "empty_transcript_area"; if (anchor.visual_offset > anchor.total_visual_rows) return "invalid_visual_offset"; if (anchor.history_visual_offset > anchor.total_visual_rows) { return "invalid_history_visual_offset"; }
return null; }
fn materializedTranscriptProjection( self: *const TranscriptRuntime, source_visual_offset: u32, area: render_engine.frame_layout.FrameRect, ) ?MaterializedTranscriptProjection { const area_rows = if (area.isEmpty()) 0 else area.height(); return switch (self.transcript_commit_state) { .invalid => null, .stable => |anchor| if (committedProjectionVisualOffset(anchor) != source_visual_offset) null else .{ .raw_flow_exact = true, .visual_rows = projectionVisualRowsInArea( anchor.total_visual_rows, committedProjectionVisualOffset(anchor), area, ), }, .recovering => |receipt| if (receipt.materialized_visual_offset != source_visual_offset) null else .{ .raw_flow_exact = receipt.materialized_flow_len != null, .visual_rows = @min( receipt.materialized_visual_rows, area_rows, ), }, }; }
fn plannedTranscriptRows( self: *const TranscriptRuntime, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, source_visual_offset: u32, resize_reflow_rows: u16, semantic_rows: u32, semantic_progress_rows: u32, ) u16 { const semantic_cap = if (self.pending_resume_source != null) resume_publication_rows_per_frame else std.math.maxInt(u32); const planned = frameInlineScrollBudgetCapped( resize_reflow_rows, semantic_rows, semantic_cap, ); if (semantic_rows == 0) return planned;
const materialized = self.materializedTranscriptProjection( source_visual_offset, prepared.projectionArea(), ); if (materialized) |projection| { if (!projection.raw_flow_exact) { return frameInlineScrollBudgetCapped( resize_reflow_rows, semantic_rows, @min(projection.visual_rows, semantic_cap), ); } }
const accepted = acceptedTranscriptRowsForInlineRows( planned, resize_reflow_rows, semantic_rows, semantic_progress_rows, ); if (accepted.semantic_progress_rows == 0) return planned;
const accepts_all_semantic_rows = accepted.semantic_rows == semantic_rows and accepted.semantic_progress_rows == semantic_progress_rows; if (accepts_all_semantic_rows) return planned; const exactness = transcript_painter.preparedTranscriptStagedFlowEndExactness( prepared, self.layout.cols, prepared.projectionArea(), source_visual_offset + accepted.semantic_progress_rows, ); if (exactness == null or exactness.?) return planned;
const projection = materialized orelse return planned; return frameInlineScrollBudgetCapped( resize_reflow_rows, semantic_rows, @min(projection.visual_rows, semantic_cap), ); }
pub fn planTranscriptScroll( self: *const TranscriptRuntime, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, ) TranscriptScrollFacts { return self.planTranscriptScrollForFrame(prepared, false, false); }
/// Selects the finality floor in flow bytes from the prepared paint's /// activity-independent candidates plus the frame-fresh producer facts /// (lifecycle watermark, assistant-tail writability, replaceable tail). /// Null means the whole flow is final. Pure over its inputs, so repeated /// calls within one frame agree. fn finalityFloorBytes( self: *const TranscriptRuntime, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, ) ?usize { return self.transcript_release.finality_floor( prepared.finality_candidates, self.finalizedToolTurnWatermark(), if (prepared.replaceable_last_line) prepared.replaceable_start else null, ); }
/// Visual rows contributed by the flow prefix [0..flow_offset). The /// prefix boundary always lands on an entry start, which is a hard-line /// start; a mid-line offset rounds down to its line, the safe direction. fn preparedVisualRowsForFlowOffset( prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, flow_offset: usize, ) u32 { if (flow_offset == 0) return 0; if (flow_offset >= prepared.bytes.len) return prepared.sourceTotalVisualRows(); const lines = prepared.sourceVisibleLines(); const visual_rows = prepared.sourceVisualRows(); var rows: u32 = 0; for (lines, 0..) |line, index| { switch (line) { .transcript => |t| if (t.ref.ref.start >= flow_offset) return rows, .folded_line => {}, } if (index < visual_rows.len) rows += visual_rows[index]; } return rows; }
/// The largest visual offset whose rows are all backed by final entries, /// clamped to the frame's target offset. Release permission never /// extends past this value. fn finalityReleasableOffset( self: *const TranscriptRuntime, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, target_offset: u32, ) u32 { const floor_bytes = self.finalityFloorBytes(prepared) orelse return target_offset; const floor_rows = preparedVisualRowsForFlowOffset(prepared, floor_bytes); return @min(target_offset, floor_rows); }
pub fn planTranscriptScrollForFrame( self: *const TranscriptRuntime, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, footer_reservation_changed: bool, replay_displaced_footer_history: bool, ) TranscriptScrollFacts { const target_offset = prepared.sourceVisualOffset(); const target_total_visual_rows = prepared.sourceTotalVisualRows(); if (self.terminal_reset_pending) { debug_trace.logf( "scroll", "transcript_transition_plan source_state=reset target_visual_offset={d} target_total_visual_rows={d} planned_rows=0", .{ target_offset, target_total_visual_rows }, ); return .{ .target_visual_offset = target_offset, .recovery_rebase = true, }; } const anchor = switch (self.transcript_commit_state) { .stable => |value| value, .recovering => |receipt| { const source_equal = std.mem.eql(u8, prepared.bytes, receipt.flow); const source_prefix_growth = prepared.bytes.len > receipt.flow.len and std.mem.startsWith(u8, prepared.bytes, receipt.flow); const source_compatible = source_equal or source_prefix_growth; const source_visual_compatible = if (source_equal) target_total_visual_rows == receipt.attempt_total_visual_rows else if (source_prefix_growth) target_total_visual_rows >= receipt.attempt_total_visual_rows else false; const resize_history_compatible = self.resize_history_row_delta == null or (!receipt.attempt_resize_history_committed and self.resize_history_row_delta == receipt.attempt_resize_history_row_delta); const recovery_progress_compatible = source_compatible and source_visual_compatible and receipt.attempt_cols == self.layout.cols and resize_history_compatible; const recovery_rebase = receipt.projection_rebase_pending or !recovery_progress_compatible; const recovery_tracks_semantic_progress = receipt.tracks_semantic_progress and source_compatible; const growth_rows: u32 = if (recovery_progress_compatible and recovery_tracks_semantic_progress and source_prefix_growth) target_total_visual_rows - receipt.attempt_total_visual_rows else 0; const measured_resize_rebase = self.resize_history_row_delta != null and prepared.measured_resize_target_provenance == .recovering; const resize_reflow_rows = if (measured_resize_rebase) 0 else receipt.remaining_resize_reflow_rows; const retained_semantic_rows = if (source_compatible) receipt.remaining_semantic_rows else 0; const retained_semantic_progress_rows = if (recovery_progress_compatible and recovery_tracks_semantic_progress) receipt.remaining_semantic_progress_rows else 0; const candidate_semantic_rows = retained_semantic_rows + growth_rows; const candidate_semantic_progress_rows = retained_semantic_progress_rows + growth_rows; // Retained debt repairs the attempted frame. Only source // growth is a new content release that needs finality. const semantic_rows, const semantic_progress_rows = if (self.finalityFloorBytes(prepared) != null) bounded: { const releasable_offset = self.finalityReleasableOffset( prepared, target_offset, ); const bounded_growth_rows = @min( growth_rows, releasable_offset -| (receipt.accepted_history_visual_offset + retained_semantic_rows), ); const bounded_rows = retained_semantic_rows + bounded_growth_rows; const bounded_progress_growth_rows = @min( growth_rows, releasable_offset -| (receipt.accepted_visual_offset + retained_semantic_progress_rows), ); break :bounded .{ bounded_rows, @min( retained_semantic_progress_rows + bounded_progress_growth_rows, bounded_rows, ), }; } else .{ candidate_semantic_rows, candidate_semantic_progress_rows, }; const acknowledged_visual_offset = receipt.accepted_visual_offset + semantic_progress_rows; const recovery_projection_deferred = recovery_progress_compatible and recovery_tracks_semantic_progress and transcript_painter.preparedTranscriptProjectionExceedsArea( prepared, prepared.projectionArea(), acknowledged_visual_offset, ); const planned_rows = if (recovery_projection_deferred) 0 else self.plannedTranscriptRows( prepared, receipt.accepted_visual_offset, resize_reflow_rows, semantic_rows, semantic_progress_rows, ); debug_trace.logf( "scroll", "transcript_transition_plan source_state=recovering source_visual_offset={d} attempt_visual_offset={d} target_visual_offset={d} attempt_total_visual_rows={d} target_total_visual_rows={d} remaining_resize_reflow_rows={d} remaining_semantic_rows={d} remaining_semantic_progress_rows={d} growth_rows={d} semantic_progress_rows={d} planned_rows={d} source_compatible={s} recovery_progress_compatible={s} recovery_rebase={s} recovery_projection_deferred={s}", .{ receipt.accepted_visual_offset, receipt.attempt_visual_offset, target_offset, receipt.attempt_total_visual_rows, target_total_visual_rows, receipt.remaining_resize_reflow_rows, receipt.remaining_semantic_rows, receipt.remaining_semantic_progress_rows, growth_rows, semantic_progress_rows, planned_rows, if (source_compatible) "true" else "false", if (recovery_progress_compatible) "true" else "false", if (recovery_rebase) "true" else "false", if (recovery_projection_deferred) "true" else "false", }, ); return .{ .source_visual_offset = receipt.accepted_visual_offset, .target_visual_offset = target_offset, .resize_reflow_rows = resize_reflow_rows, .semantic_rows = semantic_rows, .semantic_progress_rows = semantic_progress_rows, .planned_rows = planned_rows, .source_compatible = source_compatible, .recovery_rebase = recovery_rebase, .recovery_progress_compatible = recovery_progress_compatible, .recovery_tracks_semantic_progress = recovery_tracks_semantic_progress, .recovery_projection_deferred = recovery_projection_deferred, }; }, .invalid => { // Materialize authoritative pre-viewport rows into native scrollback. if (self.pendingResumeFlow().len > 0) { const semantic_rows: u32 = frameInlineScrollBudget(0, target_offset); return .{ .target_visual_offset = target_offset, .semantic_rows = semantic_rows, .semantic_progress_rows = semantic_rows, .planned_rows = self.plannedTranscriptRows( prepared, 0, 0, semantic_rows, semantic_rows, ), .source_compatible = true, .recovery_progress_compatible = true, .recovery_tracks_semantic_progress = true, }; } return .{ .target_visual_offset = target_offset, .recovery_rebase = true, }; }, }; const source_equal = std.mem.eql(u8, prepared.bytes, anchor.flow); const source_prefix_growth = prepared.bytes.len > anchor.flow.len and std.mem.startsWith(u8, prepared.bytes, anchor.flow); const source_compatible = source_equal or source_prefix_growth; const source_visual_growth = source_prefix_growth and target_total_visual_rows > anchor.total_visual_rows; const width_stable = self.committed_frame_layout.terminal_cols == 0 or self.committed_frame_layout.terminal_cols == self.layout.cols; const geometry_rebase = footer_reservation_changed and width_stable and self.resize_history_row_delta == null; const displaced_history_replay = if (geometry_rebase and replay_displaced_footer_history) compatibleHistoryReplayRange( prepared, self.layout.cols, prepared.bytes, anchor.flow, anchor.history_visual_offset, target_offset, ) else null; const recovery_rebase = (!source_compatible and !geometry_rebase) or !width_stable or self.resize_history_row_delta != null; // Release requires two independent facts: permission (the rows are // final, expressed by the finality floor) and ability (this frame // materializes their exact bytes, which an incompatible frame // cannot). Either fact missing forces zero release; the frame // re-anchors on the new flow and the derived history debt settles // on the next compatible frame through the existing replay. const releasable_offset = self.finalityReleasableOffset(prepared, target_offset); const releasable_advance = releasable_offset -| anchor.history_visual_offset; const committed_projection_offset = committedProjectionVisualOffset(anchor); const geometry_history_rows: u32 = if (geometry_rebase and ((source_compatible and source_visual_growth) or displaced_history_replay != null)) target_offset -| anchor.history_visual_offset else 0; // Geometry displacement (footer growth over transcript rows) keeps // its pre-existing semantics: displaced rows are preserved into // history even when mutable, because inline rendering has nowhere // else to keep them. The finality clamp governs content-driven // release only. const semantic_rows: u32 = if (geometry_rebase) geometry_history_rows else if (!recovery_rebase) // Normal-buffer recovery restores rows the takeover already // displaced into scrollback; that restore is display repair, // not a content release, so the finality clamp does not apply. if (anchor.normal_buffer_recovery_pending) target_offset -| anchor.history_visual_offset else if (anchor.history_catchup_pending) releasable_advance else // Rows leaving the screen top are [visual..visual+scroll); // the floor clamps that range, so the budget is measured // from the committed viewport, not from history. releasable_offset -| anchor.visual_offset else if (self.compatibleCommittedHistoryReplayRange( prepared, anchor, prepared.bytes, releasable_offset, ) != null) releasable_advance else 0; // A finality hold is either the floor sitting below the viewport // (mutable rows above the top) or a same-geometry incompatible frame // that had permission to release but no ability to materialize; // geometry-driven recovery (resize, reflow) owns its own debt. const finality_hold = releasable_offset < target_offset or (recovery_rebase and width_stable and self.committed_frame_layout.terminal_rows == self.layout.rows and self.resize_history_row_delta == null and releasable_offset > anchor.history_visual_offset +| semantic_rows); const semantic_progress_rows: u32 = if (source_compatible or geometry_rebase) semantic_rows else 0; const resize_reflow_candidate = self.calculateAnchorResizeReflowScrollRows(prepared.selection); const measured_boundary_row_pending = self.resize_history_row_delta != null and self.fullTranscriptActive() and resize_reflow_candidate == 1; const resize_reflow_rows = if (self.resize_history_row_delta == null or measured_boundary_row_pending) resize_reflow_candidate else 0; const planned = self.plannedTranscriptRows( prepared, committed_projection_offset, resize_reflow_rows, semantic_rows, semantic_rows, ); debug_trace.logf( "scroll", "transcript_transition_plan source_state=stable source_start={d} target_start={d} source_visual_offset={d} source_history_visual_offset={d} target_visual_offset={d} releasable_visual_offset={d} source_total_visual_rows={d} target_total_visual_rows={d} resize_reflow_candidate={d} resize_reflow_rows={d} semantic_rows={d} planned_rows={d} width_stable={s} source_compatible={s} footer_reservation_changed={s} replay_displaced_footer_history={s} geometry_rebase={s} recovery_rebase={s}", .{ anchor.selection.start_line, prepared.selection.start_line, anchor.visual_offset, anchor.history_visual_offset, target_offset, releasable_offset, anchor.total_visual_rows, target_total_visual_rows, resize_reflow_candidate, resize_reflow_rows, semantic_rows, planned, if (width_stable) "true" else "false", if (source_compatible) "true" else "false", if (footer_reservation_changed) "true" else "false", if (replay_displaced_footer_history) "true" else "false", if (geometry_rebase) "true" else "false", if (recovery_rebase) "true" else "false", }, ); return .{ .source_visual_offset = committed_projection_offset, .target_visual_offset = target_offset, .resize_reflow_rows = resize_reflow_rows, .semantic_rows = semantic_rows, .semantic_progress_rows = semantic_progress_rows, .planned_rows = planned, .source_compatible = source_compatible, .geometry_rebase = geometry_rebase, .recovery_rebase = recovery_rebase, .finality_hold = finality_hold, .recovery_progress_compatible = !recovery_rebase, .recovery_tracks_semantic_progress = source_compatible or geometry_rebase, }; }
fn calculateAnchorResizeReflowScrollRows( self: *const TranscriptRuntime, next_selection: ViewportSelection, ) u16 { const anchor = switch (self.transcript_commit_state) { .stable => |value| value, .invalid, .recovering => return 0, }; const committed = self.committed_frame_layout; if (anchor.layout_id != committed.layout_id or !self.viewport_clear_pending or self.owned_top_row != 1 or committed.transcript_area.top != 1 or next_selection.top_row != 1 or next_selection.bottom_row < next_selection.top_row or self.layout.cols == 0 or self.layout.rows == 0 or committed.terminal_cols == 0 or committed.terminal_rows == 0 or self.layout.cols >= committed.terminal_cols) { return 0; }
const shadow = self.shadow_vt orelse return 0; if (shadow.cols != committed.terminal_cols or shadow.rows != committed.terminal_rows or committed.transcript_area.isEmpty() or shadow.cursor_row <= committed.transcript_area.bottom) { return 0; }
const cursor_reflowed_row = reflowedRows( shadow, 1, shadow.cursor_row, self.layout.cols, true, ); if (cursor_reflowed_row <= self.layout.rows) return 0;
const chrome_rows = reflowedRows( shadow, committed.transcript_area.bottom + 1, shadow.cursor_row, self.layout.cols, true, ); const physical_transcript_rows = @as(u32, self.layout.rows) -| chrome_rows; const target_transcript_rows = @as(u32, next_selection.bottom_row) - next_selection.top_row + 1; return @intCast(@min( physical_transcript_rows -| target_transcript_rows, @as(u32, std.math.maxInt(u16)), )); }
const TransitionTarget = struct { body_disposition: TranscriptBodyDisposition = .paint, selection: ViewportSelection, visual_offset: u32, history_visual_offset: u32, source_endpoint_visual_offset: u32, total_visual_rows: u32, cursor_row: u16, cursor_col: u16, measured_history_origin: ?transcript_painter.MeasuredHistoryOrigin, normal_buffer_recovery_pending: bool = false, history_catchup_pending: bool = false, staged_flow_end: ?usize = null, projection_staged: bool = false, // The frame slides the viewport past withheld release with an // in-place repaint. Any document append is bounded separately to // the rows the frame may release. hold_staged: bool = false,
fn init( prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, scroll_facts: TranscriptScrollFacts, ) TransitionTarget { return .{ .selection = prepared.selection, .visual_offset = scroll_facts.target_visual_offset, .history_visual_offset = scroll_facts.target_visual_offset, .source_endpoint_visual_offset = scroll_facts.target_visual_offset, .total_visual_rows = prepared.sourceTotalVisualRows(), .cursor_row = prepared.cursor.cursor_row, .cursor_col = prepared.cursor.cursor_col, .measured_history_origin = prepared.measured_history_origin, }; }
fn retainCommittedAnchor( self: *TransitionTarget, anchor: CommittedTranscriptAnchor, retained: RetainedTranscriptBody, ) void { self.body_disposition = .{ .retain_committed = retained }; self.selection = anchor.selection; self.visual_offset = anchor.visual_offset; self.history_visual_offset = anchor.history_visual_offset; self.normal_buffer_recovery_pending = anchor.normal_buffer_recovery_pending; self.total_visual_rows = anchor.total_visual_rows; self.cursor_row = anchor.cursor_row; self.cursor_col = anchor.cursor_col; }
fn usePreparedProjection( self: *TransitionTarget, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, ) void { self.selection = prepared.selection; self.cursor_row = prepared.cursor.cursor_row; self.cursor_col = prepared.cursor.cursor_col; }
fn stagePreparedProjection( self: *TransitionTarget, alloc: Allocator, layout: Layout, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, target_area: render_engine.frame_layout.FrameRect, visual_offset: u32, ) !void { self.visual_offset = visual_offset; if (visual_offset == self.total_visual_rows) { try transcript_painter.reprojectPreparedTranscriptForVisualOffset( alloc, layout, prepared, target_area, visual_offset, ); self.staged_flow_end = transcript_painter.preparedTranscriptFlowOffsetForVisualOffset( prepared, layout.cols, visual_offset, ); } else { const staged = try transcript_painter.stagePreparedTranscriptForVisualOffset( alloc, layout, prepared, target_area, visual_offset, ); self.staged_flow_end = staged.flow_end; } self.projection_staged = true; self.usePreparedProjection(prepared); }
fn stagePreparedHistoryProjection( self: *TransitionTarget, alloc: Allocator, layout: Layout, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, target_area: render_engine.frame_layout.FrameRect, ) !void { const logical_visual_offset = self.visual_offset; try self.stagePreparedProjection( alloc, layout, prepared, target_area, self.history_visual_offset, ); self.visual_offset = logical_visual_offset; self.source_endpoint_visual_offset = self.history_visual_offset; } };
pub const ResolvedTranscriptTarget = struct { target: TransitionTarget, target_layout: render_engine.frame_layout.CommittedLayoutSnapshot, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, scroll_facts: TranscriptScrollFacts, accepted: AcceptedTranscriptRows, source_endpoint_cursor_row: u16, source_endpoint_cursor_col: u16, destructive_invalidation: bool, activity_overlay_active: bool, borrows_pending_resume: bool,
pub fn selection(self: ResolvedTranscriptTarget) ViewportSelection { return self.target.selection; }
pub fn cursorRow(self: ResolvedTranscriptTarget) u16 { return self.target.cursor_row; }
pub fn cursorCol(self: ResolvedTranscriptTarget) u16 { return self.target.cursor_col; }
pub fn bodyDisposition(self: ResolvedTranscriptTarget) TranscriptBodyDisposition { return self.target.body_disposition; }
pub fn occupiedTranscriptRows(self: ResolvedTranscriptTarget) u16 { const area = self.target_layout.transcript_area; if (area.isEmpty() or self.target.selection.last_visible_row < area.top) return 0; return self.target.selection.last_visible_row - area.top + 1; }
pub fn applyToPaintPlan( self: ResolvedTranscriptTarget, plan: *render_engine.paint_plan.PaintPlan, ) void { plan.viewport = self.target.selection; if (plan.cursor_target) |*cursor| { cursor.row = self.target.cursor_row; cursor.col = self.target.cursor_col; } } };
fn stableRetainedTransitionBody( self: *const TranscriptRuntime, anchor: CommittedTranscriptAnchor, source_bytes: []const u8, target_layout: render_engine.frame_layout.CommittedLayoutSnapshot, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, destructive_invalidation: bool, activity_overlay_active: bool, ) ?RetainedTranscriptBody { return render_engine.frame_retention.stableRetainedTranscriptBody(.{ .full_transcript_active = self.fullTranscriptActive(), .committed_layout_id = anchor.layout_id, .committed_flow = anchor.flow, .committed_occupied_last_row = anchor.occupied_last_row, .source_layout = self.committed_frame_layout, .source_bytes = source_bytes, .target_layout = target_layout, .scroll_plan = scroll_plan, .destructive_invalidation = destructive_invalidation, .activity_overlay_active = activity_overlay_active, }); }
fn paintedStableTargetWouldRewind( self: *const TranscriptRuntime, target: TransitionTarget, anchor: CommittedTranscriptAnchor, scroll_facts: TranscriptScrollFacts, destructive_invalidation: bool, ) bool { const same_width = self.committed_frame_layout.terminal_cols == self.layout.cols; return !self.fullTranscriptActive() and target.body_disposition == .paint and scroll_facts.source_compatible and !scroll_facts.geometry_rebase and same_width and self.resize_history_row_delta == null and !destructive_invalidation and target.visual_offset >= target.history_visual_offset and scroll_facts.target_visual_offset < anchor.visual_offset; }
fn semanticProgressNeedsStaging( target: TransitionTarget, scroll_facts: TranscriptScrollFacts, accepted_semantic_progress_rows: u32, ) bool { return target.body_disposition == .paint and !scroll_facts.recovery_rebase and scroll_facts.recovery_tracks_semantic_progress and accepted_semantic_progress_rows < scroll_facts.semantic_progress_rows; }
fn stableHistoryFloor( self: *const TranscriptRuntime, target: TransitionTarget, anchor: CommittedTranscriptAnchor, scroll_facts: TranscriptScrollFacts, ) ?u32 { const stable_terminal_geometry = self.committed_frame_layout.terminal_cols == self.layout.cols and self.committed_frame_layout.terminal_rows == self.layout.rows; if (self.fullTranscriptActive() or target.body_disposition != .paint or !stable_terminal_geometry or self.resize_history_row_delta != null) { return null; } if (target.visual_offset < target.history_visual_offset) { return target.history_visual_offset; } const committed_offset = committedProjectionVisualOffset(anchor); if (!scroll_facts.source_compatible and target.visual_offset < committed_offset and target.total_visual_rows > committed_offset) { return committed_offset; } return null; }
fn recoveringCanAdvanceSemanticProgress(scroll_facts: TranscriptScrollFacts) bool { return scroll_facts.recovery_progress_compatible and scroll_facts.recovery_tracks_semantic_progress and !scroll_facts.recovery_projection_deferred; }
fn resolveTransitionTarget( self: *const TranscriptRuntime, alloc: Allocator, source_bytes: []const u8, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, target_layout: render_engine.frame_layout.CommittedLayoutSnapshot, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, scroll_facts: TranscriptScrollFacts, accepted_semantic_rows: u32, accepted_semantic_progress_rows: u32, destructive_invalidation: bool, activity_overlay_active: bool, ) !TransitionTarget { var target = TransitionTarget.init(prepared, scroll_facts); switch (self.transcript_commit_state) { .stable => |anchor| { target.history_visual_offset = @min( target.total_visual_rows, anchor.history_visual_offset +| accepted_semantic_rows, ); target.normal_buffer_recovery_pending = anchor.normal_buffer_recovery_pending; target.history_catchup_pending = anchor.history_catchup_pending; // A retained body advances only by the released rows. When // the finality clamp withholds release from the plan itself // (as opposed to a partial acceptance, which the recovery // debt machinery owns), the viewport must still follow the // flow, so the frame repaints instead of retaining. const plan_covers_advance = scroll_facts.target_visual_offset -| committedProjectionVisualOffset(anchor) <= scroll_facts.semantic_rows; if (!scroll_facts.geometry_rebase and plan_covers_advance) { if (self.stableRetainedTransitionBody( anchor, source_bytes, target_layout, scroll_plan, destructive_invalidation, activity_overlay_active, )) |retained| { target.retainCommittedAnchor(anchor, retained); } } if (self.paintedStableTargetWouldRewind( target, anchor, scroll_facts, destructive_invalidation, )) { return error.InvalidTranscriptTransition; } if (semanticProgressNeedsStaging( target, scroll_facts, accepted_semantic_progress_rows, )) { try target.stagePreparedProjection( alloc, self.layout, prepared, target_layout.transcript_area, scroll_facts.source_visual_offset + accepted_semantic_progress_rows, ); } if (target.normal_buffer_recovery_pending and scroll_facts.source_compatible and target.visual_offset > target.history_visual_offset) { try target.stagePreparedHistoryProjection( alloc, self.layout, prepared, target_layout.transcript_area, ); } if (target.normal_buffer_recovery_pending and scroll_facts.geometry_rebase and target.history_visual_offset >= target.visual_offset) { target.normal_buffer_recovery_pending = false; } if (!target.projection_staged and target.body_disposition == .paint and !scroll_facts.geometry_rebase and !scroll_facts.recovery_rebase and !self.fullTranscriptActive() and !prepared.selection.split_active and !target_layout.transcript_area.isEmpty() and scroll_facts.target_visual_offset -| committedProjectionVisualOffset(anchor) > scroll_facts.semantic_rows and scroll_facts.target_visual_offset >= target.history_visual_offset) { // The viewport advanced further than the plan may // release: slide the window with an in-place repaint at // the target offset. The rows passed over stay // unreleased and settle later through the replay. var projection_layout = self.layout; projection_layout.content_bottom = target_layout.transcript_area.bottom; try target.stagePreparedProjection( alloc, projection_layout, prepared, target_layout.transcript_area, scroll_facts.target_visual_offset, ); target.hold_staged = true; debug_trace.logf( "scroll", "transcript_transition_hold_release target_visual_offset={d} history_visual_offset={d} semantic_rows={d}", .{ scroll_facts.target_visual_offset, target.history_visual_offset, scroll_facts.semantic_rows, }, ); } if (self.stableHistoryFloor(target, anchor, scroll_facts)) |history_floor| { var projection_layout = self.layout; projection_layout.content_bottom = target_layout.transcript_area.bottom; try target.stagePreparedProjection( alloc, projection_layout, prepared, target_layout.transcript_area, history_floor, ); target.source_endpoint_visual_offset = history_floor; debug_trace.logf( "scroll", "transcript_transition_hold_history_floor source_visual_offset={d} target_visual_offset={d}", .{ history_floor, scroll_facts.target_visual_offset }, ); } if (scroll_facts.geometry_rebase) { target.history_catchup_pending = target.visual_offset > target.history_visual_offset; } else if (target.history_visual_offset >= target.visual_offset) { target.history_catchup_pending = false; } else if (scroll_facts.finality_hold) { // Finality withheld release. Preserve the obligation on // stable anchors until history catches the viewport; // footer displacement alone never creates one. target.history_catchup_pending = true; } }, .recovering => |receipt| { target.history_visual_offset = @min( target.total_visual_rows, receipt.accepted_history_visual_offset +| accepted_semantic_rows, ); target.normal_buffer_recovery_pending = receipt.normal_buffer_recovery_pending; if (recoveringCanAdvanceSemanticProgress(scroll_facts)) { target.visual_offset = scroll_facts.source_visual_offset + accepted_semantic_progress_rows; if (accepted_semantic_progress_rows < scroll_facts.semantic_progress_rows) { try target.stagePreparedProjection( alloc, self.layout, prepared, target_layout.transcript_area, target.visual_offset, ); } else { try transcript_painter.reprojectPreparedTranscriptForVisualOffset( alloc, self.layout, prepared, target_layout.transcript_area, target.visual_offset, ); target.usePreparedProjection(prepared); } } }, .invalid => if (semanticProgressNeedsStaging( target, scroll_facts, accepted_semantic_progress_rows, )) { try target.stagePreparedProjection( alloc, self.layout, prepared, target_layout.transcript_area, accepted_semantic_progress_rows, ); }, } if (target.measured_history_origin == null and !prepared.measured_history_origin_consumed and scroll_facts.source_compatible and !destructive_invalidation) { target.measured_history_origin = switch (self.transcript_commit_state) { .invalid => null, .stable => |anchor| anchor.measured_history_origin, .recovering => |receipt| receipt.measured_history_origin, }; } if (!scroll_facts.source_compatible) { target.measured_history_origin = null; } return target; }
const TransitionHistoryReplay = struct { flow_start: usize, flow_end: usize, clear_rows: u16, };
fn committedLayoutMatches( self: *const TranscriptRuntime, anchor: CommittedTranscriptAnchor, ) bool { return anchor.layout_id == self.committed_frame_layout.layout_id and self.committed_frame_layout.terminal_cols == self.layout.cols and self.committed_frame_layout.terminal_rows == self.layout.rows; }
fn compatibleHistoryReplayRange( prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, cols: u16, target_flow: []const u8, committed_flow: []const u8, source_history_visual_offset: u32, target_history_visual_offset: u32, ) ?TransitionHistoryReplay { if (target_history_visual_offset <= source_history_visual_offset) return null; const flow_start = transcript_painter.preparedTranscriptFlowOffsetForVisualOffset( prepared, cols, source_history_visual_offset, ) orelse return null; const flow_end = transcript_painter.preparedTranscriptFlowOffsetForVisualOffset( prepared, cols, target_history_visual_offset, ) orelse return null; if (flow_end <= flow_start or flow_start > committed_flow.len) return null; const overlap_end = @min(flow_end, committed_flow.len); if (overlap_end > target_flow.len or !std.mem.eql( u8, target_flow[0..overlap_end], committed_flow[0..overlap_end], )) { return null; } const clear_rows = std.math.cast( u16, target_history_visual_offset - source_history_visual_offset, ) orelse return null; return .{ .flow_start = flow_start, .flow_end = flow_end, .clear_rows = clear_rows, }; }
fn compatibleCommittedHistoryReplayRange( self: *const TranscriptRuntime, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, anchor: CommittedTranscriptAnchor, target_flow: []const u8, target_history_visual_offset: u32, ) ?TransitionHistoryReplay { if (!self.committedLayoutMatches(anchor)) return null; if (self.resize_history_row_delta != null) return null; return compatibleHistoryReplayRange( prepared, self.layout.cols, target_flow, anchor.flow, anchor.history_visual_offset, target_history_visual_offset, ); }
const TransitionAppendBase = struct { flow_len: usize, history_replay: ?TransitionHistoryReplay = null, visual_offset: u32, visual_rows: u16, cursor_row: u16, cursor_col: u16, };
fn resolveTransitionAppendBase( self: *const TranscriptRuntime, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, scroll_facts: TranscriptScrollFacts, destructive_invalidation: bool, target_flow: []const u8, target_history_visual_offset: u32, ) !?TransitionAppendBase { switch (self.transcript_commit_state) { .stable => |anchor| { if (!destructive_invalidation) { const replay_from_history = target_history_visual_offset > anchor.history_visual_offset and (scroll_facts.geometry_rebase or anchor.normal_buffer_recovery_pending or anchor.history_catchup_pending); if (replay_from_history) { const replay = self.compatibleCommittedHistoryReplayRange( prepared, anchor, target_flow, target_history_visual_offset, ); if (replay) |history_replay| { return .{ .flow_len = history_replay.flow_start, .history_replay = history_replay, .visual_offset = anchor.history_visual_offset, .visual_rows = projectionVisualRowsInArea( anchor.total_visual_rows, anchor.history_visual_offset, self.committed_frame_layout.transcript_area, ), .cursor_row = self.committed_frame_layout.transcript_area.top, .cursor_col = 1, }; } } if (self.committedLayoutMatches(anchor) and target_flow.len >= anchor.flow.len and std.mem.startsWith(u8, target_flow, anchor.flow)) { return .{ .flow_len = anchor.flow.len, .visual_offset = committedProjectionVisualOffset(anchor), .visual_rows = projectionVisualRowsInArea( anchor.total_visual_rows, committedProjectionVisualOffset(anchor), self.committed_frame_layout.transcript_area, ), .cursor_row = anchor.cursor_row, .cursor_col = anchor.cursor_col, }; } } }, .recovering => |receipt| { if (scroll_facts.recovery_progress_compatible and scroll_facts.recovery_tracks_semantic_progress and !scroll_facts.recovery_rebase and self.committed_frame_layout.terminal_cols == self.layout.cols and self.committed_frame_layout.terminal_rows == self.layout.rows and receipt.materialized_flow_len != null) { const materialized_flow_len = receipt.materialized_flow_len.?; if (recoveryAppendPrefixMatches( target_flow, receipt, materialized_flow_len, )) { return .{ .flow_len = materialized_flow_len, .visual_offset = receipt.materialized_visual_offset, .visual_rows = receipt.materialized_visual_rows, .cursor_row = receipt.cursor_row, .cursor_col = receipt.cursor_col, }; } } }, .invalid => if (self.pendingResumeFlow().len > 0 and !destructive_invalidation and self.committed_frame_layout.terminal_cols == self.layout.cols and self.committed_frame_layout.terminal_rows == self.layout.rows) { return .{ .flow_len = 0, .visual_offset = 0, .visual_rows = 0, .cursor_row = prepared.projectionArea().top, .cursor_col = 1, }; }, } return null; }
const PlannedHistoryMaterialization = struct { visual_offset: u32, normal_buffer_recovery_pending: bool, };
fn resolvePlannedHistoryMaterialization( source_visual_offset: u32, target_visual_offset: u32, target_projection_offset: u32, document_append_planned: bool, recovery_pending: bool, ) PlannedHistoryMaterialization { if (!recovery_pending) { return .{ .visual_offset = target_visual_offset, .normal_buffer_recovery_pending = false, }; } if (target_visual_offset <= source_visual_offset) { return .{ .visual_offset = target_visual_offset, .normal_buffer_recovery_pending = recovery_pending, }; } if (document_append_planned) { return .{ .visual_offset = target_visual_offset, .normal_buffer_recovery_pending = recovery_pending and target_visual_offset < target_projection_offset, }; } return .{ .visual_offset = source_visual_offset, .normal_buffer_recovery_pending = true, }; }
test "history offset advances only when transcript bytes are materialized" { const deferred = resolvePlannedHistoryMaterialization( 4, 12, 12, false, true, ); try std.testing.expectEqual(@as(u32, 4), deferred.visual_offset); try std.testing.expect(deferred.normal_buffer_recovery_pending);
const caught_up = resolvePlannedHistoryMaterialization( 4, 12, 12, true, true, ); try std.testing.expectEqual(@as(u32, 12), caught_up.visual_offset); try std.testing.expect(!caught_up.normal_buffer_recovery_pending);
const bounded = resolvePlannedHistoryMaterialization( 4, 8, 12, true, true, ); try std.testing.expectEqual(@as(u32, 8), bounded.visual_offset); try std.testing.expect(bounded.normal_buffer_recovery_pending); }
fn resolveMaterializedEndpoint( target: TransitionTarget, source_endpoint_cursor_row: u16, source_endpoint_cursor_col: u16, append_base: ?TransitionAppendBase, projected_flow_end: ?usize, target_flow_len: usize, transcript_area: render_engine.frame_layout.FrameRect, ) MaterializedEndpoint { var endpoint: MaterializedEndpoint = .{ .visual_offset = target.history_visual_offset, .visual_rows = projectionVisualRowsInArea( target.total_visual_rows, target.history_visual_offset, transcript_area, ), .flow_len = projected_flow_end, .cursor_row = target.cursor_row, .cursor_col = target.cursor_col, }; const base = append_base orelse return endpoint; const flow_end = projected_flow_end orelse return endpoint; if (base.flow_len < flow_end) return endpoint;
endpoint.flow_len = base.flow_len; if (base.flow_len == target_flow_len) { endpoint.visual_offset = target.source_endpoint_visual_offset; endpoint.visual_rows = projectionVisualRowsInArea( target.total_visual_rows, target.source_endpoint_visual_offset, transcript_area, ); endpoint.cursor_row = source_endpoint_cursor_row; endpoint.cursor_col = source_endpoint_cursor_col; } else { endpoint.visual_offset = base.visual_offset; endpoint.visual_rows = base.visual_rows; endpoint.cursor_row = base.cursor_row; endpoint.cursor_col = base.cursor_col; } return endpoint; }
fn materializedEndpointWithoutAppend( self: *const TranscriptRuntime, document_append: render_engine.frame_scroll_plan.FrameDocumentAppend, planned: MaterializedEndpoint, ) MaterializedEndpoint { return switch (self.transcript_commit_state) { .stable => |anchor| .{ .visual_offset = committedProjectionVisualOffset(anchor), .visual_rows = projectionVisualRowsInArea( anchor.total_visual_rows, committedProjectionVisualOffset(anchor), self.committed_frame_layout.transcript_area, ), .flow_len = anchor.flow.len, .cursor_row = anchor.cursor_row, .cursor_col = anchor.cursor_col, }, .recovering => |receipt| .{ .visual_offset = receipt.materialized_visual_offset, .visual_rows = receipt.materialized_visual_rows, .flow_len = receipt.materialized_flow_len, .cursor_row = receipt.cursor_row, .cursor_col = receipt.cursor_col, }, .invalid => if (document_append.isEmpty()) planned else .{ .visual_offset = 0, .visual_rows = 0, .flow_len = 0, .cursor_row = document_append.start_row, .cursor_col = document_append.start_col, }, }; }
fn borrowsPendingResumeSource( self: *const TranscriptRuntime, source: *const TranscriptPreparationSource, ) bool { return if (self.pending_resume_source) |*pending| source == pending else false; }
pub fn prepareTranscriptScrollFactsForFrame( self: *const TranscriptRuntime, alloc: Allocator, source: *const TranscriptPreparationSource, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, footer_reservation_changed: bool, replay_displaced_footer_history: bool, ) !TranscriptScrollFacts { if (self.borrowsPendingResumeSource(source)) switch (self.transcript_commit_state) { .invalid => try transcript_painter.seedPreparedPresentationBoundary( alloc, prepared, 0, .{}, ), .recovering => |receipt| if (receipt.presentation_valid and receipt.materialized_flow_len != null) { try transcript_painter.seedPreparedPresentationBoundary( alloc, prepared, receipt.materialized_flow_len.?, .{ .resume_bytes = receipt.presentation_resume_bytes, .cursor_col = receipt.cursor_col, .pending_wrap = receipt.presentation_pending_wrap, }, ); }, .stable => {}, }; return self.planTranscriptScrollForFrame( prepared, footer_reservation_changed, replay_displaced_footer_history, ); }
pub fn resolveTranscriptTransitionTargetForFrame( self: *const TranscriptRuntime, alloc: Allocator, source: *const TranscriptPreparationSource, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, target_layout: render_engine.frame_layout.CommittedLayoutSnapshot, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, scroll_facts: TranscriptScrollFacts, destructive_invalidation: bool, activity_overlay_active: bool, ) !ResolvedTranscriptTarget { try scroll_plan.validate(self.layout.rows); if (scroll_plan.requested_inline_advance_rows != scroll_facts.planned_rows) { return error.InvalidFrameScrollPlan; } const accepted = acceptedTranscriptRows( scroll_plan, scroll_plan.terminal_scroll_rows, scroll_facts.resize_reflow_rows, scroll_facts.semantic_rows, scroll_facts.semantic_progress_rows, ); const source_endpoint_cursor_row = prepared.cursor.cursor_row; const source_endpoint_cursor_col = prepared.cursor.cursor_col; const target = self.resolveTransitionTarget( alloc, source.bytes, prepared, target_layout, scroll_plan, scroll_facts, accepted.semantic_rows, accepted.semantic_progress_rows, destructive_invalidation, activity_overlay_active, ) catch |err| { const normal_buffer_recovery_pending = switch (self.transcript_commit_state) { .stable => |anchor| anchor.normal_buffer_recovery_pending, .recovering => |receipt| receipt.normal_buffer_recovery_pending, .invalid => false, }; debug_trace.logf( "scroll", "transcript_target_resolution_failed err={s} source_compatible={s} geometry_rebase={s} recovery_rebase={s} normal_buffer_recovery_pending={s} target_visual_offset={d}", .{ @errorName(err), if (scroll_facts.source_compatible) "true" else "false", if (scroll_facts.geometry_rebase) "true" else "false", if (scroll_facts.recovery_rebase) "true" else "false", if (normal_buffer_recovery_pending) "true" else "false", scroll_facts.target_visual_offset, }, ); return err; }; if (!target_layout.transcript_area.isEmpty() and target.selection.last_visible_row > target_layout.transcript_area.bottom) { debug_trace.logf( "scroll", "transcript_target_outside_candidate last_visible={d} target_area={d}..{d} body_disposition={s}", .{ target.selection.last_visible_row, target_layout.transcript_area.top, target_layout.transcript_area.bottom, @tagName(target.body_disposition), }, ); return error.InvalidTranscriptTransition; } return .{ .target = target, .target_layout = target_layout, .scroll_plan = scroll_plan, .scroll_facts = scroll_facts, .accepted = accepted, .source_endpoint_cursor_row = source_endpoint_cursor_row, .source_endpoint_cursor_col = source_endpoint_cursor_col, .destructive_invalidation = destructive_invalidation, .activity_overlay_active = activity_overlay_active, .borrows_pending_resume = self.borrowsPendingResumeSource(source), }; }
pub fn finalizeTranscriptTransitionForFrame( self: *TranscriptRuntime, alloc: Allocator, source: *TranscriptPreparationSource, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, target_layout: render_engine.frame_layout.CommittedLayoutSnapshot, plan: *render_engine.paint_plan.PaintPlan, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, footer_reservation_changed: bool, replay_displaced_footer_history: bool, ) !TranscriptTransition { const scroll_facts = try self.prepareTranscriptScrollFactsForFrame( alloc, source, prepared, footer_reservation_changed, replay_displaced_footer_history, ); const destructive_invalidation = render_engine.frame_retention.transcriptAreaHasDestructiveInvalidation( self.committed_frame_layout.transcript_area, plan.invalidation, ); const resolved = try self.resolveTranscriptTransitionTargetForFrame( alloc, source, prepared, target_layout, scroll_plan, scroll_facts, destructive_invalidation, plan.activity == .overlay_entry, ); resolved.applyToPaintPlan(plan); return self.sealTranscriptTransition( alloc, source, prepared, plan, resolved, ); }
pub fn sealTranscriptTransition( self: *TranscriptRuntime, alloc: Allocator, source: *TranscriptPreparationSource, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, plan: *const render_engine.paint_plan.PaintPlan, resolved: ResolvedTranscriptTarget, ) !TranscriptTransition { try resolved.scroll_plan.validate(self.layout.rows); const plan_layout = render_engine.frame_layout.CommittedLayoutSnapshot.fromPaintPlan(plan.*); if (!std.meta.eql(plan_layout, resolved.target_layout) or !std.meta.eql(plan.viewport, resolved.target.selection) or (plan.activity == .overlay_entry) != resolved.activity_overlay_active) { return error.InvalidTranscriptTransition; } const destructive_invalidation = render_engine.frame_retention.transcriptAreaHasDestructiveInvalidation( self.committed_frame_layout.transcript_area, plan.invalidation, ); if (destructive_invalidation != resolved.destructive_invalidation or self.borrowsPendingResumeSource(source) != resolved.borrows_pending_resume) { return error.InvalidTranscriptTransition; } switch (resolved.target.body_disposition) { .paint => if (!std.meta.eql(prepared.selection, resolved.target.selection) or prepared.cursor.cursor_row != resolved.target.cursor_row or prepared.cursor.cursor_col != resolved.target.cursor_col) { return error.InvalidTranscriptTransition; }, .retain_committed => |retained| { const anchor = switch (self.transcript_commit_state) { .stable => |value| value, .invalid, .recovering => return error.InvalidTranscriptTransition, }; if (!std.meta.eql(anchor.selection, resolved.target.selection) or anchor.cursor_row != resolved.target.cursor_row or anchor.cursor_col != resolved.target.cursor_col or anchor.occupied_last_row != retained.occupied_last_row) { return error.InvalidTranscriptTransition; } }, } const borrows_pending_resume = resolved.borrows_pending_resume; const scroll_plan = resolved.scroll_plan; const scroll_facts = resolved.scroll_facts; const accepted = resolved.accepted; const target_layout = resolved.target_layout; const source_endpoint_cursor_row = resolved.source_endpoint_cursor_row; const source_endpoint_cursor_col = resolved.source_endpoint_cursor_col; var target = resolved.target; const source_diagnostic = self.transcriptCommitDiagnostic(); debug_trace.logf( "scroll", "transcript_transition_finalize source_state={s} body_disposition={s} source_start={d} target_start={d} source_visual_offset={d} target_visual_offset={d} target_history_visual_offset={d} target_cursor={d},{d} source_layout_id={x} target_layout_id={x}", .{ @tagName(source_diagnostic.state), @tagName(target.body_disposition), source_diagnostic.stable_start_line orelse 0, target.selection.start_line, source_diagnostic.visual_offset, target.visual_offset, target.history_visual_offset, target.cursor_row, target.cursor_col, source_diagnostic.layout_id, target_layout.layout_id, }, );
var target_cache: std.ArrayList(u8) = .empty; errdefer target_cache.deinit(alloc); const target_cache_start = transcript_store.cappedTailStart(source.bytes, self.max_transcript_bytes); const target_cache_bytes = source.bytes[target_cache_start..]; if (!borrows_pending_resume) { try target_cache.ensureTotalCapacityPrecise( alloc, @max(target_cache_bytes.len, self.transcript.capacity), ); try target_cache.appendSlice(alloc, target_cache_bytes); } const target_cache_origin_untrimmed = source.cache_origin_untrimmed and target_cache_start == 0; var transition_replaceable_last_line = prepared.replaceable_last_line; var transition_replaceable_start = prepared.replaceable_start; if (transition_replaceable_last_line) { if (target_cache_bytes.len == 0 or prepared.replaceable_start >= source.bytes.len) { transition_replaceable_last_line = false; transition_replaceable_start = 0; } else if (prepared.replaceable_start > target_cache_start) { transition_replaceable_start = prepared.replaceable_start - target_cache_start; } else { transition_replaceable_start = 0; } }
const target_flow = source.bytes; if (!borrows_pending_resume) source.bytes = &.{}; errdefer if (!borrows_pending_resume and target_flow.len > 0) alloc.free(target_flow);
const folded_summary_indices = source.folded_summary_indices; if (!borrows_pending_resume) source.folded_summary_indices = &.{}; errdefer if (!borrows_pending_resume and folded_summary_indices.len > 0) { alloc.free(folded_summary_indices); }; const source_row_provenance: []const transcript_blocks.RowProvenance = switch (target.body_disposition) { .paint => prepared.row_provenance.items, .retain_committed => switch (self.transcript_commit_state) { .invalid => &.{}, .stable => |anchor| anchor.row_provenance, .recovering => |receipt| receipt.row_provenance, }, }; const row_provenance = try alloc.dupe( transcript_blocks.RowProvenance, source_row_provenance, ); errdefer if (row_provenance.len > 0) alloc.free(row_provenance);
const append_base = try self.resolveTransitionAppendBase( prepared, scroll_facts, destructive_invalidation, target_flow, target.history_visual_offset, ); const append_is_history_replay = if (append_base) |base| base.history_replay != null else false;
const source_flow_end_exact = switch (self.transcript_commit_state) { .recovering => |receipt| receipt.materialized_flow_len != null, .invalid, .stable => true, }; const natural_projected_flow_end: ?usize = if (target.projection_staged) target.staged_flow_end else if (source_flow_end_exact) target_flow.len else null; const held_projected_flow_end: ?usize = if (target.hold_staged) if (append_base) |base| held: { const base_visual_end = base.visual_offset + base.visual_rows; const target_base_flow_end = transcript_painter.preparedTranscriptFlowOffsetForVisualOffset( prepared, self.layout.cols, base_visual_end, ) orelse break :held null; if (target_base_flow_end < base.flow_len) break :held null; // Target growth can terminate the committed line at its byte // endpoint. Charge that cursor movement before advancing into // the final rows this frame may release. const drift = walkText( 1, base.cursor_col, target_flow[base.flow_len..target_base_flow_end], self.layout.cols, ).end_row - 1; if (drift > accepted.semantic_progress_rows) break :held base.flow_len; break :held transcript_painter.preparedTranscriptFlowOffsetForVisualOffset( prepared, self.layout.cols, base_visual_end + accepted.semantic_progress_rows - drift, ); } else null else null; const projected_flow_end: ?usize = if (append_base) |base| if (base.history_replay) |replay| replay.flow_end else held_projected_flow_end orelse natural_projected_flow_end else natural_projected_flow_end; var document_append = render_engine.frame_scroll_plan.FrameDocumentAppend{}; var document_append_bytes: []u8 = &.{}; var presentation_resume_bytes: []u8 = &.{}; var presentation_pending_wrap = false; var presentation_valid = false; errdefer if (document_append_bytes.len > 0) { alloc.free(document_append_bytes); }; errdefer if (presentation_resume_bytes.len > 0) { alloc.free(presentation_resume_bytes); }; if (plan.reset_terminal) { const replay_padding_rows = target_layout.terminal_rows -| target.cursor_row; document_append_bytes = try transcript_painter.prepareResetReplayDocument( self, alloc, target_flow, prepared.sourceVisibleLines(), prepared.sourceVisualRows(), prepared.transcript_ends_with_newline, replay_padding_rows, ); document_append = .{ .bytes = document_append_bytes, .start_row = 1, .start_col = 1, .reset_replay = true, }; debug_trace.logf( "scroll", "document_append_plan raw_bytes={d} wire_bytes={d} start={d},{d} source_visual_offset={d} target_visual_offset={d} planned_scroll_rows={d}", .{ target_flow.len, document_append.bytes.len, document_append.start_row, document_append.start_col, 0, target.visual_offset, scroll_plan.terminal_scroll_rows, }, ); } else if (append_base != null and (!scroll_facts.recovery_rebase or append_is_history_replay) and !scroll_facts.recovery_projection_deferred and (if (append_is_history_replay) accepted.semantic_rows > 0 else accepted.semantic_progress_rows > 0) and projected_flow_end != null and projected_flow_end.? > append_base.?.flow_len and scroll_plan.terminal_scroll_rows > 0) { const base = append_base.?; const raw_append = target_flow[base.flow_len..projected_flow_end.?]; const resume_boundary: ?transcript_painter.PresentationBoundary = if (base.flow_len == 0) .{} else switch (self.transcript_commit_state) { .recovering => |receipt| if (receipt.presentation_valid and receipt.materialized_flow_len == base.flow_len) .{ .resume_bytes = receipt.presentation_resume_bytes, .cursor_col = base.cursor_col, .pending_wrap = receipt.presentation_pending_wrap, } else null, .invalid, .stable => null, }; if (borrows_pending_resume and base.history_replay == null and resume_boundary != null) { var prepared_append = try transcript_painter.prepareResumeDocumentAppend( alloc, target_flow, self.layout.cols, base.flow_len, projected_flow_end.?, target.projection_staged, resume_boundary.?, true, ); defer prepared_append.deinit(alloc); document_append_bytes = prepared_append.bytes; prepared_append.bytes = &.{}; presentation_resume_bytes = prepared_append.endpoint_resume_bytes; prepared_append.endpoint_resume_bytes = &.{}; presentation_pending_wrap = prepared_append.endpoint_pending_wrap; presentation_valid = true; } else { document_append_bytes = try transcript_painter.prepareTranscriptDocumentAppendBytes( alloc, target_flow, self.layout.cols, base.flow_len, projected_flow_end.?, target.projection_staged, ); } document_append = .{ .bytes = if (document_append_bytes.len > 0) document_append_bytes else raw_append, .start_row = base.cursor_row, .start_col = base.cursor_col, .clear = if (base.history_replay) |replay| .{ .rows = replay.clear_rows } else .remainder, }; debug_trace.logf( "scroll", "document_append_plan raw_bytes={d} wire_bytes={d} start={d},{d} source_visual_offset={d} target_visual_offset={d} planned_scroll_rows={d}", .{ raw_append.len, document_append.bytes.len, document_append.start_row, document_append.start_col, base.visual_offset, target.visual_offset, scroll_plan.terminal_scroll_rows, }, ); } const source_history_visual_offset = switch (self.transcript_commit_state) { .invalid => 0, .stable => |anchor| anchor.history_visual_offset, .recovering => |receipt| receipt.accepted_history_visual_offset, }; const planned_history = resolvePlannedHistoryMaterialization( source_history_visual_offset, target.history_visual_offset, target.visual_offset, plan.reset_terminal or !document_append.isEmpty(), target.normal_buffer_recovery_pending, ); if (planned_history.visual_offset != target.history_visual_offset) { debug_trace.logf( "scroll", "transcript_history_materialization_deferred source_visual_offset={d} target_visual_offset={d}", .{ source_history_visual_offset, target.history_visual_offset }, ); } target.history_visual_offset = planned_history.visual_offset; target.normal_buffer_recovery_pending = planned_history.normal_buffer_recovery_pending; const materialized = resolveMaterializedEndpoint( target, source_endpoint_cursor_row, source_endpoint_cursor_col, append_base, projected_flow_end, target_flow.len, target_layout.transcript_area, ); return .{ .scroll_plan = scroll_plan, .document_append = document_append, .document_append_bytes = document_append_bytes, .history_settle_pending = scroll_facts.recovery_rebase and !self.fullTranscriptActive() and self.finalityReleasableOffset( prepared, scroll_facts.target_visual_offset, ) > target.history_visual_offset, .resize_reflow_rows = scroll_facts.resize_reflow_rows, .semantic_rows = scroll_facts.semantic_rows, .semantic_progress_rows = scroll_facts.semantic_progress_rows, .recovery_rebase = scroll_facts.recovery_rebase, .recovery_progress_compatible = scroll_facts.recovery_progress_compatible, .recovery_tracks_semantic_progress = scroll_facts.recovery_tracks_semantic_progress, .recovery_projection_deferred = scroll_facts.recovery_projection_deferred, .body_disposition = target.body_disposition, .target_flow = target_flow, .target_flow_owned = !borrows_pending_resume, .presentation_resume_bytes = presentation_resume_bytes, .presentation_pending_wrap = presentation_pending_wrap, .presentation_valid = presentation_valid, .target_cache = target_cache, .target_cache_unchanged = borrows_pending_resume, .target_cache_origin_untrimmed = target_cache_origin_untrimmed, .folded_summary_indices = folded_summary_indices, .target_layout = target_layout, .selection = target.selection, .visual_offset = target.visual_offset, .history_visual_offset = target.history_visual_offset, .source_endpoint_visual_offset = target.source_endpoint_visual_offset, .total_visual_rows = target.total_visual_rows, .materialized = materialized, .materialized_without_append = self.materializedEndpointWithoutAppend( document_append, materialized, ), .cursor_row = target.cursor_row, .cursor_col = target.cursor_col, .replaceable_last_line = transition_replaceable_last_line, .replaceable_start = transition_replaceable_start, .replaceable_row = prepared.cursor.replaceable_row, .trace_transcript_frame = prepared.trace_transcript_frame, .trace_visible_rows = prepared.trace_visible_rows, .measured_history_origin = target.measured_history_origin, .row_provenance = row_provenance, .normal_buffer_recovery_pending = target.normal_buffer_recovery_pending, .history_catchup_pending = target.history_catchup_pending, }; }
pub fn consumeTranscriptTransition( self: *TranscriptRuntime, alloc: Allocator, transition: *TranscriptTransition, result: render_engine.terminal_diff.FrameCommitResult, ) void { const scroll_commit = result.scrollCommit(transition.scroll_plan); self.consumeTranscriptTransitionWithCommit(alloc, transition, result, scroll_commit); }
pub fn consumeFrameScrollCommit( self: *TranscriptRuntime, alloc: Allocator, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, result: render_engine.terminal_diff.FrameCommitResult, transition: ?*TranscriptTransition, ) void { const terminal_reset_commit = result.is_committed() and self.terminal_reset_pending; const resize_reset_commit = terminal_reset_commit and (self.pending_resize_observation != null or self.resize_history_row_delta != null); const scroll_commit = result.scrollCommit(scroll_plan); self.ackPreservedRowReleaseCommit(scroll_plan, scroll_commit); if (transition) |value| { std.debug.assert(std.meta.eql(scroll_plan, value.scroll_plan)); self.consumeTranscriptTransitionWithCommit(alloc, value, result, scroll_commit); } const committed_selection = if (result.is_committed()) if (transition) |value| value.selection else null else null; self.resize_bottom_anchor_pending = nextResizeBottomAnchorPending( self.resize_bottom_anchor_pending, terminal_reset_commit, resize_reset_commit, if (committed_selection) |selection| selection.tail_kind else null, if (committed_selection) |selection| selection.last_visible_row else 0, self.layout.content_bottom, ); }
fn consumeTranscriptTransitionWithCommit( self: *TranscriptRuntime, alloc: Allocator, transition: *TranscriptTransition, result: render_engine.terminal_diff.FrameCommitResult, scroll_commit: render_engine.frame_scroll_plan.FrameScrollCommit, ) void { std.debug.assert(!transition.consumed); const commit = resolveTranscriptTransitionCommit(transition, result, scroll_commit); if (commit.accepted.resize_reflow_rows > 0 and transition.measured_history_origin != null) { debug_trace.logf( "resize", "measured_history_endpoint_commit rows={d} before={s} after={s}", .{ commit.accepted.resize_reflow_rows, if (transition.measured_history_origin.?.endpoint != null) "exact" else "unavailable", if (commit.committed_measured_history_origin.?.endpoint != null) "exact" else "unavailable", }, ); }
if (result.is_committed()) { self.committed_frame_layout = transition.target_layout; }
const borrowed_resume_source = if (!transition.target_flow_owned) if (self.pending_resume_source) |*source| if (transition.target_flow.len == 0 or source.bytes.ptr == transition.target_flow.ptr) source else null else null else null; if (commit.stable and !transition.target_flow_owned and borrowed_resume_source == null) { debug_trace.logf( "scroll", "transcript_transition_commit state=invalid reason=missing_borrowed_resume_source", .{}, ); transition.target_flow = &.{}; var previous_state = self.transcript_commit_state; self.transcript_commit_state = .invalid; previous_state.deinit(alloc); self.markTranscriptDirty(); } else if (commit.stable) { var previous_cache: std.ArrayList(u8) = .empty; if (!transition.target_cache_unchanged) { previous_cache = self.transcript; self.transcript = transition.target_cache; transition.target_cache = .empty; self.transcript_cache_origin_untrimmed = transition.target_cache_origin_untrimmed; } const target_has_content = transition.target_flow.len > 0; const retained_body = transition.body_disposition == .retain_committed;
const summary_count = @min( self.folded_command_blocks.items.len, transition.folded_summary_indices.len, ); for (self.folded_command_blocks.items[0..summary_count], 0..) |*block, index| { block.summary_transcript_index = transition.folded_summary_indices[index]; }
const stable_flow = transition.target_flow; const pending_resume_bytes = if (transition.target_flow_owned) self.releasePendingResumeSource(alloc) else blk: { const pending = borrowed_resume_source.?; pending.bytes = &.{}; const bytes = stable_flow.len; _ = self.releasePendingResumeSource(alloc); break :blk bytes; }; transition.target_flow = &.{};
var previous_state = self.transcript_commit_state; self.transcript_commit_state = .{ .stable = .{ .selection = transition.selection, .visual_offset = transition.visual_offset, .history_visual_offset = transition.history_visual_offset, .total_visual_rows = transition.total_visual_rows, .flow = stable_flow, .cursor_row = transition.cursor_row, .cursor_col = transition.cursor_col, .occupied_last_row = transition.selection.last_visible_row, .occupied_last_row_blank = transition.selection.last_visible_row_blank, .layout_id = transition.target_layout.layout_id, .measured_history_origin = commit.committed_measured_history_origin, .row_provenance = transition.row_provenance, .normal_buffer_recovery_pending = transition.normal_buffer_recovery_pending, .history_catchup_pending = transition.history_catchup_pending, } }; transition.row_provenance = &.{};
self.last_rendered_cols = transition.target_layout.terminal_cols; if (pending_resume_bytes > 0) { self.invalidateTranscriptAnchor("resume publication retained source handoff"); if (transition.target_flow_owned) { debug_trace.logf( "session", "pending resume flow dropped reason=superseded bytes={d}", .{pending_resume_bytes}, ); } else { debug_trace.logf( "session", "resume historical flow committed bytes={d}", .{pending_resume_bytes}, ); } self.markTranscriptDirty(); } if (!retained_body and !self.fullTranscriptActive()) { self.last_visible_transcript_top_row = transition.selection.top_row; self.last_visible_transcript_start_line = transition.selection.start_line; self.last_visible_transcript_partial_skip_rows = transition.selection.partial_skip_rows; self.last_visible_transcript_split_active = transition.selection.split_active; self.last_visible_transcript_split_prefix_lines = transition.selection.split_prefix_lines; self.last_visible_transcript_split_suffix_start_line = transition.selection.split_suffix_start_line; self.last_visible_transcript_last_row = transition.selection.last_visible_row; self.last_visible_transcript_last_row_blank = transition.selection.last_visible_row_blank; self.last_visible_transcript_tail_kind = transition.selection.tail_kind; self.last_viewport_selection = transition.selection; self.cursor_row = transition.cursor_row; self.cursor_col = transition.cursor_col; self.replaceable_last_line = transition.replaceable_last_line; self.replaceable_start = transition.replaceable_start; self.replaceable_row = transition.replaceable_row; self.paint_trace.transcript_initialized = true; self.paint_trace.transcript_top = transition.selection.top_row; self.paint_trace.transcript_bottom = transition.selection.bottom_row; self.paint_trace.transcript_start_line = transition.selection.start_line; self.paint_trace.transcript_total_lines = transition.selection.line_count; self.paint_trace.transcript_visible_rows = transition.trace_visible_rows; self.paint_trace.transcript_partial_skip_rows = transition.selection.partial_skip_rows; self.paint_trace.transcript_entries = self.entries.items.len; self.paint_trace.transcript_log_frame = transition.trace_transcript_frame; } if (target_has_content and !self.has_painted_transcript) { self.has_painted_transcript = true; }
previous_state.deinit(alloc); previous_cache.deinit(alloc); debug_trace.logf( "scroll", "transcript_transition_commit state=stable start={d} visual_offset={d} history_visual_offset={d} layout_id={x} cursor={d},{d}", .{ transition.selection.start_line, transition.visual_offset, transition.history_visual_offset, transition.target_layout.layout_id, transition.cursor_row, transition.cursor_col, }, ); if (transition.normal_buffer_recovery_pending) { self.markTranscriptDirty(); } } else { const recovery = resolveTranscriptRecoveryCommit(self, transition, result, commit); var previous_state = self.transcript_commit_state; var presentation_resume_bytes: []u8 = &.{}; var presentation_pending_wrap = false; var presentation_valid = false; if (result.document_append_applied() and transition.presentation_valid) { presentation_resume_bytes = transition.presentation_resume_bytes; presentation_pending_wrap = transition.presentation_pending_wrap; presentation_valid = true; transition.presentation_resume_bytes = &.{}; transition.presentation_valid = false; } else switch (previous_state) { .recovering => |*receipt| { presentation_resume_bytes = receipt.presentation_resume_bytes; presentation_pending_wrap = receipt.presentation_pending_wrap; presentation_valid = receipt.presentation_valid; receipt.presentation_resume_bytes = &.{}; receipt.presentation_valid = false; }, .invalid, .stable => {}, } self.transcript_commit_state = .{ .recovering = .{ .accepted_visual_offset = recovery.accepted_visual_offset, .accepted_history_visual_offset = recovery.accepted_history_visual_offset, .attempt_visual_offset = transition.source_endpoint_visual_offset, .attempt_total_visual_rows = transition.total_visual_rows, .materialized_visual_offset = recovery.materialized_visual_offset, .materialized_visual_rows = recovery.materialized_visual_rows, .materialized_flow_len = recovery.materialized_flow_len, .remaining_resize_reflow_rows = commit.remaining_resize_reflow_rows, .remaining_semantic_rows = commit.remaining_semantic_rows, .remaining_semantic_progress_rows = commit.remaining_semantic_progress_rows, .remaining_unplanned_scroll_rows = commit.remaining_unplanned_scroll_rows, .attempt_cols = transition.target_layout.terminal_cols, .attempt_resize_history_row_delta = self.resize_history_row_delta, .attempt_resize_history_committed = result.is_committed(), .projection_rebase_pending = transition.recovery_rebase, .tracks_semantic_progress = transition.recovery_tracks_semantic_progress, .flow = transition.target_flow, .flow_owned = transition.target_flow_owned, .presentation_resume_bytes = presentation_resume_bytes, .presentation_pending_wrap = presentation_pending_wrap, .presentation_valid = presentation_valid, .cursor_row = recovery.materialized_cursor_row, .cursor_col = recovery.materialized_cursor_col, .document_append_committed = recovery.document_append_committed, .measured_history_origin = commit.committed_measured_history_origin, .row_provenance = transition.row_provenance, .normal_buffer_recovery_pending = transition.normal_buffer_recovery_pending, } }; transition.target_flow = &.{}; transition.row_provenance = &.{}; previous_state.deinit(alloc); if (commit.complete and !transition.recovery_projection_deferred and (commit.remaining_resize_reflow_rows > 0 or commit.remaining_semantic_rows > 0)) { self.markTranscriptDirty(); } debug_trace.logf( "scroll", "transcript_transition_commit state=recovering accepted_resize_reflow_rows={d} accepted_semantic_rows={d} accepted_semantic_progress_rows={d} remaining_resize_reflow_rows={d} remaining_semantic_rows={d} remaining_semantic_progress_rows={d} remaining_unplanned_scroll_rows={d} recovery_rebase={s} recovery_projection_deferred={s} append_committed={s} shadow_state={s}", .{ commit.accepted.resize_reflow_rows, commit.accepted.semantic_rows, commit.accepted.semantic_progress_rows, commit.remaining_resize_reflow_rows, commit.remaining_semantic_rows, commit.remaining_semantic_progress_rows, commit.remaining_unplanned_scroll_rows, if (transition.recovery_rebase) "true" else "false", if (transition.recovery_projection_deferred) "true" else "false", if (recovery.document_append_committed) "true" else "false", @tagName(result.state()), }, ); }
if (transition.folded_summary_indices.len > 0) { alloc.free(transition.folded_summary_indices); transition.folded_summary_indices = &.{}; } if (transition.history_settle_pending) { // Final rows remain unmaterialized past this commit; guarantee a // follow-up frame so the debt settles without external activity. self.render_requests.request(.transcript); } transition.consumed = true; }
/// Writes only to the byte buffer for callers that separately append a /// structured entry. Use `writeTranscript` when raw-entry mirroring is needed. pub fn writeTranscriptBytes(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8, record: bool) !void { return transcript_writer.writeTranscriptBytes(self, alloc, metrics, text, record); }
pub fn estimatedReflowedCursorRow(self: *const TranscriptRuntime, target_cols: u16) ?u32 { const shadow = self.shadow_vt orelse return null; if (target_cols == 0 or shadow.cursor_row == 0) return null; return reflowedRows(shadow, 1, shadow.cursor_row, target_cols, true); }
pub fn ackPreservedRowRelease( self: *TranscriptRuntime, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, committed_terminal_scroll_rows: u16, ) !void { try scroll_plan.validate(self.layout.rows); self.ackPreservedRowReleaseAssumeValid(scroll_plan, committed_terminal_scroll_rows); }
pub fn ackPreservedRowReleaseAssumeValid( self: *TranscriptRuntime, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, committed_terminal_scroll_rows: u16, ) void { const scroll_commit = scroll_plan.commit(committed_terminal_scroll_rows); self.ackPreservedRowReleaseCommit(scroll_plan, scroll_commit); }
fn ackPreservedRowReleaseCommit( self: *TranscriptRuntime, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, scroll_commit: render_engine.frame_scroll_plan.FrameScrollCommit, ) void { const accepted = scroll_commit.accepted_rows; const raw_owned_top = self.owned_top_row; const raw_viewport_top = self.viewport_top_row; const normalized_viewport_top = render_engine.frame_scroll_plan.normalizeOwnedTop( self.viewport_top_row, self.layout.rows, );
self.owned_top_row = scroll_plan.prior_owned_top -| accepted.preserved_release_rows; self.viewport_top_row = @max( self.owned_top_row, normalized_viewport_top -| accepted.preserved_release_rows, ); debug_trace.logf( "scroll", "preserved_row_release requested={d} planned={d} committed_terminal={d} accepted_terminal={d} unplanned_terminal={d} accepted={d} raw_owned_top={d} raw_viewport_top={d} normalized_owned_top={d} normalized_viewport_top={d} owned_top={d} viewport_top={d}", .{ scroll_plan.requested_release_rows, scroll_plan.preserved_release_rows, scroll_commit.physical_terminal_scroll_rows, scroll_commit.accepted_terminal_scroll_rows, scroll_commit.unplanned_terminal_scroll_rows, accepted.preserved_release_rows, raw_owned_top, raw_viewport_top, scroll_plan.prior_owned_top, normalized_viewport_top, self.owned_top_row, self.viewport_top_row, }, ); }
/// Writes to the byte buffer and mirrors the content as a raw entry. /// Structured writers must use `writeTranscriptBytes` to avoid duplication. pub fn writeTranscript(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8, record: bool) !void { return transcript_writer.writeTranscript(self, alloc, metrics, text, record); }
pub fn writeTranscriptClassified( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8, record: bool, class: RawEntryClass, ) !void { return transcript_writer.writeTranscriptClassified(self, alloc, metrics, text, record, class); }
pub fn writeTranscriptBytesFrom( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8, record: bool, entry_id: u32, ) !void { return transcript_writer.writeTranscriptBytesFrom( self, alloc, metrics, text, record, entry_id, ); }
pub fn writeCompletedToolStatus( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, kind: types.ToolOutcomeKind, summary: []const u8, record: bool, ) !void { _ = try self.writeCompletedToolStatusReturningEntryId( alloc, metrics, kind, summary, record, ); }
pub fn writeCompletedToolStatusReturningEntryId( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, kind: types.ToolOutcomeKind, summary: []const u8, record: bool, ) !u32 { const line = try lifecycleTerminalLine(alloc, kind, summary); defer alloc.free(line); return transcript_writer.writeTranscriptReturningEntryIdClassified( self, alloc, metrics, line, record, .tool_status, ); }
/// Rebuild the transcript cache at the current width and request a /// diagnostic full-frame repaint. Terminal mutation remains owned /// by the frame commit path. pub fn reconstructivePaint(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics) !void { return transcript_writer.reconstructivePaint(self, alloc, metrics); }
pub fn appendReplaceableTranscriptLine(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8) !u32 { return transcript_store.appendReplaceableTranscriptLine(self, alloc, metrics, text); }
pub fn appendReplaceableTranscriptLineClassified( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8, class: RawEntryClass, ) !u32 { return transcript_store.appendReplaceableTranscriptLineClassified(self, alloc, metrics, text, class); }
pub fn replaceTrailingTranscriptLine(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, text: []const u8) !bool { return transcript_store.replaceTrailingTranscriptLine(self, alloc, metrics, text); }
/// Returns the id of the mirrored `raw_bytes` entry, or `0` when /// `text` is empty (sentinel: `next_entry_id` starts at 1). pub fn appendReplaceableTranscriptLineSilent(self: *TranscriptRuntime, alloc: Allocator, text: []const u8) !u32 { return transcript_store.appendReplaceableTranscriptLineSilent(self, alloc, text); }
pub fn appendReplaceableTranscriptLineSilentClassified(self: *TranscriptRuntime, alloc: Allocator, text: []const u8, class: RawEntryClass) !u32 { return transcript_store.appendReplaceableTranscriptLineSilentClassified(self, alloc, text, class); }
pub fn replaceTrailingTranscriptLineSilent(self: *TranscriptRuntime, alloc: Allocator, text: []const u8) !bool { return transcript_store.replaceTrailingTranscriptLineSilent(self, alloc, text); }
pub fn writeNotice( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, notice: types.SemanticNotice, record: bool, ) !void { return transcript_store.writeNotice(self, alloc, metrics, notice, record) catch |err| switch (err) { error.InputPending => unreachable, else => |other| return other, }; }
pub fn appendReplaceableSemanticNotice( self: *TranscriptRuntime, alloc: Allocator, notice: types.SemanticNotice, ) !u32 { return transcript_store.appendReplaceableSemanticNoticeAtomic(self, alloc, notice); }
pub fn appendSemanticNotice( self: *TranscriptRuntime, alloc: Allocator, notice: types.SemanticNotice, ) !u32 { return transcript_store.appendSemanticNoticeAtomic(self, alloc, notice); }
pub fn replaceSemanticNotice( self: *TranscriptRuntime, alloc: Allocator, entry_id: u32, notice: types.SemanticNotice, ) !bool { return transcript_store.replaceSemanticNoticeAtomic(self, alloc, entry_id, notice); }
pub fn setCommandOutputRenderPolicy(self: *TranscriptRuntime, styles: Styles) void { return command_output_runtime.setCommandOutputRenderPolicy(self, styles); }
pub fn retainedTranscriptStyles(self: *const TranscriptRuntime) Styles { return self.command_output_render.styles; }
pub fn writeRecordedCommandOutputChunkAtomic( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, styles: Styles, lifecycle_id: ?types.ToolLifecycleId, stream: command_output_content.Stream, text: []const u8, ) !?u32 { return transcript_store.writeRecordedCommandOutputChunkAtomic( self, alloc, metrics, styles, lifecycle_id, stream, text, ); }
pub fn flushRecordedCommandOutputSummaryAtomic( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, styles: Styles, lifecycle_id: ?types.ToolLifecycleId, ) !void { return transcript_store.flushRecordedCommandOutputSummaryAtomic( self, alloc, metrics, styles, lifecycle_id, ); }
pub fn writeCommandOutputChunk(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, styles: Styles, stream: command_output_content.Stream, text: []const u8, record: bool) !void { return command_output_runtime.writeCommandOutputChunk(self, alloc, metrics, styles, stream, text, record); }
pub fn writeCommandOutputChunkForLifecycle( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, styles: Styles, lifecycle_id: ?types.ToolLifecycleId, stream: command_output_content.Stream, text: []const u8, record: bool, ) !void { return command_output_runtime.writeCommandOutputChunkForLifecycle( self, alloc, metrics, styles, lifecycle_id, stream, text, record, ); }
pub fn flushCommandOutputSummary(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, styles: Styles, record: bool) !void { return command_output_runtime.flushCommandOutputSummary(self, alloc, metrics, styles, record); }
pub fn flushCommandOutputSummaryForLifecycle( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, styles: Styles, lifecycle_id: ?types.ToolLifecycleId, record: bool, ) !void { return command_output_runtime.flushCommandOutputSummaryForLifecycle( self, alloc, metrics, styles, lifecycle_id, record, ); }
pub fn openCommandOutputLifecycleId( self: *const TranscriptRuntime, ) ?types.ToolLifecycleId { return command_output_runtime.openCommandOutputLifecycleId(self); }
pub fn frameSink(self: *TranscriptRuntime) render_engine.terminal_diff.FrameSink { return transcript_io.frameSinkFrom(@ptrCast(self), writeFrameSink); }
pub fn writeNotificationBell( self: *TranscriptRuntime, metrics: *Metrics, ) void { switch (transcript_io.writeFrameBytes(self, metrics, "\x07")) { .complete => {}, .partial => |partial| debug_trace.logf( "notifications", "terminal bell write failed accepted_bytes={d} err={s}", .{ partial.accepted_bytes, @errorName(partial.err) }, ), } }
fn writeFrameSink(ctx: *anyopaque, metrics: *Metrics, bytes: []const u8) render_engine.terminal_diff.FrameSinkWriteResult { const self: *TranscriptRuntime = @ptrCast(@alignCast(ctx)); return transcript_io.writeFrameBytes(self, metrics, bytes); }
pub fn recomputeCursorFromTranscript(self: *TranscriptRuntime) void { self.resetCursorTracking(); if (self.transcript.items.len == 0) return; _ = self.advanceCursor(self.transcript.items); }
pub fn prepareTranscriptSurfacePaint( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, bottom_reserved_rows: u16, ) !transcript_painter.PreparedTranscriptSurfacePaint { return transcript_painter.prepareTranscriptSurfacePaint(self, alloc, metrics, bottom_reserved_rows); }
pub fn prepareTranscriptSource( self: *TranscriptRuntime, alloc: Allocator, tracked_entry_id: ?u32, ) !TranscriptPreparationSource { if (self.pending_resume_source) |*source| { return source.clone(alloc); } return source_preparation.prepareTranscriptSource(self, alloc, tracked_entry_id); }
pub fn cachedTranscriptSource( self: *TranscriptRuntime, alloc: Allocator, ) !TranscriptPreparationSource { return self.cachedTranscriptSourceInterruptible(alloc, null) catch |err| switch (err) { error.InputPending => unreachable, else => |other| return other, }; }
pub fn pendingResumeSourceInterruptible( self: *TranscriptRuntime, alloc: Allocator, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !?*TranscriptPreparationSource { var source = if (self.pending_resume_source) |*value| value else return null; if (source.cols != self.layout.cols) { debug_trace.logf( "full_transcript_cache", "pending_resume_rebuild old_cols={d} new_cols={d}", .{ source.cols, self.layout.cols }, ); try build_checkpoint.poll(checkpoint); const bytes = try alloc.dupe(u8, source.bytes); var replacement = try source_preparation.prepareFullTranscriptViewportSourceInterruptible( self, alloc, bytes, checkpoint, ); errdefer replacement.deinit(alloc); try replacement.ensureLineIndexInterruptible(alloc, checkpoint); const previous_bytes = source.bytes; source.deinit(alloc); self.pending_resume_source = replacement; source = &self.pending_resume_source.?; switch (self.transcript_commit_state) { .recovering => |*receipt| if (!receipt.flow_owned) { std.debug.assert(receipt.flow.ptr == previous_bytes.ptr); receipt.flow = source.bytes; }, .invalid, .stable => {}, } } else if (source.hard_line_starts.len == 0) { try source.ensureLineIndexInterruptible(alloc, checkpoint); } else { try build_checkpoint.poll(checkpoint); } return source; }
pub fn cachedTranscriptSourceInterruptible( self: *TranscriptRuntime, alloc: Allocator, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !TranscriptPreparationSource { if (self.pending_resume_source != null) { return self.prepareTranscriptSource(alloc, null); } if (self.compact_transcript_source_cache.find( self.full_transcript_content_revision, self.layout.cols, self.has_committed_frame, )) |source| { source.preview.cursor_row = self.cursor_row; source.preview.cursor_col = self.cursor_col; source.preview.replaceable_row = self.replaceable_row; source.replaceable_row = self.replaceable_row; return source.clone(alloc); }
var source = try source_preparation.prepareTranscriptSourceInterruptible( self, alloc, null, null, null, checkpoint, ); errdefer source.deinit(alloc); try source.ensureLineIndexInterruptible(alloc, checkpoint); const cached = self.compact_transcript_source_cache.insert(alloc, .{ .source = source, .content_revision = self.full_transcript_content_revision, .cols = self.layout.cols, .has_committed_frame = self.has_committed_frame, }); return cached.clone(alloc); }
pub fn prepareTranscriptSourceForFrameInterruptible( self: *TranscriptRuntime, alloc: Allocator, focused_entry_id: ?u32, omitted_entry_id: ?u32, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !TranscriptPreparationSource { return source_preparation.prepareTranscriptSourceInterruptible( self, alloc, focused_entry_id, focused_entry_id, omitted_entry_id, checkpoint, ); }
pub fn prepareTranscriptSourceOmittingEntry( self: *TranscriptRuntime, alloc: Allocator, omitted_entry_id: u32, ) !TranscriptPreparationSource { return source_preparation.prepareTranscriptSourceOmittingEntry(self, alloc, omitted_entry_id); }
pub fn prepareTranscriptSourceWithFocusedEntry( self: *TranscriptRuntime, alloc: Allocator, focused_entry_id: u32, ) !TranscriptPreparationSource { return source_preparation.prepareTranscriptSourceWithFocusedEntry(self, alloc, focused_entry_id); }
pub fn prepareFullTranscriptViewportSource( self: *TranscriptRuntime, alloc: Allocator, bytes: []u8, ) !TranscriptPreparationSource { return source_preparation.prepareFullTranscriptViewportSource(self, alloc, bytes); }
pub const FullTranscriptSurfacePaint = struct { source: TranscriptPreparationSource, prepared: transcript_painter.PreparedTranscriptSurfacePaint, code_copy_frame: full_transcript_screen.CodeCopyInteractionFrame, };
pub noinline fn buildFullTranscriptProjection( self: *TranscriptRuntime, alloc: Allocator, full_diff_resolver: ?full_transcript_screen.FullDiffResolver, ) !full_transcript_screen.Projection { self.prepareFullTranscriptProjectionLayout(); return self.buildFullTranscriptProjectionUncached( alloc, full_diff_resolver, self.fullTranscriptAnchorEntryId(), null, ) catch |err| switch (err) { error.InputPending => unreachable, else => |other| return other, }; }
pub fn cachedFullTranscriptProjection( self: *TranscriptRuntime, alloc: Allocator, full_diff_resolver: ?full_transcript_screen.FullDiffResolver, ) !*full_transcript_screen.Projection { return self.cachedFullTranscriptProjectionInterruptible( alloc, full_diff_resolver, null, ) catch |err| switch (err) { error.InputPending => unreachable, else => |other| return other, }; }
pub fn cachedFullTranscriptProjectionInterruptible( self: *TranscriptRuntime, alloc: Allocator, full_diff_resolver: ?full_transcript_screen.FullDiffResolver, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !*full_transcript_screen.Projection { self.prepareFullTranscriptProjectionLayout(); const cache = switch (self.full_transcript.depth) { .review, .inline_mode => &self.full_transcript_projection_cache.review, .full => &self.full_transcript_projection_cache.full, }; const content_revision = switch (self.full_transcript.depth) { .review, .inline_mode => self.full_transcript_review_revision, .full => self.full_transcript_content_revision, }; if (cache.find( content_revision, self.layout.cols, full_diff_resolver, )) |projection| { debug_trace.logf( "full_transcript_cache", "hit depth={s} revision={d} cols={d} measured_cols={any}", .{ @tagName(self.full_transcript.depth), content_revision, self.layout.cols, projection.measurement_cols }, ); return projection; }
debug_trace.logf( "full_transcript_cache", "miss depth={s} revision={d} cols={d}", .{ @tagName(self.full_transcript.depth), content_revision, self.layout.cols }, );
if (cache.incrementalCandidate(self.layout.cols, full_diff_resolver)) |cached| { const dirty_entry = switch (cached.dirty) { .entry => |entry| entry, .clean, .all => unreachable, }; if (cachedEntryPrefixMatches( self.entries.items, cached.entry_count, cached.prefix_last_entry_id, )) { if (tool_group_projection.incrementalRebuildStart( self.entries.items, self.tool_details.items, dirty_entry.index, )) |relationship_start| { var start_index = relationship_start; if (start_index > 0) { const previous_id = self.entries.items[start_index - 1].id(); const context_id = cached.projection.retainedContextEntryId(previous_id); start_index = if (context_id) |entry_id| tool_group_projection.incrementalRebuildStart( self.entries.items, self.tool_details.items, self.transcriptEntryIndex(entry_id) orelse start_index - 1, ) orelse start_index - 1 else 0; } if (start_index < cached.entry_count) { var suffix = try self.buildFullTranscriptProjectionUncachedFrom( alloc, full_diff_resolver, null, start_index, checkpoint, ); defer suffix.deinit(alloc); if (try cached.projection.replaceFromEntry( alloc, self.entries.items[start_index].id(), &suffix, )) { cached.content_revision = content_revision; cached.entry_count = self.entries.items.len; cached.prefix_last_entry_id = entryPrefixBoundaryId( self.entries.items, self.entries.items.len, ); cached.dirty = .clean; debug_trace.logf( "full_transcript_cache", "append depth={s} revision={d} start_entry_id={d} entries={d}", .{ @tagName(self.full_transcript.depth), content_revision, self.entries.items[start_index].id(), self.entries.items.len - start_index, }, ); return &cached.projection; } } } } cached.dirty = .all; }
var replacement = try self.buildFullTranscriptProjectionUncached( alloc, full_diff_resolver, null, checkpoint, ); errdefer replacement.deinit(alloc); return cache.insert(alloc, .{ .projection = replacement, .content_revision = content_revision, .entry_count = self.entries.items.len, .prefix_last_entry_id = entryPrefixBoundaryId( self.entries.items, self.entries.items.len, ), .cols = self.layout.cols, .resolver = full_diff_resolver, }); }
fn prepareFullTranscriptProjectionLayout(self: *TranscriptRuntime) void { self.full_transcript = self.full_transcript.prepare_projection( self.layout.cols, ); }
fn buildFullTranscriptProjectionUncached( self: *TranscriptRuntime, alloc: Allocator, full_diff_resolver: ?full_transcript_screen.FullDiffResolver, anchor_entry_id: ?u32, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !full_transcript_screen.Projection { return self.buildFullTranscriptProjectionUncachedFrom( alloc, full_diff_resolver, anchor_entry_id, 0, checkpoint, ); }
fn buildFullTranscriptProjectionUncachedFrom( self: *TranscriptRuntime, alloc: Allocator, full_diff_resolver: ?full_transcript_screen.FullDiffResolver, anchor_entry_id: ?u32, start_index: usize, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !full_transcript_screen.Projection { const relationships = try self.cachedFullTranscriptRelationshipsInterruptible( alloc, checkpoint, ); var entry_actions = try tool_group_projection.materializeExpandedRelationshipsRangeInterruptible( alloc, relationships, start_index, self.layout.cols, .{ .marker_style = user_message_card.promptMarkerStyle(), .text_style = ui_render.statusline_style, .reset_style = "\x1b[0m", }, checkpoint, ); defer entry_actions.deinit(alloc); return full_transcript_screen.buildProjectionForDepthWithEntryActionsInterruptible( alloc, self.entries.items[start_index..], self.tool_details.items, self.command_output_blocks.items, self.command_output_render.styles, self.layout.cols, anchor_entry_id, switch (self.full_transcript.depth) { .review => .review, .full => .full, .inline_mode => .review, }, full_diff_resolver, entry_actions.entry_actions.items, checkpoint, ); }
fn cachedFullTranscriptRelationshipsInterruptible( self: *TranscriptRuntime, alloc: Allocator, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !*tool_group_projection.Projection { const cache = &self.full_transcript_projection_cache.relationships; if (cache.cached) |*cached| { switch (cached.dirty) { .clean => if (cached.content_revision == self.full_transcript_content_revision) { debug_trace.logf( "full_transcript_cache", "relationships_hit revision={d} entries={d}", .{ cached.content_revision, cached.entry_count }, ); return &cached.projection; }, .entry => |entry| { if (cachedEntryPrefixMatches( self.entries.items, cached.entry_count, cached.prefix_last_entry_id, )) { if (tool_group_projection.incrementalRebuildStart( self.entries.items, self.tool_details.items, entry.index, )) |start_index| { if (start_index <= cached.projection.entry_actions.items.len) { var suffix = try tool_group_projection.buildExpandedRelationshipsInterruptible( alloc, self.entries.items[start_index..], self.tool_details.items, checkpoint, ); defer suffix.deinit(alloc); try cached.projection.replaceSuffix(alloc, start_index, &suffix); cached.content_revision = self.full_transcript_content_revision; cached.entry_count = self.entries.items.len; cached.prefix_last_entry_id = entryPrefixBoundaryId( self.entries.items, self.entries.items.len, ); cached.dirty = .clean; debug_trace.logf( "full_transcript_cache", "relationships_append revision={d} start_index={d} entries={d}", .{ cached.content_revision, start_index, cached.entry_count }, ); return &cached.projection; } } } }, .all => {}, } }
var replacement = try tool_group_projection.buildExpandedRelationshipsInterruptible( alloc, self.entries.items, self.tool_details.items, checkpoint, ); errdefer replacement.deinit(alloc); if (cache.cached) |*cached| cached.projection.deinit(alloc); cache.cached = .{ .projection = replacement, .content_revision = self.full_transcript_content_revision, .entry_count = self.entries.items.len, .prefix_last_entry_id = entryPrefixBoundaryId( self.entries.items, self.entries.items.len, ), }; debug_trace.logf( "full_transcript_cache", "relationships_rebuild revision={d} entries={d}", .{ self.full_transcript_content_revision, self.entries.items.len }, ); return &cache.cached.?.projection; }
pub noinline fn prepareFullTranscriptSurfacePaint( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, projection: *full_transcript_screen.Projection, capability: ?*session_child_store.SessionChildCapability, area: render_engine.frame_layout.FrameRect, ) !FullTranscriptSurfacePaint { return self.prepareFullTranscriptSurfacePaintInterruptible( alloc, metrics, projection, capability, area, null, ) catch |err| switch (err) { error.InputPending => unreachable, else => |other| return other, }; }
pub noinline fn prepareFullTranscriptSurfacePaintInterruptible( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, projection: *full_transcript_screen.Projection, capability: ?*session_child_store.SessionChildCapability, area: render_engine.frame_layout.FrameRect, checkpoint: ?*build_checkpoint.BuildCheckpoint, ) !FullTranscriptSurfacePaint { const source_bytes = try full_transcript_screen.renderProjectionViewportSourceWithSelectorInterruptible( alloc, projection, capability, self.layout.cols, area.height(), .{ .context = self, .select_offset = selectProjectionViewportOffset }, checkpoint, ); const selected_offset = self.full_transcript.select_visual_offset( projection.measured_total_rows, area.height(), projection.measured_item_rows.items, ).offset; var code_copy_frame = try full_transcript_screen.codeCopyTargetsForWindow( alloc, projection, selected_offset, area.top, area.height(), ); errdefer code_copy_frame.deinit(alloc); var source = try self.prepareFullTranscriptViewportSource(alloc, source_bytes); errdefer source.deinit(alloc); const prepared = try transcript_painter.preparePreselectedTranscriptSurfacePaintFromSourceForArea( self, alloc, metrics, &source, area, ); return .{ .source = source, .prepared = prepared, .code_copy_frame = code_copy_frame, }; }
fn selectProjectionViewportOffset( context: *anyopaque, measurement: full_transcript_screen.ProjectionMeasurement, visible_rows: u16, ) u32 { const self: *TranscriptRuntime = @ptrCast(@alignCast(context)); const selection = self.full_transcript.select_visual_offset( measurement.total_rows, visible_rows, measurement.item_rows, ); self.full_transcript = selection.state; return selection.offset; }
test "full transcript depth changes preserve tail and history viewport intent" { const alloc = std.testing.allocator; const review_measurement = full_transcript_screen.ProjectionMeasurement{ .total_rows = 13, .anchor_row = null, .item_rows = &.{ .{ .entry_id = 10, .row = 0 }, .{ .entry_id = 20, .row = 6 }, }, }; const full_measurement = full_transcript_screen.ProjectionMeasurement{ .total_rows = 30, .anchor_row = null, .item_rows = &.{ .{ .entry_id = 10, .row = 0 }, .{ .entry_id = 20, .row = 12 }, .{ .entry_id = 30, .row = 24 }, }, };
var tail = TranscriptRuntime{ .full_transcript = .{ .depth = .review } }; defer tail.deinit(alloc); try std.testing.expectEqual( @as(u32, 8), selectProjectionViewportOffset(&tail, review_measurement, 5), ); try std.testing.expect(try tail.setTranscriptPresentationDepth(alloc, .full)); try std.testing.expectEqual( @as(u32, 25), selectProjectionViewportOffset(&tail, full_measurement, 5), ); try std.testing.expect(tail.full_transcript.follow_tail);
var history = TranscriptRuntime{ .full_transcript = .{ .depth = .review } }; defer history.deinit(alloc); _ = selectProjectionViewportOffset(&history, review_measurement, 5); history.full_transcript = history.full_transcript.scroll(.up, 2); try std.testing.expectEqual( @as(u32, 6), selectProjectionViewportOffset(&history, review_measurement, 5), ); try std.testing.expect(try history.setTranscriptPresentationDepth(alloc, .full)); try std.testing.expectEqual( @as(u32, 12), selectProjectionViewportOffset(&history, full_measurement, 5), ); try std.testing.expect(!history.full_transcript.follow_tail); }
pub fn prepareTranscriptSurfacePaintFromSourceForArea( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, source: *const TranscriptPreparationSource, area: render_engine.frame_layout.FrameRect, ) !transcript_painter.PreparedTranscriptSurfacePaint { return self.prepareTranscriptSurfacePaintFromSourceForFrame( alloc, metrics, source, area, false, ); }
pub fn prepareTranscriptSurfacePaintFromSourceForFrame( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, source: *const TranscriptPreparationSource, area: render_engine.frame_layout.FrameRect, footer_reservation_changed: bool, ) !transcript_painter.PreparedTranscriptSurfacePaint { return transcript_painter.prepareTranscriptSurfacePaintFromSourceForFrame( self, alloc, metrics, source, area, footer_reservation_changed, ); }
pub fn prepareTranscriptSurfacePaintForArea( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, area: render_engine.frame_layout.FrameRect, ) !transcript_painter.PreparedTranscriptSurfacePaint { return transcript_painter.prepareTranscriptSurfacePaintForArea(self, alloc, metrics, area); }
pub fn prepareTranscriptSurfacePaintForAreaTrackingEntry( self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, area: render_engine.frame_layout.FrameRect, entry_id: ?u32, ) !transcript_painter.PreparedTranscriptSurfacePaint { return transcript_painter.prepareTranscriptSurfacePaintForAreaTrackingEntry( self, alloc, metrics, area, entry_id, ); }
pub fn previewTranscriptFlow( self: *TranscriptRuntime, alloc: Allocator, ) !render_engine.frame_layout.TranscriptFlowPreview { return transcript_painter.previewTranscriptFlow(self, alloc); }
pub fn paintPreparedTranscriptIntoSurface( self: *TranscriptRuntime, alloc: Allocator, surface: *render_engine.frame_surface.FrameSurface, prepared: *const transcript_painter.PreparedTranscriptSurfacePaint, ) !render_engine.paint_plan.TranscriptPaintResult { return transcript_painter.paintPreparedTranscriptIntoSurface(self, alloc, surface, prepared); }
pub fn markTranscriptDirty(self: *TranscriptRuntime) void { self.clearCodeCopyFrame(); self.transcript_band_dirty = true; self.render_requests.request(.transcript); }
pub fn markTranscriptContentDirty(self: *TranscriptRuntime) void { self.full_transcript_content_revision +%= 1; self.full_transcript_projection_cache.relationships.markDirtyAll(); self.full_transcript_projection_cache.full.markDirtyAll(); if (self.command_output_display.open_command_block == null) { self.full_transcript_review_revision +%= 1; self.full_transcript_projection_cache.review.markDirtyAll(); } debug_trace.logf( "full_transcript_cache", "content_dirty content_revision={d} review_revision={d} command_open={s}", .{ self.full_transcript_content_revision, self.full_transcript_review_revision, if (self.command_output_display.open_command_block == null) "false" else "true", }, ); self.markTranscriptDirty(); }
pub fn markTranscriptStructureDirty(self: *TranscriptRuntime) void { self.full_transcript_content_revision +%= 1; self.full_transcript_review_revision +%= 1; self.full_transcript_projection_cache.relationships.markDirtyAll(); self.full_transcript_projection_cache.full.markDirtyAll(); self.full_transcript_projection_cache.review.markDirtyAll(); debug_trace.logf( "full_transcript_cache", "structure_dirty content_revision={d} review_revision={d}", .{ self.full_transcript_content_revision, self.full_transcript_review_revision }, ); self.markTranscriptDirty(); }
fn transcriptEntryIndex(self: *const TranscriptRuntime, entry_id: u32) ?usize { var index = self.entries.items.len; while (index > 0) { index -= 1; if (self.entries.items[index].id() == entry_id) return index; } return null; }
pub fn markTranscriptContentDirtyFrom( self: *TranscriptRuntime, entry_id: u32, ) void { const entry_index = self.transcriptEntryIndex(entry_id) orelse { self.markTranscriptContentDirty(); return; }; self.full_transcript_content_revision +%= 1; self.full_transcript_projection_cache.relationships.markDirtyFrom(entry_id, entry_index); self.full_transcript_projection_cache.full.markDirtyFrom(entry_id, entry_index); if (self.command_output_display.open_command_block == null) { self.full_transcript_review_revision +%= 1; self.full_transcript_projection_cache.review.markDirtyFrom(entry_id, entry_index); } debug_trace.logf( "full_transcript_cache", "content_dirty_from entry_id={d} content_revision={d} review_revision={d} command_open={s}", .{ entry_id, self.full_transcript_content_revision, self.full_transcript_review_revision, if (self.command_output_display.open_command_block == null) "false" else "true", }, ); self.markTranscriptDirty(); }
pub fn markTranscriptCommandOutputDirty(self: *TranscriptRuntime) void { self.full_transcript_content_revision +%= 1; self.full_transcript_projection_cache.relationships.markDirtyAll(); self.full_transcript_projection_cache.full.markDirtyAll(); debug_trace.logf( "full_transcript_cache", "command_output_dirty content_revision={d} review_revision={d}", .{ self.full_transcript_content_revision, self.full_transcript_review_revision }, ); self.markTranscriptDirty(); }
pub fn markTranscriptCommandOutputDirtyFrom( self: *TranscriptRuntime, entry_id: u32, ) void { const entry_index = self.transcriptEntryIndex(entry_id) orelse { self.markTranscriptCommandOutputDirty(); return; }; self.full_transcript_content_revision +%= 1; self.full_transcript_projection_cache.relationships.markDirtyFrom(entry_id, entry_index); self.full_transcript_projection_cache.full.markDirtyFrom(entry_id, entry_index); debug_trace.logf( "full_transcript_cache", "command_output_dirty_from entry_id={d} content_revision={d} review_revision={d}", .{ entry_id, self.full_transcript_content_revision, self.full_transcript_review_revision, }, ); self.markTranscriptDirty(); }
pub fn recordFrameInvalidation( shell: *TranscriptRuntime, range: render_engine.paint_plan.FrameInvalidationRange, ) !void { if (range.top == 0 or range.bottom == 0 or range.bottom < range.top) { return error.InvalidFrameInvalidationRange; }
const request_invalidations = shell.render_requests.pendingInvalidations(); if (request_invalidations.len >= render_engine.paint_plan.max_frame_invalidation_ranges) { var collapsed = request_invalidations.collapsedWith(range); const bottom = if (shell.layout.rows == 0) range.bottom else shell.layout.rows; var top = if (shell.owned_top_row == 0) @as(u16, 1) else shell.owned_top_row; if (bottom == 0) { top = range.top; } else if (top > bottom) { top = 1; } collapsed.top = top; collapsed.bottom = bottom; debug_trace.logf( "frame_plan", "collapse_pending_invalidations count={d} incoming_reason={s} collapsed_reason={s} top={d} bottom={d}", .{ request_invalidations.len, @tagName(range.reason), @tagName(collapsed.reason), collapsed.top, collapsed.bottom, }, ); shell.render_requests.replacePendingInvalidation(collapsed); } else { shell.render_requests.requestInvalidation(range); } }
pub fn normalizeFrameInvalidations( shell: *const TranscriptRuntime, pending: *render_engine.paint_plan.FrameInvalidationSet, ) void { if (shell.layout.rows == 0) return; var i: usize = 0; while (i < pending.len) : (i += 1) { const range = &pending.items[i]; if (range.bottom <= shell.layout.rows and range.top <= range.bottom) continue; range.top = if (shell.owned_top_row == 0 or shell.owned_top_row > shell.layout.rows) 1 else shell.owned_top_row; range.bottom = shell.layout.rows; } }
/// Updates the capped terminal cursor and returns the uncapped text walk. /// Scroll calculations must use `result.end_row`, not `self.cursor_row`, /// which cannot represent overflow below the viewport. Wrap-exact walks may /// return `layout.cols + 1` in `end_col`. pub fn advanceCursor(self: *TranscriptRuntime, text: []const u8) WalkResult { const result = walkText(@as(u32, self.cursor_row), self.cursor_col, text, self.layout.cols); self.cursor_col = result.end_col; self.cursor_row = @intCast(@min(result.end_row, @as(u32, self.layout.rows))); return result; }
pub fn updateExtraInputRows(self: *TranscriptRuntime, alloc: Allocator, metrics: *Metrics, new_extra: u16) !void { _ = alloc; _ = metrics; if (new_extra == self.extra_input_rows) return; const old_extra = self.extra_input_rows; self.extra_input_rows = new_extra; self.markTranscriptDirty(); self.footer_viewport.invalidateAfterExternalClear();
if (self.layout.rows > 0) { const top = if (self.owned_top_row == 0 or self.owned_top_row > self.layout.rows) @as(u16, 1) else self.owned_top_row; try self.recordFrameInvalidation(.{ .reason = .external_clear, .top = top, .bottom = self.layout.rows, }); } debug_trace.logf( "frame_plan", "footer_extra_update_frame_deferred old={d} new={d} owned_top={d} rows={d}", .{ old_extra, new_extra, self.owned_top_row, self.layout.rows }, ); }
pub fn resetCursorTracking(self: *TranscriptRuntime) void { self.cursor_row = 1; self.cursor_col = 1; }};
fn frameBandsEqual(a: render_engine.paint_plan.FrameBand, b: render_engine.paint_plan.FrameBand) bool { return a.top == b.top and a.bottom == b.bottom and a.owner == b.owner;}
fn totalVisualRows(line_rows: []const u16) u32 { var total: u32 = 0; for (line_rows) |rows| { total += rows; } return total;}
const AcceptedTranscriptRows = struct { resize_reflow_rows: u16, semantic_rows: u32, semantic_progress_rows: u32,};
const TranscriptTransitionCommit = struct { accepted: AcceptedTranscriptRows, remaining_resize_reflow_rows: u16, remaining_semantic_rows: u32, remaining_semantic_progress_rows: u32, remaining_unplanned_scroll_rows: u16, complete: bool, stable: bool, committed_measured_history_origin: ?transcript_painter.MeasuredHistoryOrigin,};
const TranscriptRecoveryCommit = struct { accepted_visual_offset: u32, accepted_history_visual_offset: u32, materialized_visual_offset: u32, materialized_visual_rows: u16, materialized_flow_len: ?usize, materialized_cursor_row: u16, materialized_cursor_col: u16, document_append_committed: bool,};
fn resolveRecoveryMaterializedEndpoint( transition: *const TranscriptTransition, result: render_engine.terminal_diff.FrameCommitResult, commit: TranscriptTransitionCommit,) MaterializedEndpoint { const planned = transition.materialized; if (commit.complete or result.document_append_applied() or !transition.recovery_progress_compatible or !transition.recovery_tracks_semantic_progress or transition.recovery_rebase) { return planned; } return transition.materialized_without_append;}
fn resolveTranscriptTransitionCommit( transition: *const TranscriptTransition, result: render_engine.terminal_diff.FrameCommitResult, scroll_commit: render_engine.frame_scroll_plan.FrameScrollCommit,) TranscriptTransitionCommit { const accepted = acceptedTranscriptRowsForInlineRows( scroll_commit.accepted_rows.inline_advance_rows, transition.resize_reflow_rows, transition.semantic_rows, transition.semantic_progress_rows, ); const remaining_resize_reflow_rows = transition.resize_reflow_rows - accepted.resize_reflow_rows; const remaining_semantic_rows = transition.semantic_rows - accepted.semantic_rows; const remaining_semantic_progress_rows = transition.semantic_progress_rows - accepted.semantic_progress_rows; const remaining_unplanned_scroll_rows = scroll_commit.unplanned_terminal_scroll_rows; const complete = result.is_committed() and scroll_commit.complete(); return .{ .accepted = accepted, .remaining_resize_reflow_rows = remaining_resize_reflow_rows, .remaining_semantic_rows = remaining_semantic_rows, .remaining_semantic_progress_rows = remaining_semantic_progress_rows, .remaining_unplanned_scroll_rows = remaining_unplanned_scroll_rows, .complete = complete, .stable = complete and !transition.recovery_projection_deferred and remaining_resize_reflow_rows == 0 and remaining_semantic_rows == 0 and remaining_unplanned_scroll_rows == 0, .committed_measured_history_origin = transcript_painter.advanceMeasuredHistoryOriginForCommittedRows( transition.target_flow, transition.measured_history_origin, transition.target_layout.terminal_cols, accepted.resize_reflow_rows, ), };}
fn resolveTranscriptRecoveryCommit( runtime: *const TranscriptRuntime, transition: *const TranscriptTransition, result: render_engine.terminal_diff.FrameCommitResult, commit: TranscriptTransitionCommit,) TranscriptRecoveryCommit { const source_offset = switch (runtime.transcript_commit_state) { .stable => |anchor| anchor.visual_offset, .recovering => |receipt| receipt.accepted_visual_offset, .invalid => 0, }; const source_history_offset = switch (runtime.transcript_commit_state) { .stable => |anchor| anchor.history_visual_offset, .recovering => |receipt| receipt.accepted_history_visual_offset, .invalid => 0, }; const projection_base_offset = if (transition.recovery_rebase and !transition.recovery_progress_compatible) transition.visual_offset else source_offset; const accepted_visual_offset = projection_base_offset + commit.accepted.semantic_progress_rows; const materialized = resolveRecoveryMaterializedEndpoint(transition, result, commit); return .{ .accepted_visual_offset = accepted_visual_offset, .accepted_history_visual_offset = @min( transition.total_visual_rows, source_history_offset +| commit.accepted.semantic_rows, ), .materialized_visual_offset = materialized.visual_offset, .materialized_visual_rows = materialized.visual_rows, .materialized_flow_len = materialized.flow_len, .materialized_cursor_row = materialized.cursor_row, .materialized_cursor_col = materialized.cursor_col, .document_append_committed = transition.recovery_tracks_semantic_progress and materialized.visual_offset > accepted_visual_offset, };}
test "resume view snapshot captures visible transcript styling" { const alloc = std.testing.allocator; var runtime: TranscriptRuntime = .{}; defer runtime.deinit(alloc); runtime.layout = .{ .rows = 6, .cols = 12, .content_bottom = 3, .divider_top_row = 4, .input_row = 5, .divider_bottom_row = 5, .hint_row = 6, }; try runtime.enableShadowVt(alloc); try runtime.shadow_vt.?.feed( "\x1b[1;1Hnot cached\x1b[2;1H" ++ "\x1b]8;;https://example.com\x1b\\" ++ "\x1b[1;3;38;2;1;2;3m\x1b[48;5;245mvisible one\x1b[0m" ++ "\x1b]8;;\x1b\\\x1b[3;1H\x1b[31mvisible two\x1b[0m" ++ "\x1b[4;1Hfooter", ); runtime.has_painted_transcript = true; runtime.last_visible_transcript_top_row = 2; runtime.last_visible_transcript_last_row = 3;
var snapshot = (try runtime.snapshotVisibleTranscriptText(alloc, 128)).?; defer snapshot.deinit(alloc); try std.testing.expect(snapshot.complete); try std.testing.expectEqual(@as(u16, 6), snapshot.terminal_rows); try std.testing.expectEqual(@as(u16, 12), snapshot.terminal_cols); try std.testing.expectEqualStrings( "\x1b[0m\x1b[1m\x1b[3m\x1b[38;2;1;2;3m" ++ "\x1b[48;5;245mvisible one\x1b[0m\n" ++ "\x1b[0m\x1b[31mvisible two\x1b[0m\n", snapshot.text, );}
test "resume view snapshot preserves the committed footer gap" { const alloc = std.testing.allocator; var runtime: TranscriptRuntime = .{}; defer runtime.deinit(alloc); runtime.layout.rows = 6; runtime.layout.cols = 12; runtime.committed_frame_layout.footer_area = .{ .top = 4, .bottom = 6 }; try runtime.enableShadowVt(alloc); try runtime.shadow_vt.?.feed("\x1b[1;1Hvisible"); runtime.has_painted_transcript = true; runtime.last_visible_transcript_top_row = 1; runtime.last_visible_transcript_last_row = 1;
var snapshot = (try runtime.snapshotVisibleTranscriptText(alloc, 128)).?; defer snapshot.deinit(alloc); try std.testing.expect(snapshot.complete); try std.testing.expectEqualStrings("visible\n\n\n", snapshot.text);}
test "resume view snapshot omits a visible leading welcome entry" { const alloc = std.testing.allocator; var runtime: TranscriptRuntime = .{}; defer runtime.deinit(alloc); runtime.layout = .{ .rows = 6, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 6, .hint_row = 6, }; var metrics: Metrics = .{}; try runtime.writeTranscriptClassified( alloc, &metrics, "fx · Run /help for commands\n\n", true, .welcome, ); try runtime.enableShadowVt(alloc); try runtime.shadow_vt.?.feed( "\x1b[1;1Hfx · Run /help for commands" ++ "\x1b[3;1Hvisible one\x1b[4;1Hvisible two", ); runtime.has_painted_transcript = true; runtime.last_visible_transcript_top_row = 1; runtime.last_visible_transcript_last_row = 4; runtime.last_viewport_selection = .{ .top_row = 1, .bottom_row = 4, .start_line = 0, .partial_skip_rows = 0, .line_count = 4, };
var snapshot = (try runtime.snapshotVisibleTranscriptText(alloc, 128)).?; defer snapshot.deinit(alloc); try std.testing.expect(snapshot.complete); try std.testing.expectEqualStrings("visible one\nvisible two\n", snapshot.text);}
test "resume view snapshot keeps one complete UTF-8 row at the byte limit" { const alloc = std.testing.allocator; var runtime: TranscriptRuntime = .{}; defer runtime.deinit(alloc); runtime.layout.rows = 6; runtime.layout.cols = 12; try runtime.enableShadowVt(alloc); try runtime.shadow_vt.?.feed("\x1b[1;1Hééé"); runtime.has_painted_transcript = true; runtime.last_visible_transcript_top_row = 1; runtime.last_visible_transcript_last_row = 1;
var snapshot = (try runtime.snapshotVisibleTranscriptText(alloc, 7)).?; defer snapshot.deinit(alloc); try std.testing.expect(snapshot.complete); try std.testing.expectEqualStrings("ééé\n", snapshot.text); try std.testing.expect(std.unicode.utf8ValidateSlice(snapshot.text));}
test "resume view snapshot drops oldest rows and retains the newest tail" { const alloc = std.testing.allocator; var runtime: TranscriptRuntime = .{}; defer runtime.deinit(alloc); runtime.layout.rows = 6; runtime.layout.cols = 12; try runtime.enableShadowVt(alloc); try runtime.shadow_vt.?.feed( "\x1b[1;1Holdest\x1b[2;1Høø\x1b[3;1HTAIL", ); runtime.has_painted_transcript = true; runtime.last_visible_transcript_top_row = 1; runtime.last_visible_transcript_last_row = 3;
var snapshot = (try runtime.snapshotVisibleTranscriptText(alloc, 10)).?; defer snapshot.deinit(alloc); try std.testing.expect(!snapshot.complete); try std.testing.expectEqualStrings("øø\nTAIL\n", snapshot.text);}
test "resume view snapshot returns no text for empty visible rows" { const alloc = std.testing.allocator; var runtime: TranscriptRuntime = .{}; defer runtime.deinit(alloc); runtime.layout.rows = 6; runtime.layout.cols = 12; try runtime.enableShadowVt(alloc); runtime.has_painted_transcript = true; runtime.last_visible_transcript_top_row = 1; runtime.last_visible_transcript_last_row = 2;
try std.testing.expect( try runtime.snapshotVisibleTranscriptText(alloc, 128) == null, );}
fn acceptedTranscriptRows( scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan, committed_terminal_scroll_rows: u16, resize_reflow_rows: u16, semantic_rows: u32, semantic_progress_rows: u32,) AcceptedTranscriptRows { const accepted_scroll_rows = scroll_plan.commit(committed_terminal_scroll_rows).accepted_rows; return acceptedTranscriptRowsForInlineRows( accepted_scroll_rows.inline_advance_rows, resize_reflow_rows, semantic_rows, semantic_progress_rows, );}
fn acceptedTranscriptRowsForInlineRows( accepted_inline_rows: u32, resize_reflow_rows: u16, semantic_rows: u32, semantic_progress_rows: u32,) AcceptedTranscriptRows { const accepted_resize_reflow_rows: u16 = @intCast(@min( accepted_inline_rows, @as(u32, resize_reflow_rows), )); const accepted_semantic_rows = @min( accepted_inline_rows - @as(u32, accepted_resize_reflow_rows), semantic_rows, ); std.debug.assert(semantic_progress_rows <= semantic_rows); const unprojected_semantic_rows = semantic_rows - semantic_progress_rows; const accepted_unprojected_semantic_rows = @min( accepted_semantic_rows, unprojected_semantic_rows, ); return .{ .resize_reflow_rows = accepted_resize_reflow_rows, .semantic_rows = accepted_semantic_rows, .semantic_progress_rows = accepted_semantic_rows - accepted_unprojected_semantic_rows, };}
fn resolveAndSealTranscriptTransitionForRuntimeTest( runtime: *TranscriptRuntime, alloc: Allocator, source: *TranscriptPreparationSource, prepared: *transcript_painter.PreparedTranscriptSurfacePaint, target_layout: render_engine.frame_layout.CommittedLayoutSnapshot, plan: *render_engine.paint_plan.PaintPlan, scroll_plan: render_engine.frame_scroll_plan.FrameScrollPlan,) !TranscriptTransition { const scroll_facts = try runtime.prepareTranscriptScrollFactsForFrame( alloc, source, prepared, false, false, ); const destructive_invalidation = render_engine.frame_retention.transcriptAreaHasDestructiveInvalidation( runtime.committed_frame_layout.transcript_area, plan.invalidation, ); const resolved = try runtime.resolveTranscriptTransitionTargetForFrame( alloc, source, prepared, target_layout, scroll_plan, scroll_facts, destructive_invalidation, plan.activity == .overlay_entry, ); resolved.applyToPaintPlan(plan); return runtime.sealTranscriptTransition( alloc, source, prepared, plan, resolved, );}
fn testFrameCommitResult( committed_rows: u16, shadow_state: render_engine.terminal_diff.ShadowCommitState,) render_engine.terminal_diff.FrameCommitResult { return .{ .bytes_written = 1, .changed_cells = 1, .full_repaint = false, .terminal_scroll_rows_committed = committed_rows, .document_append_committed = false, .committed_cursor_row = 1, .committed_cursor_col = 1, .shadow_state = shadow_state, .next_invalidation = render_engine.paint_plan.FrameInvalidationSet.empty(), };}
test "transition commit snapshot derives accepted rows and stable state from frame result" { const scroll_plan = render_engine.frame_scroll_plan.merge(8, 1, 0, 2); var transition = TranscriptTransition{ .scroll_plan = scroll_plan, .document_append = .{}, .materialized_without_append = .{}, .resize_reflow_rows = 1, .semantic_rows = 1, .semantic_progress_rows = 1, .target_flow = &.{}, .target_cache = .empty, .folded_summary_indices = &.{}, .target_layout = .{ .terminal_rows = 8, .terminal_cols = 40, }, .selection = .{ .top_row = 1, .bottom_row = 4, .start_line = 0, .partial_skip_rows = 0, .line_count = 1, }, .visual_offset = 0, .history_visual_offset = 0, .total_visual_rows = 2, .cursor_row = 4, .cursor_col = 1, .replaceable_last_line = false, .replaceable_start = 0, .replaceable_row = 4, .trace_transcript_frame = false, .trace_visible_rows = 4, };
const partial_result = testFrameCommitResult(1, .terminal_partial_write); const partial = resolveTranscriptTransitionCommit( &transition, partial_result, scroll_plan.commit(partial_result.terminal_scroll_rows_committed), ); try std.testing.expectEqual(@as(u16, 1), partial.accepted.resize_reflow_rows); try std.testing.expectEqual(@as(u32, 0), partial.accepted.semantic_rows); try std.testing.expectEqual(@as(u16, 0), partial.remaining_resize_reflow_rows); try std.testing.expectEqual(@as(u32, 1), partial.remaining_semantic_rows); try std.testing.expect(!partial.complete); try std.testing.expect(!partial.stable);
const complete_result = testFrameCommitResult(2, .committed); const complete = resolveTranscriptTransitionCommit( &transition, complete_result, scroll_plan.commit(complete_result.terminal_scroll_rows_committed), ); try std.testing.expectEqual(@as(u16, 1), complete.accepted.resize_reflow_rows); try std.testing.expectEqual(@as(u32, 1), complete.accepted.semantic_rows); try std.testing.expectEqual(@as(u32, 1), complete.accepted.semantic_progress_rows); try std.testing.expectEqual(@as(u16, 0), complete.remaining_resize_reflow_rows); try std.testing.expectEqual(@as(u32, 0), complete.remaining_semantic_rows); try std.testing.expect(complete.complete); try std.testing.expect(complete.stable);
transition.recovery_projection_deferred = true; const deferred_result = testFrameCommitResult(2, .committed); const deferred = resolveTranscriptTransitionCommit( &transition, deferred_result, scroll_plan.commit(deferred_result.terminal_scroll_rows_committed), ); try std.testing.expect(deferred.complete); try std.testing.expect(!deferred.stable);}
test "resume recovery selects a safe materialized endpoint for every outcome" { var target_flow = [_]u8{ 'f', 'i', 'r', 's', 't', '\n', 's', 'e', 'c', 'o', 'n', 'd' }; const scroll_plan = render_engine.frame_scroll_plan.merge(8, 1, 0, 1); var runtime = TranscriptRuntime{ .layout = testLayoutWithRows(8), .committed_frame_layout = .{ .terminal_rows = 8, .terminal_cols = 80, .transcript_area = .{ .top = 1, .bottom = 8 }, }, }; defer runtime.deinit(std.testing.allocator); const document_append: render_engine.frame_scroll_plan.FrameDocumentAppend = .{ .bytes = "first\n", .start_row = 2, .start_col = 3, }; const planned: MaterializedEndpoint = .{ .visual_offset = 1, .visual_rows = 1, .flow_len = 6, .cursor_row = 3, .cursor_col = 1, }; var transition = TranscriptTransition{ .scroll_plan = scroll_plan, .document_append = document_append, .semantic_rows = 2, .semantic_progress_rows = 2, .recovery_progress_compatible = true, .recovery_tracks_semantic_progress = true, .target_flow = &target_flow, .target_cache = .empty, .folded_summary_indices = &.{}, .target_layout = .{ .terminal_rows = 8, .terminal_cols = 80, }, .selection = .{ .top_row = 1, .bottom_row = 8, .start_line = 0, .partial_skip_rows = 0, .line_count = 2, }, .visual_offset = 1, .history_visual_offset = 1, .total_visual_rows = 2, .materialized = planned, .materialized_without_append = runtime.materializedEndpointWithoutAppend( document_append, planned, ), .cursor_row = 3, .cursor_col = 1, .replaceable_last_line = false, .replaceable_start = 0, .replaceable_row = 3, .trace_transcript_frame = false, .trace_visible_rows = 2, }; const result = testFrameCommitResult(0, .terminal_partial_write); const commit = resolveTranscriptTransitionCommit( &transition, result, scroll_plan.commit(result.terminal_scroll_rows_committed), );
const unapplied = resolveTranscriptRecoveryCommit(&runtime, &transition, result, commit); try std.testing.expectEqual(@as(u32, 0), unapplied.materialized_visual_offset); try std.testing.expectEqual(@as(u16, 0), unapplied.materialized_visual_rows); try std.testing.expectEqual(@as(?usize, 0), unapplied.materialized_flow_len); try std.testing.expectEqual(@as(u16, 2), unapplied.materialized_cursor_row); try std.testing.expectEqual(@as(u16, 3), unapplied.materialized_cursor_col);
try std.testing.expectEqualDeep( transition.materialized_without_append, resolveRecoveryMaterializedEndpoint(&transition, result, commit), );
var complete_commit = commit; complete_commit.complete = true; try std.testing.expectEqualDeep( planned, resolveRecoveryMaterializedEndpoint(&transition, result, complete_commit), );
var appended_result = result; appended_result.document_append_committed = true; try std.testing.expectEqualDeep( planned, resolveRecoveryMaterializedEndpoint(&transition, appended_result, commit), );
transition.recovery_progress_compatible = false; try std.testing.expectEqualDeep( planned, resolveRecoveryMaterializedEndpoint(&transition, result, commit), ); transition.recovery_progress_compatible = true;
transition.recovery_tracks_semantic_progress = false; try std.testing.expectEqualDeep( planned, resolveRecoveryMaterializedEndpoint(&transition, result, commit), ); transition.recovery_tracks_semantic_progress = true;
transition.recovery_rebase = true; try std.testing.expectEqualDeep( planned, resolveRecoveryMaterializedEndpoint(&transition, result, commit), ); transition.recovery_rebase = false;
transition.document_append = .{}; transition.materialized_without_append = runtime.materializedEndpointWithoutAppend( .{}, planned, ); const absent = resolveTranscriptRecoveryCommit(&runtime, &transition, result, commit); try std.testing.expectEqual(@as(u32, 1), absent.materialized_visual_offset); try std.testing.expectEqual(@as(u16, 1), absent.materialized_visual_rows); try std.testing.expectEqual(@as(?usize, 6), absent.materialized_flow_len); try std.testing.expectEqual(@as(u16, 3), absent.materialized_cursor_row); try std.testing.expectEqual(@as(u16, 1), absent.materialized_cursor_col);}
test "partial resume publication retains its cursor and requests the next frame" { const alloc = std.testing.allocator; const scroll_plan = render_engine.frame_scroll_plan.merge(8, 1, 0, 128); var runtime = TranscriptRuntime{ .layout = testLayoutWithRows(8) }; defer runtime.deinit(alloc); runtime.pending_resume_source = try source_preparation.prepareFullTranscriptViewportSource( &runtime, alloc, try alloc.dupe(u8, "pending"), ); var transition = TranscriptTransition{ .scroll_plan = scroll_plan, .document_append = .{}, .materialized_without_append = .{}, .semantic_rows = 256, .semantic_progress_rows = 256, .recovery_progress_compatible = true, .recovery_tracks_semantic_progress = true, .target_flow = runtime.pending_resume_source.?.bytes, .target_flow_owned = false, .target_cache = .empty, .target_cache_unchanged = true, .folded_summary_indices = &.{}, .target_layout = .{ .terminal_rows = 8, .terminal_cols = 40 }, .selection = .{ .top_row = 1, .bottom_row = 4, .start_line = 252, .partial_skip_rows = 0, .line_count = 256, }, .visual_offset = 256, .history_visual_offset = 128, .source_endpoint_visual_offset = 256, .total_visual_rows = 256, .cursor_row = 4, .cursor_col = 1, .replaceable_last_line = false, .replaceable_start = 0, .replaceable_row = 4, .trace_transcript_frame = false, .trace_visible_rows = 4, }; defer transition.deinit(alloc);
runtime.consumeTranscriptTransition( alloc, &transition, testFrameCommitResult(128, .committed), );
switch (runtime.transcript_commit_state) { .recovering => |receipt| { try std.testing.expectEqual(@as(u32, 128), receipt.accepted_visual_offset); try std.testing.expectEqual(@as(u32, 128), receipt.remaining_semantic_rows); }, .invalid, .stable => return error.TestExpectedRecoveringTranscript, } try std.testing.expectEqualStrings("pending", runtime.pendingResumeFlow()); try std.testing.expect(runtime.render_requests.hasReason(.transcript));}
test "owned stable transition traces a superseded pending resume source" { const alloc = std.testing.allocator; var tmp = std.testing.tmpDir(.{}); defer tmp.cleanup(); const root = try io_mod.dirRealpathAlloc(alloc, tmp.dir, "."); defer alloc.free(root); const trace_path = try std.fs.path.join(alloc, &.{ root, "resume-source-drop.log" }); defer alloc.free(trace_path);
debug_trace.resetForTest(); defer debug_trace.resetForTest(); try debug_trace.configureForTestWithScopes(alloc, trace_path, "session");
var runtime = TranscriptRuntime{ .layout = testLayoutWithRows(8) }; defer runtime.deinit(alloc); runtime.bindDetachedCommitAllocator(alloc); runtime.pending_resume_source = try source_preparation.prepareFullTranscriptViewportSource( &runtime, alloc, try alloc.dupe(u8, "stale"), ); var transition = TranscriptTransition{ .scroll_plan = render_engine.frame_scroll_plan.FrameScrollPlan.none(8, 1), .document_append = .{}, .target_flow = try alloc.dupe(u8, "fresh"), .target_cache = .empty, .folded_summary_indices = &.{}, .target_layout = .{ .terminal_rows = 8, .terminal_cols = 80 }, .selection = .{ .top_row = 1, .bottom_row = 1, .start_line = 0, .partial_skip_rows = 0, .line_count = 1, }, .visual_offset = 0, .history_visual_offset = 0, .total_visual_rows = 1, .materialized_without_append = .{}, .cursor_row = 1, .cursor_col = 6, .replaceable_last_line = false, .replaceable_start = 0, .replaceable_row = 1, .trace_transcript_frame = false, .trace_visible_rows = 1, }; defer transition.deinit(alloc);
runtime.consumeTranscriptTransition( alloc, &transition, testFrameCommitResult(0, .committed), ); debug_trace.shutdown();
var trace_file = try std.Io.Dir.openFileAbsolute(std.testing.io, trace_path, .{}); defer trace_file.close(std.testing.io); const trace = try io_mod.readFileToEnd(alloc, &trace_file, 4096); defer alloc.free(trace); try std.testing.expect(std.mem.find( u8, trace, "pending resume flow dropped reason=superseded bytes=5", ) != null);}
test "stable resume publication starts a fresh retained source epoch" { const alloc = std.testing.allocator; const retained_flow = "tail-1\n" ++ "tail-2\n" ++ "tail-3\n" ++ "tail-final"; const full_flow = "old-1\nold-2\nold-3\nold-4\n" ++ "old-5\nold-6\nold-7\nold-8\n" ++ retained_flow; const layout: Layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }; var runtime = TranscriptRuntime{ .layout = layout, .owned_top_row = 1, .viewport_top_row = 1, }; defer runtime.deinit(alloc); try runtime.enableShadowVt(alloc); runtime.pending_resume_source = try source_preparation.prepareFullTranscriptViewportSource( &runtime, alloc, try alloc.dupe(u8, full_flow), ); try runtime.transcript.appendSlice(alloc, retained_flow);
var transition = TranscriptTransition{ .scroll_plan = render_engine.frame_scroll_plan.FrameScrollPlan.none( layout.rows, runtime.owned_top_row, ), .document_append = .{}, .materialized_without_append = .{}, .target_flow = runtime.pending_resume_source.?.bytes, .target_flow_owned = false, .target_cache = .empty, .target_cache_unchanged = true, .folded_summary_indices = &.{}, .target_layout = .{ .layout_id = 17, .owned_top = 1, .owned_band = .{ .top = 1, .bottom = 8 }, .body_area = .{ .top = 1, .bottom = 4 }, .transcript_area = .{ .top = 1, .bottom = 4 }, .footer_area = .{ .top = 5, .bottom = 8 }, .solved_frame_height = 8, .terminal_rows = 8, .terminal_cols = 40, }, .selection = .{ .top_row = 1, .bottom_row = 4, .start_line = 8, .partial_skip_rows = 0, .line_count = 12, .last_visible_row = 4, }, .visual_offset = 8, .history_visual_offset = 8, .total_visual_rows = 12, .cursor_row = 4, .cursor_col = 11, .replaceable_last_line = false, .replaceable_start = 0, .replaceable_row = 4, .trace_transcript_frame = false, .trace_visible_rows = 4, }; defer transition.deinit(alloc); runtime.consumeTranscriptTransition( alloc, &transition, testFrameCommitResult(0, .committed), );
try std.testing.expectEqual(@as(usize, 0), runtime.pendingResumeFlow().len); try std.testing.expectEqualStrings(retained_flow, runtime.transcript.items); try std.testing.expectEqual( TranscriptCommitDiagnosticState.invalid, runtime.transcriptCommitDiagnostic().state, );
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); try std.testing.expectEqualStrings(retained_flow, source.bytes); var metrics: Metrics = .{}; var prepared = try runtime.prepareTranscriptSurfacePaintFromSourceForArea( alloc, &metrics, &source, .{ .top = 1, .bottom = 4 }, ); defer prepared.deinit(alloc); try std.testing.expectEqual(@as(usize, 0), prepared.selection.start_line); try std.testing.expectEqual(@as(usize, 4), prepared.selection.line_count); try std.testing.expectEqual(@as(u16, 4), prepared.cursor.cursor_row);
const facts = runtime.planTranscriptScroll(&prepared); try std.testing.expectEqual(@as(u16, 0), facts.planned_rows); try std.testing.expectEqual(@as(u32, 0), facts.target_visual_offset); try std.testing.expect(facts.recovery_rebase);}
test "oversized resume publication retains bounded recovery progress" { const alloc = std.testing.allocator; const layout = invalidationTestLayout(); var runtime = TranscriptRuntime{ .layout = layout, .owned_top_row = 1, .committed_frame_layout = .{ .terminal_rows = layout.rows, .terminal_cols = layout.cols, }, }; defer runtime.deinit(alloc);
var flow: std.ArrayList(u8) = .empty; defer flow.deinit(alloc); for (0..@as(usize, std.math.maxInt(u16)) + 21) |_| { try flow.appendSlice(alloc, "row\n"); } runtime.pending_resume_source = try source_preparation.prepareFullTranscriptViewportSource( &runtime, alloc, try alloc.dupe(u8, flow.items), );
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); var metrics: Metrics = .{}; var prepared = try runtime.prepareTranscriptSurfacePaintFromSourceForArea( alloc, &metrics, &source, .{ .top = 1, .bottom = layout.content_bottom }, ); defer prepared.deinit(alloc);
const facts = runtime.planTranscriptScroll(&prepared); try std.testing.expect(facts.target_visual_offset > std.math.maxInt(u16)); try std.testing.expectEqual(@as(u32, std.math.maxInt(u16)), facts.semantic_rows); try std.testing.expectEqual( @as(u16, resume_publication_rows_per_frame), facts.planned_rows, ); try std.testing.expect(facts.recovery_progress_compatible); try std.testing.expect(facts.recovery_tracks_semantic_progress); const scroll_plan = render_engine.frame_scroll_plan.merge( layout.rows, runtime.owned_top_row, 0, facts.planned_rows, ); const accepted = acceptedTranscriptRows( scroll_plan, scroll_plan.terminal_scroll_rows, facts.resize_reflow_rows, facts.semantic_rows, facts.semantic_progress_rows, ); try std.testing.expectEqual( @as(u32, resume_publication_rows_per_frame), accepted.semantic_rows, ); try std.testing.expect(accepted.semantic_rows < facts.semantic_rows);
const append_base = (try runtime.resolveTransitionAppendBase( &prepared, facts, false, source.bytes, facts.target_visual_offset, )) orelse return error.TestExpectedResumeAppendBase; try std.testing.expectEqual(@as(usize, 0), append_base.flow_len);}
test "transition commit keeps unplanned physical scroll as recovery debt" { const scroll_plan = render_engine.frame_scroll_plan.merge(8, 1, 0, 2); var transition = TranscriptTransition{ .scroll_plan = scroll_plan, .document_append = .{}, .materialized_without_append = .{}, .semantic_rows = 2, .semantic_progress_rows = 2, .target_flow = &.{}, .target_cache = .empty, .folded_summary_indices = &.{}, .target_layout = .{ .terminal_rows = 8, .terminal_cols = 40, }, .selection = .{ .top_row = 1, .bottom_row = 4, .start_line = 0, .partial_skip_rows = 0, .line_count = 2, }, .visual_offset = 0, .history_visual_offset = 0, .total_visual_rows = 2, .cursor_row = 4, .cursor_col = 1, .replaceable_last_line = false, .replaceable_start = 0, .replaceable_row = 4, .trace_transcript_frame = false, .trace_visible_rows = 4, };
const result = testFrameCommitResult(scroll_plan.terminal_scroll_rows + 1, .committed); const commit = resolveTranscriptTransitionCommit( &transition, result, scroll_plan.commit(result.terminal_scroll_rows_committed), ); try std.testing.expectEqual(@as(u32, 2), commit.accepted.semantic_rows); try std.testing.expectEqual(@as(u32, 0), commit.remaining_semantic_rows); try std.testing.expectEqual(@as(u16, 1), commit.remaining_unplanned_scroll_rows); try std.testing.expect(!commit.complete); try std.testing.expect(!commit.stable);
var runtime = TranscriptRuntime{ .layout = testLayoutWithRows(8), .owned_top_row = 1, .viewport_top_row = 1, }; defer runtime.deinit(std.testing.allocator); runtime.consumeFrameScrollCommit( std.testing.allocator, scroll_plan, result, &transition, ); const diagnostic = runtime.transcriptCommitDiagnostic(); try std.testing.expectEqual(TranscriptCommitDiagnosticState.recovering, diagnostic.state); try std.testing.expectEqual(@as(u16, 1), diagnostic.remaining_unplanned_scroll_rows);}
fn frameInlineScrollBudget(resize_reflow_rows: u16, semantic_rows: u32) u16 { return frameInlineScrollBudgetCapped( resize_reflow_rows, semantic_rows, std.math.maxInt(u32), );}
test "pending resume publication yields after a bounded row batch" { const alloc = std.testing.allocator; var runtime: TranscriptRuntime = .{}; defer runtime.deinit(alloc); const prepared = transcript_painter.PreparedTranscriptSurfacePaint{ .selection = .{ .top_row = 1, .bottom_row = 1, .start_line = 0, .partial_skip_rows = 0, .line_count = 1, } };
try std.testing.expectEqual( @as(u16, 1_000), runtime.plannedTranscriptRows(&prepared, 0, 0, 1_000, 0), ); runtime.pending_resume_source = try source_preparation.prepareFullTranscriptViewportSource( &runtime, alloc, try alloc.dupe(u8, "pending"), ); try std.testing.expectEqual( @as(u16, resume_publication_rows_per_frame), runtime.plannedTranscriptRows(&prepared, 0, 0, 1_000, 0), );}
fn frameInlineScrollBudgetCapped( resize_reflow_rows: u16, semantic_rows: u32, semantic_cap: u32,) u16 { const semantic_budget = @min( @min(semantic_rows, semantic_cap), @as(u32, std.math.maxInt(u16) - resize_reflow_rows), ); return resize_reflow_rows + @as(u16, @intCast(semantic_budget));}
fn projectionVisualRows(total_visual_rows: u32, visual_offset: u32) u16 { return @intCast(@min( total_visual_rows -| visual_offset, @as(u32, std.math.maxInt(u16)), ));}
fn projectionVisualRowsInArea( total_visual_rows: u32, visual_offset: u32, area: render_engine.frame_layout.FrameRect,) u16 { if (area.isEmpty()) return 0; return @min( projectionVisualRows(total_visual_rows, visual_offset), area.height(), );}
fn visualOffsetForSelection(line_rows: []const u16, selection: ViewportSelection) u32 { var offset: u32 = 0; const end = @min(selection.start_line, line_rows.len); for (line_rows[0..end]) |rows| { offset += rows; } return offset + selection.partial_skip_rows;}
fn reflowedRows( grid: *const vt_emulator.Grid, start_row: u16, end_row: u16, target_cols: u16, include_cursor: bool,) u32 { if (target_cols == 0 or start_row == 0 or start_row > end_row or start_row > grid.rows) return 0;
var total: u32 = 0; var row = start_row; const last_row = @min(end_row, grid.rows); while (row <= last_row) : (row += 1) { var occupied_col: u16 = 0; var col: u16 = 1; while (col <= grid.cols) : (col += 1) { const cell = grid.cellAt(row, col).?; if (cell.codepoint != ' ' or cell.combining_suffix_id != 0 or !cell.style.eql(.{})) { occupied_col = col; } } if (include_cursor and row == grid.cursor_row) { occupied_col = @max(occupied_col, grid.cursor_col); } total += if (occupied_col == 0) 1 else (@as(u32, occupied_col) - 1) / target_cols + 1; } return total;}
test "reflowed rows count a combining suffix attached to a space" { var grid = try vt_emulator.Grid.init(std.testing.allocator, 4, 1); defer grid.deinit(); try grid.feed(" \u{0301}");
try std.testing.expectEqual( @as(u32, 2), reflowedRows(&grid, 1, 1, 2, false), );}
fn invalidationTestLayout() Layout { return .{ .rows = 24, .cols = 80, .content_bottom = 20, .divider_top_row = 21, .input_row = 22, .divider_bottom_row = 23, .hint_row = 24, };}
test "frame invalidations move into one request snapshot" { var runtime = TranscriptRuntime{ .layout = invalidationTestLayout(), .owned_top_row = 5 }; defer runtime.deinit(std.testing.allocator);
try runtime.recordFrameInvalidation(.{ .reason = .resize, .top = 5, .bottom = 24 }); try runtime.recordFrameInvalidation(.{ .reason = .external_clear, .top = 21, .bottom = 24 });
var attempt = (try runtime.render_requests.beginAttempt()).?; try std.testing.expectEqual(@as(u8, 2), attempt.snapshot.invalidations.len); try std.testing.expectEqual(render_engine.paint_plan.FrameInvalidationReason.resize, attempt.snapshot.invalidations.ranges()[0].reason); try std.testing.expectEqual(render_engine.paint_plan.FrameInvalidationReason.external_clear, attempt.snapshot.invalidations.ranges()[1].reason); attempt.commit(0, render_request.animation_interval_ms, false); try std.testing.expect((try runtime.render_requests.beginAttempt()) == null);}
test "recording a frame invalidation schedules request-owned work" { var runtime = TranscriptRuntime{ .layout = invalidationTestLayout(), .owned_top_row = 5 }; defer runtime.deinit(std.testing.allocator);
try runtime.recordFrameInvalidation(.{ .reason = .external_clear, .top = 5, .bottom = 24 });
try std.testing.expect(runtime.render_requests.hasReason(.external_damage));}
test "terminal reset drops stale mid-scrollback footer clear before reanchor" { var metrics: Metrics = .{}; var runtime = TranscriptRuntime{ .layout = .{ .rows = 36, .cols = 120, .content_bottom = 32, .divider_top_row = 33, .input_row = 34, .divider_bottom_row = 35, .hint_row = 36, }, .owned_top_row = 22, .viewport_top_row = 22, .has_painted_transcript = true, .min_visible_viewport_rows = 11, }; defer runtime.deinit(std.testing.allocator); runtime.footer_viewport.has_frame = true; runtime.footer_viewport.geometry.top = 25; runtime.footer_viewport.externally_invalidated = true;
try runtime.recordFrameInvalidation(.{ .reason = .external_clear, .top = 25, .bottom = 36, });
try runtime.requestTerminalReset(&metrics);
try std.testing.expectEqual(@as(u16, 1), runtime.owned_top_row); try std.testing.expectEqual(@as(u16, 1), runtime.viewport_top_row); try std.testing.expect(!runtime.footer_viewport.has_frame); try std.testing.expect(!runtime.footer_viewport.externally_invalidated);
const pending = runtime.render_requests.pendingInvalidations(); try std.testing.expectEqual(@as(u8, 1), pending.len); try std.testing.expectEqual( render_engine.paint_plan.FrameInvalidationReason.viewport_reanchor, pending.ranges()[0].reason, ); try std.testing.expectEqual(@as(u16, 1), pending.ranges()[0].top); try std.testing.expectEqual(@as(u16, 36), pending.ranges()[0].bottom);
var plan = render_engine.paint_plan.PaintPlan{ .layout = runtime.layout, .viewport = .{ .top_row = 1, .bottom_row = 3, .start_line = 0, .partial_skip_rows = 0, .line_count = 3, .last_visible_row = 3, .last_visible_row_blank = false, .tail_kind = null, .replaceable_start_row = 1, .split_active = false, .split_prefix_lines = 0, .split_suffix_start_line = 0, }, .footer = .{ .top = 4, .top_divider = 4, .banner = 4, .banner_active = false, .input_base = 5, .picker_divider = 6, .picker_start = 7, .bottom_divider = 6, .hint = 7, .total_rows = 4, }, .activity = .none, .preserved_band = render_engine.paint_plan.FrameBand.empty(.preserved_shell), .transcript_band = .{ .top = 1, .bottom = 3, .owner = .transcript }, .blank_band = render_engine.paint_plan.FrameBand.empty(.gap), .activity_band = render_engine.paint_plan.FrameBand.empty(.activity), .footer_gap_band = render_engine.paint_plan.FrameBand.empty(.gap), .footer_band = .{ .top = 4, .bottom = 7, .owner = .footer }, .invalidation = pending, .footer_clean_allowed = false, .synchronized_update = false, .cursor_target = null, .footer_reservation_source = .none, .bottom_reserved_rows = 0, .preserve_scrollback = true, }; try plan.validate();
try std.testing.expectError( error.InvalidInvalidationRange, render_engine.paint_plan.validateInvalidationRange(plan, .{ .reason = .external_clear, .top = 25, .bottom = 36, }), );}
test "marking transcript cache dirty also schedules transcript work" { var runtime = TranscriptRuntime{}; defer runtime.deinit(std.testing.allocator);
runtime.markTranscriptDirty();
try std.testing.expect(runtime.transcript_band_dirty); try std.testing.expect(runtime.render_requests.hasReason(.transcript));}
test "frame invalidation overflow collapses to owned band with dominant reason" { var runtime = TranscriptRuntime{ .layout = invalidationTestLayout(), .owned_top_row = 7 }; defer runtime.deinit(std.testing.allocator);
var i: u8 = 0; while (i < render_engine.paint_plan.max_frame_invalidation_ranges) : (i += 1) { const row: u16 = 7 + i; try runtime.recordFrameInvalidation(.{ .reason = .external_clear, .top = row, .bottom = row }); } try runtime.recordFrameInvalidation(.{ .reason = .shadow_feed_failure, .top = 12, .bottom = 12 });
const pending = runtime.render_requests.pendingInvalidations(); try std.testing.expectEqual(@as(u8, 1), pending.len); try std.testing.expectEqual(render_engine.paint_plan.FrameInvalidationReason.shadow_feed_failure, pending.ranges()[0].reason); try std.testing.expectEqual(@as(u16, 7), pending.ranges()[0].top); try std.testing.expectEqual(@as(u16, 24), pending.ranges()[0].bottom);}
test "preserved row acknowledgment lowers ownership and viewport boundaries" { var runtime = TranscriptRuntime{ .layout = invalidationTestLayout(), .owned_top_row = 5, .viewport_top_row = 7, }; defer runtime.deinit(std.testing.allocator); const scroll_plan = render_engine.frame_scroll_plan.merge(runtime.layout.rows, runtime.owned_top_row, 2, 0);
try runtime.ackPreservedRowRelease(scroll_plan, 2);
try std.testing.expectEqual(@as(u16, 3), runtime.owned_top_row); try std.testing.expectEqual(@as(u16, 5), runtime.viewport_top_row);}
test "preserved row acknowledgment applies only committed rows inside the plan" { var partial = TranscriptRuntime{ .layout = invalidationTestLayout(), .owned_top_row = 5, .viewport_top_row = 7, }; defer partial.deinit(std.testing.allocator); const scroll_plan = render_engine.frame_scroll_plan.merge(partial.layout.rows, partial.owned_top_row, 2, 0);
try partial.ackPreservedRowRelease(scroll_plan, 1); try std.testing.expectEqual(@as(u16, 4), partial.owned_top_row); try std.testing.expectEqual(@as(u16, 6), partial.viewport_top_row);
var above_plan = TranscriptRuntime{ .layout = invalidationTestLayout(), .owned_top_row = 5, .viewport_top_row = 7, }; defer above_plan.deinit(std.testing.allocator); try above_plan.ackPreservedRowRelease(scroll_plan, 20); try std.testing.expectEqual(@as(u16, 3), above_plan.owned_top_row); try std.testing.expectEqual(@as(u16, 5), above_plan.viewport_top_row);}
test "preserved row acknowledgment normalizes stale resize boundaries before release" { var full = TranscriptRuntime{ .layout = testLayoutWithRows(5), .owned_top_row = 8, .viewport_top_row = 9, }; defer full.deinit(std.testing.allocator); const full_plan = render_engine.frame_scroll_plan.merge(full.layout.rows, full.owned_top_row, 4, 0); try full.ackPreservedRowRelease(full_plan, 4); try std.testing.expectEqual(@as(u16, 1), full.owned_top_row); try std.testing.expectEqual(@as(u16, 1), full.viewport_top_row);
var partial = TranscriptRuntime{ .layout = testLayoutWithRows(5), .owned_top_row = 8, .viewport_top_row = 9, }; defer partial.deinit(std.testing.allocator); const partial_plan = render_engine.frame_scroll_plan.merge(partial.layout.rows, partial.owned_top_row, 4, 0); try partial.ackPreservedRowRelease(partial_plan, 2); try std.testing.expectEqual(@as(u16, 3), partial.owned_top_row); try std.testing.expectEqual(@as(u16, 3), partial.viewport_top_row);}
test "preserved row acknowledgment normalizes shrink boundaries even without accepted release" { var runtime = TranscriptRuntime{ .layout = testLayoutWithRows(5), .owned_top_row = 8, .viewport_top_row = 9, }; defer runtime.deinit(std.testing.allocator); const scroll_plan = render_engine.frame_scroll_plan.FrameScrollPlan.none(runtime.layout.rows, runtime.owned_top_row);
try runtime.ackPreservedRowRelease(scroll_plan, 0);
try std.testing.expectEqual(@as(u16, 5), runtime.owned_top_row); try std.testing.expectEqual(@as(u16, 5), runtime.viewport_top_row);}
test "preserved row acknowledgment keeps viewport at or below owned top boundary" { var runtime = TranscriptRuntime{ .layout = invalidationTestLayout(), .owned_top_row = 5, .viewport_top_row = 2, }; defer runtime.deinit(std.testing.allocator); const scroll_plan = render_engine.frame_scroll_plan.merge(runtime.layout.rows, runtime.owned_top_row, 4, 0);
try runtime.ackPreservedRowRelease(scroll_plan, 4);
try std.testing.expectEqual(@as(u16, 1), runtime.owned_top_row); try std.testing.expectEqual(@as(u16, 1), runtime.viewport_top_row);}
test "transcript runtime owns render request state" { try std.testing.expect(@hasField(TranscriptRuntime, "render_requests"));}
test "recovery append prefix requires exact materialized bytes" { const alloc = std.testing.allocator; const receipt_flow = try alloc.dupe(u8, "prefix-good"); defer alloc.free(receipt_flow); const receipt = TranscriptRecoveryReceipt{ .flow = receipt_flow, .materialized_flow_len = 7, };
try std.testing.expect(recoveryAppendPrefixMatches("prefix-next", receipt, 7)); try std.testing.expect(!recoveryAppendPrefixMatches("prefiy-next", receipt, 7)); try std.testing.expect(!recoveryAppendPrefixMatches("short", receipt, 7));}
test "measured recovery rebases from accepted projection before retiring resize debt" { const alloc = std.testing.allocator; const flow = "aaaaaaaaaaaaaaaaaaaa\n" ++ "bbbbbbbbbbbbbbbbbbbb\n" ++ "cccccccccccccccccccc\n" ++ "dddddddddddddddddddd\n" ++ "eeeeeeeeeeeeeeeeeeee\n" ++ "ffffffffffffffffffff\n" ++ "gggggggggggggggggggg\n" ++ "hhhhhhhhhhhhhhhhhhhh\n"; const layout: Layout = .{ .rows = 8, .cols = 10, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }; var runtime = TranscriptRuntime{ .layout = layout, .owned_top_row = 1, .resize_history_row_delta = 2, .committed_frame_layout = .{ .layout_id = 17, .owned_top = 1, .owned_band = .{ .top = 1, .bottom = 8 }, .body_area = .{ .top = 1, .bottom = 4 }, .transcript_area = .{ .top = 1, .bottom = 4 }, .footer_area = .{ .top = 5, .bottom = 8 }, .solved_frame_height = 8, .terminal_rows = 8, .terminal_cols = 20, }, }; defer runtime.deinit(alloc); try runtime.transcript.appendSlice(alloc, flow); runtime.transcript_commit_state = .{ .recovering = .{ .accepted_visual_offset = 6, .accepted_history_visual_offset = 6, .attempt_visual_offset = 8, .attempt_total_visual_rows = 8, .materialized_visual_offset = 7, .materialized_visual_rows = 1, .materialized_flow_len = flow.len, .remaining_resize_reflow_rows = 3, .remaining_semantic_rows = 2, .remaining_semantic_progress_rows = 2, .attempt_cols = 20, .projection_rebase_pending = false, .tracks_semantic_progress = true, .flow = try alloc.dupe(u8, flow), .cursor_row = 4, .cursor_col = 1, } }; const projection = runtime.measuredResizeProjectionForFlow(flow) orelse return error.TestExpectedMeasuredResizeProjection; switch (projection) { .stable => return error.TestExpectedRecoveringProjection, .recovering => |recovering| { try std.testing.expectEqual( @as(u32, 6), recovering.accepted_visual_offset, ); try std.testing.expectEqual(@as(u16, 20), recovering.source_cols); }, }
var source = try runtime.prepareTranscriptSource(alloc, null); defer source.deinit(alloc); var metrics: Metrics = .{}; var prepared = try runtime.prepareTranscriptSurfacePaintFromSourceForArea( alloc, &metrics, &source, .{ .top = 1, .bottom = 4 }, ); defer prepared.deinit(alloc);
try std.testing.expectEqual( transcript_painter.MeasuredResizeTargetProvenance.recovering, prepared.measured_resize_target_provenance, ); const endpoint = prepared.measured_history_origin.?.endpoint orelse return error.TestExpectedMeasuredHistoryEndpoint; try std.testing.expectEqual(@as(usize, 147), endpoint.flow_offset); try std.testing.expectEqual( @as(u32, 14), visualOffsetForSelection(prepared.sourceVisualRows(), prepared.selection), ); const facts = runtime.planTranscriptScroll(&prepared); try std.testing.expectEqual(@as(u16, 0), facts.resize_reflow_rows); try std.testing.expectEqual(@as(u16, 2), facts.semantic_rows); try std.testing.expectEqual(@as(u32, 14), facts.target_visual_offset);
const scroll_plan = render_engine.frame_scroll_plan.merge( runtime.layout.rows, runtime.owned_top_row, 0, facts.planned_rows, ); var plan: render_engine.paint_plan.PaintPlan = .{ .layout = runtime.layout, .viewport = prepared.selection, .footer = .{ .top = 5, .top_divider = 5, .banner = 5, .banner_active = false, .input_base = 6, .picker_divider = 7, .picker_start = 8, .bottom_divider = 7, .hint = 8, .total_rows = 4, }, .activity = .none, .preserved_band = render_engine.paint_plan.FrameBand.empty(.preserved_shell), .transcript_band = .{ .top = 1, .bottom = 4, .owner = .transcript }, .activity_band = render_engine.paint_plan.FrameBand.empty(.activity), .footer_band = .{ .top = 5, .bottom = 8, .owner = .footer }, .invalidation = render_engine.paint_plan.FrameInvalidationSet.empty(), .footer_clean_allowed = true, .synchronized_update = true, .cursor_target = .{ .row = prepared.cursor.cursor_row, .col = prepared.cursor.cursor_col, .visible = true, }, .footer_reservation_source = .none, .bottom_reserved_rows = 0, .preserve_scrollback = true, }; var transition = try resolveAndSealTranscriptTransitionForRuntimeTest( &runtime, alloc, &source, &prepared, render_engine.frame_layout.CommittedLayoutSnapshot.fromPaintPlan(plan), &plan, scroll_plan, ); defer transition.deinit(alloc); runtime.consumeTranscriptTransition(alloc, &transition, .{ .bytes_written = 1, .changed_cells = 1, .full_repaint = true, .terminal_scroll_rows_committed = 0, .document_append_committed = false, .committed_cursor_row = transition.cursor_row, .committed_cursor_col = transition.cursor_col, .shadow_state = .committed, .next_invalidation = render_engine.paint_plan.FrameInvalidationSet.empty(), });
const committed = runtime.transcriptCommitDiagnostic(); try std.testing.expectEqual(TranscriptCommitDiagnosticState.recovering, committed.state); try std.testing.expectEqual(@as(u32, 14), committed.visual_offset); switch (runtime.transcript_commit_state) { .recovering => |receipt| { try std.testing.expectEqual(@as(u16, 0), receipt.remaining_resize_reflow_rows); try std.testing.expectEqual(@as(u32, 2), receipt.remaining_semantic_rows); }, .invalid, .stable => return error.TestExpectedRecoveringTranscript, }
runtime.resize_history_row_delta = null; var retry_source = try runtime.prepareTranscriptSource(alloc, null); defer retry_source.deinit(alloc); var retry_prepared = try runtime.prepareTranscriptSurfacePaintFromSourceForArea( alloc, &metrics, &retry_source, .{ .top = 1, .bottom = 4 }, ); defer retry_prepared.deinit(alloc); const retry = runtime.planTranscriptScroll(&retry_prepared); try std.testing.expectEqual(@as(u16, 0), retry.resize_reflow_rows); try std.testing.expectEqual(@as(u16, 2), retry.semantic_rows);}
test "source rewrite replays unchanged history prefix after footer projection rebase" { const alloc = std.testing.allocator; const target_flow = "rewrite-row-01\nrewrite-row-02\nrewrite-row-03\nrewrite-row-04\n" ++ "rewrite-row-05\nrewrite-row-06\nrewrite-row-07\nrewrite-row-08\n" ++ "rewrite-row-09\nrewrite-row-10\nrewrite-row-11\nrewrite-row-12\n"; const layout: Layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }; var runtime = TranscriptRuntime{ .layout = layout, .owned_top_row = 1, .committed_frame_layout = .{ .layout_id = 17, .owned_top = 1, .owned_band = .{ .top = 1, .bottom = 8 }, .body_area = .{ .top = 1, .bottom = 4 }, .transcript_area = .{ .top = 1, .bottom = 4 }, .footer_area = .{ .top = 5, .bottom = 8 }, .solved_frame_height = 8, .terminal_rows = 8, .terminal_cols = 40, }, }; defer runtime.deinit(alloc);
var source = try runtime.prepareFullTranscriptViewportSource( alloc, try alloc.dupe(u8, target_flow), ); defer source.deinit(alloc); var metrics: Metrics = .{}; var prepared = try runtime.prepareTranscriptSurfacePaintFromSourceForArea( alloc, &metrics, &source, .{ .top = 1, .bottom = 4 }, ); defer prepared.deinit(alloc);
const target_offset = visualOffsetForSelection( prepared.sourceVisualRows(), prepared.selection, ); try std.testing.expect(target_offset > 5); const history_offset = target_offset - 5; const previous_flow = try alloc.dupe(u8, target_flow); previous_flow[previous_flow.len - 2] = 'X'; runtime.transcript_commit_state = .{ .stable = .{ .selection = prepared.selection, .visual_offset = target_offset, .history_visual_offset = history_offset, .total_visual_rows = totalVisualRows(prepared.sourceVisualRows()), .flow = previous_flow, .cursor_row = prepared.cursor.cursor_row, .cursor_col = prepared.cursor.cursor_col, .occupied_last_row = prepared.selection.last_visible_row, .occupied_last_row_blank = prepared.selection.last_visible_row_blank, .layout_id = 17, .normal_buffer_recovery_pending = true, } };
const facts = runtime.planTranscriptScroll(&prepared); try std.testing.expect(!facts.source_compatible); try std.testing.expect(facts.recovery_rebase); try std.testing.expectEqual(target_offset, facts.target_visual_offset); try std.testing.expectEqual(target_offset - history_offset, facts.semantic_rows);
const scroll_plan = render_engine.frame_scroll_plan.merge( runtime.layout.rows, runtime.owned_top_row, 0, facts.planned_rows, ); var plan: render_engine.paint_plan.PaintPlan = .{ .layout = runtime.layout, .viewport = prepared.selection, .footer = .{ .top = 5, .top_divider = 5, .banner = 5, .banner_active = false, .input_base = 6, .picker_divider = 7, .picker_start = 8, .bottom_divider = 7, .hint = 8, .total_rows = 4, }, .activity = .none, .preserved_band = render_engine.paint_plan.FrameBand.empty(.preserved_shell), .transcript_band = .{ .top = 1, .bottom = 4, .owner = .transcript }, .activity_band = render_engine.paint_plan.FrameBand.empty(.activity), .footer_band = .{ .top = 5, .bottom = 8, .owner = .footer }, .invalidation = render_engine.paint_plan.FrameInvalidationSet.empty(), .footer_clean_allowed = true, .synchronized_update = true, .cursor_target = .{ .row = prepared.cursor.cursor_row, .col = prepared.cursor.cursor_col, .visible = true, }, .footer_reservation_source = .none, .bottom_reserved_rows = 0, .preserve_scrollback = true, }; var transition = try resolveAndSealTranscriptTransitionForRuntimeTest( &runtime, alloc, &source, &prepared, render_engine.frame_layout.CommittedLayoutSnapshot.fromPaintPlan(plan), &plan, scroll_plan, ); defer transition.deinit(alloc); try std.testing.expect(!transition.document_append.isEmpty()); switch (transition.document_append.clear) { .rows => |rows| try std.testing.expectEqual( @as(u16, @intCast(facts.semantic_rows)), rows, ), .remainder => return error.TestExpectedHistoryReplay, }}
test "history replay starts at committed source top and follows resize eligibility" { const alloc = std.testing.allocator; const committed_flow = "source-row-01\nsource-row-02\nsource-row-03\nsource-row-04\n"; const target_flow = committed_flow ++ "target-row-05\ntarget-row-06\ntarget-row-07\ntarget-row-08\n" ++ "target-row-09\ntarget-row-10\ntarget-row-11\ntarget-row-12\n"; const layout: Layout = .{ .rows = 12, .cols = 40, .content_bottom = 8, .divider_top_row = 9, .input_row = 10, .divider_bottom_row = 11, .hint_row = 12, }; var runtime = TranscriptRuntime{ .layout = layout, .owned_top_row = 5, .viewport_top_row = 5, .committed_frame_layout = .{ .layout_id = 17, .owned_top = 5, .owned_band = .{ .top = 5, .bottom = 12 }, .body_area = .{ .top = 5, .bottom = 8 }, .transcript_area = .{ .top = 5, .bottom = 8 }, .footer_area = .{ .top = 9, .bottom = 12 }, .solved_frame_height = 8, .terminal_rows = 12, .terminal_cols = 40, }, .transcript_commit_state = .{ .stable = .{ .selection = .{ .top_row = 5, .bottom_row = 8, .start_line = 0, .partial_skip_rows = 0, .line_count = 4, .last_visible_row = 8, }, .visual_offset = 0, .history_visual_offset = 0, .total_visual_rows = 4, .flow = try alloc.dupe(u8, committed_flow), .cursor_row = 8, .cursor_col = 1, .occupied_last_row = 8, .occupied_last_row_blank = true, .layout_id = 17, .history_catchup_pending = true, } }, }; defer runtime.deinit(alloc);
var source = try runtime.prepareFullTranscriptViewportSource( alloc, try alloc.dupe(u8, target_flow), ); defer source.deinit(alloc); var metrics: Metrics = .{}; var prepared = try runtime.prepareTranscriptSurfacePaintFromSourceForArea( alloc, &metrics, &source, .{ .top = 1, .bottom = 8 }, ); defer prepared.deinit(alloc); try std.testing.expectEqual(@as(u16, 1), prepared.projectionArea().top);
const facts = runtime.planTranscriptScroll(&prepared); try std.testing.expect(facts.source_compatible); try std.testing.expectEqual(@as(u32, 4), facts.target_visual_offset); try std.testing.expectEqual(@as(u16, 4), facts.planned_rows);
const append_base = (try runtime.resolveTransitionAppendBase( &prepared, facts, false, source.bytes, facts.target_visual_offset, )) orelse return error.TestExpectedHistoryReplay; try std.testing.expect(append_base.history_replay != null); try std.testing.expectEqual( runtime.committed_frame_layout.transcript_area.top, append_base.cursor_row, ); try std.testing.expectEqual(@as(u16, 1), append_base.cursor_col);
const scroll_plan = render_engine.frame_scroll_plan.merge( runtime.layout.rows, runtime.owned_top_row, runtime.owned_top_row - 1, facts.planned_rows, ); try std.testing.expectEqual(@as(u16, 4), scroll_plan.preserved_release_rows); try std.testing.expectEqual(@as(u16, 8), scroll_plan.terminal_scroll_rows);
runtime.resize_history_row_delta = 1; const resize_facts = runtime.planTranscriptScroll(&prepared); const resize_append_base = (try runtime.resolveTransitionAppendBase( &prepared, resize_facts, false, source.bytes, resize_facts.target_visual_offset, )) orelse return error.TestExpectedNaturalAppendBase; try std.testing.expect(resize_append_base.history_replay == null);}
test "preserved source rewrite holds the normal buffer at committed history" { const alloc = std.testing.allocator; var runtime = TranscriptRuntime{ .layout = .{ .rows = 8, .cols = 40, .content_bottom = 4, .divider_top_row = 5, .input_row = 6, .divider_bottom_row = 7, .hint_row = 8, }, .committed_frame_layout = .{ .layout_id = 17, .owned_top = 1, .owned_band = .{ .top = 1, .bottom = 8 }, .body_area = .{ .top = 1, .bottom = 4 }, .transcript_area = .{ .top = 1, .bottom = 4 }, .footer_area = .{ .top = 5, .bottom = 8 }, .solved_frame_height = 8, .terminal_rows = 8, .terminal_cols = 40, }, .transcript_commit_state = .{ .stable = .{ .selection = .{ .top_row = 1, .bottom_row = 4, .start_line = 2, .partial_skip_rows = 0, .line_count = 6, .last_visible_row = 4, }, .visual_offset = 5, .history_visual_offset = 2, .total_visual_rows = 6, .flow = try alloc.dupe(u8, "old source\n"), .cursor_row = 4, .cursor_col = 1, .occupied_last_row = 4, .occupied_last_row_blank = false, .layout_id = 17, } }, }; defer runtime.deinit(alloc);
runtime.reconcileTranscriptCommitSourceWithRewriteMode( "rewritten source\n", false, "test rewrite", .preserve_same_epoch, );
switch (runtime.transcript_commit_state) { .stable => |anchor| { try std.testing.expect(anchor.normal_buffer_recovery_pending); try std.testing.expectEqual( anchor.history_visual_offset, committedProjectionVisualOffset(anchor), ); }, .invalid, .recovering => return error.TestExpectedStableTranscript, }}
test "frame scroll commit consumption releases rows before transition advancement" { var runtime = TranscriptRuntime{ .layout = testLayoutWithRows(8), .owned_top_row = 4, .viewport_top_row = 4, }; defer runtime.deinit(std.testing.allocator);
const scroll_plan = render_engine.frame_scroll_plan.merge(8, 4, 3, 1); var transition = TranscriptTransition{ .scroll_plan = scroll_plan, .document_append = .{}, .materialized_without_append = .{}, .semantic_rows = 1, .semantic_progress_rows = 1, .target_flow = &.{}, .target_cache = .empty, .folded_summary_indices = &.{}, .target_layout = .{ .layout_id = 18, .owned_top = 1, .owned_band = .{ .top = 1, .bottom = 8 }, .body_area = .{ .top = 1, .bottom = 4 }, .transcript_area = .{ .top = 1, .bottom = 4 }, .footer_area = .{ .top = 5, .bottom = 8 }, .solved_frame_height = 8, .terminal_rows = 8, .terminal_cols = 80, }, .selection = .{ .top_row = 1, .bottom_row = 4, .start_line = 1, .partial_skip_rows = 0, .line_count = 4, .last_visible_row = 4, }, .visual_offset = 1, .history_visual_offset = 1, .total_visual_rows = 5, .cursor_row = 4, .cursor_col = 1, .replaceable_last_line = false, .replaceable_start = 0, .replaceable_row = 4, .trace_transcript_frame = false, .trace_visible_rows = 4, }; defer transition.deinit(std.testing.allocator);
const result = testFrameCommitResult(scroll_plan.terminal_scroll_rows, .committed); runtime.consumeFrameScrollCommit( std.testing.allocator, scroll_plan, result, &transition, );
try std.testing.expect(transition.consumed); try std.testing.expectEqual(@as(u16, 1), runtime.owned_top_row); try std.testing.expectEqual(@as(u16, 1), runtime.viewport_top_row); const committed = runtime.transcriptCommitDiagnostic(); try std.testing.expectEqual(TranscriptCommitDiagnosticState.stable, committed.state); try std.testing.expectEqual(@as(u32, 1), committed.visual_offset);}
fn testLayoutWithRows(rows: u16) Layout { return .{ .rows = rows, .cols = 80, .content_bottom = rows, .divider_top_row = rows, .input_row = rows, .divider_bottom_row = rows, .hint_row = rows, };}
test "notification bell writes standalone BEL bytes" { var tmp = std.testing.tmpDir(.{}); defer tmp.cleanup(); var file = try tmp.dir.createFile(std.testing.io, "notification-bells.log", .{ .read = true }); defer file.close(io_mod.getIo());
var runtime = TranscriptRuntime{ .stdout_file = file }; defer runtime.deinit(std.testing.allocator); var metrics: Metrics = .{}; runtime.writeNotificationBell(&metrics);
var bytes: [1]u8 = undefined; try std.testing.expectEqual( @as(usize, 1), try file.readPositionalAll(io_mod.getIo(), &bytes, 0), ); try std.testing.expectEqualSlices(u8, "\x07", &bytes);}
test { _ = @import("runtime_tests.zig");}