# Insider v0.1.0 - API Reference

## Modules

- Facade
  - [Insider](Insider.md): Runtime evidence and assurance for the BEAM.
  - [Insider.Runtime](Insider.Runtime.md): Bounded, read-only access to runtime diagnostics.
  - [Insider.Runtime.HostPolicy](Insider.Runtime.HostPolicy.md): A trusted host bootstrap binding for Runtime protected targets.

- Live
  - [Insider.Live](Insider.Live.md): Transport-agnostic live observation of the node it runs in.
  - [Insider.Live.JSON](Insider.Live.JSON.md): `Insider.Live` operations that each return one canonical JSON binary.

- Protocol
  - [Insider.Protocol](Insider.Protocol.md): Versioned request and effect-honest result constructors.
  - [Insider.Protocol.Budget](Insider.Protocol.Budget.md): Hard operation limits negotiated below library-owned ceilings.

  - [Insider.Protocol.Effect](Insider.Protocol.Effect.md): An observed runtime effect, including incomplete or uncertain effects.

  - [Insider.Protocol.Error](Insider.Protocol.Error.md): A typed protocol failure containing bounded, non-secret metadata.

  - [Insider.Protocol.Request](Insider.Protocol.Request.md): A versioned, bounded request accepted by the Insider runtime.

  - [Insider.Protocol.Result](Insider.Protocol.Result.md): A typed outcome that keeps values, failures, effects, streams, and cleanup separate.

- Policy
  - [Insider.Policy](Insider.Policy.md): Pure capability discovery and deny-by-default runtime authorization.
  - [Insider.Policy.Context](Insider.Policy.Context.md): Trusted runtime facts supplied outside the untrusted request envelope.

  - [Insider.Policy.Decision](Insider.Policy.Decision.md): A bounded, auditable policy outcome. It intentionally excludes capability references.

  - [Insider.Policy.Grant](Insider.Policy.Grant.md): A pre-verified authorization grant. Cryptographic verification is deliberately external.

  - [Insider.Policy.ProtectedTargets](Insider.Policy.ProtectedTargets.md): Immutable host-owned classification for targets that Insider must not inspect.

- Collector
  - [Insider.Collector.Calls](Insider.Collector.Calls.md): Bounded call tracing of selected functions as `call`, `call.return`,
`call.exception`, and `call.stopped` events.
  - [Insider.Collector.IngressProfile](Insider.Collector.IngressProfile.md): Host-owned ingress defaults for collector sessions.
  - [Insider.Collector.Logger](Insider.Collector.Logger.md): Supervised, bounded ingestion of structured OTP Logger events.
  - [Insider.Collector.Otel](Insider.Collector.Otel.md): Bounded capture of finished OpenTelemetry spans as `otel.span` events.
  - [Insider.Collector.Poller](Insider.Collector.Poller.md): Periodically records bounded scalar VM and explicitly targeted process samples.
  - [Insider.Collector.Session](Insider.Collector.Session.md): Host-owned, opt-in composition of bounded development/test/CI collectors.
  - [Insider.Collector.Session.Handle](Insider.Collector.Session.Handle.md): Opaque local capability for one host-owned collector session incarnation.
  - [Insider.Collector.SystemMonitor](Insider.Collector.SystemMonitor.md): Supervised, bounded collection of selected ERTS system anomalies.
  - [Insider.Collector.SystemMonitor.Policy](Insider.Collector.SystemMonitor.Policy.md): Bounded, pure-data policy for ERTS system-event collection.
  - [Insider.Collector.Telemetry](Insider.Collector.Telemetry.md): Bounded, allowlist-only ingestion of `:telemetry` events.
  - [Insider.Collector.Telemetry.Policy](Insider.Collector.Telemetry.Policy.md): Validated pure-data allowlist for Telemetry collection.

- Recorder
  - [Insider.Recorder](Insider.Recorder.md): A bounded, non-mailbox flight recorder for normalized events.
  - [Insider.Recorder.Classification](Insider.Recorder.Classification.md): Trusted, bounded sensitivity metadata bound to one exact recorded Event.
  - [Insider.Recorder.Classification.Binding](Insider.Recorder.Classification.Binding.md): The recorder-wide sensitivity and redaction-policy binding that
