Backplane.AgentRuntime.Codex.Dynamic (backplane_agent_runtime v1.10.6)

Copy Markdown

Host-mediated dynamic Codex catalog.

Discovery is deliberately separate from publication. A discovered MCP, connector, or host definition is only descriptive until the host publishes it through the strict runtime catalog.

Summary

Types

t()

Functions

call(state, snapshot, owner, name, arguments)

Calls a published tool only when its snapshot and owner are still current.

complete_plugin(state, owner, result)
discover(state, owner, candidates, opts \\ [])

Records host-authorized candidates without granting execution authority.

new(opts \\ [])
publish(state, owner, name, authority \\ %{})

Publishes one discovered definition through strict schema/authority admission.

request_plugin(state, owner, request)

Records a host-mediated plugin request; completion never grants tools.

revoke(state, owner, name)

Revokes a published definition and fences all older snapshots.

search(state, owner, query \\ "", opts \\ [])

Searches only candidates owned by the requesting host and never publishes them.

snapshot(state, owner, opts \\ [])

Creates an immutable view of currently published tools for one owner.

Types

t()

@type t() :: %Backplane.AgentRuntime.Codex.Dynamic{
  entries: term(),
  max_results: term(),
  receipts: term(),
  revision: term(),
  snapshots: term()
}

Functions

call(state, snapshot, owner, name, arguments)

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

Calls a published tool only when its snapshot and owner are still current.

complete_plugin(state, owner, result)

@spec complete_plugin(t(), term(), map()) ::
  {:ok, t(), map()} | {:error, Backplane.AgentRuntime.Error.t()}

discover(state, owner, candidates, opts \\ [])

@spec discover(t(), term(), [map()], keyword()) ::
  {:ok, t(), [map()]} | {:error, Backplane.AgentRuntime.Error.t()}

Records host-authorized candidates without granting execution authority.

new(opts \\ [])

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

publish(state, owner, name, authority \\ %{})

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

Publishes one discovered definition through strict schema/authority admission.

request_plugin(state, owner, request)

@spec request_plugin(t(), term(), map()) ::
  {:ok, t(), map()} | {:error, Backplane.AgentRuntime.Error.t()}

Records a host-mediated plugin request; completion never grants tools.

revoke(state, owner, name)

@spec revoke(t(), term(), String.t()) ::
  {:ok, t()} | {:error, Backplane.AgentRuntime.Error.t()}

Revokes a published definition and fences all older snapshots.

search(state, owner, query \\ "", opts \\ [])

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

Searches only candidates owned by the requesting host and never publishes them.

snapshot(state, owner, opts \\ [])

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

Creates an immutable view of currently published tools for one owner.