@engramx/idl 0.16.0-rc.16 → 0.16.0-rc.18

package/dist/engram.idl.d.ts

@@ -220,6 +220,15 @@ export interface BearerToken {
   issuedBy: Principal;
 }
 export type BearerTokenStatus = { Active: null } | { Revoked: null } | { Expired: null };
+export interface BirthRecord {
+  bornAtNs: bigint;
+  parentFingerprint: [] | [Uint8Array | number[]];
+  child: Principal;
+  secret: Uint8Array | number[];
+  version: bigint;
+  number: bigint;
+  parent: [] | [Principal];
+}
 export interface BrakePull {
   by: Principal;
   atNs: bigint;
@@ -393,7 +402,7 @@ export interface Engram {
    * / test/key-replacement.test.mo runs it; this body names no roster gate, because the caller holds
    * / no role here until the move.
    */
-  acceptAgentKeyNomination: ActorMethod<[Principal], Result_80>;
+  acceptAgentKeyNomination: ActorMethod<[Principal], Result_82>;
   /**
    * / Consensus transform for the alert webhook outcall: collapse the response to status-only so
    * / replicas agree regardless of response headers/body (we only care that the POST landed 2xx).
@@ -426,7 +435,7 @@ export interface Engram {
    * / account name). The action must be registered: a destination list belongs to an action, and a
    * / list for no action would be a value nothing checks. The caller is the owner's app.
    */
-  addEip712Destination: ActorMethod<[Uint8Array | number[], string], Result_79>;
+  addEip712Destination: ActorMethod<[Uint8Array | number[], string], Result_81>;
   /**
    * / Register a typed-data shape as signable. Owner-only, freeze-gated (a registration is a grant
    * / of FUTURE authority — a frozen engram must not be able to widen what it can sign), and the
@@ -461,7 +470,7 @@ export interface Engram {
         ackIrrevocable: boolean;
       },
     ],
-    Result_78
+    Result_80
   >;
   /**
    * / ⟨0.16.0, L1⟩ THE ROLE-CONFLICT ARM, and why three refusals here are not the same refusal.
@@ -484,7 +493,7 @@ export interface Engram {
    * / holding a line break are `#Invalid`; an id past the head is `#NotFound`; nothing is recorded
    * / on any refusal.
    */
-  addRecordNote: ActorMethod<[bigint, string], Result_12>;
+  addRecordNote: ActorMethod<[bigint, string], Result_13>;
   /**
    * / Returns the write RECEIPT, not just the version.
    * /
@@ -519,7 +528,7 @@ export interface Engram {
    * / is exactly what a guardian pause exists to hold. No action alert is raised: the operation is
    * / owner-initiated, owner-only, and already chained into the audit log.
    */
-  applyCondense: ActorMethod<[bigint], Result_77>;
+  applyCondense: ActorMethod<[bigint], Result_79>;
   /**
    * / Owner-only: activate a guardian who has registered against an invite.
    * /
@@ -599,7 +608,7 @@ export interface Engram {
    * /
    * / The write half also refuses while writes are PAUSED.
    */
-  backupInit: ActorMethod<[string, BackupType, [] | [string], string, [] | [string]], Result_51>;
+  backupInit: ActorMethod<[string, BackupType, [] | [string], string, [] | [string]], Result_52>;
   /**
    * / Read one chunk of a finalized backup, by index.
    * /
@@ -607,7 +616,7 @@ export interface Engram {
    * / `canAppendMemory`. Holding one says nothing about the other, deliberately: taking a backup and
    * / carrying it away are different authorities.
    */
-  backupPullChunk: ActorMethod<[string, bigint], Result_67>;
+  backupPullChunk: ActorMethod<[string, bigint], Result_68>;
   backupPushChunk: ActorMethod<[string, bigint, Uint8Array | number[]], Result_1>;
   /**
    * / The OWNER cancels an agent's pending key nomination; the agent keeps its current key. Refused
@@ -645,7 +654,7 @@ export interface Engram {
    * / pair — e6 base units of the token named first. A name only: Candid passes arguments by
    * / position, so nothing on the wire moved.
    */
-  convertEarningsToCycles: ActorMethod<[string, bigint], Result_12>;
+  convertEarningsToCycles: ActorMethod<[string, bigint], Result_13>;
   /**
    * / Owner-only: mint a single-use invite code an agent redeems with `pairAgent`.
    * /
@@ -665,7 +674,7 @@ export interface Engram {
    * / A principal that is already a GUARDIAN cannot become an agent — a guardian is an
    * / independent check on agents, so one wallet must not hold both.
    */
-  createAgentInvite: ActorMethod<[string, AgentPermissions], Result_51>;
+  createAgentInvite: ActorMethod<[string, AgentPermissions], Result_52>;
   /**
    * / Owner-only: mint an invite for a GUARDIAN — an independent check on agents, not a
    * / co-owner and not a recovery agent.
@@ -689,7 +698,7 @@ export interface Engram {
    * / So an invite that fails to redeem for that reason is not a bad code. The rule exists because
    * / a check must be independent of the thing it checks.
    */
-  createGuardianInvite: ActorMethod<[string, GuardianPermissions], Result_51>;
+  createGuardianInvite: ActorMethod<[string, GuardianPermissions], Result_52>;
   /**
    * / OWNER-ONLY deletion of a stored backup.
    * /
@@ -740,7 +749,7 @@ export interface Engram {
    * / revision, or a paid session's append) that succeeded, still held in full by the ring.
    * / One dispute per guardian per write (`#Conflict`, the first stands).
    */
-  disputeAgentWrite: ActorMethod<[bigint, string], Result_12>;
+  disputeAgentWrite: ActorMethod<[bigint, string], Result_13>;
   /**
    * / Record that log entries [fromSeq, toSeq] were served, and return the root that proves it.
    * /
@@ -755,7 +764,7 @@ export interface Engram {
    * / situation rather than a safety measure. It IS gated on requireMemoryAttached: a store that
    * / failed its integrity check must not attest anything it cannot vouch for.
    */
-  exportMemoryRange: ActorMethod<[bigint, bigint, [] | [Principal]], Result_76>;
+  exportMemoryRange: ActorMethod<[bigint, bigint, [] | [Principal]], Result_78>;
   /**
    * / ⟨0.16.0, L2.2 — renamed from `guardianFreezePayments`⟩ The prefix LIED about who may call it.
    * / The gate is `requireOwnerOrGuardian`, and an owner freezing their own payments is the ordinary
@@ -803,7 +812,7 @@ export interface Engram {
   /**
    * / Delivery status + config readback. Owner-only (the URL is a secret).
    */
-  getActionAlertStatus: ActorMethod<[], Result_65>;
+  getActionAlertStatus: ActorMethod<[], Result_66>;
   /**
    * / Agents need to know what they may revise, so they can read it too. Whole-value config, same
    * / carve-out as getProtectedPaths — and kept a SEPARATE method from it deliberately (L2.2): a
@@ -813,7 +822,7 @@ export interface Engram {
    * / Refusal reason preserved from the trap: a grant is a power, and its absence and its
    * / concealment are different facts.
    */
-  getAgentRevisablePaths: ActorMethod<[], Result_61>;
+  getAgentRevisablePaths: ActorMethod<[], Result_62>;
   /**
    * / OWNER-ONLY: every engagement's seat weeks on this engram, with the agent's root — the day it
    * / paired, the days of its first and last payment signature, a 64-week map whose bit 0 is the week
@@ -826,7 +835,7 @@ export interface Engram {
    * / empty page. Paged; `total` is every engagement ever paired here (a reset keeps the rows).
    * / Two rows can name one root: an agent paired again after it left is a second engagement.
    */
-  getAgentSeatWeeks: ActorMethod<[bigint, bigint], Result_74>;
+  getAgentSeatWeeks: ActorMethod<[bigint, bigint], Result_76>;
   /**
    * / Owner: everything written into this engram by someone other than the owner since the last
    * / markAgentWritesReviewed() — agent appends/revisions AND paid-session appends (see
@@ -836,7 +845,7 @@ export interface Engram {
    * / as a total. `earliest` discloses ring eviction — if cursor < earliest, entries between them
    * / aged out of the ring (the CHAIN still proves total count; this view can't show their bodies).
    */
-  getAgentWriteReview: ActorMethod<[], Result_73>;
+  getAgentWriteReview: ActorMethod<[], Result_75>;
   /**
    * / Why anchoring is or is not advancing. PUBLIC: ungated on purpose — detecting a stalled
    * / engram is the point, a gated read would fail-to-empty and hand a third party fabricated zeros,
@@ -859,7 +868,7 @@ export interface Engram {
    * / was signed rather than asserted.
    */
   getAuditHead: ActorMethod<[], AuditHead>;
-  getBackupMetadata: ActorMethod<[string], Result_72>;
+  getBackupMetadata: ActorMethod<[string], Result_74>;
   /**
    * / ⟨2026-10-21, the owner's round-11 answer m: a backup-retention getter⟩ How many backups of
    * / `dbType` each creator keeps, and whether that is the default — the read `setBackupRetention`
@@ -872,7 +881,7 @@ export interface Engram {
    * / the anonymous caller. A kind the setter would refuse is `#Invalid` here too
    * / (`Backup.getRetention`). Records nothing (a query).
    */
-  getBackupRetention: ActorMethod<[string], Result_71>;
+  getBackupRetention: ActorMethod<[string], Result_73>;
   /**
    * / The cashier this engram recognises as its rent biller — `null` until the registry pushes one.
    * /
@@ -882,6 +891,16 @@ export interface Engram {
    * / too is what lets the two be COMPARED, which is the only way to catch a mismatch.
    */
   getBillerId: ActorMethod<[], [] | [Principal]>;
+  /**
+   * / This engram's BIRTH CHAIN, root first: its own record last, its parent's before it, and so on
+   * / ⟨2026-10-26, the owner's lineage ruling L3A⟩.
+   * /
+   * / OWNER ONLY. The owner decides whom to show it to — the chain names the engrams this one descends
+   * / from, which is the owner's to disclose, not the registry's. The certified half is at the registry
+   * / (`getCertifiedBirth`, public, revealing only whether a fingerprint is present); the client's
+   * / `verifyBirthChain` checks both. Refused to anyone else by the combinator (`#ownerOnly`).
+   */
+  getBirthChain: ActorMethod<[], Result_72>;
   /**
    * / ⟨2026-10-21, the owner's round-11 answer d⟩ Each brake: on or off, and while on, who pulled it
    * / LAST (their key and whether as owner or guardian), since when, and the reason they gave — the
@@ -892,7 +911,7 @@ export interface Engram {
    * / is null for a brake that is off, and for one carried on across the upgrade that added this
    * / read (who pulled it was not recorded then) — never a guessed pull.
    */
-  getBrakes: ActorMethod<[], Result_70>;
+  getBrakes: ActorMethod<[], Result_71>;
   /**
    * / ⟨0.16.0, L9/L10 — census row⟩ `Wire.CertifiedAuditHead`, not an anonymous record. The
    * / registry, market and cashier already served the shared type; the engram — the canister that
@@ -919,13 +938,13 @@ export interface Engram {
    * / recorded nothing while reading as if it did. The refusal is loud in the reply instead. WHAT
    * / WOULD MAKE THIS WRONG: a reason to record who asked — then this becomes an update that says so.
    */
-  getChildAllowance: ActorMethod<[Principal], Result_69>;
+  getChildAllowance: ActorMethod<[Principal], Result_70>;
   /**
    * / Owner-only, Billing-class: what opening an engram costs this engram, the balance below which an
    * / agent's request is refused, the balance now, and every agent's allowance. The console's cost
    * / sentence reads it. Cycles are owner-class information, as on the owner's console read.
    */
-  getChildOpening: ActorMethod<[], Result_68>;
+  getChildOpening: ActorMethod<[], Result_69>;
   /**
    * / Derive the shared memory-encryption key, encrypted under the caller's transport
    * / public key. Gated to owner + read-agents (the same principals allowed to read
@@ -951,7 +970,7 @@ export interface Engram {
    * / cost. Stated here because L7 requires the reason be readable from the interface rather than
    * / inferred by opening the body — which is exactly what had to happen to write this line.
    */
-  getEncryptedMemoryKey: ActorMethod<[[] | [bigint], Uint8Array | number[]], Result_67>;
+  getEncryptedMemoryKey: ActorMethod<[[] | [bigint], Uint8Array | number[]], Result_68>;
   /**
    * / ⟨0.16.0, owner ruling 2026-08-20 — option (a)⟩ `x402Support` REPORTS THE RAIL, not a constant.
    * /
@@ -1050,7 +1069,7 @@ export interface Engram {
    * / `#Err`, never a record carrying an empty string (ic402's `getEvmAddress` answers `""` on a
    * / failed derivation — that is fail-to-empty on a money surface, and it stops here).
    */
-  getEvmAddress: ActorMethod<[], Result_66>;
+  getEvmAddress: ActorMethod<[], Result_67>;
   /**
    * / The owner's OWN EVM address, if they registered one — distinct from `getEvmAddress`, which is
    * / the address this canister derives for itself.
@@ -1069,7 +1088,7 @@ export interface Engram {
    * / cost — stated here because L7 requires the reason be readable from the interface rather than
    * / inferred by opening the body.
    */
-  getEvmSignerAddress: ActorMethod<[], Result_51>;
+  getEvmSignerAddress: ActorMethod<[], Result_52>;
   /**
    * / PUBLIC: where this chain begins, for the stranger deciding whether to trust it.
    * /
@@ -1082,7 +1101,7 @@ export interface Engram {
   /**
    * / A guardian's own channel status (their URL is their secret — each guardian sees only theirs).
    */
-  getGuardianAlertStatus: ActorMethod<[], Result_65>;
+  getGuardianAlertStatus: ActorMethod<[], Result_66>;
   /**
    * / The market this engram will accept signing requests from — `null` until the registry pushes
    * / one at spawn, which is why `requireMarket` refuses fleet-wide today.
@@ -1115,7 +1134,7 @@ export interface Engram {
    * / never renumbered: the next page starts at the last version returned plus one. Defaults
    * / return the whole history of any file a pre-FD engram could have held.
    */
-  getMemoryHistory: ActorMethod<[string, [] | [bigint], [] | [bigint]], Result_64>;
+  getMemoryHistory: ActorMethod<[string, [] | [bigint], [] | [bigint]], Result_65>;
   /**
    * / PUBLIC: the epoch alone, and deliberately nothing else (rotation study D4). A `rotatedAt[]`
    * / history would be a public, fleet-enumerable feed of when each owner terminated a trust
@@ -1164,7 +1183,7 @@ export interface Engram {
    * / forever" — a claim about what this engram will DESTROY — and an empty guard list reads as
    * / "nothing is held back".
    */
-  getMemoryRetentionPolicy: ActorMethod<[], Result_63>;
+  getMemoryRetentionPolicy: ActorMethod<[], Result_64>;
   /**
    * / The metrics reader this engram answers — `null` until the spawning registry names one.
    * /
@@ -1181,7 +1200,7 @@ export interface Engram {
    * / a fact about the caller, told to the caller. There is nothing to leak by omission — which is
    * / the test the #NotFound arm sets.
    */
-  getMyGuardianStatus: ActorMethod<[], Result_15>;
+  getMyGuardianStatus: ActorMethod<[], Result_16>;
   /**
    * / ⟨0.16.0, NEW⟩ The gated half of the status() split.
    * /
@@ -1193,7 +1212,7 @@ export interface Engram {
    * / client (rule 4) and bought a masked answer nobody had asked for — the census could not even
    * / find a consumer that read the masked `0`. Behind a gate there is nobody to mask it from.
    */
-  getOwnerConsole: ActorMethod<[], Result_62>;
+  getOwnerConsole: ActorMethod<[], Result_63>;
   /**
    * / Owner + agents only (agents need it to avoid writing protected paths).
    * /
@@ -1207,7 +1226,7 @@ export interface Engram {
    * / writing one — so a fabricated empty here does not merely misinform, it invites the write the
    * / list exists to prevent.
    */
-  getProtectedPaths: ActorMethod<[], Result_61>;
+  getProtectedPaths: ActorMethod<[], Result_62>;
   /**
    * / Whether the metrics reader's read is answered — `true` from birth.
    * /
@@ -1220,7 +1239,7 @@ export interface Engram {
    * / payment signatures the balance carries above the floor before `signX402Payment` is refused by
    * / name. The same numbers the check uses, so Billing can say only what the engram enforces.
    */
-  getSigningFloor: ActorMethod<[], Result_60>;
+  getSigningFloor: ActorMethod<[], Result_61>;
   /**
    * / The registry that spawned this engram, if it recorded one.
    * /
@@ -1241,7 +1260,7 @@ export interface Engram {
    * / A refusal names this method (`Gated.gatedResult`) rather than answering null/0 — a ceiling of
    * / "none" and a spend of 0 are both real answers, so a fabricated one would be read as fact.
    */
-  getSpendCeiling: ActorMethod<[], Result_59>;
+  getSpendCeiling: ActorMethod<[], Result_60>;
   /**
    * / Read the caps in force for a caller.
    * /
@@ -1251,8 +1270,8 @@ export interface Engram {
    * / configuration, and publishing them would tell any caller exactly how large a signing request
    * / can be before it needs an approval nobody is watching for.
    */
-  getSpendPolicy: ActorMethod<[[] | [Principal]], Result_58>;
-  getStorageStats: ActorMethod<[], Result_57>;
+  getSpendPolicy: ActorMethod<[[] | [Principal]], Result_59>;
+  getStorageStats: ActorMethod<[], Result_58>;
   /**
    * / Timer arm-state. PUBLIC and deliberately so: these timers are self-arming to save cycles,
    * / and an optimisation nobody can verify is an optimisation nobody should trust. Cheap to read,
@@ -1325,14 +1344,14 @@ export interface Engram {
    * / UPDATE, marked per L7: it awaits three ICRC-1 ledgers". It was marked in prose and invisible
    * / to any gate; the glyph is what `scripts/check-update-for-read.mjs` matches.
    */
-  getWalletBalances: ActorMethod<[], Result_56>;
+  getWalletBalances: ActorMethod<[], Result_57>;
   /**
    * / Refusal reason preserved, and it is the clearest case of why a masked read is worse than no
    * / read: three empty strings with `configured = false` is a VALID-LOOKING answer meaning "this
    * / engram has no World ID configuration" — handed to a caller who merely lacks a grant. The
    * / fabrication is indistinguishable from the truth by construction.
    */
-  getWorldIdConfig: ActorMethod<[], Result_55>;
+  getWorldIdConfig: ActorMethod<[], Result_56>;
   /**
    * / ⟨L7⟩ UPDATE, NOT QUERY: this awaits THREE system calls — `raw_rand()` for the nonce,
    * / `Call.signWithEcdsa` for the signature, and `worldIdRpPublicKey()` for the derived key. A
@@ -1343,7 +1362,7 @@ export interface Engram {
    * / the World Developer Portal. Short-lived (300s TTL, idkit-server's default) and single-purpose —
    * / it authorizes opening one verification request, nothing else.
    */
-  getWorldIdRpContext: ActorMethod<[], Result_54>;
+  getWorldIdRpContext: ActorMethod<[], Result_55>;
   /**
    * / Owner-only: the EVM address derived from the engram's dedicated World ID RP signing key (the
    * / "worldid-rp" tECDSA path). Register THIS address as the rp_id's signer in the World Developer
@@ -1355,7 +1374,7 @@ export interface Engram {
    * / refusal — a state write, which a query cannot perform. So even if the key were cached this
    * / could not become a query without silently retiring its denial record (ADR-0002's class).
    */
-  getWorldIdRpSignerAddress: ActorMethod<[], Result_51>;
+  getWorldIdRpSignerAddress: ActorMethod<[], Result_52>;
   /**
    * / The verified IDKitResult, verbatim, as World's /api/v4/verify accepted it — the re-checkable
    * / artifact behind verifiedHuman. Role-gated because it carries the NULLIFIER.
@@ -1376,7 +1395,7 @@ export interface Engram {
    * / canister does not serve. The tombstones below and at `about()` are historical and correct as
    * / written; this one was present tense, which is the difference that matters.⟩
    */
-  getWorldIdVerification: ActorMethod<[], Result_53>;
+  getWorldIdVerification: ActorMethod<[], Result_54>;
   /**
    * / ⟨0.16.0, L1⟩ THE EMERGENCY FAMILY. Every refusal below is `#Refused` or `#NotFound`, and the
    * / absence of a `#Conflict` here is the point: these are the calls someone makes while something
@@ -1460,7 +1479,7 @@ export interface Engram {
    * / Owner-gated because it reports on custody posture, and answered as a Result so that a
    * / wrong-identity caller gets a refusal rather than a bare `false` that reads as "no address yet".
    */
-  isEvmAddressCached: ActorMethod<[], Result_52>;
+  isEvmAddressCached: ActorMethod<[], Result_53>;
   /**
    * / Issue an OAuth authorization code. Called by an OAuth client's sign-in bridge
    * / (an `/auth/connector`-style route) after II authentication. The client then
@@ -1469,7 +1488,7 @@ export interface Engram {
    * /
    * / Owner-only: only the engram owner can authorize a Connector install.
    */
-  issueAuthCode: ActorMethod<[string, string, string, [] | [string]], Result_51>;
+  issueAuthCode: ActorMethod<[string, string, string, [] | [string]], Result_52>;
   /**
    * / ⟨0.16.0⟩ `getCycleSnapshotSource` DELETED — folded into `CycleSnapshot.source`, one label per
    * / ROW. A single label for a whole ring misattributes every row recorded under the other source,
@@ -1485,7 +1504,7 @@ export interface Engram {
    * / DORMANT engram and corrupts retention math — a fabricated empty here does not just misinform a
    * / reader, it feeds a wrong number into a decision about destroying data.
    */
-  listActivitySnapshots: ActorMethod<[bigint, bigint], Result_50>;
+  listActivitySnapshots: ActorMethod<[bigint, bigint], Result_51>;
   /**
    * / ⟨2026-10-21, round 11 item l — the owner's answer "round 11: a, b, c, d, e, f, g, h, i, j, k, l,
    * / m."⟩ OWNER-ONLY: what each agent has spent today, beside the daily limit in force for it, so the
@@ -1504,7 +1523,7 @@ export interface Engram {
    * / WHAT WOULD MAKE THIS WRONG: `x402SignFor` keeping the per-caller total by something other than
    * / the calling key, or under another day boundary.
    */
-  listAgentSpendToday: ActorMethod<[bigint, bigint], Result_49>;
+  listAgentSpendToday: ActorMethod<[bigint, bigint], Result_50>;
   /**
    * / ⟨0.16.0⟩ THE PAGE EXEMPLAR. Trap → `#Refused`, bare array → `Result<Page<T>>` (L1 + L3).
    * /
@@ -1521,7 +1540,7 @@ export interface Engram {
    * / `withheld` is 0: this roster is owner-only in whole, so there is no partial-visibility case.
    * / A method that filters rows by caller sets it — see L1's row-level honesty rule.
    */
-  listAgents: ActorMethod<[bigint, bigint], Result_48>;
+  listAgents: ActorMethod<[bigint, bigint], Result_49>;
   /**
    * / The GUARDIAN-audience projection of the agent roster — three fields, not the full record.
    * /
@@ -1535,7 +1554,7 @@ export interface Engram {
    * / guardian consults BEFORE REVOKING ONE. A fabricated empty here does not merely misinform —
    * / it tells someone acting under emergency powers that there is nothing to act on.
    */
-  listAgentsForGuardian: ActorMethod<[bigint, bigint], Result_47>;
+  listAgentsForGuardian: ActorMethod<[bigint, bigint], Result_48>;
   /**
    * / Owner-only: rows carry caller, amount, operation and free-text rationale. The SDK omits it.
    * /
@@ -1549,7 +1568,7 @@ export interface Engram {
    * /
    * / Refusal reason preserved: `[]` reads as "nothing is awaiting the owner's decision".
    */
-  listApprovalRequests: ActorMethod<[[] | [ApprovalStatus], bigint, bigint], Result_33>;
+  listApprovalRequests: ActorMethod<[[] | [ApprovalStatus], bigint, bigint], Result_34>;
   /**
    * / ⟨0.16.0⟩ `total` IS THE HEAD COUNTER, and on this method that is the entire point.
    * /
@@ -1585,7 +1604,7 @@ export interface Engram {
    * / at read time; nothing new is stored. WHAT WOULD MAKE THIS WRONG: a sealed row carrying any part
    * / of a body, or a stranger reaching `items` (test/record-view.test.mo pins both).
    */
-  listAuditEntries: ActorMethod<[bigint, bigint], Result_46>;
+  listAuditEntries: ActorMethod<[bigint, bigint], Result_47>;
   /**
    * / ⟨0.16.0, L1 + L3 — census-ruled⟩ THE TWO-MECHANISM EXCEPTION DISSOLVES.
    * /
@@ -1611,7 +1630,7 @@ export interface Engram {
    * / keeps its optional filter and applies it to the page, so no caller loses the ability to ask
    * / "backups of this database" — it stops being a thing the canister has to page around.
    */
-  listBackups: ActorMethod<[bigint, bigint], Result_45>;
+  listBackups: ActorMethod<[bigint, bigint], Result_46>;
   /**
    * / List all bearer tokens — Active, Revoked, and Expired. Owner uses this in
    * / the dashboard to show installed Connectors (claude.ai, Claude Desktop, etc.).
@@ -1623,7 +1642,7 @@ export interface Engram {
    * / merely stopped being used is reported `#Expired`, not a stale `#Active`), so the page carries
    * / the same honesty the store gained on 2026-08-17.
    */
-  listBearerTokens: ActorMethod<[bigint, bigint], Result_44>;
+  listBearerTokens: ActorMethod<[bigint, bigint], Result_45>;
   /**
    * / The condense checkpoints in the retained log at or above `startSeq`, oldest first.
    * /
@@ -1635,7 +1654,7 @@ export interface Engram {
    * / Owner-only like every other archive surface, and for the same structural reason: these rows
    * / carry the chain positions and roots of entries whose paths were inside the hash preimage.
    */
-  listCondenseCheckpoints: ActorMethod<[bigint, bigint], Result_43>;
+  listCondenseCheckpoints: ActorMethod<[bigint, bigint], Result_44>;
   /**
    * / ⟨0.16.0⟩ `metrics()` DELETED — absorbed by `about()`.
    * /
@@ -1644,13 +1663,13 @@ export interface Engram {
    * / both and know which one owned each field. Every field here survives on `about()`, day-flooring
    * / included.
    */
-  listCycleSnapshots: ActorMethod<[bigint, bigint], Result_42>;
+  listCycleSnapshots: ActorMethod<[bigint, bigint], Result_43>;
   /**
    * / Same `withheld` treatment as listMemoryFiles — the tombstone listing filtered reserved paths
    * / for non-owners just as silently, and a caller could not tell a filtered tombstone list from a
    * / complete one. Counted before slicing, so policy-hidden rows never blur into paging.
    */
-  listDeletedMemoryFiles: ActorMethod<[bigint, bigint], Result_41>;
+  listDeletedMemoryFiles: ActorMethod<[bigint, bigint], Result_42>;
   /**
    * / Stays on the engram under B1 (hybrid): withdrawal custody does not leave.
    * /
@@ -1666,7 +1685,7 @@ export interface Engram {
    * / The item's field is `value`, not `address`: a list may hold a venue value that is no address.
    * / Readable by the owner, an active agent or an active guardian, as the old list was.
    */
-  listEip712Destinations: ActorMethod<[Uint8Array | number[], bigint, bigint], Result_40>;
+  listEip712Destinations: ActorMethod<[Uint8Array | number[], bigint, bigint], Result_41>;
   /**
    * / The registered shapes — E3: encodeTypeString is the display artifact, verbatim.
    * / Stays on the engram under B1 (hybrid): EIP-712 signing is custody, and custody does not leave.
@@ -1679,7 +1698,7 @@ export interface Engram {
    * / from `eip712FieldRules` — they are part of what the type authorises, so a reader of the list must
    * / not have to make a second call to learn them. The row type is `Eip712TypeView`.
    */
-  listEip712Types: ActorMethod<[bigint, bigint], Result_39>;
+  listEip712Types: ActorMethod<[bigint, bigint], Result_40>;
   /**
    * / ⟨2026-10-21, round 11 c⟩ Guardians' disputes, oldest first. Same visibility as
    * / `listRepudiations` and `listRecordNotes`: the owner and ACTIVE guardians read the rows; an
@@ -1687,7 +1706,7 @@ export interface Engram {
    * / guardian's entry, not the agent's); a stranger, a pending guardian and the anonymous caller are
    * / refused.
    */
-  listGuardianDisputes: ActorMethod<[bigint, bigint], Result_38>;
+  listGuardianDisputes: ActorMethod<[bigint, bigint], Result_39>;
   /**
    * / Accessible by owner and guardians.
    * /
@@ -1696,7 +1715,7 @@ export interface Engram {
    * / pause writes" — a claim about who can STOP it. A caller who cannot tell that from "you may not
    * / see the roster" has been told the engram is unguarded when it may be fully guarded.
    */
-  listGuardians: ActorMethod<[bigint, bigint], Result_37>;
+  listGuardians: ActorMethod<[bigint, bigint], Result_38>;
   /**
    * / The export receipts in the retained log at or above `startSeq`, oldest first.
    * /
@@ -1714,7 +1733,7 @@ export interface Engram {
    * / Read `MemoryRouter.ReceiptPage` before reading `page.total` as a receipt count. It is not one;
    * / it is the chain's length, and the declaration says why.
    */
-  listMemoryExportReceipts: ActorMethod<[bigint, bigint], Result_36>;
+  listMemoryExportReceipts: ActorMethod<[bigint, bigint], Result_37>;
   /**
    * / ⟨0.16.0⟩ THE `withheld` EXEMPLAR — L1 names this exact method as the defect it fixes.
    * /
@@ -1741,7 +1760,7 @@ export interface Engram {
    * / row served, never one per file stored. A WIDENED REPLY: a reader that decodes the row by
    * / position rather than by field name breaks — none in this repository does.
    */
-  listMemoryFiles: ActorMethod<[bigint, bigint], Result_35>;
+  listMemoryFiles: ActorMethod<[bigint, bigint], Result_36>;
   /**
    * / One page of the memory log, seq-ordered, optionally narrowed to one author.
    * /
@@ -1768,7 +1787,7 @@ export interface Engram {
    * / with the disclosures that make the page verifiable — the hidden-bound defect the census itself
    * / names on previewCondense's row.
    */
-  listMemoryLog: ActorMethod<[bigint, bigint, [] | [Principal]], Result_34>;
+  listMemoryLog: ActorMethod<[bigint, bigint, [] | [Principal]], Result_35>;
   /**
    * / The caller's OWN spend-approval requests. ⟨0.16.0, L1 + L3 — fixed 2026-08-18⟩
    * /
@@ -1787,7 +1806,7 @@ export interface Engram {
    * / (The unbounded MAP is filed separately — pruning an approval record destroys evidence of what
    * / was asked, which is a retention ruling rather than a shape fix.)
    */
-  listMyApprovalRequests: ActorMethod<[bigint, bigint], Result_33>;
+  listMyApprovalRequests: ActorMethod<[bigint, bigint], Result_34>;
   /**
    * / The payer's own sessions, live ones first. PAYER-SCOPED: a caller sees only their own, which
    * / is why this needs no role — a session id is not a secret from the person who paid for it.
@@ -1798,7 +1817,7 @@ export interface Engram {
    * / client would break on — the market paged its own pending withdrawals before its cut for the
    * / same reason. The order is the order sessions were opened.
    */
-  listMySessions: ActorMethod<[bigint, bigint], Result_32>;
+  listMySessions: ActorMethod<[bigint, bigint], Result_33>;
   /**
    * /
    * / ⟨0.16.0, L3⟩ Paged and enveloped like every other `list*`, and the envelope here is uniformity
@@ -1813,7 +1832,7 @@ export interface Engram {
    * / IT recorded, so this chain is what a caller composes with when currency matters — which it
    * / cannot do if it needs a role here.
    */
-  listOwnershipTransfers: ActorMethod<[bigint, bigint], Result_31>;
+  listOwnershipTransfers: ActorMethod<[bigint, bigint], Result_32>;
   /**
    * / ⟨2026-09-29, the platform's question from the build review⟩ OWNER-ONLY: how many payment
    * / signatures each agent has obtained today, and the daily limit (200, `PaymentSignCap`). The
@@ -1831,7 +1850,7 @@ export interface Engram {
    * / engram enforces for it — beside the agents, never a row among them
    * / (`PaymentSignCap.marketplaceRow`). Null when no marketplace is set.
    */
-  listPaymentSignatureCounts: ActorMethod<[bigint, bigint], Result_30>;
+  listPaymentSignatureCounts: ActorMethod<[bigint, bigint], Result_31>;
   /**
    * / Agent records removed by a reset. Each row is a NAMED record with the fields `principal`,
    * / `name`, `registeredAt` and `purgedAt` — read them BY NAME, never by position.
@@ -1873,7 +1892,7 @@ export interface Engram {
    * / earlier ending, or the reset) — the facts `resyncAgentEdges` re-sends. The stored rows are
    * / served as they are.
    */
-  listPurgedAgents: ActorMethod<[bigint, bigint], Result_29>;
+  listPurgedAgents: ActorMethod<[bigint, bigint], Result_30>;
   /**
    * / ⟨0.16.0⟩ ONE ACCESSOR, folding `readReadLog` and `getDenialLog` — and the fold only became
    * / safe because of a change made earlier in this same leg.
@@ -1936,7 +1955,7 @@ export interface Engram {
    * / on the chained record — the same `RecordView` filter, and `withheld` counts what it removed
    * / together with what `successFilter` removed. WHAT WOULD MAKE THIS WRONG: see `listAuditEntries`.
    */
-  listReadLog: ActorMethod<[[] | [boolean], bigint, bigint], Result_28>;
+  listReadLog: ActorMethod<[[] | [boolean], bigint, bigint], Result_29>;
   /**
    * / ⟨2026-10-21, round 11 b⟩ The owner's notes, oldest first. Same visibility as
    * / `listRepudiations`, for the same reason: the owner and ACTIVE guardians read the rows; an agent
@@ -1944,7 +1963,7 @@ export interface Engram {
    * / gets an empty page whose `withheld` counts the notes in its window — never "there are none". A
    * / stranger, a pending guardian and the anonymous caller are refused.
    */
-  listRecordNotes: ActorMethod<[bigint, bigint], Result_27>;
+  listRecordNotes: ActorMethod<[bigint, bigint], Result_28>;
   /**
    * / Same visibility as listAuditEntries: the owner, this engram's agents, and ACTIVE guardians
    * / see disputes. An unauthorized read REFUSES — it does not return an empty list, because an
@@ -1961,7 +1980,7 @@ export interface Engram {
    * / WOULD MAKE THIS WRONG: a ruling that an agent may see the disputes of its own writes; this would
    * / then have to look up each disputed version's writer, which it does not do today.
    */
-  listRepudiations: ActorMethod<[bigint, bigint], Result_26>;
+  listRepudiations: ActorMethod<[bigint, bigint], Result_27>;
   /**
    * / ⟨2026-10-21, the owner's round-11 answer f⟩ OWNER-ONLY: the sign-ins, each with the name its app
    * / registered. The same tokens, in the same order and paged the same way, as `listBearerTokens`,
@@ -1972,7 +1991,7 @@ export interface Engram {
    * / and `listBearerTokens`' reply is shipped (never widened). An agent, a guardian, a stranger and
    * / the anonymous caller are refused, by `listBearerTokens`' own gate and for its reason.
    */
-  listSignIns: ActorMethod<[bigint, bigint], Result_25>;
+  listSignIns: ActorMethod<[bigint, bigint], Result_26>;
   /**
    * / Owner: advance the review cursor — "I have seen everything up to and including uptoAuditId"
    * / (null = everything at the current head). Bounded so the attestation can never cover entries
@@ -1984,7 +2003,7 @@ export interface Engram {
    * / and this never inspects an operation or a role. Widening what the review shows therefore
    * / changes only which ids the console can pass here — it cannot desynchronise the cursor.
    */
-  markAgentWritesReviewed: ActorMethod<[[] | [bigint]], Result_12>;
+  markAgentWritesReviewed: ActorMethod<[[] | [bigint]], Result_13>;
   /**
    * / ⟨2026-10-21, the owner's round-11 answer g⟩ AN AGENT READS ITS OWN GRANT — to the calling key
    * / only (`People.AgentGrant`): what it may read, where it may write, its rate, and the payment
@@ -1997,7 +2016,7 @@ export interface Engram {
    * / "Agent has resigned" — an ended agent may do nothing, and its old grant would read as powers),
    * / a guardian and a stranger ("Not authorized"), the anonymous caller. A query: it writes nothing.
    */
-  myGrant: ActorMethod<[], Result_24>;
+  myGrant: ActorMethod<[], Result_25>;
   /**
    * / The AGENT's current key nominates the key that will replace it. Nothing moves yet: the new
    * / key must accept, by its own call, within 24 hours (`acceptAgentKeyNomination`). One pending
@@ -2036,8 +2055,8 @@ export interface Engram {
    * / WHAT WOULD MAKE THIS WRONG: an await added between `ChildAllowance.take` and the registry call; the
    * / registry's `CHILD_MIN_ATTACHED_CYCLES` moving without `CHILD_ATTACH_CYCLES`.
    */
-  openChildEngram: ActorMethod<[], Result_23>;
-  openSession: ActorMethod<[SessionConfig, PaymentSignature], Result_22>;
+  openChildEngram: ActorMethod<[], Result_24>;
+  openSession: ActorMethod<[SessionConfig, PaymentSignature], Result_23>;
   /**
    * / Withdraw tokens to the owner's principal. This is the ONLY way to
    * / move tokens out of the engram to an external address, and the
@@ -2045,7 +2064,7 @@ export interface Engram {
    * / NOT freeze-gated: the owner always controls their own funds.
    * / Guardian freeze only blocks agent/public operations.
    */
-  ownerWithdraw: ActorMethod<[TokenAmount, [] | [ActionAuth]], Result_12>;
+  ownerWithdraw: ActorMethod<[TokenAmount, [] | [ActionAuth]], Result_13>;
   /**
    * / ⟨0.16.0⟩ `payRentFromEarnings` DELETED — ruled TWICE (B1 and B2), and it was the single
    * / clearest violation of the OSS/platform split in this repo.
@@ -2102,7 +2121,7 @@ export interface Engram {
    * / engagement on the agent's track record, and what to do. Before, the reply was `#Ok` with the
    * / record alone even when the registry had refused the start, so the agent was never told.
    */
-  pairAgent: ActorMethod<[{ enrolment: Enrolment; code: string }], Result_21>;
+  pairAgent: ActorMethod<[{ enrolment: Enrolment; code: string }], Result_22>;
   /**
    * / ⟨0.16.0, L2.2 — renamed from `guardianPauseWrites`⟩ Same correction as freezePayments above:
    * / owner-or-guardian, and `resumeWrites` never carried the prefix either.
@@ -2133,7 +2152,7 @@ export interface Engram {
    * / `unlocked` is the export-receipt gate ONLY. It is not a promise the condense will land: the
    * / history-budget delta is checked at commit time and can still refuse a short prefix.
    */
-  previewCondense: ActorMethod<[bigint], Result_20>;
+  previewCondense: ActorMethod<[bigint], Result_21>;
   /**
    * / A quote for a session this caller has not opened and is not committed to — the intent a
    * / buyer signs against. Pure dry run, no state, no funds.
@@ -2182,7 +2201,7 @@ export interface Engram {
    * / HONEST WHEN CUT SHORT: `complete = false` when the planning budget
    * / (`MemoryRouter.PREVIEW_MAX_DROPS`) ran out — the totals are then a floor, and say so.
    */
-  previewRetention: ActorMethod<[Array<[string, RetentionClassSpec]>], Result_19>;
+  previewRetention: ActorMethod<[Array<[string, RetentionClassSpec]>], Result_20>;
   /**
    * / Read one memory file at its current version.
    * /
@@ -2199,7 +2218,7 @@ export interface Engram {
    * / (`sessionReadContext` and the MCP reads). A caller measuring engram usage from this method
    * / will measure nothing.
    */
-  readMemory: ActorMethod<[string], Result_10>;
+  readMemory: ActorMethod<[string], Result_11>;
   /**
    * / Read many paths in one call. Per-path Results are KEPT — partial success is the point, and
    * / one unreadable path must not fail the other nine.
@@ -2217,7 +2236,7 @@ export interface Engram {
    * / path, each with its own Result — a refused RESERVED path sits beside a readable one, which is
    * / a genuine per-path fact.
    */
-  readMemoryBatch: ActorMethod<[Array<string>], Result_18>;
+  readMemoryBatch: ActorMethod<[Array<string>], Result_19>;
   /**
    * / ⟨0.16.0⟩ `getMemoryRetentionGuards` DELETED — folded into `getMemoryRetentionPolicy` above.
    * / It was the second L2.1 array-returning `get*`, and separating it from the policy it modifies
@@ -2229,7 +2248,7 @@ export interface Engram {
    * / see it cannot know whether it has the whole range, which is how silent truncation gets
    * / reintroduced. Loop while `more` is true, advancing by the bytes actually returned.
    */
-  readMemoryBytes: ActorMethod<[string, bigint, bigint, [] | [bigint]], Result_17>;
+  readMemoryBytes: ActorMethod<[string, bigint, bigint, [] | [bigint]], Result_18>;
   /**
    * / The escrow exit for a session whose settle cannot pay.
    * /
@@ -2294,7 +2313,7 @@ export interface Engram {
    * / the amount can be read back — a session closed in the same moment as the recovery and cleaned up
    * / during its transfer — it answers `#Other` naming the block, never a guessed amount.
    */
-  recoverEscrow: ActorMethod<[string, bigint], Result_16>;
+  recoverEscrow: ActorMethod<[string, bigint], Result_17>;
   /**
    * / ⟨0.16.0, L1⟩ A REDEMPTION PATH, where the arm choice is a disclosure decision.
    * /
@@ -2310,7 +2329,7 @@ export interface Engram {
    * / owner's invite gave them and that they cannot act until approved; before, that took a second
    * / read they had no reason to know to make.
    */
-  registerGuardian: ActorMethod<[string], Result_15>;
+  registerGuardian: ActorMethod<[string], Result_16>;
   /**
    * / Remove a per-caller override so that caller reverts to — and keeps TRACKING — the global caps.
    * /
@@ -2367,7 +2386,7 @@ export interface Engram {
    * / the original audit entry stay exactly where they were; this appends a chained
    * / `memory.repudiate` entry and lists the (path, version) so readers can see the dispute.
    */
-  repudiateMemoryWrite: ActorMethod<[string, bigint, string], Result_12>;
+  repudiateMemoryWrite: ActorMethod<[string, bigint, string], Result_13>;
   /**
    * / ⚠ OWNER-ONLY BULK RESET. Destructive, and wider than its name suggests.
    * /
@@ -2397,7 +2416,7 @@ export interface Engram {
    * / long-lived enough for the rent model to apply, the reset entry is not guaranteed to still be
    * / there. `agentPurgeLog` is the evidence that does not age out — which is why it exists.
    */
-  resetEngram: ActorMethod<[], Result_14>;
+  resetEngram: ActorMethod<[], Result_15>;
   /**
    * / ⟨2026-09-28, owner decision: an agent can resign from an engram, and the resignation is
    * / recorded⟩ The AGENT ends its own engagement with this engram.
@@ -2449,7 +2468,7 @@ export interface Engram {
    * / each such engagement under `cannotBeRecorded` (key, root, invite, and how and when it ended),
    * / apart from `notRecorded`, so the owner sees them rather than silence.
    */
-  resyncAgentEdges: ActorMethod<[], Result_13>;
+  resyncAgentEdges: ActorMethod<[], Result_14>;
   /**
    * / Return to managed custody: the engram adds the registry back as a controller ALONGSIDE the
    * / owner — it does not remove the owner. The inverse of `claimSovereignty`, and the reason
@@ -2511,7 +2530,7 @@ export interface Engram {
    * / that fails leaves the agents revoked here regardless — a partial notify is not a partial
    * / revocation, which is the direction that matters for a panic button.
    */
-  revokeAllAgents: ActorMethod<[], Result_12>;
+  revokeAllAgents: ActorMethod<[], Result_13>;
   /**
    * / Owner-only panic button: revoke every connector bearer token at once. Returns how many.
    * /
@@ -2522,7 +2541,7 @@ export interface Engram {
    * /
    * / Tokens are re-issuable: revoking them is not permanent the way revoking an agent is.
    */
-  revokeAllBearerTokens: ActorMethod<[], Result_12>;
+  revokeAllBearerTokens: ActorMethod<[], Result_13>;
   /**
    * / ⟨0.16.0⟩ `removeAllGuardians` DELETED — test-only (L6), and verified NOT part of KILL-SWITCH's
    * / mass-revoke set. The destructive phase-07 suite iterates `removeGuardian` instead, so nothing
@@ -2536,7 +2555,7 @@ export interface Engram {
    * / Unlike revoking an agent, this costs nothing permanently — an invite is a one-time code,
    * / so voiding it and minting a fresh one is the ordinary path.
    */
-  revokeAllInvites: ActorMethod<[], Result_12>;
+  revokeAllInvites: ActorMethod<[], Result_13>;
   /**
    * / Revoke a bearer token by its public tokenId. Idempotent.
    * / Subsequent /mcp requests using this token will be rejected.
@@ -2615,7 +2634,7 @@ export interface Engram {
    * / CIPHERTEXT; the key-holding SDK decrypts it. A caller without the key gets bytes it cannot
    * / read, not an error.
    */
-  sessionReadContext: ActorMethod<[string], Result_11>;
+  sessionReadContext: ActorMethod<[string], Result_12>;
   /**
    * / Read one memory file against a PAID x402 session voucher. No role, no invite — the voucher is
    * / the authorization, which is what makes this the engram's one rail a stranger can pay to use.
@@ -2647,7 +2666,7 @@ export interface Engram {
    * /     cent voucher could read `secrets/*`.
    * /   · Payments are frozen on this engram.
    */
-  sessionReadMemory: ActorMethod<[Voucher, string], Result_10>;
+  sessionReadMemory: ActorMethod<[Voucher, string], Result_11>;
   /**
    * / Configure action alerts: an https webhook that receives new chained-audit entries matching the
    * / enabled event classes (money / approvals / guardian / agentWrites), batched, at most one
@@ -2700,7 +2719,7 @@ export interface Engram {
    * / across all of them. "The write is the read" above went stale for a second phone, which never
    * / made the write: `getBackupRetention` is the read.
    */
-  setBackupRetention: ActorMethod<[string, bigint], Result_9>;
+  setBackupRetention: ActorMethod<[string, bigint], Result_10>;
   /**
    * / Override the caps for ONE caller — an agent this owner trusts more, or less, than the rest.
    */
@@ -2961,7 +2980,7 @@ export interface Engram {
         maxPriorityFeePerGas: bigint;
       },
     ],
-    Result_8
+    Result_9
   >;
   /**
    * / Sign an EIP-3009 authorization for x402 payment. Agent-accessible.
@@ -3062,7 +3081,7 @@ export interface Engram {
    * / class (`SeatWeeks.readRefusal`), never an empty list: an empty list is a real answer ("no agent
    * / has paired here"), and a fabricated one would be counted as one.
    */
-  sysGetAgentSeatWeeks: ActorMethod<[], Result_7>;
+  sysGetAgentSeatWeeks: ActorMethod<[], Result_8>;
   /**
    * / The metrics reader the registry designated reads this engram's paid-rail health, in one call:
    * / the balance and the line it must stay above, the memory that line is computed from, the sessions
@@ -3086,7 +3105,7 @@ export interface Engram {
    * / to freeze. Called by another canister, a query runs replicated and this engram pays for it —
    * / a few million cycles an hour, the cost of being watched.
    */
-  sysGetRailHealth: ActorMethod<[], Result_6>;
+  sysGetRailHealth: ActorMethod<[], Result_7>;
   /**
    * / The cashier reads how many signatures this engram has produced, per caller and in total.
    * / ⟨2026-09-28⟩ The owner's decision of that date: a running counter on the engram, exported to
@@ -3111,7 +3130,20 @@ export interface Engram {
    * / only engrams the registry confirms run published code, and read a lower count than last time as
    * / a reinstall — the reasoning is at `signaturesByCaller`.
    */
-  sysGetSignatureCounts: ActorMethod<[], Result_5>;
+  sysGetSignatureCounts: ActorMethod<[], Result_6>;
+  /**
+   * / Note a restart the registry just made: what this engram owes for it, the floor a repayment may
+   * / not go under, and until when to keep its timers quiet.
+   * /
+   * / CALLER: the registry that spawned this engram, from inside its owner's `restartMyStoppedEngram`,
+   * / and nobody else (ADR-0020) — the same authority as `sysSetBillerId`. The owner's next conversion
+   * / that lands pays the loan back first. The loan is capped at `RestartRepay.LOAN_MAX_CYCLES` and
+   * / the quiet window at 30 minutes, whatever the registry says.
+   */
+  sysNoteRestart: ActorMethod<
+    [{ keepCycles: bigint; loan: bigint; quietUntilNs: bigint }],
+    Result_1
+  >;
   /**
    * / Rent lifecycle notice — how the OWNER (not the agent) learns their subscription lapsed. D6
    * / shipped the handoff but every alarm it added talks to the operating service's watchdog; the
@@ -3200,6 +3232,28 @@ export interface Engram {
     ],
     Result_1
   >;
+  /**
+   * / Give back what a paid security update advanced this engram and the install did not use.
+   * /
+   * / CALLER: the registry that spawned this engram, right after it installed a security update it
+   * / paid for, and nobody else (ADR-0020). Sends the smallest of: the advance, what this engram holds
+   * / above its balance before the update, and what sits above its 30-day reserve plus send headroom
+   * / (`RestartRepay.giveBack`) — attached to the registry's `sysRepayUpgradeAdvance`, which accepts no
+   * / more than it advanced. The registry writes off what is not returned; nothing is owed after.
+   * / ⟨2026-10-26, the owner's review choice 1B: "take back only what we added; anything left over goes
+   * / to the 90-day write-off"⟩ The registry now names the ONE advance it is asking for (`advanceId`,
+   * / the one its deposit for this install put on its ledger) and `advance` is that advance's amount
+   * / alone — never the sum of every advance this engram has out. The engram passes the id back to
+   * / `sysRepayUpgradeAdvance` unchanged, and the registry settles that advance only. The engram's own
+   * / caps are unchanged (`RestartRepay.giveBack`). HONEST LIMIT, unchanged by 1B: the engram cannot
+   * / tell its owner's top-up from the unused advance, so when the install used part of the advance and
+   * / the owner added compute meanwhile, up to the part the install used can still come from the
+   * / owner's top-up (the cap is the advance, not its unused part).
+   */
+  sysReturnUpgradeAdvance: ActorMethod<
+    [{ balanceBefore: bigint; advanceId: bigint; advance: bigint }],
+    Result_5
+  >;
   /**
    * / Point this engram at the biller that converts its tokens → cycles. Settable, not hardcoded:
    * / coupling is by principal id, so the same wasm runs against any deployment's biller.
@@ -3218,6 +3272,23 @@ export interface Engram {
    * / rather than telling an owner to run a call they can no longer make.
    */
   sysSetBillerId: ActorMethod<[Principal], Result_1>;
+  /**
+   * / Give this engram its BIRTH CHAIN: its ancestors' birth records and its own, root first, its own
+   * / last ⟨2026-10-26, the owner's lineage rulings L2C-lite and L3A⟩.
+   * /
+   * / CALLER: the registry that spawned this engram, from its birth push or its sweep's retry, and
+   * / nobody else (ADR-0020) — the same authority as `sysSetBillerId`, through the named gate
+   * / `AccessControl.requireSpawningRegistry`. ⚠ THE REGISTRY'S CLIENT DECLARATION IS HAND-WRITTEN
+   * / (`sysSetBirthChain : ([BirthRecord.BirthRecord]) -> async Wire.Result<()>`, in `mintAndPush`): a
+   * / different reply type here traps inside the registry's callback, and a different name leaves every
+   * / newborn without its record, silently retried. test/lineage-wiring.test.ts holds the two equal.
+   * /
+   * / SET ONCE: the same chain again answers `#Ok` and changes nothing (the registry's sweep may re-send
+   * / a push whose reply was lost); a different one is refused `#Conflict`. THE ENGRAM DOES NOT HASH:
+   * / it checks only that the chain ends with its own record. The fingerprints are the registry's to
+   * / certify and the client's `verifyBirthChain` to check.
+   */
+  sysSetBirthChain: ActorMethod<[Array<BirthRecord>], Result_1>;
   /**
    * / Point this engram at the commerce satellite allowed to ask it for signatures. ⟨0.16.0, B1⟩
    * /
@@ -3247,7 +3318,10 @@ export interface Engram {
    * / A CANISTER ONLY: a person's principal, the anonymous principal or the management canister is
    * / refused `#Invalid` and nothing changes — a person named here would be handed this engram's seat
    * / counts. Set or replaced, never cleared: the owner's control is the switch
-   * / (`setSeatWeeksReadEnabled`), not the pointer. The chained record entry
+   * / (`setSeatWeeksReadEnabled`), not the pointer.
+   * / ⟨CORRECTED 2026-10-26, the owner's lineage ruling L6A⟩ "Set or replaced" is no longer true: it is
+   * / SET ONCE. The same reader again answers `#Ok` and changes nothing; another is refused `#Conflict`
+   * / (`AccessControl.setOnce` says why). Still never cleared. The chained record entry
    * / (`metrics.sysSetMetricsReaderId`) is the evidence of when the read was granted, and to whom.
    */
   sysSetMetricsReaderId: ActorMethod<[Principal], Result_1>;
@@ -3906,84 +3980,86 @@ export interface ResetReport {
 }
 export type Result = { Ok: WriteReceipt } | { Err: Error };
 export type Result_1 = { Ok: null } | { Err: Error };
-export type Result_10 = { Ok: MemoryFile } | { Err: Error };
-export type Result_11 = { Ok: SessionContext } | { Err: Error };
-export type Result_12 = { Ok: bigint } | { Err: Error };
-export type Result_13 = { Ok: ResyncReport } | { Err: Error };
-export type Result_14 = { Ok: ResetReport } | { Err: Error };
-export type Result_15 = { Ok: GuardianRecord } | { Err: Error };
-export type Result_16 = { Ok: EngramEscrowRecovery } | { Err: Error };
-export type Result_17 = { Ok: MemoryByteChunk } | { Err: Error };
-export type Result_18 = { Ok: Array<BatchReadItem> } | { Err: Error };
-export type Result_19 = { Ok: RetentionPreview } | { Err: Error };
+export type Result_10 = { Ok: BackupRetentionReport } | { Err: Error };
+export type Result_11 = { Ok: MemoryFile } | { Err: Error };
+export type Result_12 = { Ok: SessionContext } | { Err: Error };
+export type Result_13 = { Ok: bigint } | { Err: Error };
+export type Result_14 = { Ok: ResyncReport } | { Err: Error };
+export type Result_15 = { Ok: ResetReport } | { Err: Error };
+export type Result_16 = { Ok: GuardianRecord } | { Err: Error };
+export type Result_17 = { Ok: EngramEscrowRecovery } | { Err: Error };
+export type Result_18 = { Ok: MemoryByteChunk } | { Err: Error };
+export type Result_19 = { Ok: Array<BatchReadItem> } | { Err: Error };
 export type Result_2 = { Ok: ControlHandover } | { Err: Error };
-export type Result_20 = { Ok: CondensePreview } | { Err: Error };
-export type Result_21 = { Ok: Pairing } | { Err: Error };
-export type Result_22 = { Ok: EngramSessionState } | { Err: Error };
-export type Result_23 = { Ok: Principal } | { Err: Error };
-export type Result_24 = { Ok: AgentGrant } | { Err: Error };
-export type Result_25 = { Ok: Page } | { Err: Error };
-export type Result_26 = { Ok: Page_1 } | { Err: Error };
-export type Result_27 = { Ok: Page_2 } | { Err: Error };
-export type Result_28 = { Ok: Page_3 } | { Err: Error };
-export type Result_29 = { Ok: Page_4 } | { Err: Error };
+export type Result_20 = { Ok: RetentionPreview } | { Err: Error };
+export type Result_21 = { Ok: CondensePreview } | { Err: Error };
+export type Result_22 = { Ok: Pairing } | { Err: Error };
+export type Result_23 = { Ok: EngramSessionState } | { Err: Error };
+export type Result_24 = { Ok: Principal } | { Err: Error };
+export type Result_25 = { Ok: AgentGrant } | { Err: Error };
+export type Result_26 = { Ok: Page } | { Err: Error };
+export type Result_27 = { Ok: Page_1 } | { Err: Error };
+export type Result_28 = { Ok: Page_2 } | { Err: Error };
+export type Result_29 = { Ok: Page_3 } | { Err: Error };
 export type Result_3 = { Ok: X402SignOutcome } | { Err: Error };
-export type Result_30 = { Ok: PaymentSignatureCounts } | { Err: Error };
-export type Result_31 = { Ok: Page_6 } | { Err: Error };
-export type Result_32 = { Ok: Page_7 } | { Err: Error };
-export type Result_33 = { Ok: Page_8 } | { Err: Error };
-export type Result_34 = { Ok: LogPage } | { Err: Error };
-export type Result_35 = { Ok: Page_10 } | { Err: Error };
-export type Result_36 = { Ok: ReceiptPage } | { Err: Error };
-export type Result_37 = { Ok: Page_12 } | { Err: Error };
-export type Result_38 = { Ok: Page_13 } | { Err: Error };
-export type Result_39 = { Ok: Page_14 } | { Err: Error };
+export type Result_30 = { Ok: Page_4 } | { Err: Error };
+export type Result_31 = { Ok: PaymentSignatureCounts } | { Err: Error };
+export type Result_32 = { Ok: Page_6 } | { Err: Error };
+export type Result_33 = { Ok: Page_7 } | { Err: Error };
+export type Result_34 = { Ok: Page_8 } | { Err: Error };
+export type Result_35 = { Ok: LogPage } | { Err: Error };
+export type Result_36 = { Ok: Page_10 } | { Err: Error };
+export type Result_37 = { Ok: ReceiptPage } | { Err: Error };
+export type Result_38 = { Ok: Page_12 } | { Err: Error };
+export type Result_39 = { Ok: Page_13 } | { Err: Error };
 export type Result_4 = { Ok: Eip712SignatureOut } | { Err: Error };
-export type Result_40 = { Ok: Page_15 } | { Err: Error };
-export type Result_41 = { Ok: Page_16 } | { Err: Error };
-export type Result_42 = { Ok: Page_17 } | { Err: Error };
-export type Result_43 = { Ok: CheckpointPage } | { Err: Error };
-export type Result_44 = { Ok: Page_19 } | { Err: Error };
-export type Result_45 = { Ok: Page_20 } | { Err: Error };
-export type Result_46 = { Ok: RecordPage } | { Err: Error };
-export type Result_47 = { Ok: Page_21 } | { Err: Error };
-export type Result_48 = { Ok: Page_22 } | { Err: Error };
-export type Result_49 = { Ok: AgentSpendToday } | { Err: Error };
-export type Result_5 = { Ok: SignatureCounts } | { Err: Error };
-export type Result_50 = { Ok: Page_24 } | { Err: Error };
-export type Result_51 = { Ok: string } | { Err: Error };
-export type Result_52 = { Ok: boolean } | { Err: Error };
-export type Result_53 = { Ok: [] | [string] } | { Err: Error };
-export type Result_54 = { Ok: WorldIdRpContext } | { Err: Error };
-export type Result_55 = { Ok: WorldIdConfig } | { Err: Error };
-export type Result_56 = { Ok: WalletBalances } | { Err: Error };
-export type Result_57 = { Ok: StorageReport } | { Err: Error };
-export type Result_58 = { Ok: SpendingPolicy } | { Err: Error };
-export type Result_59 = { Ok: SpendCeiling } | { Err: Error };
-export type Result_6 = { Ok: RailHealth } | { Err: Error };
-export type Result_60 = { Ok: SigningFloorStatus } | { Err: Error };
-export type Result_61 = { Ok: { paths: Array<string> } } | { Err: Error };
-export type Result_62 = { Ok: OwnerConsole } | { Err: Error };
-export type Result_63 = { Ok: MemoryRetentionPolicy } | { Err: Error };
-export type Result_64 = { Ok: MemoryHistory } | { Err: Error };
-export type Result_65 = { Ok: AlertStatus } | { Err: Error };
-export type Result_66 = { Ok: EvmAddresses } | { Err: Error };
-export type Result_67 = { Ok: Uint8Array | number[] } | { Err: Error };
-export type Result_68 = { Ok: ChildOpening } | { Err: Error };
-export type Result_69 = { Ok: ChildAllowanceRow } | { Err: Error };
-export type Result_7 = { Ok: Array<Seat> } | { Err: Error };
-export type Result_70 = { Ok: Brakes } | { Err: Error };
-export type Result_71 = { Ok: BackupRetention } | { Err: Error };
-export type Result_72 = { Ok: BackupMetadata } | { Err: Error };
-export type Result_73 = { Ok: AgentWriteReview } | { Err: Error };
-export type Result_74 = { Ok: Page_25 } | { Err: Error };
-export type Result_76 = { Ok: MemoryRangeExport } | { Err: Error };
-export type Result_77 = { Ok: CondenseResult } | { Err: Error };
-export type Result_78 = { Ok: Eip712Registration } | { Err: Error };
-export type Result_79 = { Ok: { activatesAtNs: bigint } } | { Err: Error };
-export type Result_8 = { Ok: SignedTransaction } | { Err: Error };
-export type Result_80 = { Ok: AgentRecord } | { Err: Error };
-export type Result_9 = { Ok: BackupRetentionReport } | { Err: Error };
+export type Result_40 = { Ok: Page_14 } | { Err: Error };
+export type Result_41 = { Ok: Page_15 } | { Err: Error };
+export type Result_42 = { Ok: Page_16 } | { Err: Error };
+export type Result_43 = { Ok: Page_17 } | { Err: Error };
+export type Result_44 = { Ok: CheckpointPage } | { Err: Error };
+export type Result_45 = { Ok: Page_19 } | { Err: Error };
+export type Result_46 = { Ok: Page_20 } | { Err: Error };
+export type Result_47 = { Ok: RecordPage } | { Err: Error };
+export type Result_48 = { Ok: Page_21 } | { Err: Error };
+export type Result_49 = { Ok: Page_22 } | { Err: Error };
+export type Result_5 = { Ok: { returned: bigint } } | { Err: Error };
+export type Result_50 = { Ok: AgentSpendToday } | { Err: Error };
+export type Result_51 = { Ok: Page_24 } | { Err: Error };
+export type Result_52 = { Ok: string } | { Err: Error };
+export type Result_53 = { Ok: boolean } | { Err: Error };
+export type Result_54 = { Ok: [] | [string] } | { Err: Error };
+export type Result_55 = { Ok: WorldIdRpContext } | { Err: Error };
+export type Result_56 = { Ok: WorldIdConfig } | { Err: Error };
+export type Result_57 = { Ok: WalletBalances } | { Err: Error };
+export type Result_58 = { Ok: StorageReport } | { Err: Error };
+export type Result_59 = { Ok: SpendingPolicy } | { Err: Error };
+export type Result_6 = { Ok: SignatureCounts } | { Err: Error };
+export type Result_60 = { Ok: SpendCeiling } | { Err: Error };
+export type Result_61 = { Ok: SigningFloorStatus } | { Err: Error };
+export type Result_62 = { Ok: { paths: Array<string> } } | { Err: Error };
+export type Result_63 = { Ok: OwnerConsole } | { Err: Error };
+export type Result_64 = { Ok: MemoryRetentionPolicy } | { Err: Error };
+export type Result_65 = { Ok: MemoryHistory } | { Err: Error };
+export type Result_66 = { Ok: AlertStatus } | { Err: Error };
+export type Result_67 = { Ok: EvmAddresses } | { Err: Error };
+export type Result_68 = { Ok: Uint8Array | number[] } | { Err: Error };
+export type Result_69 = { Ok: ChildOpening } | { Err: Error };
+export type Result_7 = { Ok: RailHealth } | { Err: Error };
+export type Result_70 = { Ok: ChildAllowanceRow } | { Err: Error };
+export type Result_71 = { Ok: Brakes } | { Err: Error };
+export type Result_72 = { Ok: Array<BirthRecord> } | { Err: Error };
+export type Result_73 = { Ok: BackupRetention } | { Err: Error };
+export type Result_74 = { Ok: BackupMetadata } | { Err: Error };
+export type Result_75 = { Ok: AgentWriteReview } | { Err: Error };
+export type Result_76 = { Ok: Page_25 } | { Err: Error };
+export type Result_78 = { Ok: MemoryRangeExport } | { Err: Error };
+export type Result_79 = { Ok: CondenseResult } | { Err: Error };
+export type Result_8 = { Ok: Array<Seat> } | { Err: Error };
+export type Result_80 = { Ok: Eip712Registration } | { Err: Error };
+export type Result_81 = { Ok: { activatesAtNs: bigint } } | { Err: Error };
+export type Result_82 = { Ok: AgentRecord } | { Err: Error };
+export type Result_9 = { Ok: SignedTransaction } | { Err: Error };
 export interface ResyncReport {
   startsAcknowledged: bigint;
   cannotBeRecorded: Array<UnrecordableEngagement>;