Skip to content

cayu.tools.exa

Public Cayu API. Definitions are grouped by their public source module, and definitions from private implementation modules appear on their package’s page; adding a symbol does not move existing links. The import shown at each entry is a supported public namespace. Read the Python API overview and install the required extra.

from cayu.tools import ExaWebAdapter

Implement provider-neutral search and known-URL fetch through Exa.

The API key remains an application-owned SecretRef and is resolved through the invocation’s credential proxy immediately before each request.

ExaWebAdapter.__init__(*, api_key_ref: SecretRef, origin: str=DEFAULT_EXA_ORIGIN, auth_header: Literal['x-api-key', 'authorization']='x-api-key', search_type: Literal['instant', 'fast', 'auto', 'deep-lite', 'deep', 'deep-reasoning']=DEFAULT_EXA_SEARCH_TYPE, search_max_age_hours: int | None=None, fetch_max_age_hours: int | None=None, moderation: bool=False, max_provider_response_bytes: int=DEFAULT_EXA_MAX_PROVIDER_RESPONSE_BYTES, transport: httpx.AsyncBaseTransport | None=None) -> None
ExaWebAdapter.webbridge_credential_authority() -> WebBridgeCredentialAuthority

Declare the hosted authority without resolving its secret value.

async ExaWebAdapter.search(ctx: ToolContext, request: WebSearchAdapterRequest) -> ToolResult
async ExaWebAdapter.fetch(ctx: ToolContext, request: WebFetchAdapterRequest) -> ToolResult

Release source · Runtime guarantees · Capability guides