rulvar API reference / @rulvar/core / RunInternals
Interface: RunInternals
Defined in: packages/core/src/engine/ctx.ts:520
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/src/engine/ctx.ts:532 |
admission? | AdmissionController | The single admission point for all spawns (M6-T06). | packages/core/src/engine/ctx.ts:525 |
budget | RunBudget | - | packages/core/src/engine/ctx.ts:523 |
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/src/engine/ctx.ts:587 |
cost | CostAttribution | - | packages/core/src/engine/ctx.ts:560 |
defaults | { gates?: Record<string, MechanicalGateProfile>; limits?: UsageLimits; permissions?: PermissionConfig; profiles?: Record<string, AgentProfile>; retry?: RetryPolicy; routing?: Partial<Record<InvocationRole, ModelSpec>>; schemas?: Record<string, SchemaSpec>; toolsets?: Record<string, ToolsOption>; workflows?: Record<string, unknown>; } | - | packages/core/src/engine/ctx.ts:533 |
defaults.gates? | Record<string, MechanicalGateProfile> | Registered mechanical gate profiles (M7-T10). | packages/core/src/engine/ctx.ts:548 |
defaults.limits? | UsageLimits | - | packages/core/src/engine/ctx.ts:536 |
defaults.permissions? | PermissionConfig | Engine-wide permission chain layers. | packages/core/src/engine/ctx.ts:538 |
defaults.profiles? | Record<string, AgentProfile> | - | packages/core/src/engine/ctx.ts:535 |
defaults.retry? | RetryPolicy | Engine-wide transport RetryPolicy (M4-T05). | packages/core/src/engine/ctx.ts:540 |
defaults.routing? | Partial<Record<InvocationRole, ModelSpec>> | - | packages/core/src/engine/ctx.ts:534 |
defaults.schemas? | Record<string, SchemaSpec> | Registered SchemaSpec names for outputSchemaRef (M7-T05). | packages/core/src/engine/ctx.ts:544 |
defaults.toolsets? | Record<string, ToolsOption> | Registered tool profile names for toolsetRef (M7-T05). | packages/core/src/engine/ctx.ts:546 |
defaults.workflows? | Record<string, unknown> | The per-engine workflow registry (consumers: M6 ctx.workflow, M8 worker). | packages/core/src/engine/ctx.ts:542 |
dropped | DroppedItem[] | - | packages/core/src/engine/ctx.ts:559 |
errorPolicy | ErrorPolicy | - | packages/core/src/engine/ctx.ts:558 |
events | RunEventSink | - | packages/core/src/engine/ctx.ts:527 |
external? | ExternalRegistry | Open external suspensions plus the quiescence activity counter (M2-T08). | packages/core/src/engine/ctx.ts:581 |
flatReserveUsd? | number | budgetDefaults.flatReserveUsd; last resort of the reserve formula. | packages/core/src/engine/ctx.ts:555 |
floors? | QualityFloors | Hard router constraints from engine config (M4-T09). | packages/core/src/engine/ctx.ts:557 |
isolation? | IsolationProvider | The worktree lifecycle provider. | packages/core/src/engine/ctx.ts:564 |
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/src/engine/ctx.ts:571 |
mintTranscriptRef | () => string | - | packages/core/src/engine/ctx.ts:588 |
now | () => number | - | packages/core/src/engine/ctx.ts:589 |
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/src/engine/ctx.ts:577 |
priceUsd | (servedBy, usage) => number | undefined | - | packages/core/src/engine/ctx.ts:561 |
pricingVersion? | string | The configured price table's version; pinned in decision entries (M4-T06). | packages/core/src/engine/ctx.ts:553 |
providerLimiter? | KeyedLimiter | Engine-scoped per-provider keyed limiter (M4-T07). | packages/core/src/engine/ctx.ts:551 |
replayer | Replayer | - | packages/core/src/engine/ctx.ts:522 |
rootSpanId | string | The run root span; every top-level span parents on it. | packages/core/src/engine/ctx.ts:530 |
runId | string | - | packages/core/src/engine/ctx.ts:521 |
runSignal? | AbortSignal | - | packages/core/src/engine/ctx.ts:562 |
semaphore | Semaphore | - | packages/core/src/engine/ctx.ts:526 |
spans | SpanMinter | - | packages/core/src/engine/ctx.ts:528 |
transcripts | TranscriptStore | - | packages/core/src/engine/ctx.ts:531 |