+ lHj Rt^RIHt^RIt^RIt^RIHtHtHtH t H t ]P!] 4t RRltRRltRR ltR RR RR RR RRR/RRlltRRltR RR RR RR RRR/RRlltR#)uRegistry-level browser extension router. Agent-side half of browser-extension-control: decides, per ``browser_*`` handler invocation, whether an attached extension controller (via :mod:`gateway.browser_control_broker`) or the legacy backend executes it. Routing contract (see ``tests/tools/test_browser_extension_router.py``): - Feature off ⇒ legacy, broker never touched, ``fallback()`` called exactly once. - No server-bound identity ⇒ legacy. - Bound identity ⇒ authoritative extension lane; missing/ambiguous scope, disconnect, or capability mismatch fail closed (never jump to another browser). - Selected controller ⇒ authoritative; its errors propagate, legacy never retried. - ``args`` is never mutated. :func:`routed_browser_handler` resolves the flag and broker lazily on every call so importing this module never pulls in the gateway and config changes apply without restart. ) annotationsN)AnyCallableDictOptionalTuplecV^8dQhRR/#)returnz2tuple[Optional[str], Optional[str], Optional[str]])formats"C/home/ubuntu/.hermes/hermes-agent/tools/browser_extension_router.py __annotate__rsKcta^RIHo\;QJd.V3RlR4FNK 5#!V3RlR44#)zF(session_id, principal_id, transport_family) from the session context.get_session_envc3J<"TFpS!VR4;'gRxK R#5i)Nr ).0keyrs& r "_bound_identity..!s.?C R ((D(?s# #)HERMES_SESSION_ID HERMES_BROWSER_CONTROL_PRINCIPAL'HERMES_BROWSER_CONTROL_TRANSPORT_FAMILY)gateway.session_contextrtuplers@r _bound_identityrs<7 5?55? rc V^8dQhRRRR/#)r messagestrr Exceptionr )r s"r rr(s**S*Y*rc^RIHpV!V4#))ControllerUnavailable)gateway.browser_control_brokerr%)r r%s& r _controller_unavailabler'(sD  ))rc V^8dQhRRRR/#)r actionr!r boolr )r s"r rr.s34rc:^RIHpHpV!4'gR#\4;wr4rV\ V4'gR#V!4pVP W4VR7pVRJ;'dVP W4RJ# \d\PRTRR7R#i;i)zWhether this request owns one exact controller capable of ``action``. Runs during tool-schema assembly inside the request's session context; consults the process-local broker directly and fails closed on any gap.browser_control_enabledget_browser_control_brokerF) session_id principal_idtransport_familyNz2browser extension availability check failed for %sT)exc_info) r&r-r.rallscope_for_sessionselectr"loggerdebug) r)r-r.r/r0r1identitybrokerscopes & r extension_controller_availabler;.s f&((@O@QQ2 "28}}+-((Jl|(}D MMV]]5%A%MM  I6\` as!A3A3$A3A33#BBr/task_idr0r1 tool_call_idrcDV^8dQhRRRRRRRRR R R R R R RR RR RR RR/ #)r r)r!argsdict[str, Any]fallbackCallable[[], Any]r9renabledr*r/ Optional[str]r<r0r1r=r r )r s"r rrBsx!Y!Y !Y%!Y4E!YOR!Y]a!Y!Y/<!YS`!Y$!Y;H!Y !YrcTV'dS\T;'gR4P4'd*\T;'gR4P4'gV!4#\WVWxR7p VP!R /V Bp V fB\ VRR4p \ V 4'dV !R /V B'gV!4#\ RV 24hVPW4f\ RV 24hVPWWR7p \V \4'dV #\P!V RR 7#) agRoute one browser action through the extension-control broker. ``broker`` exposes ``scope_for_session(**identity)``, ``select(scope, cap)`` and ``dispatch(scope, *, action, arguments, tool_call_id)``. ``fallback`` is called exactly once when the feature is off or no server-bound identity exists; once a controller is selected its result/exception is final. r)r/r<r0r1Nlane_registeredz)bound browser controller unavailable for z(bound browser controller cannot execute )r) argumentsr=F) ensure_asciir ) r!stripdictr4getattrcallabler'r5dispatch isinstancejsondumps)r)r?rAr9rCr/r<r0r1r=r8r: lane_boundresults&&$$$$$$$$ r route_browser_toolrSBs  #l00b17799EUE[E[Y[A\AbAbAdAdzzyH  $ $ 0x 0E }V%6= J   (>X(>(>: %(QRXQY&Z[[ }}U#+%(PQWPX&YZZ __UT_ ]F,,6X$**VRW2XXrcV^8dQhRR/#)r r r!r )r s"r rrfscrch^RIHpVP4;'gR# \dR#i;i)zEActive tool_call_id bound by the agent executor, or ``""`` when none._approval_tool_call_idr)tools.approval_contextrWgetr"rVs r current_tool_call_idrZfs3A%))+11r1 s"" 11c<V^8dQhRRRRRRRRR RR RR RR RR R/ #)r r)r!r?r@rArBr<rDr/r0r1r=r rr )r s"r rrps[ %4EP]4A$;H rc ~^RIHpHp T!4'gT!4#\ 4wrp \YY)!4RT;'gT Y5;'gT T;'gT Tf\4R7 #TR7 # \d(p \P RT 4T!4uRp ? #Rp ? ii;i \d R;p ;rLi;i)uLazy registry-handler route wrapper for ``browser_*`` tools. Feature off (or gateway unimportable) ⇒ the legacy handler runs unchanged.r,z?browser extension router unavailable (%s); using legacy backendNT)rAr9rCr/r<r0r1r=) r&r-r.r"r6r7rrSrZ)r)r?rAr<r/r0r1r=r-r.exc env_session env_principal env_transports&&$$$$$$ r routed_browser_handlerrapsf # $ $z;4C4E1 M x0J0LVZ,,gLiLi\i)::]/;/C)+  JV    VX[\z ;6:: :mm;s.A4 B)4 B&?B!B&!B&)B<;B<)__doc__ __future__rrOloggingtypingrrrrr getLogger__name__r6rr'r;rSrZrar rr rhs&# 77   8 $* (!Y $!Y?C!Ycg!Y'+!YKM!YH`d $DH'+KOr