Interface: PolicyLimitExceededBuilder<THandle>

Defined in: builders/policy-builder.ts:20

Fluent configurator for limit-exceeded flush and abort handling ($limit in .onLimitExceeded).

Configures the mandatory flush interrupt and optional abort hook invoked when maxTurns, maxCostUsd, or maxDurationSeconds is breached.

Type Parameters

Type Parameter	Default type	Description
THandle	unknown	Runtime handle type of the active isolation scope.

Methods

build()

build(): PolicyLimitExceededConfig<THandle>;

Defined in: builders/policy-builder.ts:58

Compiles the accumulated limit-exceeded state into an immutable PolicyLimitExceededConfig.

Internal finalize method invoked by PolicyBuilder.onLimitExceeded.

Returns

PolicyLimitExceededConfig<THandle>

Deeply frozen limit-exceeded configuration.

---

flushWithInterrupt()

flushWithInterrupt<TPayload>(interrupt): PolicyLimitExceededBuilder<THandle>;

Defined in: builders/policy-builder.ts:32

Binds the mandatory interrupt raised after flushing the in-flight turn on a limit breach.

Enables downstream .onInterrupt(interrupt, ...) edges to adjudicate, ask, or replace the actor.

Type Parameters

Type Parameter	Default type	Description
TPayload	unknown	Interrupt payload type.

Parameters

Parameter	Type	Description
interrupt	MaybeBuilder<InterruptNode<TPayload>>	Target interrupt AST node or builder.

Returns

PolicyLimitExceededBuilder<THandle>

Updated immutable builder instance.

---

onAbort()

onAbort<TAbortMeta>(abortHook): PolicyLimitExceededBuilder<THandle>;

Defined in: builders/policy-builder.ts:47

Binds an optional abort hook (git.snapshotAndReset()) executed before raising the flush interrupt.

Captures abort metadata into telemetry.abortMeta for downstream replacement steps.

Type Parameters

Type Parameter	Default type	Description
TAbortMeta extends Record<string, unknown>	Record<string, unknown>	Structured metadata record returned by the abort hook.

Parameters

Parameter	Type	Description
abortHook	MaybeBuilder<AbortHookASTNode<THandle, TAbortMeta>>	Abort hook AST node or builder.

Returns

PolicyLimitExceededBuilder<THandle>

Updated immutable builder instance.