+ lHj Ra0t$Rt^RIHt^RIt^RIt^RIHt^RIH t ^RI H t H t H t ]P!]4t]!RR7!RR 44t]!RR7!R R 44t]!RR7!R R 44t/tR]R&/tR]R&/tR]R&/tR]R&RRltRR/RRlltRR/RRlltRR/RRlltR4RR/RR lllt]!]P>PAR!44t!!R"R#]"4t#R$R%lt$R&R'lt%R(R)lt&R*R+lt'R,R-lt(R.R/lt)R0R1lt*R2R3lt+R#)5uThe contract catalog: every method, server→client request and event the gateway speaks. Three tables, filled by the ``contracts.*`` topic modules at import time and read by ``tui_gateway/server.py`` (runtime validation) and ``scripts/gen_gateway_contracts.py`` (TypeScript + OpenRPC rendering). A handler registered with ``@method`` for a name that has no contract here fails at import: the wire has no undeclared surface. ) annotationsN) dataclass)ValidationError)ParamsPayloadResultT)frozencD]tRt^t$R]R&R]R&R]R&RtR]R&R tR #) MethodContractstrname type[Params]params type[Result]resultdocN__name__ __module__ __qualname____firstlineno____annotations__r__static_attributes__rC/home/ubuntu/.hermes/hermes-agent/tui_gateway/contracts/registry.pyr r s I  CMrr cH]tRt^t$RtR]R&R]R&R]R&RtR]R &R tR #) ServerRequestContractzBA question the backend asks the client (``server_requests.send``).r r r rrrrrrN)rrrr__doc__rrrrrrrrsL I  CMrrc:]tRt^(t$R]R&R]R&RtR]R&RtR#) EventContractr r type[Payload] | NonepayloadrrrNrrrrr!r!(s I !!CMrr!zdict[str, MethodContract]METHODSCANONICAL_METHODSz dict[str, ServerRequestContract]SERVER_REQUESTSzdict[str, EventContract]EVENTSc V^8dQhRRRR/#)tabledictreturnNoner)formats"r __annotate__r/7sDDrctVPV9d\RVP 24hWVP&R#)zcontract declared twice: N)r RuntimeError)r*entrys&&r_declarer37s3 zzU6uzzlCDD%**rrrc ,V^8dQhRRRRRRRRRR /# r)r r rr rrrr,r r)r.s"rr/r/?s0|#Werc>\WW#4p\\V4V#N)r r3r$r rrrr2s&$$$ rmethodr9?s 4 5E We Lrc ,V^8dQhRRRRRRRRRR /#r5r)r.s"rr/r/Es13<TWaorc>\WW#4p\\V4V#r7)r r3r%r8s&$$$ rcanonical_methodr<Es 4 5E & Lrc ,V^8dQhRRRRRRRRRR /#) r)r r rr rrrr,rr)r.s"rr/r/Ks1|RU_trc>\WW#4p\\V4V#r7)rr3r&r8s&$$$ rserver_requestr?Ks !$ \WV4p\\V4V#r7)r!r3r')r r#rr2s&&$ reventrBQs $ -E VU LrHERMES_TEST_ISOLATIONc]tRt^_tRtRtR#)ContractViolationzNA result or payload the gateway produced does not match its declared contract.rN)rrrrrrrrrrErE_sXrrEc(V^8dQhRRRRRRRR/#)r)kindr r excrr,r-r)r.s"rr/r/cs.JJ#JSJJ4Jrcv\'d\V RV: RV 24Vh\PRWV4R#) z violates its contract: z$%s %r violates its wire contract: %sN)STRICTrEloggererror)rGr rHs&&&r_reportrNcs8 v4&$1I# OPVYY LL7SIrc$V^8dQhRRRRRR/#)r)contract&MethodContract | ServerRequestContractrr+r,ztuple[dict | None, str | None]r)r.s"rr/r/is#DdWurc VPPV4VR3# \dpTP4FypTP R4R8XgKRP RTP RR 444;'gRpRRTP R T R TP R 4 R 23uuRp?# Rp?TR3#Rp?ii;i) uReject UNKNOWN keys (``4000`` with the key path) — the one check no handler performs, and the one that catches a renamed or misspelled field on either side. Required / type errors are left to the handler, which owns its documented domain codes (``4006`` missing session_id, ``4015`` bad url, …) and which clients already branch on; ``check_params_accepted`` closes the loop by flagging a handler that SUCCEEDS on params the contract calls invalid.typeextra_forbidden.c38"TFp\V4xK R#5ir7r .0ps& r "validate_params..tsB/A!s1vv/AlocrNzinvalid params for z: msguq — the client and the Hermes backend are out of sync (different versions); run `hermes update` and restart bothr)rmodel_validatererrorsgetjoinr )rPrrHerrr^s&& rvalidate_paramsreis 2&&v. 4< 2::.s<);AQ);r]r^rN)rTrhr)rr`rrar r$rbrc)rPrrHrds&& rcanonical_param_problemsrk{sM&&v. I MUXT^T^T`MT`S4.B>.B>6B>=C C Cc$V^8dQhRRRRRR/#)r)rPrQrr+r,r-r)r.s"rr/r/s$::$J:TX:]a:rcVPPV4R# \d#p\RTPT4Rp?R#Rp?ii;i)zThe handler answered with a result: the params it accepted must be valid under the contract, else the contract is narrower than the wire (a required field that is optional in practice, a type the handler coerces). Same strict/error-log policy as results.zparams accepted byN)rr`rrNr )rPrrHs&& rcheck_params_acceptedrns=:&&v. :$hmmS99: A AA c$V^8dQhRRRRRR/#)r)rPrQrr+r,r-r)r.s"rr/r/s#11A141TX1rcVPPV4R# \d#p\RTPT4Rp?R#Rp?ii;i)z result ofN)rr`rrNr )rPrrHs&& r check_resultrrs<1&&v. 1 X]]C001roc$V^8dQhRRRRRR/#)r)r r r#z dict | Noner,r-r)r.s"rr/r/s! ) ) )k )d )rc.\PV4pVfR#VPf!V'd\RV\ V44R#VPP T;'g/4R# \ dp\RY4Rp?R#Rp?ii;i)Nz payload of)r'rbr#rN_no_payload_errorr`r)r r#rPrHs&& r check_payloadrvs{zz$H   L$(9'(B C)'' 26 ) d(()s A2)A22 B= BBc(V^8dQhRRRRRRRR/#)r)methodszdict[str, object]emitted_eventszset[str]server_requestsr,r-r)r.s"rr/r/s1dd.dd[cdhldrcD.p\\V4\\4, 4;p'dVPRV 24\\\4\V4, 4;p'dVPRV 24\V\\4, 4;p'dVPRV 24\\\4V, 4;p'dVPRV 24\V\\ 4, 4;p'dVPRV 24\\\ 4V, 4;p'dVPRV 24V'd"\ RRPV4,4hR #) zEvery registered method / emitted event name / sent server request has a contract, and no contract is orphaned. Raises with the full lists.zmethods without a contract: z"method contracts with no handler: zevents without a contract: zevent contracts nothing emits: z$server requests without a contract: z(server request contracts nothing sends: z'tui_gateway/contracts is incomplete: z N)sortedsetr$appendr'r&rErc)rxryrzproblemsrhorphans&&& rassert_completersDHWG 455w56wi@AG s7|344v4wiHIO,>??v?B6(KL JV[[YaMb bccrc V^8dQhRRRR/#)r)r#r+r,rr)r.s"rr/r/s((t((rc!RR\4pVPV4\R4h \d pTuRp?#Rp?ii;i)c]tRt^tRtR#)!_no_payload_error.._EmptyrN)rrrrrrrr_Emptyrs rrN unreachable)rr`rAssertionError)r#rrHs& rrurusE  g&  ''  s- A?AAr7),__conditional_annotations__r __future__rloggingos dataclassesrpydanticrbaserrr getLoggerrrLr rr!r$rr%r&r'r3r9r<r?rBboolenvironrbrKrrErNrerkrnrrrvrru)rs@rrsL# !$))   8 $ $ $ $ &( "'02,14616#% %PR Z\ XZ  bjjnn45 6YYJ $ :1 ) d((r