yj-UdZddlmZddlZddlZddlZddlZddlmZm Z m Z ddl Z ddl m Z ddlmZejeZiZded<ejZd Zd Zd ZddZddZddZGdde ZdS)uBrowser Use cloud browser provider — plugin form. Subclasses :class:`agent.browser_provider.BrowserProvider` (the plugin-facing ABC introduced in PR #25214). The legacy in-tree module ``tools.browser_providers.browser_use`` was removed in the same PR; this file is now the canonical implementation. Browser Use is the only browser backend with dual auth: a direct ``BROWSER_USE_API_KEY`` for self-billed users, or the managed Nous tool gateway (which Hermes uses to bill Browser Use sessions to a Nous subscription). The dispatch order — direct API key first, managed gateway second — preserves the pre-migration behaviour in ``tools.browser_providers.browser_use.BrowserUseProvider._get_config_or_none``. Config keys this provider responds to:: browser: cloud_provider: "browser-use" # explicit selection tool_gateway: browser: "gateway" # optional: prefer managed gateway # even when BROWSER_USE_API_KEY is set Auth env vars (one of):: BROWSER_USE_API_KEY=... # https://browser-use.com # OR a managed Nous gateway entry (configured via 'hermes setup') ) annotationsN)AnyDictOptional)BrowserProvider) get_secretDict[str, str]_pending_create_keysz"https://api.browser-use.com/api/v3ustask_idstrreturnct5t|}|r|cdddSdtjj}|t|<|cdddS#1swxYwYdS)Nzbrowser-use-session-create:)_pending_create_keys_lockr getuuiduuid4hex)r existingcreateds J/home/ragecks/.hermes/hermes-agent/plugins/browser/browser_use/provider.py!_get_or_create_pending_create_keyr8s "'++G44   C 0@BB(/W%sA&&A&&A*-A*Nonec|t5t|dddddS#1swxYwYdS)N)rr pop)r s r_clear_pending_create_keyrCs "00  $///000000000000000000s 155responserequests.Responseboolc~|jdkrdS|jdkrdS |}n#t$rYdSwxYwt|tsdS|d}t|tsdSt |dpd}d|vS) uDecide whether to keep the idempotency key after a failed create. Preserve the key when the failure looks retryable (5xx) OR when the gateway reports the original request is still in flight (409 "already in progress") — in either case, retrying with the same key lets the gateway deduplicate. Drop the key on any other 4xx (auth failure, bad request, etc.) — those won't succeed by being retried. iTiFerrormessagezalready in progress) status_codejson Exception isinstancedictrrlower)rpayloadr"r#s r#_should_preserve_pending_create_keyr,Hss""ts""u--// uu gt $ $u KK E eT " "u%))I&&,"--3355G G ++s 1 ??ceZdZdZeddZeddZddZdd dd ZddZ ddZ d dZ d!dZ d"dZ ddZdS)#BrowserUseBrowserProvideranBrowser Use (https://browser-use.com) cloud browser backend. Dual auth: prefers a direct BROWSER_USE_API_KEY when set, falling back to the managed Nous tool gateway when ``tool_gateway.browser`` config routes through it. Setting ``tool_gateway.browser: gateway`` flips the order so managed billing wins even when BROWSER_USE_API_KEY is present. rrcdS)N browser-useselfs rnamezBrowserUseBrowserProvider.namer}cdS)N Browser User1r2s r display_namez&BrowserUseBrowserProvider.display_namevr5r6r c2|dduS)NF refresh_token)_get_config_or_noner2s r is_availablez&BrowserUseBrowserProvider.is_availablezs''e'<>>>>233  ??955 "% % /. !.J4J    ?4..55c::    r6Dict[str, Any]cxddlm}|}|d}|rd}t||S)Nr)managed_nous_tools_enabledz=Browser Use requires a direct BROWSER_USE_API_KEY credential.zsBrowser Use requires either a direct BROWSER_USE_API_KEY credential or a managed Browser Use gateway configuration.)rLrTr= ValueError)r3rTconfigr#s r _get_configz%BrowserUseBrowserProvider._get_configseIIIIII))++ >O *)++ QW%% % r6rVr cd|ddS)Nzapplication/jsonrF)z Content-TypezX-Browser-Use-API-Keyr1)r3rVs r_headersz"BrowserUseBrowserProvider._headerss.%+I%6   r6r Dict[str, object]c|}t|d}||}|rt ||d<|rt t dni} tj|dd||d}n-#tj $r}|rtd||d}~wwxYw|j s?|rt|st|td |jd |j|}|rt|d |d t#jjdd } |r|jdnd} t*d| |dp|dpd} | |d| |dddi| dS)NrHzX-Idempotency-Key)timeoutproxyCountryCoderGz /browsersheadersr&r\z#Browser Use API connection failed: z&Failed to create Browser Use session:  hermes__zx-external-call-idzCreated Browser Use session %scdpUrl connectUrlr$id timeoutAt browser_useT) session_name bb_session_idcdp_url expires_atfeaturesexternal_call_id)rWr rrYr _DEFAULT_MANAGED_TIMEOUT_MINUTES#_DEFAULT_MANAGED_PROXY_COUNTRY_CODErequestspostRequestException RuntimeErrorokr,rr%textr&rrrr`loggerinfo) r3r rVrHr`r+rexc session_datarjrorls rcreate_sessionz(BrowserUseBrowserProvider.create_sessionsb!!##FJJ~6677 --''  V+LW+U+UG' (  ;$G      }*%000 HH (    ;c;;   {  3$G$Q$Q 3)'222:'::*2-::   }}  / %g . . .AAA4:<<+;BQB+?AA :F PH  !5 6 6 6D   4lCCC""8,,T 0@0@0N0NTRT))$/'**;77&- 0   s4!BC%B;;C session_idc |}n,#t$rtd|YdSwxYw t j|dd|||ddid}|jd vrtd |d Std ||j|j dd dS#t$r'}t d||Yd}~dSd}~wwxYw)Nu;Cannot close Browser Use session %s — missing credentialsFrG /browsers/actionstop r_>z*Successfully closed Browser Use session %sTz4Failed to close Browser Use session %s: HTTP %s - %srz,Exception closing Browser Use session %s: %s) rWrUrxwarningrrpatchrYr%debugrwr'r")r3r}rVres r close_sessionz'BrowserUseBrowserProvider.close_sessionsI %%''FF    NNMz   55    ~*%==== f--' H #66 I:VVVtJ(M$3$'  u    LLGUV W W W55555 s-%AAAC"/C DC??DrcF|}|td|dS tj|dd|||ddiddS#t $r'}td||Yd}~dSd}~wwxYw) NuGCannot emergency-cleanup Browser Use session %s — missing credentialsrGrrrr r_z7Emergency cleanup failed for Browser Use session %s: %s)r=rxrrrrrYr'r)r3r}rVrs remergency_cleanupz+BrowserUseBrowserProvider.emergency_cleanup!s))++ > NNY    F  N*%==== f--'            LLI:WX          s8A// B 9BB cdddddddgdd S) Nr8paidz#Cloud browser with remote executionrDzBrowser Use API keyzhttps://browser-use.com)keyprompturl browserbase)r4badgetagenv_vars post_setupr1r2s rget_setup_schemaz*BrowserUseBrowserProvider.get_setup_schema5s9!8134(   r6N)rr)rr )r<r rr?)rrR)rVrRrr )r rrrZ)r}rrr )r}rrr)__name__ __module__ __qualname____doc__propertyr4r9r>r=rWrYr|rrrr1r6rr.r.isXXIIII<@       D(    C C C C J>(      r6r.)r rrr)r rrr)rrrr )r __future__rloggingos threadingrtypingrrrrragent.browser_providerragent.secret_scoper getLoggerrrxr __annotations__LockrrMrprqrrr,r.r1r6rrs\8#"""""  &&&&&&&&&&222222))))))  8 $ $ (*))))*IN,, 0 #$ &*#0000 ,,,,B[ [ [ [ [ [ [ [ [ [ r6