Insider.Runtime (Insider v0.1.0)

Copy Markdown View Source

Bounded, read-only access to runtime diagnostics.

Runtime operations return Insider.Protocol.Result values so IEx, Mix tasks, and future adapters share the same limits and outcome vocabulary. The caller supplies the trusted environment; releases must not infer it from an untrusted request.

Summary

Functions

Builds an additive protected-target binding from trusted host startup configuration.

Returns the runtime operations available in the declared environment.

Describes a target using a host-owned protected-target binding.

Types

option()

@type option() ::
  {:environment, :development | :test | :ci}
  | {:provider, module()}
  | {:probe_timeout_ms, pos_integer()}
  | {:cleanup_timeout_ms, pos_integer()}

Functions

bind_host_policy(options)

@spec bind_host_policy(keyword()) ::
  {:ok, Insider.Runtime.HostPolicy.t()} | {:error, :invalid_policy}

Builds an additive protected-target binding from trusted host startup configuration.

capabilities(options)

@spec capabilities([option()]) ::
  Insider.Protocol.Result.t() | {:error, Insider.Protocol.Error.t()}

Returns the runtime operations available in the declared environment.

describe(pid, options, host_policy)

Describes a target using a host-owned protected-target binding.

host_policy must come from trusted host startup configuration via bind_host_policy/1; protocol requests, adapter parameters, and Runtime options cannot replace it. This is a binding primitive, not a session or production-enablement lifecycle.