Package com.tnsai.quality.sandbox

Interface SandboxExecutionListener

All Known Implementing Classes:

RecordingSandboxExecutionListener

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface SandboxExecutionListener

Sink for SandboxExecutionEvents (TNS-296). Implementations forward events to whatever observability backend the operator has — SLF4J, Datadog, OTel span enrichment, an audit Kafka topic, or a Prometheus counter.

Concurrency

Implementations MUST be safe to call from multiple sandbox threads concurrently — sandboxes don't synchronize their event emission with each other.

Failure isolation

Implementations should not throw; the framework wraps every call in a try/catch so observability outages don't break the execution hot path, but a clean implementation never relies on that safety net.

Since:

0.10.0 (TNS-296)

Method Summary

Modifier and Type	Method	Description
static SandboxExecutionListener	noop()	No-op listener — used when observability is disabled.
void	onExecution(SandboxExecutionEvent event)

Method Details

onExecution

void onExecution(SandboxExecutionEvent event)

noop

static SandboxExecutionListener noop()

No-op listener — used when observability is disabled.