rulvar API reference

---

rulvar API reference / @rulvar/core / AdaptiveEvents

Type Alias: AdaptiveEvents

type AdaptiveEvents = 
  | {
  applied: number;
  dropped: number;
  entryRef: number;
  planHash: string;
  revisionUnitsRemaining: number;
  type: "plan:revised";
}
  | {
  logicalTaskId: string;
  nodeId: string;
  type: "node:parked";
}
  | {
  logicalTaskId: string;
  nodeId: string;
  type: "node:cancelled";
}
  | {
  donorRef: number;
  logicalTaskId: string;
  nodeId: string;
  reclaimedUsd: number;
  type: "node:linked";
}
  | {
  coversToOrdinal: number;
  digestSeq: number;
  planHash: string;
  renderSize: number;
  type: "orchestrator:woke";
}
  | {
  effectiveCapUsd: number;
  entryRef: number;
  frozen: boolean;
  reserveUsedUsd: number;
  spentUsd: number;
  type: "orchestrator:budget";
}
  | {
  costToDateUsd: number;
  entryRef: number;
  kind: "scope_bigger" | "scope_different" | "blocked_with_evidence";
  logicalTaskId: string;
  type: "escalation:raised";
}
  | {
  by: ResolutionBy;
  countsAgainstLimit: boolean;
  decision: "retry" | "decompose" | "cancel" | "accept";
  entryRef: number;
  type: "escalation:decided";
}
  | {
  agentType: string;
  entryRef: number;
  logicalTaskId: string;
  spawnUnitsAfter: number;
  type: "spawn:admitted";
  verdict: "admit" | "reuse_full" | "admit_graft";
}
  | {
  agentType: string;
  code: string;
  entryRef: number;
  logicalTaskId?: string;
  type: "spawn:rejected";
}
  | {
  entryRef: number;
  gate: "mechanical" | "judge" | "spot-check";
  logicalTaskId: string;
  rung: number;
  type: "verify:failed";
}
  | {
  entryRef: number;
  op:   | "brief_set"
     | "fact_add"
     | "fact_supersede"
     | "lesson_add"
     | "observation_add";
  type: "ledger:op";
}
  | {
  logicalTaskId: string;
  stallStreak: number;
  type: "stall:detected";
}
  | {
  limit: number;
  oscillationCount: number;
  spawnKeyHash: string;
  type: "guard:oscillation";
}
  | {
  by: ResolutionBy;
  entryRef: number;
  targetRef: number;
  type: "resolution:applied";
}
  | {
  entryRef: number;
  reason: "already_resolved" | "target_abandoned";
  supersededBy: number;
  targetRef: number;
  type: "resolution:superseded";
}
  | {
  counter: string;
  entryRef: number;
  phi: number;
  remaining: number;
  type: "termination:debit";
}
  | {
  code: string;
  counter: string;
  entryRef: number;
  type: "termination:denied";
}
  | {
  field: string;
  frozenValue: Json;
  liveValue: Json;
  type: "termination:config-drift";
}
  | {
  code: "HASH_VERSION_TOO_OLD" | "HASH_VERSION_TOO_NEW";
  found: number;
  type: "journal:compat";
  window: [number, number];
};

Defined in: packages/core/src/l0/events.ts:89

Adaptive orchestration, resolutions, and accounting: emitted only by runs where the corresponding machinery is active (applicability per mode: https://docs.rulvar.com/guide/adaptive-orchestration). The types land as one closed catalog with M7-T03; emitters arrive with their tasks.

Union Members

Type Literal

{
  applied: number;
  dropped: number;
  entryRef: number;
  planHash: string;
  revisionUnitsRemaining: number;
  type: "plan:revised";
}

---

Type Literal

{
  logicalTaskId: string;
  nodeId: string;
  type: "node:parked";
}

---

Type Literal

{
  logicalTaskId: string;
  nodeId: string;
  type: "node:cancelled";
}

---

Type Literal

{
  donorRef: number;
  logicalTaskId: string;
  nodeId: string;
  reclaimedUsd: number;
  type: "node:linked";
}

---

Type Literal

{
  coversToOrdinal: number;
  digestSeq: number;
  planHash: string;
  renderSize: number;
  type: "orchestrator:woke";
}

---

Type Literal

{
  effectiveCapUsd: number;
  entryRef: number;
  frozen: boolean;
  reserveUsedUsd: number;
  spentUsd: number;
  type: "orchestrator:budget";
}

---

Type Literal

{
  costToDateUsd: number;
  entryRef: number;
  kind: "scope_bigger" | "scope_different" | "blocked_with_evidence";
  logicalTaskId: string;
  type: "escalation:raised";
}

---

Type Literal

{
  by: ResolutionBy;
  countsAgainstLimit: boolean;
  decision: "retry" | "decompose" | "cancel" | "accept";
  entryRef: number;
  type: "escalation:decided";
}

---

Type Literal

{
  agentType: string;
  entryRef: number;
  logicalTaskId: string;
  spawnUnitsAfter: number;
  type: "spawn:admitted";
  verdict: "admit" | "reuse_full" | "admit_graft";
}

Name	Type	Description	Defined in
agentType	string	-	packages/core/src/l0/events.ts:141
entryRef	number	-	packages/core/src/l0/events.ts:138
logicalTaskId	string	-	packages/core/src/l0/events.ts:142
spawnUnitsAfter	number	-	packages/core/src/l0/events.ts:143
type	"spawn:admitted"	-	packages/core/src/l0/events.ts:137
verdict	"admit" | "reuse_full" | "admit_graft"	The admitting arms of the unified AdmitVerdict union.	packages/core/src/l0/events.ts:140

---

Type Literal

{
  agentType: string;
  code: string;
  entryRef: number;
  logicalTaskId?: string;
  type: "spawn:rejected";
}

---

Type Literal

{
  entryRef: number;
  gate: "mechanical" | "judge" | "spot-check";
  logicalTaskId: string;
  rung: number;
  type: "verify:failed";
}

---

Type Literal

{
  entryRef: number;
  op:   | "brief_set"
     | "fact_add"
     | "fact_supersede"
     | "lesson_add"
     | "observation_add";
  type: "ledger:op";
}

---

Type Literal

{
  logicalTaskId: string;
  stallStreak: number;
  type: "stall:detected";
}

---

Type Literal

{
  limit: number;
  oscillationCount: number;
  spawnKeyHash: string;
  type: "guard:oscillation";
}

---

Type Literal

{
  by: ResolutionBy;
  entryRef: number;
  targetRef: number;
  type: "resolution:applied";
}

---

Type Literal

{
  entryRef: number;
  reason: "already_resolved" | "target_abandoned";
  supersededBy: number;
  targetRef: number;
  type: "resolution:superseded";
}

---

Type Literal

{
  counter: string;
  entryRef: number;
  phi: number;
  remaining: number;
  type: "termination:debit";
}

---

Type Literal

{
  code: string;
  counter: string;
  entryRef: number;
  type: "termination:denied";
}

---

Type Literal

{
  field: string;
  frozenValue: Json;
  liveValue: Json;
  type: "termination:config-drift";
}

---

Type Literal

{
  code: "HASH_VERSION_TOO_OLD" | "HASH_VERSION_TOO_NEW";
  found: number;
  type: "journal:compat";
  window: [number, number];
}