Struct Web 

pub struct Web { /* private fields */ }

A Plugin that gives a run web access: one tool that fetches a page and one that searches the web.

Its id is promptforge/web. promptforge/web/fetch fetches a URL through a hardened HTTP client and returns its content as text, with an HTML page rendered as markdown. promptforge/web/search runs a search through the Host’s SearchProvider.

It needs two services: the search provider registered under the key SEARCH_PROVIDER and the tokio runtime handle registered under the key TOKIO_RUNTIME. A run that requires the Plugin is refused when either service is missing. A run that declares it optional gets the web tools only when both services are present.

Implementations

impl Web

pub fn new() -> Web

Builds the Plugin with the default fetch policy.

The HTTP client is built here, once, and every run’s fetch tool shares it.

Panics

Panics only if the built-in Plugin id promptforge/web fails to parse, or if the HTTP client fails to build for the default policy because the TLS backend failed to initialize. Either would be a defect outside the caller’s control.

pub fn with_fetch_config(self, config: FetchConfig) -> Result<Web, ConfigError>

Replaces the default fetch policy with a validated custom one.

Errors

Returns ConfigError if the HTTP client fails to build for config (for example a TLS backend that fails to initialize).

Trait Implementations

impl Clone for Web

fn clone(&self) -> Web

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Web

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Web

fn default() -> Web

Returns the “default value” for a type.

impl Plugin for Web

fn id(&self) -> &PluginId

Returns the Plugin’s stable identity (namespace/plugin).

fn description(&self) -> &str

Returns a one-sentence description of the Plugin, shown to Hosts.

fn needs(&self) -> &[ServiceId]

Returns the ids of the run services this Plugin needs from [RunServices].

fn create(&self, services: &RunServices) -> Result<Contribution, PluginError>

Activates the Plugin for one run.

fn conflicts(&self) -> &[PluginId]

Returns the Plugins that conflict with this one when declared in the same run.