rulvar API reference / @rulvar/rulvar / RunInternals
Interface: RunInternals
Defined in: packages/core/dist/index.d.ts
Everything one run's ctx needs; created per run by the engine (M1-T11).
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
adapters | ReadonlyMap<string, ProviderAdapter> | - | packages/core/dist/index.d.ts |
admission? | AdmissionController | The single admission point for all spawns (M6-T06). | packages/core/dist/index.d.ts |
budget | RunBudget | - | packages/core/dist/index.d.ts |
claimedLineageDecisions? | Set<number> | Seqs of spawn-admission decisions already paired with a live ctx.agent dispatch this process lifetime, so byte-identical repeats recover THEIR OWN decisions in journal order (DEF-3; M7-T02). | packages/core/dist/index.d.ts |
cost | CostAttribution | - | packages/core/dist/index.d.ts |
defaults | { gates?: Record<string, MechanicalGateProfile>; limits?: UsageLimits; permissions?: PermissionConfig; profiles?: Record<string, AgentProfile>; retry?: RetryPolicy; routing?: Partial<Record<InvocationRole, ModelSpec>>; schemas?: Record<string, SchemaSpec<unknown>>; toolsets?: Record<string, ToolsOption>; workflows?: Record<string, unknown>; } | - | packages/core/dist/index.d.ts |
defaults.gates? | Record<string, MechanicalGateProfile> | - | packages/core/dist/index.d.ts |
defaults.limits? | UsageLimits | - | packages/core/dist/index.d.ts |
defaults.permissions? | PermissionConfig | - | packages/core/dist/index.d.ts |
defaults.profiles? | Record<string, AgentProfile> | - | packages/core/dist/index.d.ts |
defaults.retry? | RetryPolicy | - | packages/core/dist/index.d.ts |
defaults.routing? | Partial<Record<InvocationRole, ModelSpec>> | - | packages/core/dist/index.d.ts |
defaults.schemas? | Record<string, SchemaSpec<unknown>> | - | packages/core/dist/index.d.ts |
defaults.toolsets? | Record<string, ToolsOption> | - | packages/core/dist/index.d.ts |
defaults.workflows? | Record<string, unknown> | - | packages/core/dist/index.d.ts |
dropped | DroppedItem[] | - | packages/core/dist/index.d.ts |
errorPolicy | ErrorPolicy | - | packages/core/dist/index.d.ts |
events | RunEventSink | - | packages/core/dist/index.d.ts |
external? | ExternalRegistry | Open external suspensions plus the quiescence activity counter (M2-T08). | packages/core/dist/index.d.ts |
flatReserveUsd? | number | budgetDefaults.flatReserveUsd; last resort of the reserve formula. | packages/core/dist/index.d.ts |
floors? | QualityFloors | Hard router constraints from engine config (M4-T09). | packages/core/dist/index.d.ts |
isolation? | IsolationProvider | The worktree lifecycle provider. | packages/core/dist/index.d.ts |
knowledge? | ModelKnowledgeHandle | The ModelKnowledge runtime handle (M10-T03): current() only, commit physically absent. Present only when the engine was given stores.modelKnowledge; absent means the feature is off and no kb entries are ever written. | packages/core/dist/index.d.ts |
mintTranscriptRef | () => string | - | packages/core/dist/index.d.ts |
now | () => number | - | packages/core/dist/index.d.ts |
onEscalation? | (result) => | EscalationDecision | Promise<EscalationDecision> | The InProcessRunner escalation hook: receives escalated results when the call form cannot carry them; its decision is journaled as the authoritative escalation-decision entry. | packages/core/dist/index.d.ts |
priceUsd | (servedBy, usage) => number | undefined | - | packages/core/dist/index.d.ts |
pricingVersion? | string | The configured price table's version; pinned in decision entries (M4-T06). | packages/core/dist/index.d.ts |
providerLimiter? | KeyedLimiter | Engine-scoped per-provider keyed limiter (M4-T07). | packages/core/dist/index.d.ts |
replayer | Replayer | - | packages/core/dist/index.d.ts |
rootSpanId | string | The run root span; every top-level span parents on it. | packages/core/dist/index.d.ts |
runId | string | - | packages/core/dist/index.d.ts |
runSignal? | AbortSignal | - | packages/core/dist/index.d.ts |
semaphore | Semaphore | - | packages/core/dist/index.d.ts |
spans | SpanMinter | - | packages/core/dist/index.d.ts |
transcripts | TranscriptStore | - | packages/core/dist/index.d.ts |