`Insider.Recorder.start_link/1` validates from its `classification:` option.
Every recorded entry's `Insider.Recorder.Classification` is derived from it.

  - [Insider.Recorder.Config](Insider.Recorder.Config.md): Validated recorder configuration derived from `Insider.Recorder.start_link/1`
options: event, byte, trigger-window, rate-limit, admission-stall, and
source-share bounds plus the trusted classification binding. Hosts do not
construct it directly.
  - [Insider.Recorder.Handle](Insider.Recorder.Handle.md): Producer-side capability for one recorder, obtained once with
`Insider.Recorder.handle/1`.
  - [Insider.Recorder.Snapshot](Insider.Recorder.Snapshot.md): Immutable, bounded view of a sealed recorder window.

- Detectors
  - [Insider.Detectors.MailboxGrowth](Insider.Detectors.MailboxGrowth.md): Detects sustained mailbox growth with no observed reductions progress.
  - [Insider.Detectors.MailboxGrowth.Error](Insider.Detectors.MailboxGrowth.Error.md): A bounded explanation of why a sample could not be evaluated.
  - [Insider.Detectors.MailboxGrowth.State](Insider.Detectors.MailboxGrowth.State.md): Opaque reducer state created by `Insider.Detectors.MailboxGrowth.new/1`.
  - [Insider.Detectors.RestartRecurrence](Insider.Detectors.RestartRecurrence.md): Detects repeated abnormal supervisor child terminations without owning a process.
  - [Insider.Detectors.RestartRecurrence.Error](Insider.Detectors.RestartRecurrence.Error.md): A bounded explanation of why a target event could not be evaluated.
  - [Insider.Detectors.RestartRecurrence.State](Insider.Detectors.RestartRecurrence.State.md): Opaque reducer state created by `Insider.Detectors.RestartRecurrence.new/1`.
  - [Insider.Finding](Insider.Finding.md): A bounded detector-neutral finding with statically validated details.

- Events and identity
  - [Insider.Event](Insider.Event.md): Versioned, bounded, portable evidence shared by collectors and detectors.
  - [Insider.Event.Ordering](Insider.Event.Ordering.md): Ordering rules for immutable normalized events.
  - [Insider.Identity](Insider.Identity.md): Same-node correlation for explicitly declared process identities.
  - [Insider.Identity.Generation](Insider.Identity.Generation.md): Immutable evidence for one declared process incarnation.
  - [Insider.Identity.Subject](Insider.Identity.Subject.md): Portable, application-declared diagnostic identity.
  - [Insider.Provenance](Insider.Provenance.md): Bounded, portable provenance for incident evidence.

- Incident
  - [Insider.Incident.ArtifactReference](Insider.Incident.ArtifactReference.md): A bounded content-addressed reference to evidence kept outside a capsule.
  - [Insider.Incident.Capsule](Insider.Incident.Capsule.md): A bounded, redacted, content-addressed incident artifact that validates offline.
  - [Insider.Incident.ExportPolicy](Insider.Incident.ExportPolicy.md): Trusted capsule-export classification paired with a redaction policy.

- Redaction
  - [Insider.Redaction](Insider.Redaction.md): Fail-closed sanitization of untrusted BEAM terms into bounded Event-compatible values.
  - [Insider.Redaction.Credentials](Insider.Redaction.Credentials.md): Credential masking for values that leave the node.
  - [Insider.Redaction.Outcome](Insider.Redaction.Outcome.md): A fully sanitized value and its deterministic disclosure manifest.
  - [Insider.Redaction.Policy](Insider.Redaction.Policy.md): A bounded, callback-free redaction policy selected by trusted runtime code.

- Observability
  - [Insider.Observability.Datadog](Insider.Observability.Datadog.md): Pure mapping to a mock Datadog Events v2 request body.
  - [Insider.Observability.Export](Insider.Observability.Export.md): A bounded, vendor-neutral projection of a validated incident capsule.
  - [Insider.Observability.MockEvent](Insider.Observability.MockEvent.md): A canonical, provider-shaped mock event derived from an observability export.
  - [Insider.Observability.MockHostClient](Insider.Observability.MockHostClient.md): Contract for a host-owned asynchronous handoff of inert mock events.
  - [Insider.Observability.Sentry](Insider.Observability.Sentry.md): Pure mapping to a mock Sentry event payload.
  - [Insider.Observability.Trigger](Insider.Observability.Trigger.md): A bounded, vendor-neutral request for local incident handling.

