Something went wrong. Try again.
opencode v2 mirror
Something went wrong. Try again.
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799188001880118802188031880418805188061880718808188091881018811188121881318814188151881618817188181881918820188211882218823188241882518826188271882818829188301883118832188331883418835188361883718838188391884018841188421884318844188451884618847188481884918850188511885218853188541885518856188571885818859188601886118862188631886418865188661886718868188691887018871188721887318874188751887618877188781887918880188811888218883188841888518886188871888818889188901889118892188931889418895188961889718898188991890018901189021890318904189051890618907189081890918910189111891218913189141891518916189171891818919189201892118922189231892418925189261892718928189291893018931189321893318934189351893618937189381893918940189411894218943189441894518946189471894818949189501895118952189531895418955189561895718958189591896018961189621896318964189651896618967189681896918970189711897218973189741897518976189771897818979189801898118982189831898418985189861898718988189891899018991189921899318994189951899618997189981899919000190011900219003190041900519006190071900819009190101901119012190131901419015190161901719018190191902019021190221902319024190251902619027190281902919030190311903219033190341903519036190371903819039190401904119042190431904419045190461904719048190491905019051190521905319054190551905619057190581905919060190611906219063190641906519066190671906819069190701907119072190731907419075190761907719078190791908019081190821908319084190851908619087190881908919090190911909219093190941909519096190971909819099191001910119102191031910419105191061910719108191091911019111191121911319114191151911619117191181911919120191211912219123191241912519126191271912819129191301913119132191331913419135191361913719138191391914019141191421914319144191451914619147191481914919150191511915219153191541915519156191571915819159191601916119162191631916419165191661916719168191691917019171191721917319174191751917619177191781917919180191811918219183191841918519186191871918819189191901919119192191931919419195191961919719198191991920019201192021920319204192051920619207192081920919210192111921219213192141921519216192171921819219192201922119222192231922419225192261922719228192291923019231192321923319234192351923619237192381923919240192411924219243192441924519246192471924819249192501925119252192531925419255192561925719258192591926019261192621926319264192651926619267192681926919270192711927219273192741927519276192771927819279192801928119282192831928419285192861928719288192891929019291192921929319294192951929619297192981929919300193011930219303193041930519306193071930819309193101931119312193131931419315193161931719318193191932019321193221932319324193251932619327193281932919330193311933219333193341933519336193371933819339193401934119342193431934419345193461934719348193491935019351193521935319354193551935619357{ "openapi": "3.1.0", "info": { "title": "opencode HttpApi", "version": "0.0.1", "description": "Experimental HttpApi surface for selected instance routes." }, "paths": { "/api/info": { "get": { "tags": ["server"], "operationId": "server.info", "parameters": [], "security": [], "responses": { "200": { "description": "ServerInfo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerInfo" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Return the server identity, connection URLs, paths, and readiness status.", "summary": "Get server info" } }, "/api/pair": { "post": { "tags": ["server"], "operationId": "server.pair", "parameters": [], "security": [], "responses": { "200": { "description": "PairingCode", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PairingCode" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Create a short-lived, single-use code for a /auth/connect/:code pairing link.", "summary": "Create pairing code" } }, "/auth/connect/{code}": { "get": { "tags": ["server"], "operationId": "server.connect", "parameters": [ { "name": "code", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "200": { "description": "PairingSession", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PairingSession" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" }, { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } ] } } } } }, "description": "Redeem a pairing code. Browsers receive a session cookie and a redirect to the web app; requests that accept JSON receive a session token to use as the password.", "summary": "Redeem pairing code" } }, "/api/location": { "get": { "tags": ["location"], "operationId": "location.get", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Location.PublicInfo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Location.PublicInfo" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Resolve the requested location or the server default location.", "summary": "Get location" } }, "/api/location/reload": { "post": { "tags": ["location"], "operationId": "location.reload", "parameters": [], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Shut down and rebuild every loaded location. Pending permissions and forms are cancelled; running sessions continue with fresh services at the next step boundary. Emits location.shutdown for client recovery and responds once all replacement builds settle.", "summary": "Reload configuration" } }, "/api/agent": { "get": { "tags": ["agent"], "operationId": "agent.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Agent.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve currently registered agents.", "summary": "List agents" } }, "/api/agent/{agentID}": { "get": { "tags": ["agent"], "operationId": "agent.get", "parameters": [ { "name": "agentID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Agent.Info" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "AgentNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentNotFoundErrorEncoded" } } } } }, "description": "Retrieve a single currently registered agent.", "summary": "Get agent" } }, "/api/plugin": { "get": { "tags": ["plugin"], "operationId": "plugin.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Plugin.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve enabled server plugins and their current status.", "summary": "List plugins" } }, "/api/plugin/check": { "post": { "tags": ["plugin"], "operationId": "plugin.check", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Plugin.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Check one or all package plugins for available updates.", "summary": "Check plugin updates", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "target": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "required": true } } }, "/api/plugin/update": { "post": { "tags": ["plugin"], "operationId": "plugin.update", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Update package plugins concurrently and notify active locations to reload them. Responds once every update has finished; fails when any update fails.", "summary": "Update plugins", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "string" } } }, "required": ["targets"], "additionalProperties": false } } }, "required": true } } }, "/api/session": { "get": { "tags": ["session"], "operationId": "session.list", "parameters": [ { "name": "limit", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Maximum number of sessions to return. Defaults to the newest 50 sessions." }, "required": false }, { "name": "order", "in": "query", "schema": { "anyOf": [ { "type": "string", "enum": ["asc", "desc"] }, { "type": "null" } ], "description": "Session order for the first page. Use desc for newest first or asc for oldest first." }, "required": false }, { "name": "search", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "parentID", "in": "query", "schema": { "anyOf": [ { "anyOf": [ { "type": "string", "pattern": "^ses" }, { "type": "string", "enum": ["null"] } ], "description": "Filter by parent session. Use null to return only root sessions." }, { "type": "null" } ] }, "required": false }, { "name": "directory", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "project", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "subpath", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "cursor", "in": "query", "schema": { "anyOf": [ { "type": "string", "description": "Opaque pagination cursor returned as cursor.previous or cursor.next in the previous response." }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "SessionsResponse", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionsResponse" } } } }, "400": { "description": "InvalidCursorError | InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidCursorErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve sessions in the requested order. Items keep that order across pages; use cursor.next or cursor.previous to move through the ordered list.", "summary": "List sessions" }, "post": { "tags": ["session"], "operationId": "session.create", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Create a session at the requested location.", "summary": "Create session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^ses" }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "agent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "model": { "anyOf": [ { "$ref": "#/components/schemas/Model.Ref" }, { "type": "null" } ] }, "location": { "anyOf": [ { "$ref": "#/components/schemas/Location.PublicRef" }, { "type": "null" } ] }, "metadata": { "anyOf": [ { "$ref": "#/components/schemas/Session.Metadata" }, { "type": "null" } ] }, "permissions": { "anyOf": [ { "$ref": "#/components/schemas/Permission.Ruleset" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "required": true } } }, "/api/experimental/session/stats": { "get": { "tags": ["session"], "operationId": "experimental.session.stats", "parameters": [ { "name": "from", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "to", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "project", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "timezone", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "tools", "in": "query", "schema": { "anyOf": [ { "type": "string", "enum": ["none", "summary", "detail"] }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SessionStats.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Aggregate local session activity, usage, and tool reliability for a time range.", "summary": "Get session statistics" } }, "/api/experimental/session/import": { "post": { "tags": ["session"], "operationId": "experimental.session.import", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } }, "409": { "description": "ConflictError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictErrorEncoded" } } } } }, "description": "Import a projected session transcript at the requested location. If parentID is supplied, the parent session must already exist; import parents before children.", "summary": "Import session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "info": { "$ref": "#/components/schemas/Session.Info" }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/Session.Message.Info" } }, "location": { "anyOf": [ { "$ref": "#/components/schemas/Location.PublicRef" }, { "type": "null" } ] } }, "required": ["info", "messages"], "additionalProperties": false } } }, "required": true } } }, "/api/experimental/session/{sessionID}/export": { "get": { "tags": ["session"], "operationId": "experimental.session.export", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "sanitize", "in": "query", "schema": { "anyOf": [ { "type": "string", "enum": ["true", "false"] }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SessionTransfer.Data" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } }, "500": { "description": "UnknownError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnknownErrorEncoded" } } } } }, "description": "Export a complete projected session transcript.", "summary": "Export session" } }, "/api/session/active": { "get": { "tags": ["session"], "operationId": "session.active", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "patternProperties": { "^ses": { "$ref": "#/components/schemas/SessionActive" } } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve foreground Session drains currently owned by this OpenCode process. Sessions absent from the result are inactive.", "summary": "List active sessions" } }, "/api/session/{sessionID}": { "get": { "tags": ["session"], "operationId": "session.get", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Retrieve a session by ID.", "summary": "Get session" }, "delete": { "tags": ["session"], "operationId": "session.remove", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Delete a session and its child sessions.", "summary": "Delete session" }, "patch": { "tags": ["session"], "operationId": "session.update", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Update mutable session properties.", "summary": "Update session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "metadata": { "anyOf": [ { "$ref": "#/components/schemas/Session.Metadata" }, { "type": "null" } ] }, "permissions": { "anyOf": [ { "$ref": "#/components/schemas/Permission.Ruleset" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/fork": { "post": { "tags": ["session"], "operationId": "session.fork", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | MessageNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/MessageNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Create a child session by copying projected history before a message. Omit before to copy the full history.", "summary": "Fork session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "before": { "anyOf": [ { "type": "string", "pattern": "^msg_" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/agent": { "post": { "tags": ["session"], "operationId": "session.switchAgent", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Switch the agent used by subsequent provider turns.", "summary": "Switch session agent", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "agent": { "type": "string" } }, "required": ["agent"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/model": { "post": { "tags": ["session"], "operationId": "session.switchModel", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Switch the model used by subsequent provider turns.", "summary": "Switch session model", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "model": { "$ref": "#/components/schemas/Model.Ref" } }, "required": ["model"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/move": { "post": { "tags": ["session"], "operationId": "session.move", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Move a session to another project directory at the requested delivery boundary.", "summary": "Move session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "directory": { "type": "string" }, "delivery": { "anyOf": [ { "$ref": "#/components/schemas/Session.Inbox.Delivery" }, { "type": "null" } ] } }, "required": ["directory"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/prompt": { "post": { "tags": ["session"], "operationId": "session.prompt", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Inbox.User" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "ConflictError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictErrorEncoded" } } } } }, "description": "Durably admit one session input and schedule agent-loop execution unless resume is false.", "summary": "Send message", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^msg_" }, { "type": "null" } ] }, "text": { "type": "string" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/PromptInput.FileAttachment" } }, "agents": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.AgentAttachment" } }, "skills": { "type": "array", "items": { "$ref": "#/components/schemas/PromptInput.SkillAttachment" } }, "metadata": { "type": "object" }, "delivery": { "anyOf": [ { "$ref": "#/components/schemas/Session.Inbox.Delivery" }, { "type": "null" } ] }, "resume": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": ["text"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/command": { "post": { "tags": ["session"], "operationId": "session.command", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | CommandNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/CommandNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "500": { "description": "CommandExecutionError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommandExecutionErrorEncoded" } } } } }, "description": "Execute a slash command callback immediately.", "summary": "Run command", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "text": { "type": "string" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/PromptInput.FileAttachment" } }, "agents": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.AgentAttachment" } }, "skills": { "type": "array", "items": { "$ref": "#/components/schemas/PromptInput.SkillAttachment" } }, "delivery": { "anyOf": [ { "$ref": "#/components/schemas/Session.Inbox.Delivery" }, { "type": "null" } ] } }, "required": ["name", "text"], "additionalProperties": false } } }, "required": true } } }, "/api/experimental/session/{sessionID}/skill": { "post": { "tags": ["session"], "operationId": "experimental.session.skill", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | SkillNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SkillNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Activate a skill for a session by appending a skill message and resuming execution.", "summary": "Activate skill", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "resume": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": ["id"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/synthetic": { "post": { "tags": ["session"], "operationId": "session.synthetic", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Inbox.Synthetic" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "ConflictError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictErrorEncoded" } } } } }, "description": "Durably admit synthetic session input and schedule execution unless resume is false.", "summary": "Add synthetic message", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^msg_" }, { "type": "null" } ] }, "text": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "metadata": { "type": "object" }, "delivery": { "anyOf": [ { "$ref": "#/components/schemas/Session.Inbox.Delivery" }, { "type": "null" } ] }, "resume": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": ["text"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/shell": { "post": { "tags": ["session"], "operationId": "session.shell", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Execute one shell command in the session's working directory. Emits a shell.started event before execution and a shell.ended event with the merged output after.", "summary": "Run shell command", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^msg_" }, { "type": "null" } ] }, "command": { "type": "string" } }, "required": ["command"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/compact": { "post": { "tags": ["session"], "operationId": "session.compact", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Inbox.Compaction" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "ConflictError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictErrorEncoded" } } } } }, "description": "Durably admit a session compaction request. Steers by default: it runs at the next step boundary instead of waiting behind queued prompts.", "summary": "Compact session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^msg_" }, { "type": "null" } ] }, "delivery": { "anyOf": [ { "$ref": "#/components/schemas/Session.Inbox.Delivery" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "required": true } } }, "/api/experimental/session/{sessionID}/wait": { "post": { "tags": ["session"], "operationId": "experimental.session.wait", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Wait for a session agent loop to become idle.", "summary": "Wait for session" } }, "/api/session/{sessionID}/revert/stage": { "post": { "tags": ["session"], "operationId": "session.revert.stage", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Revert" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "MessageNotFoundError | SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/MessageNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "SessionBusyError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionBusyErrorEncoded" } } } }, "500": { "description": "UnknownError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnknownErrorEncoded" } } } } }, "description": "Stage or move a reversible session boundary and optionally apply its file changes.", "summary": "Stage session revert", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "messageID": { "type": "string", "pattern": "^msg_" }, "files": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": ["messageID"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/revert": { "delete": { "tags": ["session"], "operationId": "session.revert.clear", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "SessionBusyError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionBusyErrorEncoded" } } } }, "500": { "description": "UnknownError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnknownErrorEncoded" } } } } }, "summary": "Clear staged revert" } }, "/api/session/{sessionID}/revert/commit": { "post": { "tags": ["session"], "operationId": "session.revert.commit", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "SessionBusyError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionBusyErrorEncoded" } } } } }, "summary": "Commit staged revert" } }, "/api/session/{sessionID}/context": { "get": { "tags": ["session"], "operationId": "session.context", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Session.Message.Info" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } }, "500": { "description": "UnknownError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnknownErrorEncoded" } } } } }, "description": "Retrieve the active context messages for a session (all messages after the last compaction).", "summary": "Get session context" } }, "/api/session/{sessionID}/diff": { "get": { "tags": ["session"], "operationId": "session.diff", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "from", "in": "query", "schema": { "anyOf": [ { "type": "string", "pattern": "^msg_" }, { "type": "null" } ], "description": "User message whose turn to diff. Defaults to the turn of the newest user message." }, "required": false }, { "name": "to", "in": "query", "schema": { "anyOf": [ { "type": "string", "pattern": "^msg_" }, { "type": "null" } ], "description": "Later user message whose turn ends the range. Defaults to the turn of `from` alone." }, "required": false }, { "name": "context", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Unchanged lines around each hunk. Omit for full-file patches." }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/FileDiff.Info" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "MessageNotFoundError | SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/MessageNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "500": { "description": "UnknownError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnknownErrorEncoded" } } } } }, "description": "Structured per-file diffs of the files a turn changed. A turn runs from the first prompt after the session was last idle until its next idle marker, so prompts steered in while it was busy belong to the same turn; `to` extends the range through a later turn. Compares the range's first recorded snapshot with its last; a step still running in the active session compares against the working copy. Ranges that span a location change are rejected. In sessions without any idle marker, a prompt's turn spans until the next user message.", "summary": "Diff session turns" } }, "/api/session/{sessionID}/inbox": { "get": { "tags": ["session"], "operationId": "session.inbox.list", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Session.Inbox.Info" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "List durable enqueued session work not yet delivered, ordered by enqueue sequence. Includes user, synthetic, compaction, and move items.", "summary": "List session inbox" } }, "/api/session/{sessionID}/inbox/{inboxID}": { "delete": { "tags": ["session"], "operationId": "session.inbox.cancel", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "inboxID", "in": "path", "schema": { "type": "string", "pattern": "^msg_" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Cancel an inbox item that has not yet been delivered. Unavailable items are a no-op.", "summary": "Cancel inbox input" }, "patch": { "tags": ["session"], "operationId": "session.inbox.update", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "inboxID", "in": "path", "schema": { "type": "string", "pattern": "^msg_" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } }, "409": { "description": "ConflictError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictErrorEncoded" } } } } }, "description": "Change a pending inbox item's delivery mode. Steering wakes session execution.", "summary": "Update inbox item", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "delivery": { "$ref": "#/components/schemas/Session.Inbox.Delivery" } }, "required": ["delivery"], "additionalProperties": false } } }, "required": true } } }, "/api/experimental/session/{sessionID}/instructions/entries": { "get": { "tags": ["session"], "operationId": "experimental.session.instructions.entry.list", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/InstructionEntry.Info" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "List API-managed instruction entries attached to the session.", "summary": "List instruction entries" } }, "/api/experimental/session/{sessionID}/instructions/entries/{key}": { "put": { "tags": ["session"], "operationId": "experimental.session.instructions.entry.put", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "key", "in": "path", "schema": { "$ref": "#/components/schemas/InstructionEntry.Key" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "413": { "description": "InstructionEntryValueTooLargeError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstructionEntryValueTooLargeErrorEncoded" } } } } }, "description": "Attach or replace one durable instruction entry. Changes announce as updates at the next step boundary.", "summary": "Put instruction entry", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "value": {} }, "required": ["value"], "additionalProperties": false } } }, "required": true } }, "delete": { "tags": ["session"], "operationId": "experimental.session.instructions.entry.remove", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "key", "in": "path", "schema": { "$ref": "#/components/schemas/InstructionEntry.Key" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Remove one instruction entry; the removal is announced to the model at the next step boundary.", "summary": "Remove instruction entry" } }, "/api/session/{sessionID}/generate": { "post": { "tags": ["session"], "operationId": "session.generate", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "SessionGenerateResponse", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionGenerateResponse" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Generate transient text from the current session context without mutating session history.", "summary": "Generate text from session context", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "prompt": { "type": "string" } }, "required": ["prompt"], "additionalProperties": false } } }, "required": true } } }, "/api/experimental/session/{sessionID}/log": { "get": { "tags": ["session"], "operationId": "session.log", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "after", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "follow", "in": "query", "schema": { "anyOf": [ { "type": "string", "enum": ["true", "false"] }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "text/event-stream": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "event": { "type": "string" }, "data": { "$ref": "#/components/schemas/SessionLogItemEncoded" } }, "required": ["id", "event", "data"], "additionalProperties": false }, "x-effect-stream": { "encoding": "sse", "causeSchema": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["Fail"] }, "error": { "not": {} } }, "required": ["_tag", "error"], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["Die"] }, "defect": {} }, "required": ["_tag", "defect"], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["Interrupt"] }, "fiberId": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": ["_tag", "fiberId"], "additionalProperties": false } ] } }, "errorSchema": { "not": {} }, "failureEvent": "effect/httpapi/stream/failure" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Experimental durable session event log. Reads events after an exclusive aggregate sequence and continues with live events when follow=true.", "summary": "Read the session log" } }, "/api/session/{sessionID}/interrupt": { "post": { "tags": ["session"], "operationId": "session.interrupt", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "resume", "in": "query", "schema": { "anyOf": [ { "type": "string", "enum": ["true", "false"] }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "SessionInterruptResponse", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionInterruptResponse" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Interrupt active execution owned by this OpenCode process. Returns interrupted=true when an active execution was interrupted and false for the idle no-op. When resume=true, execution resumes pending steering input and next-in-line control items (manual compaction, moves) while queued prompts remain parked.", "summary": "Interrupt session execution" } }, "/api/session/{sessionID}/background": { "post": { "tags": ["session"], "operationId": "session.background", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Move active foreground backgroundable tools for this session into background observation. Idle requests are a no-op.", "summary": "Background blocking session tools" } }, "/api/session/{sessionID}/message/{messageID}": { "get": { "tags": ["session"], "operationId": "session.message.get", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "messageID", "in": "path", "schema": { "type": "string", "pattern": "^msg_" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Session.Message.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | MessageNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/MessageNotFoundErrorEncoded" } ] } } } } }, "description": "Retrieve one projected message owned by the Session.", "summary": "Get session message" } }, "/api/session/{sessionID}/form": { "get": { "tags": ["session"], "operationId": "session.form.list", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Form.Info" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Retrieve pending forms for a session.", "summary": "List session forms" }, "post": { "tags": ["session"], "operationId": "session.form.create", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Form.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "ConflictError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConflictErrorEncoded" } } } } }, "description": "Create a form for a session.", "summary": "Create session form", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Form.CreatePayload" } } }, "required": true } } }, "/api/session/{sessionID}/form/{formID}": { "get": { "tags": ["session"], "operationId": "session.form.get", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "formID", "in": "path", "schema": { "type": "string", "pattern": "^frm_" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Form.Detail" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | FormNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/FormNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Retrieve a form and its current state for a session.", "summary": "Get session form" }, "delete": { "tags": ["session"], "operationId": "session.form.cancel", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "formID", "in": "path", "schema": { "type": "string", "pattern": "^frm_" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | FormNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/FormNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "FormAlreadySettledError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormAlreadySettledErrorEncoded" } } } } }, "description": "Cancel a pending form.", "summary": "Cancel form" } }, "/api/session/{sessionID}/form/{formID}/reply": { "post": { "tags": ["session"], "operationId": "session.form.reply", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "formID", "in": "path", "schema": { "type": "string", "pattern": "^frm_" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "FormInvalidAnswerError | InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/FormInvalidAnswerErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | FormNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/FormNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } }, "409": { "description": "FormAlreadySettledError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormAlreadySettledErrorEncoded" } } } } }, "description": "Submit an answer to a pending form.", "summary": "Reply to form", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Form.Reply" } } }, "required": true } } }, "/api/session/{sessionID}/environment": { "put": { "tags": ["session"], "operationId": "session.environment", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Replace the process environment used by local shell commands for this session.", "summary": "Set session environment", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "variables": { "type": "object", "additionalProperties": { "type": "string" } } }, "required": ["variables"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/view": { "post": { "tags": ["session"], "operationId": "session.view", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Mark the idle transition observed by the viewer as viewed.", "summary": "View session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "idle": { "type": "number" } }, "required": ["idle"], "additionalProperties": false } } }, "required": true } } }, "/api/session/{sessionID}/message": { "get": { "tags": ["session"], "operationId": "session.message.list", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "limit", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Maximum number of messages to return. When omitted, the endpoint returns its default page size." }, "required": false }, { "name": "order", "in": "query", "schema": { "anyOf": [ { "type": "string", "enum": ["asc", "desc"] }, { "type": "null" } ], "description": "Message order for the first page. Use desc for newest first or asc for oldest first." }, "required": false }, { "name": "cursor", "in": "query", "schema": { "anyOf": [ { "type": "string", "description": "Opaque pagination cursor returned as cursor.previous or cursor.next in the previous response. Do not combine with order." }, { "type": "null" } ] }, "required": false }, { "name": "type", "in": "query", "schema": { "anyOf": [ { "type": "string", "enum": [ "agent-switched", "model-switched", "location-switched", "user", "synthetic", "system", "skill", "shell", "assistant", "compaction" ] }, { "type": "null" } ], "description": "Filter by message type before pagination. When omitted, all message types are returned. Pass the same type when following cursors." }, "required": false } ], "security": [], "responses": { "200": { "description": "SessionMessagesResponse", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionMessagesResponse" } } } }, "400": { "description": "InvalidCursorError | InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidCursorErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } }, "500": { "description": "UnknownError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnknownErrorEncoded" } } } } }, "description": "Retrieve projected messages for a session, optionally filtered by type. Items keep the requested order across pages; use cursor.next or cursor.previous to move through the ordered timeline, passing the same type filter on each page.", "summary": "Get session messages" } }, "/api/model": { "get": { "tags": ["model"], "operationId": "model.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Model.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Retrieve the current snapshot of available models ordered by release date. The snapshot may precede initial plugin settlement.", "summary": "List models" } }, "/api/model/default": { "get": { "tags": ["model"], "operationId": "model.default", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "anyOf": [ { "$ref": "#/components/schemas/Model.Info" }, { "type": "null" } ] } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Retrieve the model used when a session has no explicit model selection.", "summary": "Get default model" } }, "/api/experimental/generate": { "post": { "tags": ["generate"], "operationId": "experimental.generate.text", "parameters": [], "security": [], "responses": { "200": { "description": "GenerateTextResponse", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateTextResponse" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Run one stateless model generation using the server's base configuration and return the assistant text. Uses the base configuration's default model when none is specified.", "summary": "Generate text", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "prompt": { "type": "string" }, "model": { "anyOf": [ { "$ref": "#/components/schemas/Model.Ref" }, { "type": "null" } ] } }, "required": ["prompt"], "additionalProperties": false } } }, "required": true } } }, "/api/provider": { "get": { "tags": ["provider"], "operationId": "provider.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Provider.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Retrieve active AI providers so clients can show provider availability and configuration.", "summary": "List providers" } }, "/api/provider/{providerID}": { "get": { "tags": ["provider"], "operationId": "provider.get", "parameters": [ { "name": "providerID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Provider.Info" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ProviderNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderNotFoundErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Retrieve a single AI provider so clients can inspect its availability and endpoint settings.", "summary": "Get provider" } }, "/api/integration": { "get": { "tags": ["integration"], "operationId": "integration.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Integration.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve available integrations and their authentication methods.", "summary": "List integrations" } }, "/api/integration/{integrationID}": { "get": { "tags": ["integration"], "operationId": "integration.get", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Integration.Info" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "IntegrationNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationNotFoundErrorEncoded" } } } } }, "description": "Retrieve one integration and its authentication methods.", "summary": "Get integration" } }, "/api/experimental/integration/wellknown": { "post": { "tags": ["integration"], "operationId": "experimental.integration.wellknown.add", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Discover and persist an experimental wellknown integration source.", "summary": "Add wellknown integration", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" } }, "required": ["url"], "additionalProperties": false } } }, "required": true } } }, "/api/integration/{integrationID}/connect/key": { "post": { "tags": ["integration"], "operationId": "integration.connect.key", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "IntegrationNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationNotFoundErrorEncoded" } } } } }, "description": "Run a key authentication method and store the resulting credential.", "summary": "Connect with key", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "string" }, "answer": { "anyOf": [ { "$ref": "#/components/schemas/Form.Answer" }, { "type": "null" } ] }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["key"], "additionalProperties": false } } }, "required": true } } }, "/api/integration/{integrationID}/connect/oauth": { "post": { "tags": ["integration"], "operationId": "integration.oauth.connect", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Integration.AttemptEncoded" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Start an OAuth attempt and return the authorization details.", "summary": "Begin OAuth connection", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "methodID": { "type": "string" }, "answer": { "anyOf": [ { "$ref": "#/components/schemas/Form.Answer" }, { "type": "null" } ] }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["methodID"], "additionalProperties": false } } }, "required": true } } }, "/api/integration/{integrationID}/connect/oauth/{attemptID}": { "get": { "tags": ["integration"], "operationId": "integration.oauth.status", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "attemptID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Integration.AttemptStatus" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "IntegrationNotFoundError | IntegrationAttemptNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/IntegrationNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/IntegrationAttemptNotFoundErrorEncoded" } ] } } } } }, "description": "Poll the current status of an OAuth attempt.", "summary": "Get OAuth attempt status" }, "delete": { "tags": ["integration"], "operationId": "integration.oauth.cancel", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "attemptID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Cancel an OAuth attempt and release its resources.", "summary": "Cancel OAuth connection" } }, "/api/integration/{integrationID}/connect/oauth/{attemptID}/complete": { "post": { "tags": ["integration"], "operationId": "integration.oauth.complete", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "attemptID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "IntegrationNotFoundError | IntegrationAttemptNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/IntegrationNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/IntegrationAttemptNotFoundErrorEncoded" } ] } } } } }, "description": "Complete a code-based OAuth attempt and store the resulting credential.", "summary": "Complete OAuth connection", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false } } }, "required": true } } }, "/api/integration/{integrationID}/connect/command": { "post": { "tags": ["integration"], "operationId": "integration.command.connect", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Integration.CommandAttempt" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "IntegrationNotFoundError | IntegrationMethodNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/IntegrationNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/IntegrationMethodNotFoundErrorEncoded" } ] } } } } }, "description": "Start a command authentication attempt.", "summary": "Begin command connection", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "methodID": { "type": "string" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["methodID"], "additionalProperties": false } } }, "required": true } } }, "/api/integration/{integrationID}/connect/command/{attemptID}": { "get": { "tags": ["integration"], "operationId": "integration.command.status", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "attemptID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Integration.CommandAttemptStatus" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "IntegrationNotFoundError | IntegrationAttemptNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/IntegrationNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/IntegrationAttemptNotFoundErrorEncoded" } ] } } } } }, "description": "Poll the current status and output of a command authentication attempt.", "summary": "Get command attempt status" }, "delete": { "tags": ["integration"], "operationId": "integration.command.cancel", "parameters": [ { "name": "integrationID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "attemptID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Cancel a command authentication attempt and terminate its process.", "summary": "Cancel command connection" } }, "/api/mcp": { "get": { "tags": ["mcp"], "operationId": "mcp.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Mcp.Server" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve configured MCP servers and their connection status.", "summary": "List MCP servers" } }, "/api/experimental/mcp/{server}": { "put": { "tags": ["mcp"], "operationId": "experimental.mcp.add", "parameters": [ { "name": "server", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Add an MCP server at runtime or replace an existing one, connecting it immediately.", "summary": "Add MCP server", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "config": { "anyOf": [ { "$ref": "#/components/schemas/Mcp.LocalConfigEncoded" }, { "$ref": "#/components/schemas/Mcp.RemoteConfigEncoded" } ] } }, "required": ["config"], "additionalProperties": false } } }, "required": true } }, "delete": { "tags": ["mcp"], "operationId": "experimental.mcp.remove", "parameters": [ { "name": "server", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "McpServerNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpServerNotFoundErrorEncoded" } } } } }, "description": "Stop an MCP server and remove it from the runtime set until restart.", "summary": "Remove MCP server" } }, "/api/experimental/mcp/{server}/connect": { "post": { "tags": ["mcp"], "operationId": "experimental.mcp.connect", "parameters": [ { "name": "server", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "McpServerNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpServerNotFoundErrorEncoded" } } } } }, "description": "Connect an MCP server at runtime, overriding a disabled configuration until restart.", "summary": "Connect MCP server" } }, "/api/experimental/mcp/{server}/disconnect": { "post": { "tags": ["mcp"], "operationId": "experimental.mcp.disconnect", "parameters": [ { "name": "server", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "McpServerNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpServerNotFoundErrorEncoded" } } } } }, "description": "Disconnect an MCP server at runtime, removing its tools until reconnected.", "summary": "Disconnect MCP server" } }, "/api/mcp/resource": { "get": { "tags": ["mcp"], "operationId": "mcp.resource.catalog", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Mcp.ResourceCatalog" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve resources and resource templates from connected MCP servers.", "summary": "List MCP resources" } }, "/api/credential/{credentialID}": { "patch": { "tags": ["credential"], "operationId": "credential.update", "parameters": [ { "name": "credentialID", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Update a stored credential label.", "summary": "Update credential", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "label": { "type": "string" } }, "required": ["label"], "additionalProperties": false } } }, "required": true } }, "delete": { "tags": ["credential"], "operationId": "credential.remove", "parameters": [ { "name": "credentialID", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Remove a stored integration credential.", "summary": "Remove credential" } }, "/api/credential/{credentialID}/activate": { "post": { "tags": ["credential"], "operationId": "credential.activate", "parameters": [ { "name": "credentialID", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Activate a stored integration credential.", "summary": "Activate credential" } }, "/api/project": { "get": { "tags": ["project"], "operationId": "project.list", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Project" } } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List known projects.", "summary": "List projects" } }, "/api/project/{projectID}": { "patch": { "tags": ["project"], "operationId": "project.update", "parameters": [ { "name": "projectID", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "200": { "description": "Project", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Project" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ProjectNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectNotFoundErrorEncoded" } } } } }, "description": "Update the project canonical directory, display metadata, and workspace commands.", "summary": "Update project", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "canonical": { "type": "string" }, "name": { "type": "string" }, "icon": { "$ref": "#/components/schemas/Project.Icon" }, "commands": { "$ref": "#/components/schemas/Project.Commands" } }, "additionalProperties": false } } }, "required": true } } }, "/api/form": { "get": { "tags": ["form"], "operationId": "form.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Form.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve pending forms for a location.", "summary": "List pending forms" } }, "/api/permission/request": { "get": { "tags": ["permission"], "operationId": "permission.request.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Permission.Request" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve pending permission requests for a location.", "summary": "List pending permission requests" } }, "/api/permission/saved": { "get": { "tags": ["permission"], "operationId": "permission.saved.list", "parameters": [ { "name": "projectID", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PermissionSaved.Info" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve saved permissions, optionally filtered by project.", "summary": "List saved permissions" } }, "/api/permission/saved/{id}": { "delete": { "tags": ["permission"], "operationId": "permission.saved.remove", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Remove a saved permission by ID.", "summary": "Remove saved permission" } }, "/api/session/{sessionID}/permission": { "post": { "tags": ["permission"], "operationId": "session.permission.create", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^per" }, "effect": { "$ref": "#/components/schemas/Permission.Effect" } }, "required": ["id", "effect"], "additionalProperties": false } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Evaluate and, when approval is required, create a permission request for a session.", "summary": "Create permission request", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^per" }, { "type": "null" } ] }, "action": { "type": "string" }, "resources": { "type": "array", "items": { "type": "string" } }, "save": { "type": "array", "items": { "type": "string" } }, "metadata": { "type": "object" }, "source": { "$ref": "#/components/schemas/Permission.Source" }, "agent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["action", "resources"], "additionalProperties": false } } }, "required": true } }, "get": { "tags": ["permission"], "operationId": "session.permission.list", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Permission.Request" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } } } } }, "description": "Retrieve pending permission requests owned by a session.", "summary": "List session permission requests" } }, "/api/session/{sessionID}/permission/{requestID}": { "get": { "tags": ["permission"], "operationId": "session.permission.get", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "requestID", "in": "path", "schema": { "type": "string", "pattern": "^per" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Permission.Request" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | PermissionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/PermissionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Retrieve a pending permission request owned by a session.", "summary": "Get permission request" } }, "/api/session/{sessionID}/permission/{requestID}/reply": { "post": { "tags": ["permission"], "operationId": "session.permission.reply", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "requestID", "in": "path", "schema": { "type": "string", "pattern": "^per" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "SessionNotFoundError | PermissionNotFoundError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/PermissionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" }, { "$ref": "#/components/schemas/SessionNotFoundErrorEncoded" } ] } } } } }, "description": "Respond to a pending permission request owned by a session.", "summary": "Reply to pending permission request", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "decision": { "$ref": "#/components/schemas/Permission.Reply" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["decision"], "additionalProperties": false } } }, "required": true } } }, "/api/fs/read/*": { "get": { "tags": ["filesystem"], "operationId": "fs.read", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "FileNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileNotFoundErrorEncoded" } } } } }, "description": "Serve one file relative to the requested location.", "summary": "Read file" } }, "/api/fs/list": { "get": { "tags": ["filesystem"], "operationId": "fs.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true }, { "name": "path", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "An absolute path or a path relative to the requested location. Defaults to the location directory." }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/FileSystem.Entry" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List direct children using an absolute path or a path relative to the requested location, including parents and siblings outside its directory. Entry paths remain relative to the requested location; listing does not switch locations.", "summary": "List directory" } }, "/api/fs/find": { "get": { "tags": ["filesystem"], "operationId": "fs.find", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true }, { "name": "query", "in": "query", "schema": { "type": "string" }, "required": true }, { "name": "type", "in": "query", "schema": { "type": "string", "enum": ["file", "directory"] }, "required": false }, { "name": "limit", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/FileSystem.Entry" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Find recursively ranked filesystem entries relative to the requested location.", "summary": "Find files" } }, "/api/experimental/fs/write": { "post": { "tags": ["filesystem"], "operationId": "experimental.fs.write", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true }, { "name": "path", "in": "query", "schema": { "type": "string", "description": "An absolute path or a path relative to the requested location. Missing parent directories are created." }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/FileSystem.Write" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Write the raw request body to an absolute path or a path relative to the requested location, creating parent directories, and return the resolved absolute path. Unlike read, the target is not confined to the location. Experimental: may change without compatibility guarantees.", "summary": "Write file", "requestBody": { "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } }, "required": true } } }, "/api/command": { "get": { "tags": ["command"], "operationId": "command.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Command.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve currently registered commands.", "summary": "List commands" } }, "/api/skill": { "get": { "tags": ["skill"], "operationId": "skill.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Skill.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Retrieve currently registered skills.", "summary": "List skills" } }, "/api/rpc/{rpcID}/{method}": { "post": { "tags": ["rpc"], "operationId": "rpc.call", "parameters": [ { "name": "rpcID", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "method", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Rpc.Output", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Rpc.Output" } } } }, "400": { "description": "RpcError | InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/RpcErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "500": { "description": "RpcInternalError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RpcInternalErrorEncoded" } } } } }, "description": "Dispatch a method to the currently registered RPC at the requested location.", "summary": "Call a plugin RPC", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Rpc.Input" } } }, "required": true } } }, "/api/event": { "get": { "tags": ["event"], "operationId": "event.subscribe", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "text/event-stream": { "schema": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "event": { "type": "string" }, "data": { "$ref": "#/components/schemas/V2EventEncoded" } }, "required": ["id", "event", "data"], "additionalProperties": false }, "x-effect-stream": { "encoding": "sse", "causeSchema": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["Fail"] }, "error": { "not": {} } }, "required": ["_tag", "error"], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["Die"] }, "defect": {} }, "required": ["_tag", "defect"], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["Interrupt"] }, "fiberId": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": ["_tag", "fiberId"], "additionalProperties": false } ] } }, "errorSchema": { "not": {} }, "failureEvent": "effect/httpapi/stream/failure" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Subscribe to native events and plugin RPC events across all server locations. Volatile by contract: a slow consumer overflows and fails the stream, and events during disconnection are missed.", "summary": "Subscribe to events" } }, "/api/pty": { "get": { "tags": ["pty"], "operationId": "pty.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Pty" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List PTY sessions for a location, including exited sessions retained until removal.", "summary": "List PTY sessions" }, "post": { "tags": ["pty"], "operationId": "pty.create", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Pty" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Create a pseudo-terminal session for a location.", "summary": "Create PTY session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "command": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "cwd": { "type": "string" }, "title": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": false } } }, "required": true } } }, "/api/pty/{ptyID}": { "get": { "tags": ["pty"], "operationId": "pty.get", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Pty" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } } }, "description": "Get one PTY session, including its exit code once exited.", "summary": "Get PTY session" }, "put": { "tags": ["pty"], "operationId": "pty.update", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Pty" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } } }, "description": "Update the title or viewport size of one PTY session.", "summary": "Update PTY session", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string" }, "size": { "type": "object", "properties": { "rows": { "type": "integer", "exclusiveMinimum": 0 }, "cols": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["rows", "cols"], "additionalProperties": false } }, "additionalProperties": false } } }, "required": true } }, "delete": { "tags": ["pty"], "operationId": "pty.remove", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } } }, "description": "Terminate and remove one PTY session.", "summary": "Remove PTY session" } }, "/api/pty/{ptyID}/connect-token": { "post": { "tags": ["pty"], "operationId": "pty.connect.token", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true }, { "name": "x-opencode-ticket", "in": "header", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/PtyTicket.ConnectToken" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "403": { "description": "ForbiddenError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForbiddenErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } } }, "description": "Create a short-lived single-use ticket for opening a PTY WebSocket connection.", "summary": "Create PTY WebSocket token" } }, "/api/pty/{ptyID}/connect": { "get": { "tags": ["pty"], "operationId": "pty.connect", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true }, { "in": "query", "name": "location[directory]", "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "schema": { "type": "string" } }, { "in": "query", "name": "ticket", "schema": { "type": "string" } } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "boolean" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "403": { "description": "ForbiddenError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForbiddenErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } } }, "description": "Establish a WebSocket connection streaming PTY output and accepting terminal input.", "summary": "Connect to PTY session", "x-websocket": true } }, "/api/experimental/session/{sessionID}/terminal/read": { "get": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.read", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true }, { "name": "lines", "in": "query", "schema": { "anyOf": [ { "$ref": "#/components/schemas/PersistentPty.ReadLinesEncoded" }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/PersistentPty.ReadResult" }, { "type": "null" } ] } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Read the last physical rows without changing selection or taking control. Omitted lines uses the live terminal height; larger counts include retained history. Blank rows are preserved. Screen dimensions and cursor remain relative to the live screen. Returns null when no current terminal exists. Selection is server-local and resets on restart. Experimental: may change without compatibility guarantees.", "summary": "Read the session's most recently controlled terminal" } }, "/api/experimental/session/{sessionID}/terminal": { "get": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.list", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PersistentPty.Info" } } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } } }, "post": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.create", "parameters": [ { "name": "sessionID", "in": "path", "schema": { "type": "string", "pattern": "^ses" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PersistentPty.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersistentPty.CreateInput" } } }, "required": true } } }, "/api/experimental/persistent-pty/shutdown": { "post": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.shutdown", "parameters": [], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } } } }, "/api/experimental/persistent-pty/handoff": { "post": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.handoff", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "handoff": { "anyOf": [ { "$ref": "#/components/schemas/PersistentPty.Handoff" }, { "type": "null" } ] } }, "required": ["handoff"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } } } }, "/api/experimental/persistent-pty/{ptyID}": { "get": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.get", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PersistentPty.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } } }, "put": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.update", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PersistentPty.Info" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersistentPty.UpdateInput" } } }, "required": true } }, "delete": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.remove", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } } } }, "/api/experimental/persistent-pty/{ptyID}/snapshot": { "get": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.snapshot", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PersistentPty.Snapshot" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } } } }, "/api/experimental/persistent-pty/{ptyID}/connect-token": { "post": { "tags": ["persistentPty"], "operationId": "server.experimental.persistentPty.connectToken", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true }, { "name": "x-opencode-ticket", "in": "header", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PtyTicket.ConnectToken" } }, "required": ["data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "403": { "description": "ForbiddenError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForbiddenErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } } } }, "/api/experimental/persistent-pty/{ptyID}/connect": { "get": { "tags": ["persistentPty"], "operationId": "persistentPty.connect", "parameters": [ { "name": "ptyID", "in": "path", "schema": { "type": "string", "pattern": "^pty" }, "required": true }, { "in": "query", "name": "cursor", "schema": { "type": "string" } }, { "in": "query", "name": "role", "schema": { "type": "string" } }, { "in": "query", "name": "attachment_id", "schema": { "type": "string" } }, { "in": "query", "name": "takeover", "schema": { "type": "string" } }, { "in": "query", "name": "input_protocol", "schema": { "type": "string" } }, { "in": "query", "name": "ticket", "schema": { "type": "string" } } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "boolean" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "403": { "description": "ForbiddenError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForbiddenErrorEncoded" } } } }, "404": { "description": "PtyNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PtyNotFoundErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Stream persistent PTY output through the OpenCode server.", "summary": "Connect to a persistent PTY", "x-websocket": true } }, "/api/shell": { "get": { "tags": ["shell"], "operationId": "shell.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Shell.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List currently running shell commands for a location. Exited commands are not included.", "summary": "List running shell commands" }, "post": { "tags": ["shell"], "operationId": "shell.create", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Shell.Info" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Spawn one non-interactive shell command for a location. Combined stdout/stderr is captured to a file pageable via output.", "summary": "Run shell command", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "command": { "type": "string" }, "cwd": { "type": "string" }, "timeout": { "type": "integer", "minimum": 0 }, "metadata": { "type": "object" } }, "required": ["command"], "additionalProperties": false } } }, "required": true } } }, "/api/shell/{id}": { "get": { "tags": ["shell"], "operationId": "shell.get", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string", "pattern": "^sh_" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Shell.Info" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ShellNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShellNotFoundErrorEncoded" } } } } }, "description": "Get one shell command, including its status and exit code once exited.", "summary": "Get shell command" }, "delete": { "tags": ["shell"], "operationId": "shell.remove", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string", "pattern": "^sh_" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Terminate and remove one shell command and its retained output.", "summary": "Remove shell command" } }, "/api/shell/{id}/output": { "get": { "tags": ["shell"], "operationId": "shell.output", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string", "pattern": "^sh_" }, "required": true }, { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true }, { "name": "cursor", "in": "query", "schema": { "type": "string", "pattern": "^[+-]?\\d*\\.?\\d+(?:[Ee][+-]?\\d+)?$" }, "required": false }, { "name": "limit", "in": "query", "schema": { "type": "string", "pattern": "^[+-]?\\d*\\.?\\d+(?:[Ee][+-]?\\d+)?$" }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "object", "properties": { "output": { "type": "string" }, "cursor": { "type": "integer", "minimum": 0 }, "size": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" } }, "required": ["output", "cursor", "size", "truncated"], "additionalProperties": false } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ShellNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShellNotFoundErrorEncoded" } } } } }, "description": "Page through captured combined output by absolute byte cursor.", "summary": "Read shell output" } }, "/api/reference": { "get": { "tags": ["reference"], "operationId": "reference.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Reference.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List references available in the requested location.", "summary": "List references" } }, "/api/worktree": { "get": { "tags": ["worktree"], "operationId": "worktree.list", "parameters": [ { "name": "projectID", "in": "query", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "200": { "description": "Worktree.List", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Worktree.List" } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ProjectNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectNotFoundErrorEncoded" } } } } }, "description": "Return the project's saved worktree inventory without loading configuration or running discovery.", "summary": "List worktrees" }, "post": { "tags": ["worktree"], "operationId": "worktree.create", "parameters": [], "security": [], "responses": { "200": { "description": "Worktree.Info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Worktree.Info" } } } }, "400": { "description": "WorktreeError | InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/WorktreeErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ProjectNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectNotFoundErrorEncoded" } } } } }, "description": "Load the project's canonical configuration, create a local worktree using its selected strategy, then run the project's setup script.", "summary": "Create worktree", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Worktree.CreateInput" } } }, "required": true } }, "delete": { "tags": ["worktree"], "operationId": "worktree.remove", "parameters": [], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "WorktreeError | InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/WorktreeErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ProjectNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectNotFoundErrorEncoded" } } } } }, "description": "Load the project's canonical configuration and remove a saved worktree using its recorded strategy.", "summary": "Remove worktree", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Worktree.RemoveInput" } } }, "required": true } } }, "/api/worktree/refresh": { "post": { "tags": ["worktree"], "operationId": "worktree.refresh", "parameters": [], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "WorktreeError | InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/WorktreeErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "404": { "description": "ProjectNotFoundError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectNotFoundErrorEncoded" } } } } }, "description": "Load the project's canonical configuration, discover worktrees across known checkout roots using all available strategies, and reconcile saved state.", "summary": "Refresh worktrees", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "projectID": { "type": "string" } }, "required": ["projectID"], "additionalProperties": false } } }, "required": true } } }, "/api/vcs": { "get": { "tags": ["vcs"], "operationId": "vcs.get", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Vcs.Info" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Get current and default branch information for the requested location.", "summary": "VCS info" } }, "/api/vcs/base": { "get": { "tags": ["vcs"], "operationId": "vcs.base", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "anyOf": [ { "$ref": "#/components/schemas/Vcs.Base" }, { "type": "null" } ] } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Infer a local review base from named branch creation history, or the repository default only when currently on that branch. Returns null before the first commit or when the provider lacks base metadata; ambiguous Git history requires an explicit base on diff requests.", "summary": "VCS review base" } }, "/api/vcs/status": { "get": { "tags": ["vcs"], "operationId": "vcs.status", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Vcs.FileStatus" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List uncommitted working-copy changes relative to the requested location.", "summary": "VCS status" } }, "/api/vcs/branch": { "get": { "tags": ["vcs"], "operationId": "vcs.branch.list", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true }, { "name": "search", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false }, { "name": "limit", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/Vcs.BranchList" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List local and remote branches available at the requested location.", "summary": "VCS branches" } }, "/api/vcs/diff": { "get": { "tags": ["vcs"], "operationId": "vcs.diff", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true }, { "name": "mode", "in": "query", "schema": { "$ref": "#/components/schemas/Vcs.Mode" }, "required": true }, { "name": "base", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "context", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required": false } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/FileDiff.Info" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Diff HEAD to the working copy (working), the base merge-base to the working copy (branch), or the base merge-base to HEAD (committed). Omitting base preserves repository-default comparison; supplying it overrides the comparison without saving it.", "summary": "VCS diff" } }, "/api/debug/location": { "get": { "tags": ["debug"], "operationId": "debug.location.list", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Location.PublicRef" } } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "List locations currently loaded by the server.", "summary": "List loaded locations" }, "delete": { "tags": ["debug"], "operationId": "debug.location.evict", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Dispose the requested location's cached services so its next use boots them fresh.", "summary": "Evict a loaded location" } }, "/api/experimental/migration/v1": { "get": { "tags": ["migration"], "operationId": "experimental.migration.v1.status", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": ["required", "completed"] } }, "required": ["status"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["running"] }, "progress": { "type": "object", "properties": { "label": { "type": "string" }, "numerator": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "denominator": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": ["label"], "additionalProperties": false } }, "required": ["status", "progress"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["error"] }, "error": { "type": "string" } }, "required": ["status", "error"], "additionalProperties": false } ] } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Return the progress of the V1 to V2 session history migration.", "summary": "Get V1 migration status" } }, "/api/websearch/provider": { "get": { "tags": ["websearch"], "operationId": "websearch.providers", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/WebSearch.Provider" } } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Return the registered web search providers.", "summary": "List web search providers" } }, "/api/websearch": { "post": { "tags": ["websearch"], "operationId": "websearch.query", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "data": { "$ref": "#/components/schemas/WebSearch.ResponseEncoded" } }, "required": ["location", "data"], "additionalProperties": false } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" }, { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } ] } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } }, "503": { "description": "ServiceUnavailableError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceUnavailableErrorEncoded" } } } } }, "description": "Run one web search through the selected provider. Specify a provider to override the configured default.", "summary": "Search the web", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "providerID": { "type": "string" } }, "required": ["query"], "additionalProperties": false } } }, "required": true } } }, "/api/config": { "get": { "tags": ["config"], "operationId": "config.get", "parameters": [ { "name": "location", "in": "query", "schema": { "anyOf": [ { "type": "object", "properties": { "directory": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, { "type": "null" } ] }, "required": false, "style": "deepObject", "explode": true } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Config.Entry" } } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Return configuration documents and discovery sources for the requested location, from lowest to highest priority.", "summary": "Get configuration" } }, "/api/config/shell": { "get": { "tags": ["config"], "operationId": "config.shells", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ConfigShell.Option" } } } } }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Return shells available to terminal and agent execution.", "summary": "List available shells" } }, "/api/experimental/config": { "patch": { "tags": ["config"], "operationId": "experimental.config.update", "parameters": [], "security": [], "responses": { "204": { "description": "<No Content>" }, "400": { "description": "InvalidRequestError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidRequestErrorEncoded" } } } }, "401": { "description": "UnauthorizedError", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedErrorEncoded" } } } } }, "description": "Patch supported fields in the highest-precedence global configuration document.", "summary": "Update global configuration", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Config.Patch" } } }, "required": true } } } }, "components": { "schemas": { "Agent.Color": { "type": "string" }, "Agent.Info": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "model": { "$ref": "#/components/schemas/Model.Ref" }, "request": { "$ref": "#/components/schemas/Provider.Request" }, "system": { "type": "string" }, "description": { "type": "string" }, "mode": { "type": "string", "enum": ["subagent", "primary", "all"] }, "hidden": { "type": "boolean" }, "color": { "$ref": "#/components/schemas/Agent.Color" }, "steps": { "type": "integer", "exclusiveMinimum": 0 }, "permissions": { "$ref": "#/components/schemas/Permission.Ruleset" } }, "required": ["id", "name", "request", "mode", "hidden", "permissions"], "additionalProperties": false }, "AgentNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["AgentNotFoundError"] }, "agentID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "agentID", "message"], "additionalProperties": false }, "Command.Info": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" } }, "required": ["name"], "additionalProperties": false }, "CommandExecutionErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["CommandExecutionError"] }, "command": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "command", "message"], "additionalProperties": false }, "CommandNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["CommandNotFoundError"] }, "command": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "command", "message"], "additionalProperties": false }, "Config.AgentEncoded": { "type": "object", "properties": { "model": { "anyOf": [ { "type": "string", "pattern": "^[^/#]+\\/[^#]+(?:#[^#]+)?$" }, { "type": "object", "properties": { "providerID": { "type": "string", "pattern": "^[^/#]+$" }, "model": { "type": "string", "pattern": "^[^#]+$" }, "variant": { "type": "string", "pattern": "^[^#]+$" } }, "required": ["providerID", "model"], "additionalProperties": false } ] }, "request": { "type": "object", "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" } }, "additionalProperties": false }, "system": { "type": "string" }, "description": { "type": "string" }, "mode": { "type": "string", "enum": ["subagent", "primary", "all"] }, "hidden": { "type": "boolean" }, "color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "steps": { "type": "integer", "exclusiveMinimum": 0 }, "disabled": { "type": "boolean" }, "permissions": { "$ref": "#/components/schemas/Permission.Ruleset" } }, "additionalProperties": false }, "Config.CommandEncoded": { "type": "object", "properties": { "template": { "type": "string" }, "description": { "type": "string" }, "agent": { "type": "string" }, "model": { "anyOf": [ { "type": "string", "pattern": "^[^/#]+\\/[^#]+(?:#[^#]+)?$" }, { "type": "object", "properties": { "providerID": { "type": "string", "pattern": "^[^/#]+$" }, "model": { "type": "string", "pattern": "^[^#]+$" }, "variant": { "type": "string", "pattern": "^[^#]+$" } }, "required": ["providerID", "model"], "additionalProperties": false } ] }, "subagent": { "type": "boolean" }, "subtask": { "type": "boolean", "description": "Deprecated alias for subagent." } }, "required": ["template"], "additionalProperties": false }, "Config.DirectoryEncoded": { "type": "object", "properties": { "type": { "type": "string", "enum": ["directory"] }, "path": { "type": "string" } }, "required": ["type", "path"], "additionalProperties": false }, "Config.DocumentEncoded": { "type": "object", "properties": { "type": { "type": "string", "enum": ["document"] }, "path": { "type": "string" }, "info": { "$ref": "#/components/schemas/Config.InfoEncoded" } }, "required": ["type", "info"], "additionalProperties": false }, "Config.Entry": { "anyOf": [ { "$ref": "#/components/schemas/Config.DocumentEncoded" }, { "$ref": "#/components/schemas/Config.DirectoryEncoded" } ] }, "Config.Formatter.EntryEncoded": { "type": "object", "properties": { "disabled": { "type": "boolean" }, "command": { "type": "array", "items": { "type": "string" } }, "environment": { "type": "object", "additionalProperties": { "type": "string" } }, "extensions": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "Config.InfoEncoded": { "type": "object", "properties": { "$schema": { "type": "string" }, "shell": { "type": "string" }, "model": { "anyOf": [ { "type": "string", "pattern": "^[^/#]+\\/[^#]+(?:#[^#]+)?$" }, { "type": "object", "properties": { "providerID": { "type": "string", "pattern": "^[^/#]+$" }, "model": { "type": "string", "pattern": "^[^#]+$" }, "variant": { "type": "string", "pattern": "^[^#]+$" } }, "required": ["providerID", "model"], "additionalProperties": false } ] }, "default_agent": { "type": "string" }, "update": { "type": "string", "enum": ["disable", "notify", "auto"] }, "share": { "type": "string", "enum": ["manual", "auto", "disabled"] }, "enterprise": { "type": "object", "properties": { "url": { "type": "string" } }, "additionalProperties": false }, "username": { "type": "string" }, "permissions": { "$ref": "#/components/schemas/Permission.Ruleset" }, "agents": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Config.AgentEncoded" } }, "snapshots": { "type": "boolean" }, "watcher": { "type": "object", "properties": { "ignore": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "formatter": { "anyOf": [ { "type": "boolean" }, { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Config.Formatter.EntryEncoded" } } ] }, "lsp": { "anyOf": [ { "type": "boolean" }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "disabled": { "type": "boolean", "enum": [true] } }, "required": ["disabled"], "additionalProperties": false }, { "$ref": "#/components/schemas/Config.LSP.ServerEncoded" } ] } } ] }, "media": { "type": "object", "properties": { "image": { "type": "object", "properties": { "auto_resize": { "type": "boolean" }, "max_width": { "type": "integer", "exclusiveMinimum": 0 }, "max_height": { "type": "integer", "exclusiveMinimum": 0 }, "max_base64_bytes": { "type": "integer", "exclusiveMinimum": 0 } }, "additionalProperties": false } }, "additionalProperties": false }, "tool_output": { "type": "object", "properties": { "max_lines": { "type": "integer", "exclusiveMinimum": 0 }, "max_bytes": { "type": "integer", "exclusiveMinimum": 0 } }, "additionalProperties": false }, "mcp": { "type": "object", "properties": { "timeout": { "type": "object", "properties": { "startup": { "type": "integer", "exclusiveMinimum": 0 }, "catalog": { "type": "integer", "exclusiveMinimum": 0 }, "execution": { "type": "integer", "exclusiveMinimum": 0 } }, "additionalProperties": false }, "servers": { "type": "object", "additionalProperties": { "anyOf": [ { "$ref": "#/components/schemas/Mcp.LocalConfigEncoded" }, { "$ref": "#/components/schemas/Mcp.RemoteConfigEncoded" } ] } } }, "additionalProperties": false }, "compaction": { "type": "object", "properties": { "auto": { "type": "boolean" }, "keep": { "type": "object", "properties": { "tokens": { "type": "integer", "minimum": 0 } }, "additionalProperties": false }, "buffer": { "type": "integer", "minimum": 0 }, "grace": { "type": "integer", "minimum": 0 } }, "additionalProperties": false }, "skills": { "type": "array", "items": { "type": "string" } }, "commands": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Config.CommandEncoded" } }, "instructions": { "type": "array", "items": { "type": "string" } }, "references": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string" }, { "$ref": "#/components/schemas/Config.Reference.GitEncoded" }, { "$ref": "#/components/schemas/Config.Reference.LocalEncoded" } ] } }, "websearch": { "anyOf": [ { "type": "boolean", "enum": [false] }, { "$ref": "#/components/schemas/ConfigWebSearch.InfoEncoded" } ] }, "plugins": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "$ref": "#/components/schemas/Config.Plugin.EntryEncoded" } ] } }, "worktree": { "$ref": "#/components/schemas/Config.Worktree" }, "warming": { "anyOf": [ { "type": "boolean" }, { "$ref": "#/components/schemas/Config.WarmingEncoded" } ] }, "providers": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Config.ProviderEncoded" } }, "experimental": { "type": "object", "properties": { "portable_shell_scanner": { "type": "boolean" }, "subagent_depth": { "type": "integer", "minimum": 0 }, "policies": { "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string", "enum": ["provider.use", "permission"] }, "resource": { "type": "string" }, "effect": { "type": "string", "enum": ["allow", "deny"] } }, "required": ["action", "resource", "effect"], "additionalProperties": false } } }, "additionalProperties": false } }, "additionalProperties": false }, "Config.LSP.ServerEncoded": { "type": "object", "properties": { "command": { "type": "array", "items": { "type": "string" } }, "extensions": { "type": "array", "items": { "type": "string" } }, "disabled": { "type": "boolean" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "initialization": { "type": "object" } }, "required": ["command"], "additionalProperties": false }, "Config.Model.CostEncoded": { "type": "object", "properties": { "tier": { "type": "object", "properties": { "type": { "type": "string", "enum": ["context"] }, "size": { "type": "integer" } }, "required": ["type", "size"], "additionalProperties": false }, "input": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" }, "output": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" }, "cache": { "type": "object", "properties": { "read": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" }, "write": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" } }, "additionalProperties": false } }, "required": ["input", "output"], "additionalProperties": false }, "Config.Model.Settings": { "type": "object", "properties": { "compaction": { "$ref": "#/components/schemas/Provider.Compaction" } }, "allOf": [ { "type": "object", "additionalProperties": { "anyOf": [ {}, { "type": "null" } ] } } ] }, "Config.ModelEncoded": { "type": "object", "properties": { "modelID": { "type": "string" }, "family": { "type": "string" }, "name": { "type": "string" }, "compatibility": { "$ref": "#/components/schemas/Model.Compatibility" }, "package": { "type": "string" }, "settings": { "$ref": "#/components/schemas/Config.Model.Settings" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" }, "capabilities": { "$ref": "#/components/schemas/Model.Capabilities" }, "variants": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "settings": { "$ref": "#/components/schemas/Config.Model.Settings" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" } }, "required": ["id"], "additionalProperties": false } }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/Config.Model.CostEncoded" }, { "type": "array", "items": { "$ref": "#/components/schemas/Config.Model.CostEncoded" } } ] }, "disabled": { "type": "boolean" }, "limit": { "type": "object", "properties": { "context": { "type": "integer" }, "input": { "type": "integer" }, "output": { "type": "integer" } }, "additionalProperties": false } }, "additionalProperties": false }, "Config.Patch": { "type": "object", "properties": { "shell": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["shell"], "additionalProperties": false }, "Config.Plugin.EntryEncoded": { "type": "object", "properties": { "package": { "type": "string" }, "options": { "type": "object" } }, "required": ["package"], "additionalProperties": false }, "Config.Provider.Settings": { "type": "object", "properties": { "timeout": { "anyOf": [ { "type": "number" }, { "type": "boolean", "enum": [false] } ] }, "chunkTimeout": { "type": "number" }, "compaction": { "$ref": "#/components/schemas/Provider.Compaction" }, "transport": { "$ref": "#/components/schemas/Provider.Transport" } }, "allOf": [ { "type": "object", "additionalProperties": { "anyOf": [ {}, { "type": "null" } ] } } ] }, "Config.ProviderEncoded": { "type": "object", "properties": { "canonical": { "type": "string" }, "name": { "type": "string" }, "env": { "type": "array", "items": { "type": "string" } }, "package": { "type": "string" }, "settings": { "$ref": "#/components/schemas/Config.Provider.Settings" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" }, "models": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Config.ModelEncoded" } } }, "additionalProperties": false }, "Config.Reference.GitEncoded": { "type": "object", "properties": { "repository": { "type": "string" }, "branch": { "type": "string" }, "description": { "type": "string" }, "hidden": { "type": "boolean" } }, "required": ["repository"], "additionalProperties": false }, "Config.Reference.LocalEncoded": { "type": "object", "properties": { "path": { "type": "string" }, "description": { "type": "string" }, "hidden": { "type": "boolean" } }, "required": ["path"], "additionalProperties": false }, "Config.WarmingEncoded": { "type": "object", "properties": { "prompt": { "type": "string" }, "interval": { "type": "string" }, "duration": { "type": "string" } }, "additionalProperties": false }, "Config.Worktree": { "type": "object", "properties": { "directory": { "type": "string" } }, "required": ["directory"], "additionalProperties": false }, "ConfigShell.Option": { "type": "object", "properties": { "path": { "type": "string" }, "name": { "type": "string" }, "acceptable": { "type": "boolean" } }, "required": ["path", "name", "acceptable"], "additionalProperties": false }, "ConfigWebSearch.InfoEncoded": { "type": "object", "properties": { "provider": { "anyOf": [ { "type": "string", "enum": ["random"], "description": "Reuse a randomly selected provider until it is rate limited, then switch to another available provider." }, { "type": "string" } ] } }, "required": ["provider"], "additionalProperties": false }, "ConflictErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["ConflictError"] }, "message": { "type": "string" }, "resource": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["_tag", "message"], "additionalProperties": false }, "Connection.CredentialInfo": { "type": "object", "properties": { "type": { "type": "string", "enum": ["credential"] }, "id": { "type": "string" }, "label": { "type": "string" }, "method": { "type": "string", "enum": ["key", "oauth"] } }, "required": ["type", "id", "label", "method"], "additionalProperties": false }, "Connection.EnvInfo": { "type": "object", "properties": { "type": { "type": "string", "enum": ["env"] }, "name": { "type": "string" } }, "required": ["type", "name"], "additionalProperties": false }, "Connection.Info": { "anyOf": [ { "$ref": "#/components/schemas/Connection.CredentialInfo" }, { "$ref": "#/components/schemas/Connection.EnvInfo" } ] }, "FileDiff.Info": { "type": "object", "properties": { "file": { "type": "string" }, "patch": { "type": "string" }, "additions": { "type": "integer", "minimum": 0 }, "deletions": { "type": "integer", "minimum": 0 }, "status": { "type": "string", "enum": ["added", "deleted", "modified"] } }, "required": ["file", "patch", "additions", "deletions", "status"], "additionalProperties": false }, "FileNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["FileNotFoundError"] }, "path": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "path", "message"], "additionalProperties": false }, "FileSystem.Entry": { "type": "object", "properties": { "path": { "type": "string" }, "type": { "type": "string", "enum": ["file", "directory"] } }, "required": ["path", "type"], "additionalProperties": false }, "FileSystem.Write": { "type": "object", "properties": { "path": { "type": "string" } }, "required": ["path"], "additionalProperties": false }, "ForbiddenErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["ForbiddenError"] }, "message": { "type": "string" } }, "required": ["_tag", "message"], "additionalProperties": false }, "Form.Answer": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Form.Value" } }, "Form.BooleanField": { "type": "object", "properties": { "key": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "hidden": { "type": "boolean" }, "when": { "type": "array", "items": { "$ref": "#/components/schemas/Form.When" } }, "type": { "type": "string", "enum": ["boolean"] }, "default": { "type": "boolean" } }, "required": ["key", "type"], "additionalProperties": false }, "Form.CreatePayload": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "pattern": "^frm_" }, { "type": "null" } ] }, "title": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/Form.Metadata" }, "fields": { "$ref": "#/components/schemas/Form.Fields" } }, "required": ["title", "fields"], "additionalProperties": false }, "Form.Detail": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^frm_" }, "sessionID": { "type": "string" }, "title": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/Form.Metadata" }, "fields": { "$ref": "#/components/schemas/Form.Fields" }, "state": { "$ref": "#/components/schemas/Form.State" } }, "required": ["id", "sessionID", "title", "fields", "state"], "additionalProperties": false }, "Form.ExternalField": { "type": "object", "properties": { "key": { "type": "string" }, "type": { "type": "string", "enum": ["external"] }, "url": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" } }, "required": ["key", "type", "url"], "additionalProperties": false }, "Form.Field": { "anyOf": [ { "$ref": "#/components/schemas/Form.StringField" }, { "$ref": "#/components/schemas/Form.NumberField" }, { "$ref": "#/components/schemas/Form.IntegerField" }, { "$ref": "#/components/schemas/Form.BooleanField" }, { "$ref": "#/components/schemas/Form.MultiselectField" }, { "$ref": "#/components/schemas/Form.ExternalField" } ] }, "Form.Fields": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/Form.Field" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/Form.Field" } }, "Form.Fields_1": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/Form.Field" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/Form.Field" } }, "Form.Fields_2": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/Form.Field" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/Form.Field" } }, "Form.Info": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^frm_" }, "sessionID": { "type": "string" }, "title": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/Form.Metadata" }, "fields": { "$ref": "#/components/schemas/Form.Fields" } }, "required": ["id", "sessionID", "title", "fields"], "additionalProperties": false }, "Form.IntegerField": { "type": "object", "properties": { "key": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "hidden": { "type": "boolean" }, "when": { "type": "array", "items": { "$ref": "#/components/schemas/Form.When" } }, "type": { "type": "string", "enum": ["integer"] }, "minimum": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "maximum": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "default": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["key", "type"], "additionalProperties": false }, "Form.Metadata": { "type": "object" }, "Form.MultiselectField": { "type": "object", "properties": { "key": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "hidden": { "type": "boolean" }, "when": { "type": "array", "items": { "$ref": "#/components/schemas/Form.When" } }, "type": { "type": "string", "enum": ["multiselect"] }, "options": { "type": "array", "items": { "$ref": "#/components/schemas/Form.Option" } }, "minItems": { "type": "integer", "minimum": 0 }, "maxItems": { "type": "integer", "minimum": 0 }, "custom": { "type": "boolean" }, "default": { "type": "array", "items": { "type": "string" } } }, "required": ["key", "type", "options"], "additionalProperties": false }, "Form.NumberField": { "type": "object", "properties": { "key": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "hidden": { "type": "boolean" }, "when": { "type": "array", "items": { "$ref": "#/components/schemas/Form.When" } }, "type": { "type": "string", "enum": ["number"] }, "minimum": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "maximum": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "default": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["key", "type"], "additionalProperties": false }, "Form.Option": { "type": "object", "properties": { "value": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["value", "label"], "additionalProperties": false }, "Form.Reply": { "type": "object", "properties": { "answer": { "$ref": "#/components/schemas/Form.Answer" } }, "required": ["answer"], "additionalProperties": false }, "Form.State": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": ["pending"] } }, "required": ["status"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["answered"] }, "answer": { "$ref": "#/components/schemas/Form.Answer" } }, "required": ["status", "answer"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["cancelled"] } }, "required": ["status"], "additionalProperties": false } ] }, "Form.StringField": { "type": "object", "properties": { "key": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "hidden": { "type": "boolean" }, "when": { "type": "array", "items": { "$ref": "#/components/schemas/Form.When" } }, "type": { "type": "string", "enum": ["string"] }, "format": { "type": "string", "enum": ["email", "uri", "date", "date-time"] }, "minLength": { "type": "integer", "minimum": 0 }, "maxLength": { "type": "integer", "minimum": 0 }, "pattern": { "type": "string" }, "placeholder": { "type": "string" }, "default": { "type": "string" }, "options": { "type": "array", "items": { "$ref": "#/components/schemas/Form.Option" } }, "custom": { "type": "boolean" } }, "required": ["key", "type"], "additionalProperties": false }, "Form.Value": { "anyOf": [ { "type": "string" }, { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] }, "Form.When": { "type": "object", "properties": { "key": { "type": "string" }, "op": { "type": "string", "enum": ["eq", "neq"] }, "value": { "anyOf": [ { "type": "string" }, { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, { "type": "boolean" } ] } }, "required": ["key", "op", "value"], "additionalProperties": false }, "FormAlreadySettledErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["FormAlreadySettledError"] }, "id": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "id", "message"], "additionalProperties": false }, "FormInvalidAnswerErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["FormInvalidAnswerError"] }, "id": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "id", "message"], "additionalProperties": false }, "FormNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["FormNotFoundError"] }, "id": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "id", "message"], "additionalProperties": false }, "GenerateTextResponse": { "type": "object", "properties": { "data": { "type": "object", "properties": { "text": { "type": "string" } }, "required": ["text"], "additionalProperties": false } }, "required": ["data"], "additionalProperties": false }, "InstructionEntry.Info": { "type": "object", "properties": { "key": { "$ref": "#/components/schemas/InstructionEntry.Key" }, "value": { "description": "JSON value attached to the session's instructions" } }, "required": ["key", "value"], "additionalProperties": false }, "InstructionEntry.Key": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*$", "description": "Instruction entry key (lowercase alphanumerics plus . _ -)" }, "InstructionEntryValueTooLargeErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["InstructionEntryValueTooLargeError"] }, "actualBytes": { "type": "integer" }, "maxBytes": { "type": "integer" }, "message": { "type": "string" } }, "required": ["_tag", "actualBytes", "maxBytes", "message"], "additionalProperties": false }, "Integration.AttemptEncoded": { "type": "object", "properties": { "attemptID": { "type": "string" }, "url": { "type": "string" }, "instructions": { "type": "string" }, "mode": { "type": "string", "enum": ["auto", "code"] }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["attemptID", "url", "instructions", "mode", "time"], "additionalProperties": false }, "Integration.AttemptStatus": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": ["pending"] }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "time"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["complete"] }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "time"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["failed"] }, "message": { "type": "string" }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "message", "time"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["expired"] }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "time"], "additionalProperties": false } ] }, "Integration.CommandAttempt": { "type": "object", "properties": { "attemptID": { "type": "string" }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["attemptID", "time"], "additionalProperties": false }, "Integration.CommandAttemptStatus": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": ["pending"] }, "message": { "type": "string" }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "time"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["complete"] }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "time"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["failed"] }, "message": { "type": "string" }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "message", "time"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["expired"] }, "time": { "type": "object", "properties": { "created": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "expires": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["created", "expires"], "additionalProperties": false } }, "required": ["status", "time"], "additionalProperties": false } ] }, "Integration.CommandMethod": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": ["command"] }, "label": { "type": "string" }, "command": { "type": "array", "items": { "type": "string" } } }, "required": ["id", "type", "label", "command"], "additionalProperties": false }, "Integration.EnvMethod": { "type": "object", "properties": { "type": { "type": "string", "enum": ["env"] }, "names": { "type": "array", "items": { "type": "string" } } }, "required": ["type", "names"], "additionalProperties": false }, "Integration.Info": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "metadata": { "type": "object" }, "methods": { "type": "array", "items": { "$ref": "#/components/schemas/Integration.Method" } }, "connections": { "type": "array", "items": { "$ref": "#/components/schemas/Connection.Info" } } }, "required": ["id", "name", "methods", "connections"], "additionalProperties": false }, "Integration.KeyMethod": { "type": "object", "properties": { "type": { "type": "string", "enum": ["key"] }, "label": { "type": "string" }, "form": { "$ref": "#/components/schemas/Form.Fields_2" } }, "required": ["type"], "additionalProperties": false }, "Integration.Method": { "anyOf": [ { "$ref": "#/components/schemas/Integration.OAuthMethod" }, { "$ref": "#/components/schemas/Integration.CommandMethod" }, { "$ref": "#/components/schemas/Integration.KeyMethod" }, { "$ref": "#/components/schemas/Integration.EnvMethod" } ] }, "Integration.OAuthMethod": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": ["oauth"] }, "label": { "type": "string" }, "form": { "$ref": "#/components/schemas/Form.Fields_1" } }, "required": ["id", "type", "label"], "additionalProperties": false }, "IntegrationAttemptNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["IntegrationAttemptNotFoundError"] }, "integrationID": { "type": "string" }, "attemptID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "integrationID", "attemptID", "message"], "additionalProperties": false }, "IntegrationMethodNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["IntegrationMethodNotFoundError"] }, "integrationID": { "type": "string" }, "methodID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "integrationID", "methodID", "message"], "additionalProperties": false }, "IntegrationNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["IntegrationNotFoundError"] }, "integrationID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "integrationID", "message"], "additionalProperties": false }, "InvalidCursorErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["InvalidCursorError"] }, "message": { "type": "string" } }, "required": ["_tag", "message"], "additionalProperties": false }, "InvalidRequestErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["InvalidRequestError"] }, "message": { "type": "string" }, "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "field": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["_tag", "message"], "additionalProperties": false }, "Location.PublicInfo": { "type": "object", "properties": { "directory": { "type": "string" }, "project": { "type": "object", "properties": { "id": { "type": "string" }, "directory": { "type": "string" }, "canonical": { "type": "string" } }, "required": ["id", "directory", "canonical"], "additionalProperties": false } }, "required": ["directory", "project"], "additionalProperties": false }, "Location.PublicRef": { "type": "object", "properties": { "directory": { "type": "string" } }, "required": ["directory"], "additionalProperties": false }, "Mcp.LocalConfigEncoded": { "type": "object", "properties": { "type": { "type": "string", "enum": ["local"] }, "command": { "type": "array", "items": { "type": "string" } }, "cwd": { "type": "string" }, "environment": { "type": "object", "additionalProperties": { "type": "string" } }, "disabled": { "type": "boolean" }, "codemode": { "type": "boolean" }, "timeout": { "type": "object", "properties": { "startup": { "type": "integer", "exclusiveMinimum": 0 }, "catalog": { "type": "integer", "exclusiveMinimum": 0 }, "execution": { "type": "integer", "exclusiveMinimum": 0 } }, "additionalProperties": false }, "protocol": { "$ref": "#/components/schemas/Mcp.Protocol" } }, "required": ["type", "command"], "additionalProperties": false }, "Mcp.OAuthConfigEncoded": { "type": "object", "properties": { "client_id": { "type": "string" }, "client_secret": { "type": "string" }, "scope": { "type": "string" }, "callback_port": { "type": "integer", "minimum": 1, "maximum": 65535 }, "redirect_uri": { "type": "string" }, "auth_server_metadata_url": { "type": "string" } }, "additionalProperties": false }, "Mcp.Protocol": { "type": "string", "enum": ["legacy", "auto", "2026-07-28"], "description": "MCP protocol negotiation. \"legacy\" (default) opens with the initialize handshake and speaks protocol revisions up to 2025-11-25. \"auto\" probes for the 2026-07-28 revision and falls back to legacy when the server does not support it. \"2026-07-28\" requires that revision and fails otherwise." }, "Mcp.RemoteConfigEncoded": { "type": "object", "properties": { "type": { "type": "string", "enum": ["remote"] }, "url": { "type": "string" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "oauth": { "anyOf": [ { "$ref": "#/components/schemas/Mcp.OAuthConfigEncoded" }, { "type": "boolean", "enum": [false] } ] }, "disabled": { "type": "boolean" }, "codemode": { "type": "boolean" }, "timeout": { "type": "object", "properties": { "startup": { "type": "integer", "exclusiveMinimum": 0 }, "catalog": { "type": "integer", "exclusiveMinimum": 0 }, "execution": { "type": "integer", "exclusiveMinimum": 0 } }, "additionalProperties": false }, "protocol": { "$ref": "#/components/schemas/Mcp.Protocol" } }, "required": ["type", "url"], "additionalProperties": false }, "Mcp.Resource": { "type": "object", "properties": { "server": { "type": "string" }, "name": { "type": "string" }, "uri": { "type": "string" }, "description": { "type": "string" }, "mimeType": { "type": "string" } }, "required": ["server", "name", "uri"], "additionalProperties": false }, "Mcp.ResourceCatalog": { "type": "object", "properties": { "resources": { "type": "array", "items": { "$ref": "#/components/schemas/Mcp.Resource" } }, "templates": { "type": "array", "items": { "$ref": "#/components/schemas/Mcp.ResourceTemplate" } } }, "required": ["resources", "templates"], "additionalProperties": false }, "Mcp.ResourceTemplate": { "type": "object", "properties": { "server": { "type": "string" }, "name": { "type": "string" }, "uriTemplate": { "type": "string" }, "description": { "type": "string" }, "mimeType": { "type": "string" } }, "required": ["server", "name", "uriTemplate"], "additionalProperties": false }, "Mcp.Server": { "type": "object", "properties": { "name": { "type": "string" }, "status": { "anyOf": [ { "$ref": "#/components/schemas/Mcp.Status.Connected" }, { "$ref": "#/components/schemas/Mcp.Status.Pending" }, { "$ref": "#/components/schemas/Mcp.Status.Disabled" }, { "$ref": "#/components/schemas/Mcp.Status.Failed" }, { "$ref": "#/components/schemas/Mcp.Status.NeedsAuth" } ] }, "integrationID": { "type": "string" } }, "required": ["name", "status"], "additionalProperties": false }, "Mcp.Status.Connected": { "type": "object", "properties": { "status": { "type": "string", "enum": ["connected"] } }, "required": ["status"], "additionalProperties": false }, "Mcp.Status.Disabled": { "type": "object", "properties": { "status": { "type": "string", "enum": ["disabled"] } }, "required": ["status"], "additionalProperties": false }, "Mcp.Status.Failed": { "type": "object", "properties": { "status": { "type": "string", "enum": ["failed"] }, "error": { "type": "string" } }, "required": ["status", "error"], "additionalProperties": false }, "Mcp.Status.NeedsAuth": { "type": "object", "properties": { "status": { "type": "string", "enum": ["needs_auth"] }, "error": { "type": "string" } }, "required": ["status", "error"], "additionalProperties": false }, "Mcp.Status.Pending": { "type": "object", "properties": { "status": { "type": "string", "enum": ["pending"] } }, "required": ["status"], "additionalProperties": false }, "McpServerNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["McpServerNotFoundError"] }, "server": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "server", "message"], "additionalProperties": false }, "MessageNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["MessageNotFoundError"] }, "sessionID": { "type": "string" }, "messageID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "sessionID", "messageID", "message"], "additionalProperties": false }, "Model.Capabilities": { "type": "object", "properties": { "tools": { "type": "boolean" }, "input": { "type": "array", "items": { "type": "string" } }, "output": { "type": "array", "items": { "type": "string" } } }, "required": ["tools", "input", "output"], "additionalProperties": false }, "Model.Compatibility": { "type": "object", "properties": { "reasoningField": { "$ref": "#/components/schemas/Model.ReasoningField" }, "requireReasoning": { "type": "boolean" }, "maxTokensField": { "$ref": "#/components/schemas/Model.MaxTokensField" }, "requireFinishReason": { "type": "boolean" }, "requireAssistantAfterTool": { "type": "boolean" }, "supportsPromptCacheKey": { "type": "boolean" } }, "additionalProperties": false }, "Model.Cost": { "type": "object", "properties": { "tier": { "type": "object", "properties": { "type": { "type": "string", "enum": ["context"] }, "size": { "type": "integer" } }, "required": ["type", "size"], "additionalProperties": false }, "input": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" }, "output": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" }, "cache": { "type": "object", "properties": { "read": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" }, "write": { "$ref": "#/components/schemas/Money.USDPerMillionTokens" } }, "required": ["read", "write"], "additionalProperties": false } }, "required": ["input", "output", "cache"], "additionalProperties": false }, "Model.Info": { "type": "object", "properties": { "id": { "type": "string" }, "modelID": { "type": "string" }, "providerID": { "type": "string" }, "canonical": { "type": "string" }, "family": { "type": "string" }, "name": { "type": "string" }, "compatibility": { "$ref": "#/components/schemas/Model.Compatibility" }, "package": { "type": "string" }, "settings": { "$ref": "#/components/schemas/Model.Settings" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" }, "capabilities": { "$ref": "#/components/schemas/Model.Capabilities" }, "variants": { "type": "array", "items": { "$ref": "#/components/schemas/Model.Variant" } }, "time": { "type": "object", "properties": { "released": { "type": "number" } }, "required": ["released"], "additionalProperties": false }, "cost": { "type": "array", "items": { "$ref": "#/components/schemas/Model.Cost" } }, "status": { "type": "string", "enum": ["alpha", "beta", "deprecated", "active"] }, "enabled": { "type": "boolean" }, "limit": { "type": "object", "properties": { "context": { "type": "integer" }, "input": { "type": "integer" }, "output": { "type": "integer" } }, "required": ["context", "output"], "additionalProperties": false } }, "required": [ "id", "modelID", "providerID", "name", "capabilities", "variants", "time", "cost", "status", "enabled", "limit" ], "additionalProperties": false }, "Model.MaxTokensField": { "type": "string", "enum": ["max_completion_tokens", "max_tokens"] }, "Model.ReasoningField": { "anyOf": [ { "type": "string", "enum": ["reasoning", "reasoning_content", "reasoning_text"] }, { "type": "string" } ] }, "Model.Ref": { "type": "object", "properties": { "id": { "type": "string" }, "providerID": { "type": "string" }, "variant": { "type": "string" } }, "required": ["id", "providerID"], "additionalProperties": false }, "Model.Settings": { "type": "object", "properties": { "compaction": { "$ref": "#/components/schemas/Provider.Compaction" } }, "allOf": [ { "type": "object", "additionalProperties": {} } ] }, "Model.Variant": { "type": "object", "properties": { "id": { "type": "string" }, "settings": { "$ref": "#/components/schemas/Model.Settings" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" } }, "required": ["id"], "additionalProperties": false }, "Money.USD": { "type": "number" }, "Money.USDPerMillionTokens": { "type": "number" }, "PairingCode": { "type": "object", "properties": { "code": { "type": "string" }, "expires_in": { "type": "integer" } }, "required": ["code", "expires_in"], "additionalProperties": false }, "PairingSession": { "type": "object", "properties": { "token": { "type": "string" } }, "required": ["token"], "additionalProperties": false }, "Permission.Effect": { "type": "string", "enum": ["allow", "deny", "ask"] }, "Permission.Reply": { "type": "string", "enum": ["once", "always", "reject"] }, "Permission.Request": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^per" }, "sessionID": { "type": "string", "pattern": "^ses" }, "action": { "type": "string" }, "resources": { "type": "array", "items": { "type": "string" } }, "save": { "type": "array", "items": { "type": "string" } }, "metadata": { "type": "object" }, "source": { "$ref": "#/components/schemas/Permission.Source" }, "message": { "type": "string" } }, "required": ["id", "sessionID", "action", "resources"], "additionalProperties": false }, "Permission.Rule": { "type": "object", "properties": { "action": { "type": "string" }, "resource": { "type": "string" }, "effect": { "$ref": "#/components/schemas/Permission.Effect" } }, "required": ["action", "resource", "effect"], "additionalProperties": false }, "Permission.Ruleset": { "type": "array", "items": { "$ref": "#/components/schemas/Permission.Rule" } }, "Permission.Source": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": ["tool"] }, "messageID": { "type": "string" }, "id": { "type": "string" } }, "required": ["type", "messageID", "id"], "additionalProperties": false } ] }, "PermissionNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["PermissionNotFoundError"] }, "requestID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "requestID", "message"], "additionalProperties": false }, "PermissionSaved.Info": { "type": "object", "properties": { "id": { "type": "string" }, "projectID": { "type": "string" }, "action": { "type": "string" }, "resource": { "type": "string" }, "time": { "type": "object", "properties": { "created": { "type": "number" }, "updated": { "type": "number" } }, "required": ["created", "updated"], "additionalProperties": false } }, "required": ["id", "projectID", "action", "resource", "time"], "additionalProperties": false }, "PersistentPty.CreateInput": { "type": "object", "properties": { "command": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "cwd": { "type": "string" }, "title": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "size": { "type": "object", "properties": { "cols": { "type": "integer", "exclusiveMinimum": 0 }, "rows": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["cols", "rows"], "additionalProperties": false } }, "required": ["args", "title", "env"], "additionalProperties": false }, "PersistentPty.Handoff": { "type": "object", "properties": { "directory": { "type": "string" }, "instanceID": { "type": "string" }, "ticket": { "type": "string" }, "expiresAt": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] } }, "required": ["directory", "instanceID", "ticket", "expiresAt"], "additionalProperties": false }, "PersistentPty.Info": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^pty" }, "title": { "type": "string" }, "command": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "cwd": { "type": "string" }, "status": { "type": "string", "enum": ["running", "exited"] }, "pid": { "type": "integer", "minimum": 0 }, "exitCode": { "type": "integer", "minimum": 0 }, "sessionID": { "type": "string", "pattern": "^ses" }, "foregroundProcess": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "type": "object", "properties": { "cols": { "type": "integer", "exclusiveMinimum": 0 }, "rows": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["cols", "rows"], "additionalProperties": false }, "output": { "type": "object", "properties": { "head": { "type": "integer", "minimum": 0 }, "tail": { "type": "integer", "minimum": 0 } }, "required": ["head", "tail"], "additionalProperties": false } }, "required": [ "id", "title", "command", "args", "cwd", "status", "pid", "sessionID", "foregroundProcess", "size", "output" ], "additionalProperties": false }, "PersistentPty.ReadLinesEncoded": { "type": "string" }, "PersistentPty.ReadResult": { "type": "object", "properties": { "ptyID": { "type": "string", "pattern": "^pty" }, "title": { "type": "string" }, "cwd": { "type": "string" }, "foregroundProcess": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "screen": { "type": "object", "properties": { "text": { "type": "string" }, "cols": { "type": "integer", "exclusiveMinimum": 0 }, "rows": { "type": "integer", "exclusiveMinimum": 0 }, "cursor": { "type": "object", "properties": { "x": { "type": "integer", "minimum": 0 }, "y": { "type": "integer", "minimum": 0 } }, "required": ["x", "y"], "additionalProperties": false } }, "required": ["text", "cols", "rows", "cursor"], "additionalProperties": false } }, "required": ["ptyID", "title", "cwd", "foregroundProcess", "screen"], "additionalProperties": false }, "PersistentPty.Snapshot": { "type": "object", "properties": { "info": { "$ref": "#/components/schemas/PersistentPty.Info" }, "text": { "type": "string" }, "checkpoint": { "type": "string", "format": "byte", "contentEncoding": "base64" }, "cursor": { "type": "object", "properties": { "x": { "type": "integer", "minimum": 0 }, "y": { "type": "integer", "minimum": 0 } }, "required": ["x", "y"], "additionalProperties": false } }, "required": ["info", "text", "checkpoint", "cursor"], "additionalProperties": false }, "PersistentPty.UpdateInput": { "type": "object", "properties": { "attachmentID": { "type": "string" }, "size": { "type": "object", "properties": { "cols": { "type": "integer", "exclusiveMinimum": 0 }, "rows": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["cols", "rows"], "additionalProperties": false } }, "required": ["size"], "additionalProperties": false }, "Plugin.Features": { "type": "object", "properties": { "server": { "type": "boolean", "enum": [true] }, "tui": { "type": "boolean", "enum": [true] }, "rpc": { "type": "boolean", "enum": [true] } }, "additionalProperties": false }, "Plugin.Info": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "$ref": "#/components/schemas/Plugin.Source" }, "features": { "$ref": "#/components/schemas/Plugin.Features" }, "state": { "$ref": "#/components/schemas/Plugin.State" } }, "required": ["source", "features", "state"], "additionalProperties": false }, "Plugin.Source": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": ["builtin"] } }, "required": ["type"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": ["package"] }, "target": { "type": "string" }, "version": { "type": "string" }, "outdated": { "type": "boolean", "enum": [true] }, "updating": { "type": "boolean", "enum": [true] } }, "required": ["type", "target"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": ["local"] }, "path": { "type": "string" } }, "required": ["type", "path"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": ["sdk"] } }, "required": ["type"], "additionalProperties": false } ] }, "Plugin.State": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": ["active"] } }, "required": ["status"], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["failed"] }, "error": { "type": "string" }, "ref": { "type": "string" } }, "required": ["status", "error"], "additionalProperties": false } ] }, "Project": { "type": "object", "properties": { "id": { "type": "string" }, "canonical": { "type": "string" }, "vcs": { "$ref": "#/components/schemas/Project.Vcs" }, "name": { "type": "string" }, "icon": { "$ref": "#/components/schemas/Project.Icon" }, "commands": { "$ref": "#/components/schemas/Project.Commands" }, "time": { "$ref": "#/components/schemas/Project.Time" }, "sandboxes": { "type": "array", "items": { "type": "string" } } }, "required": ["id", "canonical", "time", "sandboxes"], "additionalProperties": false }, "Project.Commands": { "type": "object", "properties": { "start": { "type": "string", "description": "Startup script to run when creating a new workspace (worktree)" } }, "additionalProperties": false }, "Project.Icon": { "type": "object", "properties": { "url": { "type": "string" }, "override": { "type": "string" }, "color": { "type": "string" } }, "additionalProperties": false }, "Project.Time": { "type": "object", "properties": { "created": { "type": "integer", "minimum": 0 }, "updated": { "type": "integer", "minimum": 0 }, "active": { "type": "integer", "minimum": 0 } }, "required": ["created", "updated", "active"], "additionalProperties": false }, "Project.Vcs": { "type": "string", "pattern": "^[a-z][a-z0-9._-]*$" }, "ProjectNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["ProjectNotFoundError"] }, "projectID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "projectID", "message"], "additionalProperties": false }, "Prompt.AgentAttachment": { "type": "object", "properties": { "name": { "type": "string" }, "mention": { "$ref": "#/components/schemas/Prompt.Mention" } }, "required": ["name"], "additionalProperties": false }, "Prompt.Base64": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }, "Prompt.FileAttachment": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Prompt.Base64" }, "mime": { "type": "string" }, "source": { "$ref": "#/components/schemas/Prompt.FileSource" }, "name": { "type": "string" }, "description": { "type": "string" }, "mention": { "$ref": "#/components/schemas/Prompt.Mention" } }, "required": ["data", "mime", "source"], "additionalProperties": false }, "Prompt.FileSource": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": ["inline"] } }, "required": ["type"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": ["uri"] }, "uri": { "type": "string" } }, "required": ["type", "uri"], "additionalProperties": false } ] }, "Prompt.Mention": { "type": "object", "properties": { "start": { "type": "number" }, "end": { "type": "number" }, "text": { "type": "string" } }, "required": ["start", "end", "text"], "additionalProperties": false }, "Prompt.SkillAttachment": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "text": { "type": "string" }, "mention": { "$ref": "#/components/schemas/Prompt.Mention" } }, "required": ["id", "name"], "additionalProperties": false }, "PromptInput.FileAttachment": { "type": "object", "properties": { "uri": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "mention": { "$ref": "#/components/schemas/Prompt.Mention" } }, "required": ["uri"], "additionalProperties": false }, "PromptInput.SkillAttachment": { "type": "object", "properties": { "id": { "type": "string" }, "mention": { "$ref": "#/components/schemas/Prompt.Mention" } }, "required": ["id"], "additionalProperties": false }, "Provider.Compaction": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": ["summary"] } }, "required": ["type"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": ["native"] } }, "required": ["type"], "additionalProperties": false } ] }, "Provider.Info": { "type": "object", "properties": { "id": { "type": "string" }, "canonical": { "type": "string" }, "integrationID": { "type": "string" }, "name": { "type": "string" }, "activation": { "type": "string", "enum": ["auto", "enabled", "disabled"] }, "package": { "type": "string" }, "settings": { "$ref": "#/components/schemas/Provider.Settings" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" } }, "required": ["id", "name", "activation", "package"], "additionalProperties": false }, "Provider.Request": { "type": "object", "properties": { "settings": { "$ref": "#/components/schemas/Provider.Settings" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "object" } }, "required": ["settings", "headers", "body"], "additionalProperties": false }, "Provider.Settings": { "type": "object", "properties": { "timeout": { "anyOf": [ { "type": "number" }, { "type": "boolean", "enum": [false] } ] }, "chunkTimeout": { "type": "number" }, "compaction": { "$ref": "#/components/schemas/Provider.Compaction" }, "transport": { "$ref": "#/components/schemas/Provider.Transport" } }, "allOf": [ { "type": "object", "additionalProperties": {} } ] }, "Provider.Transport": { "type": "string", "enum": ["http", "websocket"] }, "ProviderNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["ProviderNotFoundError"] }, "providerID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "providerID", "message"], "additionalProperties": false }, "Pty": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^pty" }, "title": { "type": "string" }, "command": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "cwd": { "type": "string" }, "status": { "type": "string", "enum": ["running", "exited"] }, "pid": { "type": "integer", "minimum": 0 }, "exitCode": { "type": "integer", "minimum": 0 } }, "required": ["id", "title", "command", "args", "cwd", "status", "pid"], "additionalProperties": false }, "PtyNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["PtyNotFoundError"] }, "ptyID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "ptyID", "message"], "additionalProperties": false }, "PtyTicket.ConnectToken": { "type": "object", "properties": { "ticket": { "type": "string" }, "expires_in": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["ticket", "expires_in"], "additionalProperties": false }, "Reference.GitSource": { "type": "object", "properties": { "type": { "type": "string", "enum": ["git"] }, "repository": { "type": "string" }, "branch": { "type": "string" } }, "required": ["type", "repository"], "additionalProperties": false }, "Reference.Info": { "type": "object", "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "description": { "type": "string" }, "hidden": { "type": "boolean" }, "source": { "$ref": "#/components/schemas/Reference.Source" } }, "required": ["name", "path", "source"], "additionalProperties": false }, "Reference.LocalSource": { "type": "object", "properties": { "type": { "type": "string", "enum": ["local"] }, "path": { "type": "string" } }, "required": ["type", "path"], "additionalProperties": false }, "Reference.Source": { "anyOf": [ { "$ref": "#/components/schemas/Reference.LocalSource" }, { "$ref": "#/components/schemas/Reference.GitSource" } ] }, "Rpc.Input": { "type": "object", "properties": { "input": {} }, "additionalProperties": false }, "Rpc.Output": { "type": "object", "properties": { "output": {} }, "additionalProperties": false }, "RpcErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["RpcError"] }, "type": { "type": "string" }, "message": { "type": "string" }, "data": { "anyOf": [ {}, { "type": "null" } ] } }, "required": ["_tag", "type", "message"], "additionalProperties": false }, "RpcInternalErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["RpcInternalError"] }, "type": { "type": "string", "enum": ["rpc.internal", "rpc.invalid_output"] }, "message": { "type": "string" }, "data": { "anyOf": [ {}, { "type": "null" } ] } }, "required": ["_tag", "type", "message"], "additionalProperties": false }, "ServerInfo": { "type": "object", "properties": { "version": { "type": "string" }, "pid": { "type": "integer", "minimum": 0 }, "urls": { "type": "array", "items": { "type": "string" } }, "paths": { "type": "object", "properties": { "tmp": { "type": "string" } }, "required": ["tmp"], "additionalProperties": false } }, "required": ["version", "pid", "urls", "paths"], "additionalProperties": false }, "ServiceUnavailableErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["ServiceUnavailableError"] }, "message": { "type": "string" }, "service": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["_tag", "message"], "additionalProperties": false }, "Session.ForkBoundary": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": ["before"] }, "messageID": { "type": "string", "pattern": "^msg_" } }, "required": ["type", "messageID"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": ["through"] }, "messageID": { "type": "string", "pattern": "^msg_" } }, "required": ["type", "messageID"], "additionalProperties": false } ] }, "Session.Inbox.Compaction": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "sessionID": { "type": "string", "pattern": "^ses" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["compaction"] }, "payload": { "$ref": "#/components/schemas/Session.Inbox.CompactionPayload" }, "delivery": { "$ref": "#/components/schemas/Session.Inbox.Delivery" } }, "required": ["id", "sessionID", "time", "type", "payload", "delivery"], "additionalProperties": false }, "Session.Inbox.CompactionPayload": { "anyOf": [ { "type": "object" }, { "type": "array" } ] }, "Session.Inbox.Delivery": { "type": "string", "enum": ["steer", "queue"] }, "Session.Inbox.Info": { "anyOf": [ { "$ref": "#/components/schemas/Session.Inbox.User" }, { "$ref": "#/components/schemas/Session.Inbox.Synthetic" }, { "$ref": "#/components/schemas/Session.Inbox.Compaction" }, { "$ref": "#/components/schemas/Session.Inbox.Move" } ] }, "Session.Inbox.Move": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "sessionID": { "type": "string", "pattern": "^ses" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["move"] }, "delivery": { "$ref": "#/components/schemas/Session.Inbox.Delivery" }, "payload": { "$ref": "#/components/schemas/Session.Inbox.MovePayload" } }, "required": ["id", "sessionID", "time", "type", "delivery", "payload"], "additionalProperties": false }, "Session.Inbox.MovePayload": { "type": "object", "properties": { "projectID": { "type": "string" }, "subpath": { "type": "string" }, "location": { "$ref": "#/components/schemas/Location.PublicRef" } }, "required": ["projectID", "location"], "additionalProperties": false }, "Session.Inbox.Synthetic": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "sessionID": { "type": "string", "pattern": "^ses" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["synthetic"] }, "payload": { "$ref": "#/components/schemas/Session.Inbox.SyntheticPayload" }, "delivery": { "$ref": "#/components/schemas/Session.Inbox.Delivery" } }, "required": ["id", "sessionID", "time", "type", "payload", "delivery"], "additionalProperties": false }, "Session.Inbox.SyntheticPayload": { "type": "object", "properties": { "text": { "type": "string" }, "description": { "type": "string" }, "metadata": { "type": "object" } }, "required": ["text"], "additionalProperties": false }, "Session.Inbox.User": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "sessionID": { "type": "string", "pattern": "^ses" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["user"] }, "payload": { "$ref": "#/components/schemas/Session.Inbox.UserPayload" }, "delivery": { "$ref": "#/components/schemas/Session.Inbox.Delivery" } }, "required": ["id", "sessionID", "time", "type", "payload", "delivery"], "additionalProperties": false }, "Session.Inbox.UserPayload": { "type": "object", "properties": { "text": { "type": "string" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.FileAttachment" } }, "agents": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.AgentAttachment" } }, "skills": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.SkillAttachment" } }, "metadata": { "type": "object" } }, "required": ["text"], "additionalProperties": false }, "Session.Info": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^ses" }, "parentID": { "type": "string", "pattern": "^ses" }, "fork": { "type": "object", "properties": { "sessionID": { "type": "string", "pattern": "^ses" }, "boundary": { "$ref": "#/components/schemas/Session.ForkBoundary" } }, "required": ["sessionID", "boundary"], "additionalProperties": false }, "projectID": { "type": "string" }, "agent": { "type": "string" }, "model": { "$ref": "#/components/schemas/Model.Ref" }, "cost": { "$ref": "#/components/schemas/Money.USD" }, "tokens": { "$ref": "#/components/schemas/TokenUsage.Info" }, "outcome": { "type": "string", "enum": ["succeeded", "failed", "interrupted"] }, "time": { "type": "object", "properties": { "created": { "type": "number" }, "updated": { "type": "number" }, "idle": { "type": "number" }, "viewed": { "type": "number" }, "archived": { "type": "number" } }, "required": ["created", "updated"], "additionalProperties": false }, "title": { "type": "string" }, "subpath": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/Session.Metadata" }, "permissions": { "$ref": "#/components/schemas/Permission.Ruleset" }, "revert": { "$ref": "#/components/schemas/Session.Revert" }, "location": { "$ref": "#/components/schemas/Location.PublicRef" } }, "required": ["id", "projectID", "cost", "tokens", "time", "location"], "additionalProperties": false }, "Session.Message.AgentSelected": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["agent-switched"] }, "agent": { "type": "string" }, "previous": { "type": "string" } }, "required": ["id", "time", "type", "agent"], "additionalProperties": false }, "Session.Message.Assistant": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" }, "streamed": { "type": "number" }, "completed": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["assistant"] }, "agent": { "type": "string" }, "model": { "$ref": "#/components/schemas/Model.Ref" }, "content": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/Session.Message.Assistant.Text" }, { "$ref": "#/components/schemas/Session.Message.Assistant.Reasoning" }, { "$ref": "#/components/schemas/Session.Message.Assistant.Tool" } ] } }, "snapshot": { "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "files": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "finish": { "type": "string", "enum": ["stop", "length", "tool-calls", "content-filter", "error", "unknown"] }, "rawFinish": { "type": "string" }, "providerState": { "$ref": "#/components/schemas/Session.Message.ProviderState_4" }, "cost": { "$ref": "#/components/schemas/Money.USD" }, "tokens": { "$ref": "#/components/schemas/TokenUsage.Info" }, "error": { "$ref": "#/components/schemas/Session.StructuredError" }, "retry": { "$ref": "#/components/schemas/Session.Message.Assistant.Retry" } }, "required": ["id", "time", "type", "agent", "model", "content"], "additionalProperties": false }, "Session.Message.Assistant.Reasoning": { "type": "object", "properties": { "type": { "type": "string", "enum": ["reasoning"] }, "text": { "type": "string" }, "state": { "$ref": "#/components/schemas/Session.Message.ProviderState_1" }, "time": { "type": "object", "properties": { "created": { "type": "number" }, "completed": { "type": "number" } }, "required": ["created"], "additionalProperties": false } }, "required": ["type", "text"], "additionalProperties": false }, "Session.Message.Assistant.Retry": { "type": "object", "properties": { "attempt": { "type": "integer", "exclusiveMinimum": 0 }, "at": { "type": "number" }, "error": { "$ref": "#/components/schemas/Session.StructuredError" } }, "required": ["attempt", "at", "error"], "additionalProperties": false }, "Session.Message.Assistant.Text": { "type": "object", "properties": { "type": { "type": "string", "enum": ["text"] }, "text": { "type": "string" }, "state": { "$ref": "#/components/schemas/Session.Message.ProviderState" } }, "required": ["type", "text"], "additionalProperties": false }, "Session.Message.Assistant.Tool": { "type": "object", "properties": { "type": { "type": "string", "enum": ["tool"] }, "id": { "type": "string" }, "name": { "type": "string" }, "executed": { "type": "boolean" }, "providerState": { "$ref": "#/components/schemas/Session.Message.ProviderState_2" }, "providerResultState": { "$ref": "#/components/schemas/Session.Message.ProviderState_3" }, "state": { "anyOf": [ { "$ref": "#/components/schemas/Session.Message.ToolState.Streaming" }, { "$ref": "#/components/schemas/Session.Message.ToolState.Running" }, { "$ref": "#/components/schemas/Session.Message.ToolState.Completed" }, { "$ref": "#/components/schemas/Session.Message.ToolState.Error" } ] }, "time": { "type": "object", "properties": { "created": { "type": "number" }, "ran": { "type": "number" }, "completed": { "type": "number" } }, "required": ["created"], "additionalProperties": false } }, "required": ["type", "id", "name", "state", "time"], "additionalProperties": false }, "Session.Message.Compaction": { "anyOf": [ { "$ref": "#/components/schemas/Session.Message.Compaction.Running" }, { "$ref": "#/components/schemas/Session.Message.Compaction.Completed" }, { "$ref": "#/components/schemas/Session.Message.Compaction.Failed" } ] }, "Session.Message.Compaction.Completed": { "type": "object", "properties": { "type": { "type": "string", "enum": ["compaction"] }, "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "status": { "type": "string", "enum": ["completed"] }, "reason": { "type": "string", "enum": ["auto", "manual"] }, "model": { "$ref": "#/components/schemas/Model.Ref" }, "providerState": { "$ref": "#/components/schemas/Session.Message.ProviderState_5" }, "summary": { "type": "string" }, "recent": { "type": "string" }, "providerContext": { "$ref": "#/components/schemas/Session.ProviderContext" }, "cost": { "$ref": "#/components/schemas/Money.USD" }, "tokens": { "$ref": "#/components/schemas/TokenUsage.Info" } }, "required": ["type", "id", "time", "status", "reason", "summary", "recent"], "additionalProperties": false }, "Session.Message.Compaction.Failed": { "type": "object", "properties": { "type": { "type": "string", "enum": ["compaction"] }, "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "status": { "type": "string", "enum": ["failed"] }, "reason": { "type": "string", "enum": ["auto", "manual"] }, "error": { "$ref": "#/components/schemas/Session.StructuredError" }, "cost": { "$ref": "#/components/schemas/Money.USD" }, "tokens": { "$ref": "#/components/schemas/TokenUsage.Info" } }, "required": ["type", "id", "time", "status", "reason", "error"], "additionalProperties": false }, "Session.Message.Compaction.Running": { "type": "object", "properties": { "type": { "type": "string", "enum": ["compaction"] }, "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "status": { "type": "string", "enum": ["running"] }, "reason": { "type": "string", "enum": ["auto", "manual"] }, "summary": { "type": "string" }, "recent": { "type": "string" } }, "required": ["type", "id", "time", "status", "reason", "summary", "recent"], "additionalProperties": false }, "Session.Message.Idle": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["idle"] }, "outcome": { "type": "string", "enum": ["succeeded", "failed", "interrupted"] } }, "required": ["id", "time", "type", "outcome"], "additionalProperties": false }, "Session.Message.Info": { "anyOf": [ { "$ref": "#/components/schemas/Session.Message.AgentSelected" }, { "$ref": "#/components/schemas/Session.Message.ModelSelected" }, { "$ref": "#/components/schemas/Session.Message.LocationSwitched" }, { "$ref": "#/components/schemas/Session.Message.User" }, { "$ref": "#/components/schemas/Session.Message.Synthetic" }, { "$ref": "#/components/schemas/Session.Message.System" }, { "$ref": "#/components/schemas/Session.Message.Skill" }, { "$ref": "#/components/schemas/Session.Message.Shell" }, { "$ref": "#/components/schemas/Session.Message.Assistant" }, { "$ref": "#/components/schemas/Session.Message.Compaction" }, { "$ref": "#/components/schemas/Session.Message.Idle" } ] }, "Session.Message.LocationSwitched": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["location-switched"] }, "projectID": { "type": "string" }, "subpath": { "type": "string" }, "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "previous": { "anyOf": [ { "type": "object", "properties": { "location": { "$ref": "#/components/schemas/Location.PublicRef" }, "projectID": { "type": "string" }, "subpath": { "type": "string" } }, "required": ["location"], "additionalProperties": false }, { "type": "null" } ] } }, "required": ["id", "time", "type", "location"], "additionalProperties": false }, "Session.Message.ModelSelected": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["model-switched"] }, "model": { "$ref": "#/components/schemas/Model.Ref" }, "previous": { "$ref": "#/components/schemas/Model.Ref" } }, "required": ["id", "time", "type", "model"], "additionalProperties": false }, "Session.Message.ProviderState": { "type": "object" }, "Session.Message.ProviderState_1": { "type": "object" }, "Session.Message.ProviderState_2": { "type": "object" }, "Session.Message.ProviderState_3": { "type": "object" }, "Session.Message.ProviderState_4": { "type": "object" }, "Session.Message.ProviderState_5": { "type": "object" }, "Session.Message.Shell": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" }, "completed": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["shell"] }, "shellID": { "type": "string", "pattern": "^sh_" }, "command": { "type": "string" }, "status": { "type": "string", "enum": ["running", "exited", "timeout", "killed"] }, "exit": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": ["Infinity", "-Infinity", "NaN"] } ] }, "output": { "type": "object", "properties": { "output": { "type": "string" }, "cursor": { "type": "integer", "minimum": 0 }, "size": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" } }, "required": ["output", "cursor", "size", "truncated"], "additionalProperties": false } }, "required": ["id", "time", "type", "shellID", "command", "status"], "additionalProperties": false }, "Session.Message.Skill": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["skill"] }, "skill": { "type": "string" }, "name": { "type": "string" }, "text": { "type": "string" } }, "required": ["id", "time", "type", "skill", "name", "text"], "additionalProperties": false }, "Session.Message.Synthetic": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "text": { "type": "string" }, "description": { "type": "string" }, "type": { "type": "string", "enum": ["synthetic"] } }, "required": ["id", "time", "text", "type"], "additionalProperties": false }, "Session.Message.System": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "type": { "type": "string", "enum": ["system"] }, "text": { "type": "string" }, "description": { "type": "string" } }, "required": ["id", "time", "type", "text"], "additionalProperties": false }, "Session.Message.ToolState.Completed": { "type": "object", "properties": { "status": { "type": "string", "enum": ["completed"] }, "input": { "type": "object" }, "content": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/Tool.Content" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/Tool.Content" } }, "metadata": { "type": "object" } }, "required": ["status", "input", "content"], "additionalProperties": false }, "Session.Message.ToolState.Error": { "type": "object", "properties": { "status": { "type": "string", "enum": ["error"] }, "input": { "type": "object" }, "error": { "$ref": "#/components/schemas/Session.StructuredError" }, "content": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/Tool.Content" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/Tool.Content" } }, "metadata": { "type": "object" } }, "required": ["status", "input", "error"], "additionalProperties": false }, "Session.Message.ToolState.Running": { "type": "object", "properties": { "status": { "type": "string", "enum": ["running"] }, "input": { "type": "object" }, "metadata": { "type": "object" } }, "required": ["status", "input", "metadata"], "additionalProperties": false }, "Session.Message.ToolState.Streaming": { "type": "object", "properties": { "status": { "type": "string", "enum": ["streaming"] }, "input": { "type": "string" } }, "required": ["status", "input"], "additionalProperties": false }, "Session.Message.User": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^msg_" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "created": { "type": "number" } }, "required": ["created"], "additionalProperties": false }, "text": { "type": "string" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.FileAttachment" } }, "agents": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.AgentAttachment" } }, "skills": { "type": "array", "items": { "$ref": "#/components/schemas/Prompt.SkillAttachment" } }, "type": { "type": "string", "enum": ["user"] } }, "required": ["id", "time", "text", "type"], "additionalProperties": false }, "Session.Metadata": { "type": "object" }, "Session.ProviderContext": { "type": "object", "properties": { "version": { "type": "number", "enum": [1] }, "provenance": { "$ref": "#/components/schemas/Session.ProviderContext.Provenance" }, "messages": {} }, "required": ["version", "provenance", "messages"], "additionalProperties": false }, "Session.ProviderContext.Provenance": { "type": "object", "properties": { "providerID": { "type": "string" }, "provider": { "type": "string" }, "modelID": { "type": "string" }, "route": { "type": "string" }, "protocol": { "type": "string" }, "endpoint": { "type": "string" } }, "required": ["providerID", "provider", "modelID", "route", "protocol", "endpoint"], "additionalProperties": false }, "Session.Revert": { "type": "object", "properties": { "messageID": { "type": "string", "pattern": "^msg_" }, "partID": { "type": "string" }, "snapshot": { "type": "string" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/FileDiff.Info" } } }, "required": ["messageID"], "additionalProperties": false }, "Session.StructuredError": { "type": "object", "properties": { "type": { "type": "string" }, "message": { "type": "string" }, "status": { "type": "integer", "minimum": 100, "maximum": 599 } }, "required": ["type", "message"], "additionalProperties": false }, "SessionActive": { "type": "object", "properties": { "type": { "type": "string", "enum": ["running"] } }, "required": ["type"], "additionalProperties": false }, "SessionBusyErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["SessionBusyError"] }, "sessionID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "sessionID", "message"], "additionalProperties": false }, "SessionGenerateResponse": { "type": "object", "properties": { "data": { "type": "object", "properties": { "text": { "type": "string" } }, "required": ["text"], "additionalProperties": false } }, "required": ["data"], "additionalProperties": false }, "SessionInterruptResponse": { "type": "object", "properties": { "interrupted": { "type": "boolean", "description": "Whether an active execution owned by this OpenCode process was interrupted." } }, "required": ["interrupted"], "additionalProperties": false }, "SessionLogItemEncoded": { "type": "string", "contentMediaType": "application/json" }, "SessionMessagesResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Session.Message.Info" } }, "cursor": { "type": "object", "properties": { "previous": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "next": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false } }, "required": ["data", "cursor"], "additionalProperties": false }, "SessionNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["SessionNotFoundError"] }, "sessionID": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "sessionID", "message"], "additionalProperties": false }, "SessionStats.Activity": { "type": "object", "properties": { "date": { "type": "string" }, "steps": { "type": "integer", "minimum": 0 } }, "required": ["date", "steps"], "additionalProperties": false }, "SessionStats.Info": { "type": "object", "properties": { "range": { "type": "object", "properties": { "from": { "type": "number" }, "to": { "type": "number" } }, "required": ["from", "to"], "additionalProperties": false }, "sessions": { "type": "integer", "minimum": 0 }, "subagents": { "type": "integer", "minimum": 0 }, "prompts": { "type": "integer", "minimum": 0 }, "steps": { "type": "integer", "minimum": 0 }, "tokens": { "$ref": "#/components/schemas/TokenUsage.Info" }, "cost": { "$ref": "#/components/schemas/Money.USD" }, "tools": { "$ref": "#/components/schemas/SessionStats.Tools" }, "activeDays": { "type": "integer", "minimum": 0 }, "streak": { "type": "integer", "minimum": 0 }, "activity": { "type": "array", "items": { "$ref": "#/components/schemas/SessionStats.Activity" } }, "models": { "type": "array", "items": { "$ref": "#/components/schemas/SessionStats.ModelUsage" } } }, "required": [ "range", "sessions", "subagents", "prompts", "steps", "tokens", "cost", "tools", "activeDays", "streak", "activity", "models" ], "additionalProperties": false }, "SessionStats.ModelUsage": { "type": "object", "properties": { "model": { "$ref": "#/components/schemas/Model.Ref" }, "steps": { "type": "integer", "minimum": 0 }, "tokens": { "$ref": "#/components/schemas/TokenUsage.Info" }, "cost": { "$ref": "#/components/schemas/Money.USD" } }, "required": ["model", "steps", "tokens", "cost"], "additionalProperties": false }, "SessionStats.ToolTotals": { "type": "object", "properties": { "calls": { "type": "integer", "minimum": 0 }, "succeeded": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 }, "unfinished": { "type": "integer", "minimum": 0 } }, "required": ["calls", "succeeded", "failed", "unfinished"], "additionalProperties": false }, "SessionStats.ToolUsage": { "type": "object", "properties": { "name": { "type": "string" }, "calls": { "type": "integer", "minimum": 0 }, "succeeded": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 }, "unfinished": { "type": "integer", "minimum": 0 }, "durationP50": { "type": "number" } }, "required": ["name", "calls", "succeeded", "failed", "unfinished"], "additionalProperties": false }, "SessionStats.Tools": { "anyOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": ["none"] } }, "required": ["mode"], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": ["summary"] }, "totals": { "$ref": "#/components/schemas/SessionStats.ToolTotals" } }, "required": ["mode", "totals"], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": ["detail"] }, "totals": { "$ref": "#/components/schemas/SessionStats.ToolTotals" }, "usage": { "type": "array", "items": { "$ref": "#/components/schemas/SessionStats.ToolUsage" } } }, "required": ["mode", "totals", "usage"], "additionalProperties": false } ] }, "SessionTransfer.Data": { "type": "object", "properties": { "info": { "$ref": "#/components/schemas/Session.Info" }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/Session.Message.Info" } } }, "required": ["info", "messages"], "additionalProperties": false }, "SessionsResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Session.Info" } }, "cursor": { "type": "object", "properties": { "previous": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "next": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false } }, "required": ["data", "cursor"], "additionalProperties": false }, "Shell.Info": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^sh_" }, "status": { "type": "string", "enum": ["running", "exited", "timeout", "killed"] }, "command": { "type": "string" }, "cwd": { "type": "string" }, "shell": { "type": "string" }, "file": { "type": "string" }, "pid": { "type": "integer", "minimum": 0 }, "exit": { "type": "number" }, "signal": { "type": "string" }, "metadata": { "type": "object" }, "time": { "type": "object", "properties": { "started": { "type": "number", "description": "Start time in milliseconds since the Unix epoch" }, "completed": { "type": "number" } }, "required": ["started"], "additionalProperties": false } }, "required": ["id", "status", "command", "cwd", "shell", "file", "metadata", "time"], "additionalProperties": false }, "ShellNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["ShellNotFoundError"] }, "id": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "id", "message"], "additionalProperties": false }, "Skill.Info": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "autoinvoke": { "type": "boolean" }, "path": { "type": "string" }, "content": { "type": "string" } }, "required": ["id", "name", "path", "content"], "additionalProperties": false }, "SkillNotFoundErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["SkillNotFoundError"] }, "skill": { "type": "string" }, "message": { "type": "string" } }, "required": ["_tag", "skill", "message"], "additionalProperties": false }, "TokenUsage.Info": { "type": "object", "properties": { "input": { "type": "number" }, "output": { "type": "number" }, "reasoning": { "type": "number" }, "cache": { "type": "object", "properties": { "read": { "type": "number" }, "write": { "type": "number" } }, "required": ["read", "write"], "additionalProperties": false } }, "required": ["input", "output", "reasoning", "cache"], "additionalProperties": false }, "Tool.Content": { "anyOf": [ { "$ref": "#/components/schemas/Tool.TextContent" }, { "$ref": "#/components/schemas/Tool.FileContent" } ] }, "Tool.FileContent": { "type": "object", "properties": { "type": { "type": "string", "enum": ["file"] }, "uri": { "type": "string" }, "mime": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["type", "uri", "mime"], "additionalProperties": false }, "Tool.TextContent": { "type": "object", "properties": { "type": { "type": "string", "enum": ["text"] }, "text": { "type": "string" } }, "required": ["type", "text"], "additionalProperties": false }, "UnauthorizedErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["UnauthorizedError"] }, "message": { "type": "string" } }, "required": ["_tag", "message"], "additionalProperties": false }, "UnknownErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": ["UnknownError"] }, "message": { "type": "string" }, "ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["_tag", "message"], "additionalProperties": false }, "V2EventEncoded": { "type": "string", "contentMediaType": "application/json" }, "Vcs.Base": { "type": "object", "properties": { "name": { "type": "string" }, "ref": { "type": "string" }, "source": { "type": "string", "enum": ["reflog", "default"] } }, "required": ["name", "ref", "source"], "additionalProperties": false }, "Vcs.Branch": { "type": "object", "properties": { "current": { "type": "string" }, "default": { "type": "string" } }, "additionalProperties": false }, "Vcs.BranchList": { "type": "array", "items": { "type": "string" } }, "Vcs.FileStatus": { "type": "object", "properties": { "file": { "type": "string" }, "additions": { "type": "integer", "minimum": 0 }, "deletions": { "type": "integer", "minimum": 0 }, "status": { "type": "string", "enum": ["added", "deleted", "modified"] } }, "required": ["file", "additions", "deletions", "status"], "additionalProperties": false }, "Vcs.Info": { "type": "object", "properties": { "provider": { "type": "string" }, "branch": { "$ref": "#/components/schemas/Vcs.Branch" }, "workingCopy": { "$ref": "#/components/schemas/Vcs.WorkingCopy" } }, "required": ["branch"], "additionalProperties": false }, "Vcs.Mode": { "type": "string", "enum": ["working", "branch", "committed"] }, "Vcs.WorkingCopy": { "type": "object", "properties": { "label": { "type": "string" }, "workspace": { "type": "string" }, "changeID": { "type": "string" }, "commitID": { "type": "string" }, "bookmarks": { "type": "array", "items": { "type": "string" } }, "description": { "type": "string" }, "conflicted": { "type": "boolean" }, "empty": { "type": "boolean" } }, "required": ["bookmarks", "conflicted", "empty"], "additionalProperties": false }, "WebSearch.Provider": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": ["id", "name"], "additionalProperties": false }, "WebSearch.ResponseEncoded": { "type": "object", "properties": { "providerID": { "type": "string" }, "results": { "type": "array", "items": { "$ref": "#/components/schemas/WebSearch.Result" } } }, "required": ["providerID", "results"], "additionalProperties": false }, "WebSearch.Result": { "type": "object", "properties": { "url": { "type": "string" }, "title": { "type": "string" }, "content": { "type": "string" }, "time": { "type": "object", "properties": { "published": { "type": "number" } }, "additionalProperties": false } }, "required": ["url", "time"], "additionalProperties": false }, "Worktree.CreateInput": { "type": "object", "properties": { "projectID": { "type": "string" }, "from": { "type": "string" }, "branch": { "type": "string" }, "base": { "type": "string" }, "directory": { "type": "string" }, "name": { "type": "string" } }, "required": ["projectID"], "additionalProperties": false }, "Worktree.Directory": { "type": "object", "properties": { "directory": { "type": "string" }, "strategy": { "type": "string" } }, "required": ["directory"], "additionalProperties": false }, "Worktree.Info": { "type": "object", "properties": { "directory": { "type": "string" } }, "required": ["directory"], "additionalProperties": false }, "Worktree.List": { "type": "array", "items": { "$ref": "#/components/schemas/Worktree.Directory" } }, "Worktree.RemoveInput": { "type": "object", "properties": { "projectID": { "type": "string" }, "directory": { "type": "string" }, "force": { "type": "boolean" } }, "required": ["projectID", "directory", "force"], "additionalProperties": false }, "WorktreeErrorEncoded": { "type": "object", "properties": { "name": { "type": "string", "enum": ["WorktreeError"] }, "data": { "type": "object", "properties": { "message": { "type": "string" }, "forceRequired": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": ["message"], "additionalProperties": false } }, "required": ["name", "data"], "additionalProperties": false } }, "securitySchemes": {} }, "security": [], "tags": [ { "name": "server" }, { "name": "location" }, { "name": "agent" }, { "name": "plugin", "description": "Experimental plugin routes." }, { "name": "session", "description": "Experimental session routes." }, { "name": "session", "description": "Experimental message routes." }, { "name": "model", "description": "Experimental model routes." }, { "name": "generate", "description": "Experimental one-shot generation routes." }, { "name": "provider", "description": "Experimental provider routes." }, { "name": "integration", "description": "Integration discovery and authentication routes." }, { "name": "mcp", "description": "MCP server and resource routes." }, { "name": "credential" }, { "name": "project", "description": "Project routes." }, { "name": "form", "description": "Location form routes." }, { "name": "permission", "description": "Experimental permission routes." }, { "name": "filesystem", "description": "Experimental location-scoped filesystem routes." }, { "name": "command", "description": "Experimental command routes." }, { "name": "skill", "description": "Experimental skill routes." }, { "name": "rpc", "description": "Plugin RPC routes." }, { "name": "event", "description": "Experimental event stream routes." }, { "name": "pty", "description": "Experimental location-scoped PTY routes." }, { "name": "persistentPty", "description": "Prototype persistent PTY routes." }, { "name": "shell", "description": "Location-scoped shell command routes." }, { "name": "reference", "description": "Location-scoped project references." }, { "name": "worktree", "description": "Project-based worktree management routes." }, { "name": "vcs", "description": "Location-scoped version control routes." }, { "name": "debug" }, { "name": "migration" }, { "name": "websearch", "description": "Location-scoped web search routes." }, { "name": "config", "description": "Location-scoped configuration routes." } ]}