Backplane.AgentRuntime.Codex.Web (backplane_agent_runtime v1.10.76)

Copy Markdown

Bounded, host-authorized HTTP fetch adapter for Codex service tools.

Summary

Functions

Calls an explicitly selected revision-2 host readable-fetch adapter. See Web.ReadableFetch.

Calls a host search adapter and preserves its bounded success map unchanged.

Uses the same bounded result contract as search/3 for a social search adapter.

Functions

fetch(url, opts \\ [])

@spec fetch(String.t(), keyword()) ::
  {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}

fetch_readable(adapter, arguments, opts \\ [])

@spec fetch_readable(module(), map(), keyword()) ::
  {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}

Calls an explicitly selected revision-2 host readable-fetch adapter. See Web.ReadableFetch.

search(adapter, query, opts \\ [])

@spec search(module(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}

Calls a host search adapter and preserves its bounded success map unchanged.

Besides results lists and answer envelopes, adapters may return a raw envelope with kind: :raw (or "raw"), a nonempty UTF-8 provider, and a plain data map containing JSON values and UTF-8 string keys. Envelope fields accept atom or string keys without duplicate aliases. Raw payload URLs and nested cache metadata are opaque; no outer query, timing, or cache fields are required. result_limit bounds the complete result using :erlang.external_size/1.

x_search(adapter, query, opts \\ [])

@spec x_search(module(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}

Uses the same bounded result contract as search/3 for a social search adapter.