io.enterpriseai.ContextBudget
Source: sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/ContextBudget.java. Back to the Java SDK reference index.
This page is generated by tools/docs/gen_sdk_reference.py from the SDK sources and the OpenAPI text folders. Do not edit it by hand: change the source and regenerate.
Model ContextBudget
Token budget of one model call: B_context = W_model - B_output - B_reasoning - B_safety (Context Contract v1, field budget).
Fields:
| Name | Type | Required | Description |
|---|---|---|---|
window | int | yes | Context window of the model in tokens (window), zero or more. |
outputReserved | int | yes | Tokens reserved for the output (output_reserved). |
reasoningReserved | int | yes | Tokens reserved for reasoning (reasoning_reserved). |
safetyMargin | int | yes | Safety margin in tokens (safety_margin); of takes 5 percent of the window, at least 256. |
ContextBudget.contextBudget
int contextBudget()
Tokens left for the assembled context; negative when reservations exceed the window.
This element takes no parameter.
Returns: int. window - outputReserved - reasoningReserved - safetyMargin, in tokens.
ContextBudget.fits
boolean fits(int tokens)
True when tokens fit in the context budget.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
tokens | int | yes | Size of the context in tokens. |
Returns: boolean. True when tokens is lower than or equal to contextBudget().
ContextBudget.overflow
int overflow(int tokens)
Tokens to remove from a context of tokens to fit, 0 when it fits.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
tokens | int | yes | Size of the context in tokens. |
Returns: int. The number of tokens in excess, never negative.