Package ai.extend.types

Class RunUsage.Builder

java.lang.Object

ai.extend.types.RunUsage.Builder

All Implemented Interfaces:

RunUsage._FinalStage, RunUsage.CreditsStage

Enclosing class:

RunUsage

public static final class RunUsage.Builder
extends java.lang.Object
implements RunUsage.CreditsStage, RunUsage._FinalStage

Method Summary

Modifier and Type	Method	Description
RunUsage._FinalStage	breakdown(java.util.List<RunUsageBreakdownEntry> breakdown)	The chargeable resources that make up totalCredits, including this run itself when it has its own line item.
RunUsage._FinalStage	breakdown(java.util.Optional<java.util.List<RunUsageBreakdownEntry>> breakdown)	The chargeable resources that make up totalCredits, including this run itself when it has its own line item.
RunUsage	build()
RunUsage._FinalStage	credits(double credits)	The credits consumed by this run.
RunUsage.Builder	from(RunUsage other)
RunUsage._FinalStage	totalCredits(java.lang.Double totalCredits)	The total credits accounted for under this run, including any other runs it was responsible for creating.
RunUsage._FinalStage	totalCredits(java.util.Optional<java.lang.Double> totalCredits)	The total credits accounted for under this run, including any other runs it was responsible for creating.

Methods inherited from class java.lang.Object

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

Method Detail

from

public RunUsage.Builder from(RunUsage other)

Specified by:

from in interface RunUsage.CreditsStage

credits

public RunUsage._FinalStage credits(double credits)

The credits consumed by this run. For most run types this is the line item for the run's own work; for workflow_run this is the aggregate across all child runs.

The credits consumed by this run. For most run types this is the line item for the run's own work; for workflow_run this is the aggregate across all child runs.

Specified by:

credits in interface RunUsage.CreditsStage

Returns:

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

breakdown

public RunUsage._FinalStage breakdown(java.util.List<RunUsageBreakdownEntry> breakdown)

The chargeable resources that make up totalCredits, including this run itself when it has its own line item. For workflow_run, lists every contributing child run sorted by creation time (the workflow itself isn't chargeable and has no line item).

Availability: Present on runs persisted on or after May 14, 2026. Runs persisted before that date will omit this field.

Specified by:

breakdown in interface RunUsage._FinalStage

Returns:

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

breakdown

public RunUsage._FinalStage breakdown(java.util.Optional<java.util.List<RunUsageBreakdownEntry>> breakdown)

The chargeable resources that make up totalCredits, including this run itself when it has its own line item. For workflow_run, lists every contributing child run sorted by creation time (the workflow itself isn't chargeable and has no line item).

Availability: Present on runs persisted on or after May 14, 2026. Runs persisted before that date will omit this field.

Specified by:

breakdown in interface RunUsage._FinalStage

totalCredits

public RunUsage._FinalStage totalCredits(java.lang.Double totalCredits)

The total credits accounted for under this run, including any other runs it was responsible for creating. For example, an extract run on a fresh upload triggers a parse run, so totalCredits includes both line items. For runs that didn't trigger any other work — like parse_run, edit_run and workflow_run — totalCredits equals credits.

Availability: Present on runs persisted on or after May 14, 2026. Runs persisted before that date will omit this field.

Specified by:

totalCredits in interface RunUsage._FinalStage

Returns:

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

totalCredits

public RunUsage._FinalStage totalCredits(java.util.Optional<java.lang.Double> totalCredits)

The total credits accounted for under this run, including any other runs it was responsible for creating. For example, an extract run on a fresh upload triggers a parse run, so totalCredits includes both line items. For runs that didn't trigger any other work — like parse_run, edit_run and workflow_run — totalCredits equals credits.

Availability: Present on runs persisted on or after May 14, 2026. Runs persisted before that date will omit this field.

Specified by:

totalCredits in interface RunUsage._FinalStage

build

public RunUsage build()

Specified by:

build in interface RunUsage._FinalStage