ReadonlyCapabilitiesWhat this driver can do. Declared by the class, never read from the database.
ProtectedconfigConfiguration from the metadata record, set during Initialize.
Why this driver is unavailable, for diagnostics. Null when it is available.
Determine whether this driver can serve requests, calling MarkAvailable or MarkUnavailable exactly once.
Must not throw for the ordinary "not configured here" case — see the class note.
Execute a search. Called only when IsAvailable is true.
ProtectedGetRead a non-secret setting from the record's ProviderConfig JSON.
ProtectedGetRead a credential value, preferring the decrypted MJ: Credentials record and falling back
to an environment variable.
The fallback exists because the web search actions this engine supersedes read their keys
from mj.config.cjs / the environment, and a host upgrading should not have to migrate its
secrets into the Credential store on the same day it gains the engine.
key within the credential record's decrypted values, e.g. apiKey
environment variable consulted when no credential value is present
Receive configuration from the provider's metadata record.
The default stores it; override to do additional setup, and call super.Initialize(...).
Whether this driver may participate in searches. False until CheckAvailability says otherwise.
ProtectedMarkMark this driver operational. Call from CheckAvailability.
ProtectedMarkMark this driver unusable, with a reason an administrator can act on.
ProtectedResolveThe effective result cap: the caller's request, bounded by the metadata override (when set) and then by the vendor's own hard cap.
Clamped rather than rejected — a caller asking for 50 wants as many as possible, and most vendors reject the whole request when asked for more than they serve.
StaticGetEnumerate every registered driver with its capabilities, for admin UI dropdowns.
Instantiates each registration to read Capabilities, so a driver's constructor must stay
side-effect free.
Searches the web through the Brave Search API.
Brave is the recommended default for a structural reason rather than a qualitative one: it serves from its own index rather than reselling Google's or Bing's. Every SERP-proxy vendor, and the Google Custom Search JSON API that this engine exists to replace, depends on a search engine continuing to permit that access. Brave does not, so it fails independently of every other driver here — which is the entire point of having a provider set.
Credential key
apiKey; environment fallbackBRAVE_SEARCH_API_KEY.