Backplane.AgentRuntime.Codex.DynamicRuntime (backplane_agent_runtime v1.10.53)

Copy Markdown

Host-mediated MCP resources, deferred tool publication, and plugin requests.

Summary

Functions

Returns a specification to start this module under a supervisor.

Runs one real caller-owned Events page under native lifecycle ownership.

Returns retained exact plugin-wait retirement evidence, or unknown_outcome.

Observe an already acknowledged immutable host request in the actual effect caller.

Runs one caller-owned MCP resource request with cooperative local cancellation.

Runs explicit sequential MCP requests under one admitted invocation.

Functions

call(operation)

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

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

contracts(arg1)

@spec contracts(map()) :: [map()]

event_request(operation, starter)

Runs one real caller-owned Events page under native lifecycle ownership.

The starter receives reserved tracking/deadline options and must return the actual EventRequest. Full local retirement precedes the unchanged MCP result; responsibility remains registered until the result Store acknowledgement.

plugin_install_retirement(runtime, exact_identity)

Returns retained exact plugin-wait retirement evidence, or unknown_outcome.

plugin_install_wait(operation, host_request_ref, wait_fn)

Observe an already acknowledged immutable host request in the actual effect caller.

The callback may only wait for that request. It must not install, dispatch MCP, or start untracked work. Registration precedes the callback; cancellation seals completion and observes the registered caller's termination, not remote rollback.

resource_request(scope, starter)

Runs one caller-owned MCP resource request with cooperative local cancellation.

The starter must only start that resource request in the calling process. It returns the public MCP result for the adapter's usual result/error conversion. Additional untracked adapter effects cannot be confirmed by this helper.

resource_request_scope(operation, callback)

Runs explicit sequential MCP requests under one admitted invocation.

The callback may only perform scoped resource requests and pure result aggregation. Each one-argument starter must preserve the supplied reserved options and return its real caller-owned MCP handle. Untracked effects cannot be confirmed by the scope. The callback's ordinary value is preserved.

start_link(opts \\ [])

@spec start_link(keyword()) :: GenServer.on_start()