Package ai.vectros.types

Class TruncationWarningEvent.Builder

java.lang.Object

ai.vectros.types.TruncationWarningEvent.Builder

All Implemented Interfaces:

TruncationWarningEvent._FinalStage, TruncationWarningEvent.EventStage, TruncationWarningEvent.NoContentCountStage, TruncationWarningEvent.ReasonStage, TruncationWarningEvent.ResultsRequestedStage, TruncationWarningEvent.ResultsUsedStage, TruncationWarningEvent.TruncatedCountStage

Enclosing class:

TruncationWarningEvent

public static final class TruncationWarningEvent.Builder
extends Object
implements TruncationWarningEvent.EventStage, TruncationWarningEvent.ResultsRequestedStage, TruncationWarningEvent.ResultsUsedStage, TruncationWarningEvent.TruncatedCountStage, TruncationWarningEvent.NoContentCountStage, TruncationWarningEvent.ReasonStage, TruncationWarningEvent._FinalStage

Method Summary

Modifier and Type	Method	Description
TruncationWarningEvent.Builder	additionalProperties(Map<String,Object> additionalProperties)
TruncationWarningEvent.Builder	additionalProperty(String key, Object value)
TruncationWarningEvent	build()
TruncationWarningEvent.ResultsRequestedStage	event(@NotNull TruncationWarningEventEvent event)	Backward-compatible alias of type.
TruncationWarningEvent.Builder	from(TruncationWarningEvent other)
TruncationWarningEvent.ReasonStage	noContentCount(int noContentCount)	How many of the dropped results had no groundable text to include at all, independent of budget. 0 if none were.
TruncationWarningEvent._FinalStage	reason(@NotNull TruncationWarningEventReason reason)	A single human-readable summary of why results were dropped: context_window_budget (only the budget reason applied), no_groundable_content (only the no-content reason applied), or context_window_budget_and_no_content (both applied).
TruncationWarningEvent.ResultsUsedStage	resultsRequested(int resultsRequested)	The number of results retrieved before any were dropped.
TruncationWarningEvent.TruncatedCountStage	resultsUsed(int resultsUsed)	The number of results actually included in the prompt — resultsRequested minus truncatedCount minus noContentCount.
TruncationWarningEvent.NoContentCountStage	truncatedCount(int truncatedCount)	How many of the dropped results were cut for context-window budget reasons (lower-scoring overflow). 0 if none were.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

from

public TruncationWarningEvent.Builder from(TruncationWarningEvent other)

Specified by:

from in interface TruncationWarningEvent.EventStage

event

public TruncationWarningEvent.ResultsRequestedStage event(@NotNull
 @NotNull TruncationWarningEventEvent event)

Backward-compatible alias of type. Always truncation_warning.

Backward-compatible alias of type. Always truncation_warning.

Specified by:

event in interface TruncationWarningEvent.EventStage

Returns:

Reference to this so that method calls can be chained together.

resultsRequested

public TruncationWarningEvent.ResultsUsedStage resultsRequested(int resultsRequested)

The number of results retrieved before any were dropped.

The number of results retrieved before any were dropped.

Specified by:

resultsRequested in interface TruncationWarningEvent.ResultsRequestedStage

Returns:

Reference to this so that method calls can be chained together.

resultsUsed

public TruncationWarningEvent.TruncatedCountStage resultsUsed(int resultsUsed)

The number of results actually included in the prompt — resultsRequested minus truncatedCount minus noContentCount.

The number of results actually included in the prompt — resultsRequested minus truncatedCount minus noContentCount.

Specified by:

resultsUsed in interface TruncationWarningEvent.ResultsUsedStage

Returns:

Reference to this so that method calls can be chained together.

truncatedCount

public TruncationWarningEvent.NoContentCountStage truncatedCount(int truncatedCount)

How many of the dropped results were cut for context-window budget reasons (lower-scoring overflow). 0 if none were.

How many of the dropped results were cut for context-window budget reasons (lower-scoring overflow). 0 if none were.

Specified by:

truncatedCount in interface TruncationWarningEvent.TruncatedCountStage

Returns:

Reference to this so that method calls can be chained together.

noContentCount

public TruncationWarningEvent.ReasonStage noContentCount(int noContentCount)

How many of the dropped results had no groundable text to include at all, independent of budget. 0 if none were.

How many of the dropped results had no groundable text to include at all, independent of budget. 0 if none were.

Specified by:

noContentCount in interface TruncationWarningEvent.NoContentCountStage

Returns:

Reference to this so that method calls can be chained together.

reason

public TruncationWarningEvent._FinalStage reason(@NotNull
 @NotNull TruncationWarningEventReason reason)

A single human-readable summary of why results were dropped: context_window_budget (only the budget reason applied), no_groundable_content (only the no-content reason applied), or context_window_budget_and_no_content (both applied). A caller wanting exact attribution should read truncatedCount/noContentCount directly rather than parse this field.

A single human-readable summary of why results were dropped: context_window_budget (only the budget reason applied), no_groundable_content (only the no-content reason applied), or context_window_budget_and_no_content (both applied). A caller wanting exact attribution should read truncatedCount/noContentCount directly rather than parse this field.

Specified by:

reason in interface TruncationWarningEvent.ReasonStage

Returns:

Reference to this so that method calls can be chained together.

build

public TruncationWarningEvent build()

Specified by:

build in interface TruncationWarningEvent._FinalStage

additionalProperty

public TruncationWarningEvent.Builder additionalProperty(String key,
 Object value)

Specified by:

additionalProperty in interface TruncationWarningEvent._FinalStage

additionalProperties

public TruncationWarningEvent.Builder additionalProperties(Map<String,Object> additionalProperties)

Specified by:

additionalProperties in interface TruncationWarningEvent._FinalStage