Backplane.AgentRuntime.Codex.MultiAgent (backplane_agent_runtime v1.10.34)

Copy Markdown

Supervised Codex V1/V2 collaboration runtime.

The process owns only collaboration state and waiters. Child work is executed by real Conversation processes under a DynamicSupervisor.

Summary

Functions

bind_contract(runtime, action, attrs)

@spec bind_contract(pid(), atom(), map()) ::
  {:ok, Backplane.AgentRuntime.Codex.Contract.t()}
  | {:error, Backplane.AgentRuntime.Error.t()}

Binds a normalized host contract to one collaboration action in this manager.

The returned contract does not grant authority. Hosts must explicitly grant its name, revision and collaboration_binding.fingerprint in tool_bindings. Argument/result conversion belongs to its trusted registered backend.

call(operation)

call_bound(operation, canonical_arguments)

@spec call_bound(map(), map()) :: Backplane.AgentRuntime.ToolEffects.result()

Executes an admitted host invocation using its immutable collaboration binding.

The original invocation and arguments remain the effect/refusal identity; canonical_arguments are separately converted by the trusted host adapter.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

close_session(runtime)

close_session(runtime, owner_id, incarnation)

contracts(profile, runtime, opts \\ [])

@spec contracts(:v1 | :v2, pid(), keyword()) :: [map()]

detach_parent(runtime, binding)

rebind_parent(runtime, binding, authority)

resolve_interaction(runtime, correlation, value)

Resolves an observed child interaction after its checkpoint is acknowledged.

Correlation must come from the current manager snapshot or observation stream. An unknown outcome must be reconciled through observation, never retried.

snapshot(runtime)

start_link(opts)

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

subscribe(runtime, observer \\ self())

transfer_ready(runtime)

unsubscribe(runtime, observer \\ self())