Rulvar API reference / @rulvar/rulvar / AdmitSpec
Interface: AdmitSpec
Defined in: packages/core/dist/index.d.ts
What the admission point needs to know about one spawn.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
ancestry? | string[] | Decomposition parent-LTID chain (relation 'decompose-child' only). | packages/core/dist/index.d.ts |
approach? | string | Raw approach tag; normalized by the engine. | packages/core/dist/index.d.ts |
budgetUsd? | number | Explicit child budget; clamped by childBudgetFraction. | packages/core/dist/index.d.ts |
childScope | string | The child's journal scope; doubles as its budget account scope. | packages/core/dist/index.d.ts |
estCostUsd? | number | Reserve hint; falls back to the flat engine default. | packages/core/dist/index.d.ts |
ladderLength? | number | The declared ladder length of the resolved profile (K_l); default 1, the single implicit rung. Under a termination account, a length beyond the frozen kMax rejects with ladder_exceeds_frozen and a NEW lineage is allocated E0 escalation units plus K_l - 1 rungs (DEF-2). | packages/core/dist/index.d.ts |
lineage? | SpawnLineageOpt | Lineage continuation (DEF-3); absence mints a fresh lineage root. A continuation demands a causeRef: the seq of the entry that caused the rebirth. | packages/core/dist/index.d.ts |
name | string | Registered workflow name or agent profile name; telemetry and cards only. | packages/core/dist/index.d.ts |
nodeKey? | string | The children-quota key (maxChildrenPerNode); defaults to parentAccountScope. Orchestrators pass their own scope so each node counts its own children. | packages/core/dist/index.d.ts |
origin | SpawnOrigin | - | packages/core/dist/index.d.ts |
parentAccountScope | string | The nearest enclosing budget account of the spawner. | packages/core/dist/index.d.ts |
pendingReserveUsd? | number | Same-batch reserves already admitted read-only but not yet committed (a multi-op plan revision): the read-only branch adds them to this spawn's reserve so every embedded admit of one batch is dispatchable under the same snapshot, not just the first. | packages/core/dist/index.d.ts |
roster? | { admittedChildren: number; floor: number; liveExposureUsd: number; } | The sequential roster feasibility inputs (RV2005), passed by the SINGLE spawn_agent path when acceptance.minSpawnedChildren is declared: the admission projects the whole REMAINING roster at this seat's own dispatch projection, live in-flight exposure included, and refuses the first infeasible seat typed 'roster_floor' before any child is paid. Batch seats never carry this: the RV1908 batchGate already judged their batch entire. | packages/core/dist/index.d.ts |
roster.admittedChildren | number | - | packages/core/dist/index.d.ts |
roster.floor | number | - | packages/core/dist/index.d.ts |
roster.liveExposureUsd | number | - | packages/core/dist/index.d.ts |
signature? | Partial<ApproachSignatureInputs> | Coarse-signature identity inputs; unspecified fields canonize onto the deterministic legacy constants so signatures stay byte-stable (the toolset/schema registries land in M7-T05). | packages/core/dist/index.d.ts |