Backplane.AgentRuntime.Codex.Web.ReadableFetch behaviour (backplane_agent_runtime v1.10.65)

Copy Markdown

Explicit revision-2 native readable-fetch adapter boundary.

Hosts implement fetch/2, owning acquisition, per-hop redirect authorization, transfer decoding, extraction and caching. Options include :allowed_hosts, :timeout, :result_limit and, for native calls, reserved :runtime_context containing exact invocation identity and the live :effect_deadline accessor. Hosts must retain the deadline across their work and clean up owned resources.

Results are unchanged plain JSON maps with UTF-8 string keys. Required fields are url (exact input), final_url, text and content_type. Additional portable metadata is retained. Both URLs must be authorized absolute HTTP(S) URLs; hosts also authorize every intermediate redirect. Complete result size is bounded by :erlang.external_size/1. Standalone calls invent no runtime identity.

Summary

Callbacks

fetch(map, keyword)

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

Functions

fetch(adapter, arguments, opts)

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

schema()

@spec schema() :: map()