Interface AdapterReferenceSession

public interface AdapterReferenceSession
Runner-owned recorder for adapter TCK reference-operation effects.

A session is created and owned by the TCK runner for one scenario verification. Probe implementations receive the session only while executing AdapterSemanticProbe.runReferenceOperations(AdapterTckScenario, java.util.List, AdapterReferenceSession). A probe must record each observable operation effect through this session in the same order as the supplied operations. Returning a fabricated AdapterReferenceOutcome without recording the corresponding effect is rejected by the runner.

Implementations supplied by the runner are thread-safe for the duration of a scenario, bounded by the runner execution policy, and retain only redacted, deterministic evidence. The session does not expose vendor SDK types, external service handles, credentials, raw payloads, or endpoint details.

  • Method Details

    • recordEffect

      AdapterReferenceOutcome recordEffect(AdapterReferenceOperation operation, String observedValue)
      Records an observable effect for a reference operation.
      Parameters:
      operation - reference operation that produced the effect
      observedValue - safe deterministic value observed after executing the operation
      Returns:
      safe reference outcome to return from the probe
      Throws:
      IllegalArgumentException - if the operation or observed value is invalid