@engramx/idl 0.16.0-rc.15 → 0.16.0-rc.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/engram.did +613 -184
- package/dist/engram.idl.d.ts +577 -178
- package/dist/engram.idl.js +348 -184
- package/dist/registry.did +351 -73
- package/dist/registry.idl.d.ts +334 -73
- package/dist/registry.idl.js +113 -47
- package/package.json +1 -1
package/dist/engram.idl.d.ts
CHANGED
|
@@ -54,6 +54,12 @@ export interface AgentEnding {
|
|
|
54
54
|
day: bigint;
|
|
55
55
|
reason: AgentEndReason;
|
|
56
56
|
}
|
|
57
|
+
export interface AgentGrant {
|
|
58
|
+
key: Principal;
|
|
59
|
+
permissions: AgentPermissions;
|
|
60
|
+
name: string;
|
|
61
|
+
paymentLimits: PaymentLimits;
|
|
62
|
+
}
|
|
57
63
|
export interface AgentPaymentSignatures {
|
|
58
64
|
agent: Principal;
|
|
59
65
|
signedToday: bigint;
|
|
@@ -84,6 +90,16 @@ export interface AgentRecord {
|
|
|
84
90
|
keyRotatedAtNs: bigint;
|
|
85
91
|
keyHeldFrom: LogPosition;
|
|
86
92
|
}
|
|
93
|
+
export interface AgentSpendRow {
|
|
94
|
+
agent: Principal;
|
|
95
|
+
spentToday: [] | [bigint];
|
|
96
|
+
root: Principal;
|
|
97
|
+
maxPerDay: [] | [bigint];
|
|
98
|
+
}
|
|
99
|
+
export interface AgentSpendToday {
|
|
100
|
+
dayStartNs: bigint;
|
|
101
|
+
agents: Page_23;
|
|
102
|
+
}
|
|
87
103
|
export type AgentStatus = { Active: null } | { Resigned: null } | { Revoked: null };
|
|
88
104
|
export interface AgentWriteReview {
|
|
89
105
|
cursor: bigint;
|
|
@@ -175,6 +191,11 @@ export interface BackupMetadata {
|
|
|
175
191
|
chunkCount: bigint;
|
|
176
192
|
parentBackupId: [] | [string];
|
|
177
193
|
}
|
|
194
|
+
export interface BackupRetention {
|
|
195
|
+
maxBackups: bigint;
|
|
196
|
+
isDefault: boolean;
|
|
197
|
+
dbType: string;
|
|
198
|
+
}
|
|
178
199
|
export interface BackupRetentionReport {
|
|
179
200
|
maxBackups: bigint;
|
|
180
201
|
dbType: string;
|
|
@@ -199,6 +220,30 @@ export interface BearerToken {
|
|
|
199
220
|
issuedBy: Principal;
|
|
200
221
|
}
|
|
201
222
|
export type BearerTokenStatus = { Active: null } | { Revoked: null } | { Expired: null };
|
|
223
|
+
export interface BirthRecord {
|
|
224
|
+
bornAtNs: bigint;
|
|
225
|
+
parentFingerprint: [] | [Uint8Array | number[]];
|
|
226
|
+
child: Principal;
|
|
227
|
+
secret: Uint8Array | number[];
|
|
228
|
+
version: bigint;
|
|
229
|
+
number: bigint;
|
|
230
|
+
parent: [] | [Principal];
|
|
231
|
+
}
|
|
232
|
+
export interface BrakePull {
|
|
233
|
+
by: Principal;
|
|
234
|
+
atNs: bigint;
|
|
235
|
+
role: BrakeRole;
|
|
236
|
+
reason: [] | [string];
|
|
237
|
+
}
|
|
238
|
+
export type BrakeRole = { Guardian: null } | { Owner: null };
|
|
239
|
+
export interface BrakeState {
|
|
240
|
+
on: boolean;
|
|
241
|
+
pull: [] | [BrakePull];
|
|
242
|
+
}
|
|
243
|
+
export interface Brakes {
|
|
244
|
+
payments: BrakeState;
|
|
245
|
+
writes: BrakeState;
|
|
246
|
+
}
|
|
202
247
|
export interface CallerSignatureCount {
|
|
203
248
|
count: bigint;
|
|
204
249
|
role: Role;
|
|
@@ -214,7 +259,7 @@ export interface CertifiedAuditHead {
|
|
|
214
259
|
}
|
|
215
260
|
export interface CheckpointPage {
|
|
216
261
|
firstAvailableSeq: bigint;
|
|
217
|
-
page:
|
|
262
|
+
page: Page_18;
|
|
218
263
|
scannedThroughSeq: bigint;
|
|
219
264
|
}
|
|
220
265
|
export interface ChildAllowanceRow {
|
|
@@ -357,11 +402,18 @@ export interface Engram {
|
|
|
357
402
|
* / test/key-replacement.test.mo runs it; this body names no roster gate, because the caller holds
|
|
358
403
|
* / no role here until the move.
|
|
359
404
|
*/
|
|
360
|
-
acceptAgentKeyNomination: ActorMethod<[Principal],
|
|
405
|
+
acceptAgentKeyNomination: ActorMethod<[Principal], Result_82>;
|
|
361
406
|
/**
|
|
362
407
|
* / Consensus transform for the alert webhook outcall: collapse the response to status-only so
|
|
363
408
|
* / replicas agree regardless of response headers/body (we only care that the POST landed 2xx).
|
|
364
409
|
* /
|
|
410
|
+
* / ⟨CORRECTED 2026-10-21⟩ No longer a consensus transform: the alert outcall is non-replicated
|
|
411
|
+
* / (`is_replicated = ?false` in `scanAndPost`), so ONE node sends the POST and runs this on its
|
|
412
|
+
* / own response — there are no replicas to agree, and "on every replica" below now means "on that
|
|
413
|
+
* / node". It stays so the response is collapsed to status-only before the engram reads it. The
|
|
414
|
+
* / PUBLIC reasoning below is unchanged: the outcall protocol still calls it with no caller identity.
|
|
415
|
+
* / `worldIdTransform` is still a true consensus transform (World ID stays replicated).
|
|
416
|
+
* /
|
|
365
417
|
* / PUBLIC: not a choice. The management canister invokes a transform on every replica as part of
|
|
366
418
|
* / the HTTP-outcall protocol, and that invocation carries no caller identity to gate on — a gate
|
|
367
419
|
* / here would refuse the only caller there is and break every alert this canister sends. Safe
|
|
@@ -383,7 +435,7 @@ export interface Engram {
|
|
|
383
435
|
* / account name). The action must be registered: a destination list belongs to an action, and a
|
|
384
436
|
* / list for no action would be a value nothing checks. The caller is the owner's app.
|
|
385
437
|
*/
|
|
386
|
-
addEip712Destination: ActorMethod<[Uint8Array | number[], string],
|
|
438
|
+
addEip712Destination: ActorMethod<[Uint8Array | number[], string], Result_81>;
|
|
387
439
|
/**
|
|
388
440
|
* / Register a typed-data shape as signable. Owner-only, freeze-gated (a registration is a grant
|
|
389
441
|
* / of FUTURE authority — a frozen engram must not be able to widen what it can sign), and the
|
|
@@ -418,7 +470,7 @@ export interface Engram {
|
|
|
418
470
|
ackIrrevocable: boolean;
|
|
419
471
|
},
|
|
420
472
|
],
|
|
421
|
-
|
|
473
|
+
Result_80
|
|
422
474
|
>;
|
|
423
475
|
/**
|
|
424
476
|
* / ⟨0.16.0, L1⟩ THE ROLE-CONFLICT ARM, and why three refusals here are not the same refusal.
|
|
@@ -431,6 +483,17 @@ export interface Engram {
|
|
|
431
483
|
* / or the roster is full. Only the last is worth an agent's time to resolve.
|
|
432
484
|
*/
|
|
433
485
|
addGuardian: ActorMethod<[Principal, string, GuardianPermissions], Result_1>;
|
|
486
|
+
/**
|
|
487
|
+
* / ⟨2026-10-21, the owner's round-11 answer b⟩ OWNER-ONLY: put a note on any entry of this
|
|
488
|
+
* / engram's record — words, nothing else. Appends a chained `record.note` entry
|
|
489
|
+
* / (`about=<id> note=<words>`) and keeps the note for `listRecordNotes`; answers the new entry's
|
|
490
|
+
* / id. The entry noted may be any entry ever appended (`about` below the head), including one the
|
|
491
|
+
* / ring no longer holds in full. An agent, a guardian, a stranger and the anonymous caller are
|
|
492
|
+
* / refused by `requireOwner`'s own words. Empty words, words over `RecordWords.WORDS_MAX` or
|
|
493
|
+
* / holding a line break are `#Invalid`; an id past the head is `#NotFound`; nothing is recorded
|
|
494
|
+
* / on any refusal.
|
|
495
|
+
*/
|
|
496
|
+
addRecordNote: ActorMethod<[bigint, string], Result_13>;
|
|
434
497
|
/**
|
|
435
498
|
* / Returns the write RECEIPT, not just the version.
|
|
436
499
|
* /
|
|
@@ -465,7 +528,7 @@ export interface Engram {
|
|
|
465
528
|
* / is exactly what a guardian pause exists to hold. No action alert is raised: the operation is
|
|
466
529
|
* / owner-initiated, owner-only, and already chained into the audit log.
|
|
467
530
|
*/
|
|
468
|
-
applyCondense: ActorMethod<[bigint],
|
|
531
|
+
applyCondense: ActorMethod<[bigint], Result_79>;
|
|
469
532
|
/**
|
|
470
533
|
* / Owner-only: activate a guardian who has registered against an invite.
|
|
471
534
|
* /
|
|
@@ -545,7 +608,7 @@ export interface Engram {
|
|
|
545
608
|
* /
|
|
546
609
|
* / The write half also refuses while writes are PAUSED.
|
|
547
610
|
*/
|
|
548
|
-
backupInit: ActorMethod<[string, BackupType, [] | [string], string, [] | [string]],
|
|
611
|
+
backupInit: ActorMethod<[string, BackupType, [] | [string], string, [] | [string]], Result_52>;
|
|
549
612
|
/**
|
|
550
613
|
* / Read one chunk of a finalized backup, by index.
|
|
551
614
|
* /
|
|
@@ -553,7 +616,7 @@ export interface Engram {
|
|
|
553
616
|
* / `canAppendMemory`. Holding one says nothing about the other, deliberately: taking a backup and
|
|
554
617
|
* / carrying it away are different authorities.
|
|
555
618
|
*/
|
|
556
|
-
backupPullChunk: ActorMethod<[string, bigint],
|
|
619
|
+
backupPullChunk: ActorMethod<[string, bigint], Result_68>;
|
|
557
620
|
backupPushChunk: ActorMethod<[string, bigint, Uint8Array | number[]], Result_1>;
|
|
558
621
|
/**
|
|
559
622
|
* / The OWNER cancels an agent's pending key nomination; the agent keeps its current key. Refused
|
|
@@ -591,7 +654,7 @@ export interface Engram {
|
|
|
591
654
|
* / pair — e6 base units of the token named first. A name only: Candid passes arguments by
|
|
592
655
|
* / position, so nothing on the wire moved.
|
|
593
656
|
*/
|
|
594
|
-
convertEarningsToCycles: ActorMethod<[string, bigint],
|
|
657
|
+
convertEarningsToCycles: ActorMethod<[string, bigint], Result_13>;
|
|
595
658
|
/**
|
|
596
659
|
* / Owner-only: mint a single-use invite code an agent redeems with `pairAgent`.
|
|
597
660
|
* /
|
|
@@ -611,7 +674,7 @@ export interface Engram {
|
|
|
611
674
|
* / A principal that is already a GUARDIAN cannot become an agent — a guardian is an
|
|
612
675
|
* / independent check on agents, so one wallet must not hold both.
|
|
613
676
|
*/
|
|
614
|
-
createAgentInvite: ActorMethod<[string, AgentPermissions],
|
|
677
|
+
createAgentInvite: ActorMethod<[string, AgentPermissions], Result_52>;
|
|
615
678
|
/**
|
|
616
679
|
* / Owner-only: mint an invite for a GUARDIAN — an independent check on agents, not a
|
|
617
680
|
* / co-owner and not a recovery agent.
|
|
@@ -635,7 +698,7 @@ export interface Engram {
|
|
|
635
698
|
* / So an invite that fails to redeem for that reason is not a bad code. The rule exists because
|
|
636
699
|
* / a check must be independent of the thing it checks.
|
|
637
700
|
*/
|
|
638
|
-
createGuardianInvite: ActorMethod<[string, GuardianPermissions],
|
|
701
|
+
createGuardianInvite: ActorMethod<[string, GuardianPermissions], Result_52>;
|
|
639
702
|
/**
|
|
640
703
|
* / OWNER-ONLY deletion of a stored backup.
|
|
641
704
|
* /
|
|
@@ -669,6 +732,24 @@ export interface Engram {
|
|
|
669
732
|
* / does not change the policy — the next request over the same limit will be raised again.
|
|
670
733
|
*/
|
|
671
734
|
denyRequest: ActorMethod<[string, string], Result_1>;
|
|
735
|
+
/**
|
|
736
|
+
* / ⟨2026-10-21, the owner's round-11 answer c⟩ A NEW GUARDIAN POWER, words only: an ACTIVE
|
|
737
|
+
* / guardian disputes an agent's write. It never moves money, stops anything or changes a grant.
|
|
738
|
+
* / Appends a chained `record.dispute` entry (`about=<id> reason=<words>`) and keeps the dispute
|
|
739
|
+
* / for `listGuardianDisputes`; answers the new entry's id. NOT ALERTED, deliberately: a
|
|
740
|
+
* / `guardian.*` operation would fall in the alerts' #guardian class, and which entries reach a
|
|
741
|
+
* / phone is the held alerts round's to decide (`ActionAlerts.classify` answers null for
|
|
742
|
+
* / `record.*`). The owner sees it on the record's Disputes tab.
|
|
743
|
+
* /
|
|
744
|
+
* / WHO: every active guardian — no grant bit (`RecordWords` header says why). The OWNER is refused
|
|
745
|
+
* / by name (`RecordWords.OWNER_DISPUTES_ELSEWHERE` — the owner's dispute is
|
|
746
|
+
* / `repudiateMemoryWrite`); an agent and a stranger get "Not a guardian", a pending guardian "Guardian
|
|
747
|
+
* / is pending approval", the anonymous caller the anonymous refusal.
|
|
748
|
+
* / WHAT: an entry the owner's review would show (`qualifiesForReview` — an agent's append or
|
|
749
|
+
* / revision, or a paid session's append) that succeeded, still held in full by the ring.
|
|
750
|
+
* / One dispute per guardian per write (`#Conflict`, the first stands).
|
|
751
|
+
*/
|
|
752
|
+
disputeAgentWrite: ActorMethod<[bigint, string], Result_13>;
|
|
672
753
|
/**
|
|
673
754
|
* / Record that log entries [fromSeq, toSeq] were served, and return the root that proves it.
|
|
674
755
|
* /
|
|
@@ -683,7 +764,7 @@ export interface Engram {
|
|
|
683
764
|
* / situation rather than a safety measure. It IS gated on requireMemoryAttached: a store that
|
|
684
765
|
* / failed its integrity check must not attest anything it cannot vouch for.
|
|
685
766
|
*/
|
|
686
|
-
exportMemoryRange: ActorMethod<[bigint, bigint, [] | [Principal]],
|
|
767
|
+
exportMemoryRange: ActorMethod<[bigint, bigint, [] | [Principal]], Result_78>;
|
|
687
768
|
/**
|
|
688
769
|
* / ⟨0.16.0, L2.2 — renamed from `guardianFreezePayments`⟩ The prefix LIED about who may call it.
|
|
689
770
|
* / The gate is `requireOwnerOrGuardian`, and an owner freezing their own payments is the ordinary
|
|
@@ -718,10 +799,20 @@ export interface Engram {
|
|
|
718
799
|
* / before this one. If any of them is wrong, this comment is where the argument should happen.
|
|
719
800
|
*/
|
|
720
801
|
freezePayments: ActorMethod<[], Result_1>;
|
|
802
|
+
/**
|
|
803
|
+
* / ⟨2026-10-21, the owner's round-11 answer d⟩ `freezePayments` with a reason the strip and the
|
|
804
|
+
* / guardian page show ("Sam froze payments: 'a payment I didn't expect'"). A NEW method, not an
|
|
805
|
+
* / argument on `freezePayments`: a shipped argument tuple is frozen. Same callers, same grant, same
|
|
806
|
+
* / brake: the owner, or an active guardian holding `canFreezePayments`; an agent, a stranger, a
|
|
807
|
+
* / pending guardian and the anonymous caller are refused by `requireOwnerOrGuardian`'s own words.
|
|
808
|
+
* / An empty reason is no reason; a reason too long or holding a line break is `#Invalid` and the
|
|
809
|
+
* / brake is NOT pulled — the caller pulls it with `freezePayments`, or shortens the words.
|
|
810
|
+
*/
|
|
811
|
+
freezePaymentsWithReason: ActorMethod<[string], Result_1>;
|
|
721
812
|
/**
|
|
722
813
|
* / Delivery status + config readback. Owner-only (the URL is a secret).
|
|
723
814
|
*/
|
|
724
|
-
getActionAlertStatus: ActorMethod<[],
|
|
815
|
+
getActionAlertStatus: ActorMethod<[], Result_66>;
|
|
725
816
|
/**
|
|
726
817
|
* / Agents need to know what they may revise, so they can read it too. Whole-value config, same
|
|
727
818
|
* / carve-out as getProtectedPaths — and kept a SEPARATE method from it deliberately (L2.2): a
|
|
@@ -731,7 +822,7 @@ export interface Engram {
|
|
|
731
822
|
* / Refusal reason preserved from the trap: a grant is a power, and its absence and its
|
|
732
823
|
* / concealment are different facts.
|
|
733
824
|
*/
|
|
734
|
-
getAgentRevisablePaths: ActorMethod<[],
|
|
825
|
+
getAgentRevisablePaths: ActorMethod<[], Result_62>;
|
|
735
826
|
/**
|
|
736
827
|
* / OWNER-ONLY: every engagement's seat weeks on this engram, with the agent's root — the day it
|
|
737
828
|
* / paired, the days of its first and last payment signature, a 64-week map whose bit 0 is the week
|
|
@@ -744,7 +835,7 @@ export interface Engram {
|
|
|
744
835
|
* / empty page. Paged; `total` is every engagement ever paired here (a reset keeps the rows).
|
|
745
836
|
* / Two rows can name one root: an agent paired again after it left is a second engagement.
|
|
746
837
|
*/
|
|
747
|
-
getAgentSeatWeeks: ActorMethod<[bigint, bigint],
|
|
838
|
+
getAgentSeatWeeks: ActorMethod<[bigint, bigint], Result_76>;
|
|
748
839
|
/**
|
|
749
840
|
* / Owner: everything written into this engram by someone other than the owner since the last
|
|
750
841
|
* / markAgentWritesReviewed() — agent appends/revisions AND paid-session appends (see
|
|
@@ -754,7 +845,7 @@ export interface Engram {
|
|
|
754
845
|
* / as a total. `earliest` discloses ring eviction — if cursor < earliest, entries between them
|
|
755
846
|
* / aged out of the ring (the CHAIN still proves total count; this view can't show their bodies).
|
|
756
847
|
*/
|
|
757
|
-
getAgentWriteReview: ActorMethod<[],
|
|
848
|
+
getAgentWriteReview: ActorMethod<[], Result_75>;
|
|
758
849
|
/**
|
|
759
850
|
* / Why anchoring is or is not advancing. PUBLIC: ungated on purpose — detecting a stalled
|
|
760
851
|
* / engram is the point, a gated read would fail-to-empty and hand a third party fabricated zeros,
|
|
@@ -777,7 +868,20 @@ export interface Engram {
|
|
|
777
868
|
* / was signed rather than asserted.
|
|
778
869
|
*/
|
|
779
870
|
getAuditHead: ActorMethod<[], AuditHead>;
|
|
780
|
-
getBackupMetadata: ActorMethod<[string],
|
|
871
|
+
getBackupMetadata: ActorMethod<[string], Result_74>;
|
|
872
|
+
/**
|
|
873
|
+
* / ⟨2026-10-21, the owner's round-11 answer m: a backup-retention getter⟩ How many backups of
|
|
874
|
+
* / `dbType` each creator keeps, and whether that is the default — the read `setBackupRetention`
|
|
875
|
+
* / lacked, so "Keeps your newest 3" showed only on the phone that last set it.
|
|
876
|
+
* /
|
|
877
|
+
* / WHO: the OWNER, and an active AGENT holding `canAppendMemory` — the permission that lets it
|
|
878
|
+
* / upload backups, which are exactly the backups this number bounds (`#perm(#append_memory)`).
|
|
879
|
+
* / Refused, each by the gate's own words: an agent without that permission ("Permission
|
|
880
|
+
* / denied"), a revoked or resigned agent, a guardian (guardians take no backups), a stranger and
|
|
881
|
+
* / the anonymous caller. A kind the setter would refuse is `#Invalid` here too
|
|
882
|
+
* / (`Backup.getRetention`). Records nothing (a query).
|
|
883
|
+
*/
|
|
884
|
+
getBackupRetention: ActorMethod<[string], Result_73>;
|
|
781
885
|
/**
|
|
782
886
|
* / The cashier this engram recognises as its rent biller — `null` until the registry pushes one.
|
|
783
887
|
* /
|
|
@@ -787,6 +891,27 @@ export interface Engram {
|
|
|
787
891
|
* / too is what lets the two be COMPARED, which is the only way to catch a mismatch.
|
|
788
892
|
*/
|
|
789
893
|
getBillerId: ActorMethod<[], [] | [Principal]>;
|
|
894
|
+
/**
|
|
895
|
+
* / This engram's BIRTH CHAIN, root first: its own record last, its parent's before it, and so on
|
|
896
|
+
* / ⟨2026-10-26, the owner's lineage ruling L3A⟩.
|
|
897
|
+
* /
|
|
898
|
+
* / OWNER ONLY. The owner decides whom to show it to — the chain names the engrams this one descends
|
|
899
|
+
* / from, which is the owner's to disclose, not the registry's. The certified half is at the registry
|
|
900
|
+
* / (`getCertifiedBirth`, public, revealing only whether a fingerprint is present); the client's
|
|
901
|
+
* / `verifyBirthChain` checks both. Refused to anyone else by the combinator (`#ownerOnly`).
|
|
902
|
+
*/
|
|
903
|
+
getBirthChain: ActorMethod<[], Result_72>;
|
|
904
|
+
/**
|
|
905
|
+
* / ⟨2026-10-21, the owner's round-11 answer d⟩ Each brake: on or off, and while on, who pulled it
|
|
906
|
+
* / LAST (their key and whether as owner or guardian), since when, and the reason they gave — the
|
|
907
|
+
* / same person and time as the newest brake entry on the record (`RecordWords.BrakePull`). For the
|
|
908
|
+
* / owner's status strip and the guardian page. The OWNER and ACTIVE GUARDIANS may read it; an
|
|
909
|
+
* / agent, a stranger, a pending guardian and the anonymous caller are refused (`#ownerOrGuardian`
|
|
910
|
+
* / — an agent learns a brake is on from the refusal of what it tried, and needs no more). `pull`
|
|
911
|
+
* / is null for a brake that is off, and for one carried on across the upgrade that added this
|
|
912
|
+
* / read (who pulled it was not recorded then) — never a guessed pull.
|
|
913
|
+
*/
|
|
914
|
+
getBrakes: ActorMethod<[], Result_71>;
|
|
790
915
|
/**
|
|
791
916
|
* / ⟨0.16.0, L9/L10 — census row⟩ `Wire.CertifiedAuditHead`, not an anonymous record. The
|
|
792
917
|
* / registry, market and cashier already served the shared type; the engram — the canister that
|
|
@@ -813,13 +938,13 @@ export interface Engram {
|
|
|
813
938
|
* / recorded nothing while reading as if it did. The refusal is loud in the reply instead. WHAT
|
|
814
939
|
* / WOULD MAKE THIS WRONG: a reason to record who asked — then this becomes an update that says so.
|
|
815
940
|
*/
|
|
816
|
-
getChildAllowance: ActorMethod<[Principal],
|
|
941
|
+
getChildAllowance: ActorMethod<[Principal], Result_70>;
|
|
817
942
|
/**
|
|
818
943
|
* / Owner-only, Billing-class: what opening an engram costs this engram, the balance below which an
|
|
819
944
|
* / agent's request is refused, the balance now, and every agent's allowance. The console's cost
|
|
820
945
|
* / sentence reads it. Cycles are owner-class information, as on the owner's console read.
|
|
821
946
|
*/
|
|
822
|
-
getChildOpening: ActorMethod<[],
|
|
947
|
+
getChildOpening: ActorMethod<[], Result_69>;
|
|
823
948
|
/**
|
|
824
949
|
* / Derive the shared memory-encryption key, encrypted under the caller's transport
|
|
825
950
|
* / public key. Gated to owner + read-agents (the same principals allowed to read
|
|
@@ -845,7 +970,7 @@ export interface Engram {
|
|
|
845
970
|
* / cost. Stated here because L7 requires the reason be readable from the interface rather than
|
|
846
971
|
* / inferred by opening the body — which is exactly what had to happen to write this line.
|
|
847
972
|
*/
|
|
848
|
-
getEncryptedMemoryKey: ActorMethod<[[] | [bigint], Uint8Array | number[]],
|
|
973
|
+
getEncryptedMemoryKey: ActorMethod<[[] | [bigint], Uint8Array | number[]], Result_68>;
|
|
849
974
|
/**
|
|
850
975
|
* / ⟨0.16.0, owner ruling 2026-08-20 — option (a)⟩ `x402Support` REPORTS THE RAIL, not a constant.
|
|
851
976
|
* /
|
|
@@ -944,7 +1069,7 @@ export interface Engram {
|
|
|
944
1069
|
* / `#Err`, never a record carrying an empty string (ic402's `getEvmAddress` answers `""` on a
|
|
945
1070
|
* / failed derivation — that is fail-to-empty on a money surface, and it stops here).
|
|
946
1071
|
*/
|
|
947
|
-
getEvmAddress: ActorMethod<[],
|
|
1072
|
+
getEvmAddress: ActorMethod<[], Result_67>;
|
|
948
1073
|
/**
|
|
949
1074
|
* / The owner's OWN EVM address, if they registered one — distinct from `getEvmAddress`, which is
|
|
950
1075
|
* / the address this canister derives for itself.
|
|
@@ -963,7 +1088,7 @@ export interface Engram {
|
|
|
963
1088
|
* / cost — stated here because L7 requires the reason be readable from the interface rather than
|
|
964
1089
|
* / inferred by opening the body.
|
|
965
1090
|
*/
|
|
966
|
-
getEvmSignerAddress: ActorMethod<[],
|
|
1091
|
+
getEvmSignerAddress: ActorMethod<[], Result_52>;
|
|
967
1092
|
/**
|
|
968
1093
|
* / PUBLIC: where this chain begins, for the stranger deciding whether to trust it.
|
|
969
1094
|
* /
|
|
@@ -976,7 +1101,7 @@ export interface Engram {
|
|
|
976
1101
|
/**
|
|
977
1102
|
* / A guardian's own channel status (their URL is their secret — each guardian sees only theirs).
|
|
978
1103
|
*/
|
|
979
|
-
getGuardianAlertStatus: ActorMethod<[],
|
|
1104
|
+
getGuardianAlertStatus: ActorMethod<[], Result_66>;
|
|
980
1105
|
/**
|
|
981
1106
|
* / The market this engram will accept signing requests from — `null` until the registry pushes
|
|
982
1107
|
* / one at spawn, which is why `requireMarket` refuses fleet-wide today.
|
|
@@ -1009,7 +1134,7 @@ export interface Engram {
|
|
|
1009
1134
|
* / never renumbered: the next page starts at the last version returned plus one. Defaults
|
|
1010
1135
|
* / return the whole history of any file a pre-FD engram could have held.
|
|
1011
1136
|
*/
|
|
1012
|
-
getMemoryHistory: ActorMethod<[string, [] | [bigint], [] | [bigint]],
|
|
1137
|
+
getMemoryHistory: ActorMethod<[string, [] | [bigint], [] | [bigint]], Result_65>;
|
|
1013
1138
|
/**
|
|
1014
1139
|
* / PUBLIC: the epoch alone, and deliberately nothing else (rotation study D4). A `rotatedAt[]`
|
|
1015
1140
|
* / history would be a public, fleet-enumerable feed of when each owner terminated a trust
|
|
@@ -1058,7 +1183,7 @@ export interface Engram {
|
|
|
1058
1183
|
* / forever" — a claim about what this engram will DESTROY — and an empty guard list reads as
|
|
1059
1184
|
* / "nothing is held back".
|
|
1060
1185
|
*/
|
|
1061
|
-
getMemoryRetentionPolicy: ActorMethod<[],
|
|
1186
|
+
getMemoryRetentionPolicy: ActorMethod<[], Result_64>;
|
|
1062
1187
|
/**
|
|
1063
1188
|
* / The metrics reader this engram answers — `null` until the spawning registry names one.
|
|
1064
1189
|
* /
|
|
@@ -1075,7 +1200,7 @@ export interface Engram {
|
|
|
1075
1200
|
* / a fact about the caller, told to the caller. There is nothing to leak by omission — which is
|
|
1076
1201
|
* / the test the #NotFound arm sets.
|
|
1077
1202
|
*/
|
|
1078
|
-
getMyGuardianStatus: ActorMethod<[],
|
|
1203
|
+
getMyGuardianStatus: ActorMethod<[], Result_16>;
|
|
1079
1204
|
/**
|
|
1080
1205
|
* / ⟨0.16.0, NEW⟩ The gated half of the status() split.
|
|
1081
1206
|
* /
|
|
@@ -1087,7 +1212,7 @@ export interface Engram {
|
|
|
1087
1212
|
* / client (rule 4) and bought a masked answer nobody had asked for — the census could not even
|
|
1088
1213
|
* / find a consumer that read the masked `0`. Behind a gate there is nobody to mask it from.
|
|
1089
1214
|
*/
|
|
1090
|
-
getOwnerConsole: ActorMethod<[],
|
|
1215
|
+
getOwnerConsole: ActorMethod<[], Result_63>;
|
|
1091
1216
|
/**
|
|
1092
1217
|
* / Owner + agents only (agents need it to avoid writing protected paths).
|
|
1093
1218
|
* /
|
|
@@ -1101,7 +1226,7 @@ export interface Engram {
|
|
|
1101
1226
|
* / writing one — so a fabricated empty here does not merely misinform, it invites the write the
|
|
1102
1227
|
* / list exists to prevent.
|
|
1103
1228
|
*/
|
|
1104
|
-
getProtectedPaths: ActorMethod<[],
|
|
1229
|
+
getProtectedPaths: ActorMethod<[], Result_62>;
|
|
1105
1230
|
/**
|
|
1106
1231
|
* / Whether the metrics reader's read is answered — `true` from birth.
|
|
1107
1232
|
* /
|
|
@@ -1114,7 +1239,7 @@ export interface Engram {
|
|
|
1114
1239
|
* / payment signatures the balance carries above the floor before `signX402Payment` is refused by
|
|
1115
1240
|
* / name. The same numbers the check uses, so Billing can say only what the engram enforces.
|
|
1116
1241
|
*/
|
|
1117
|
-
getSigningFloor: ActorMethod<[],
|
|
1242
|
+
getSigningFloor: ActorMethod<[], Result_61>;
|
|
1118
1243
|
/**
|
|
1119
1244
|
* / The registry that spawned this engram, if it recorded one.
|
|
1120
1245
|
* /
|
|
@@ -1135,7 +1260,7 @@ export interface Engram {
|
|
|
1135
1260
|
* / A refusal names this method (`Gated.gatedResult`) rather than answering null/0 — a ceiling of
|
|
1136
1261
|
* / "none" and a spend of 0 are both real answers, so a fabricated one would be read as fact.
|
|
1137
1262
|
*/
|
|
1138
|
-
getSpendCeiling: ActorMethod<[],
|
|
1263
|
+
getSpendCeiling: ActorMethod<[], Result_60>;
|
|
1139
1264
|
/**
|
|
1140
1265
|
* / Read the caps in force for a caller.
|
|
1141
1266
|
* /
|
|
@@ -1145,8 +1270,8 @@ export interface Engram {
|
|
|
1145
1270
|
* / configuration, and publishing them would tell any caller exactly how large a signing request
|
|
1146
1271
|
* / can be before it needs an approval nobody is watching for.
|
|
1147
1272
|
*/
|
|
1148
|
-
getSpendPolicy: ActorMethod<[[] | [Principal]],
|
|
1149
|
-
getStorageStats: ActorMethod<[],
|
|
1273
|
+
getSpendPolicy: ActorMethod<[[] | [Principal]], Result_59>;
|
|
1274
|
+
getStorageStats: ActorMethod<[], Result_58>;
|
|
1150
1275
|
/**
|
|
1151
1276
|
* / Timer arm-state. PUBLIC and deliberately so: these timers are self-arming to save cycles,
|
|
1152
1277
|
* / and an optimisation nobody can verify is an optimisation nobody should trust. Cheap to read,
|
|
@@ -1219,14 +1344,14 @@ export interface Engram {
|
|
|
1219
1344
|
* / UPDATE, marked per L7: it awaits three ICRC-1 ledgers". It was marked in prose and invisible
|
|
1220
1345
|
* / to any gate; the glyph is what `scripts/check-update-for-read.mjs` matches.
|
|
1221
1346
|
*/
|
|
1222
|
-
getWalletBalances: ActorMethod<[],
|
|
1347
|
+
getWalletBalances: ActorMethod<[], Result_57>;
|
|
1223
1348
|
/**
|
|
1224
1349
|
* / Refusal reason preserved, and it is the clearest case of why a masked read is worse than no
|
|
1225
1350
|
* / read: three empty strings with `configured = false` is a VALID-LOOKING answer meaning "this
|
|
1226
1351
|
* / engram has no World ID configuration" — handed to a caller who merely lacks a grant. The
|
|
1227
1352
|
* / fabrication is indistinguishable from the truth by construction.
|
|
1228
1353
|
*/
|
|
1229
|
-
getWorldIdConfig: ActorMethod<[],
|
|
1354
|
+
getWorldIdConfig: ActorMethod<[], Result_56>;
|
|
1230
1355
|
/**
|
|
1231
1356
|
* / ⟨L7⟩ UPDATE, NOT QUERY: this awaits THREE system calls — `raw_rand()` for the nonce,
|
|
1232
1357
|
* / `Call.signWithEcdsa` for the signature, and `worldIdRpPublicKey()` for the derived key. A
|
|
@@ -1237,7 +1362,7 @@ export interface Engram {
|
|
|
1237
1362
|
* / the World Developer Portal. Short-lived (300s TTL, idkit-server's default) and single-purpose —
|
|
1238
1363
|
* / it authorizes opening one verification request, nothing else.
|
|
1239
1364
|
*/
|
|
1240
|
-
getWorldIdRpContext: ActorMethod<[],
|
|
1365
|
+
getWorldIdRpContext: ActorMethod<[], Result_55>;
|
|
1241
1366
|
/**
|
|
1242
1367
|
* / Owner-only: the EVM address derived from the engram's dedicated World ID RP signing key (the
|
|
1243
1368
|
* / "worldid-rp" tECDSA path). Register THIS address as the rp_id's signer in the World Developer
|
|
@@ -1249,7 +1374,7 @@ export interface Engram {
|
|
|
1249
1374
|
* / refusal — a state write, which a query cannot perform. So even if the key were cached this
|
|
1250
1375
|
* / could not become a query without silently retiring its denial record (ADR-0002's class).
|
|
1251
1376
|
*/
|
|
1252
|
-
getWorldIdRpSignerAddress: ActorMethod<[],
|
|
1377
|
+
getWorldIdRpSignerAddress: ActorMethod<[], Result_52>;
|
|
1253
1378
|
/**
|
|
1254
1379
|
* / The verified IDKitResult, verbatim, as World's /api/v4/verify accepted it — the re-checkable
|
|
1255
1380
|
* / artifact behind verifiedHuman. Role-gated because it carries the NULLIFIER.
|
|
@@ -1270,7 +1395,7 @@ export interface Engram {
|
|
|
1270
1395
|
* / canister does not serve. The tombstones below and at `about()` are historical and correct as
|
|
1271
1396
|
* / written; this one was present tense, which is the difference that matters.⟩
|
|
1272
1397
|
*/
|
|
1273
|
-
getWorldIdVerification: ActorMethod<[],
|
|
1398
|
+
getWorldIdVerification: ActorMethod<[], Result_54>;
|
|
1274
1399
|
/**
|
|
1275
1400
|
* / ⟨0.16.0, L1⟩ THE EMERGENCY FAMILY. Every refusal below is `#Refused` or `#NotFound`, and the
|
|
1276
1401
|
* / absence of a `#Conflict` here is the point: these are the calls someone makes while something
|
|
@@ -1354,7 +1479,7 @@ export interface Engram {
|
|
|
1354
1479
|
* / Owner-gated because it reports on custody posture, and answered as a Result so that a
|
|
1355
1480
|
* / wrong-identity caller gets a refusal rather than a bare `false` that reads as "no address yet".
|
|
1356
1481
|
*/
|
|
1357
|
-
isEvmAddressCached: ActorMethod<[],
|
|
1482
|
+
isEvmAddressCached: ActorMethod<[], Result_53>;
|
|
1358
1483
|
/**
|
|
1359
1484
|
* / Issue an OAuth authorization code. Called by an OAuth client's sign-in bridge
|
|
1360
1485
|
* / (an `/auth/connector`-style route) after II authentication. The client then
|
|
@@ -1363,7 +1488,7 @@ export interface Engram {
|
|
|
1363
1488
|
* /
|
|
1364
1489
|
* / Owner-only: only the engram owner can authorize a Connector install.
|
|
1365
1490
|
*/
|
|
1366
|
-
issueAuthCode: ActorMethod<[string, string, string, [] | [string]],
|
|
1491
|
+
issueAuthCode: ActorMethod<[string, string, string, [] | [string]], Result_52>;
|
|
1367
1492
|
/**
|
|
1368
1493
|
* / ⟨0.16.0⟩ `getCycleSnapshotSource` DELETED — folded into `CycleSnapshot.source`, one label per
|
|
1369
1494
|
* / ROW. A single label for a whole ring misattributes every row recorded under the other source,
|
|
@@ -1379,7 +1504,26 @@ export interface Engram {
|
|
|
1379
1504
|
* / DORMANT engram and corrupts retention math — a fabricated empty here does not just misinform a
|
|
1380
1505
|
* / reader, it feeds a wrong number into a decision about destroying data.
|
|
1381
1506
|
*/
|
|
1382
|
-
listActivitySnapshots: ActorMethod<[bigint, bigint],
|
|
1507
|
+
listActivitySnapshots: ActorMethod<[bigint, bigint], Result_51>;
|
|
1508
|
+
/**
|
|
1509
|
+
* / ⟨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,
|
|
1510
|
+
* / m."⟩ OWNER-ONLY: what each agent has spent today, beside the daily limit in force for it, so the
|
|
1511
|
+
* / agent rows can say "$0.50 of $5.00 today" where they said a count of payments. Read from the
|
|
1512
|
+
* / state the payment path already keeps — `outboundSpendToday`, through `SpendCeiling.callerSpentOn`
|
|
1513
|
+
* / (the reader `x402SignFor` uses) — and the limits from `gate.getPolicy(<the agent's key>)`, the
|
|
1514
|
+
* / policy `x402SignFor` checks, on the UTC day it checks (`SpendCeiling.dayIndex`). Amounts are the
|
|
1515
|
+
* / token's minor units, as the record's `amount=` writes them. No new state.
|
|
1516
|
+
* /
|
|
1517
|
+
* / OWNER-ONLY for `getSpendCeiling`'s reason: one agent's spending is the owner's custody
|
|
1518
|
+
* / information, and would tell another agent how much it spent. Everyone else — an agent, a
|
|
1519
|
+
* / guardian, a stranger, the anonymous caller — is refused by name (`#Refused
|
|
1520
|
+
* / listAgentSpendToday: …`), never answered with zeros. Paged like `listAgents`, in its order, one
|
|
1521
|
+
* / row per agent record; a row's `spentToday` is null, not 0, where no daily limit is in force,
|
|
1522
|
+
* / because the payment path keeps no figure then (`SpendCeiling.AgentSpendRow` says why).
|
|
1523
|
+
* / WHAT WOULD MAKE THIS WRONG: `x402SignFor` keeping the per-caller total by something other than
|
|
1524
|
+
* / the calling key, or under another day boundary.
|
|
1525
|
+
*/
|
|
1526
|
+
listAgentSpendToday: ActorMethod<[bigint, bigint], Result_50>;
|
|
1383
1527
|
/**
|
|
1384
1528
|
* / ⟨0.16.0⟩ THE PAGE EXEMPLAR. Trap → `#Refused`, bare array → `Result<Page<T>>` (L1 + L3).
|
|
1385
1529
|
* /
|
|
@@ -1396,7 +1540,7 @@ export interface Engram {
|
|
|
1396
1540
|
* / `withheld` is 0: this roster is owner-only in whole, so there is no partial-visibility case.
|
|
1397
1541
|
* / A method that filters rows by caller sets it — see L1's row-level honesty rule.
|
|
1398
1542
|
*/
|
|
1399
|
-
listAgents: ActorMethod<[bigint, bigint],
|
|
1543
|
+
listAgents: ActorMethod<[bigint, bigint], Result_49>;
|
|
1400
1544
|
/**
|
|
1401
1545
|
* / The GUARDIAN-audience projection of the agent roster — three fields, not the full record.
|
|
1402
1546
|
* /
|
|
@@ -1410,7 +1554,7 @@ export interface Engram {
|
|
|
1410
1554
|
* / guardian consults BEFORE REVOKING ONE. A fabricated empty here does not merely misinform —
|
|
1411
1555
|
* / it tells someone acting under emergency powers that there is nothing to act on.
|
|
1412
1556
|
*/
|
|
1413
|
-
listAgentsForGuardian: ActorMethod<[bigint, bigint],
|
|
1557
|
+
listAgentsForGuardian: ActorMethod<[bigint, bigint], Result_48>;
|
|
1414
1558
|
/**
|
|
1415
1559
|
* / Owner-only: rows carry caller, amount, operation and free-text rationale. The SDK omits it.
|
|
1416
1560
|
* /
|
|
@@ -1424,7 +1568,7 @@ export interface Engram {
|
|
|
1424
1568
|
* /
|
|
1425
1569
|
* / Refusal reason preserved: `[]` reads as "nothing is awaiting the owner's decision".
|
|
1426
1570
|
*/
|
|
1427
|
-
listApprovalRequests: ActorMethod<[[] | [ApprovalStatus], bigint, bigint],
|
|
1571
|
+
listApprovalRequests: ActorMethod<[[] | [ApprovalStatus], bigint, bigint], Result_34>;
|
|
1428
1572
|
/**
|
|
1429
1573
|
* / ⟨0.16.0⟩ `total` IS THE HEAD COUNTER, and on this method that is the entire point.
|
|
1430
1574
|
* /
|
|
@@ -1460,7 +1604,7 @@ export interface Engram {
|
|
|
1460
1604
|
* / at read time; nothing new is stored. WHAT WOULD MAKE THIS WRONG: a sealed row carrying any part
|
|
1461
1605
|
* / of a body, or a stranger reaching `items` (test/record-view.test.mo pins both).
|
|
1462
1606
|
*/
|
|
1463
|
-
listAuditEntries: ActorMethod<[bigint, bigint],
|
|
1607
|
+
listAuditEntries: ActorMethod<[bigint, bigint], Result_47>;
|
|
1464
1608
|
/**
|
|
1465
1609
|
* / ⟨0.16.0, L1 + L3 — census-ruled⟩ THE TWO-MECHANISM EXCEPTION DISSOLVES.
|
|
1466
1610
|
* /
|
|
@@ -1486,7 +1630,7 @@ export interface Engram {
|
|
|
1486
1630
|
* / keeps its optional filter and applies it to the page, so no caller loses the ability to ask
|
|
1487
1631
|
* / "backups of this database" — it stops being a thing the canister has to page around.
|
|
1488
1632
|
*/
|
|
1489
|
-
listBackups: ActorMethod<[bigint, bigint],
|
|
1633
|
+
listBackups: ActorMethod<[bigint, bigint], Result_46>;
|
|
1490
1634
|
/**
|
|
1491
1635
|
* / List all bearer tokens — Active, Revoked, and Expired. Owner uses this in
|
|
1492
1636
|
* / the dashboard to show installed Connectors (claude.ai, Claude Desktop, etc.).
|
|
@@ -1498,7 +1642,7 @@ export interface Engram {
|
|
|
1498
1642
|
* / merely stopped being used is reported `#Expired`, not a stale `#Active`), so the page carries
|
|
1499
1643
|
* / the same honesty the store gained on 2026-08-17.
|
|
1500
1644
|
*/
|
|
1501
|
-
listBearerTokens: ActorMethod<[bigint, bigint],
|
|
1645
|
+
listBearerTokens: ActorMethod<[bigint, bigint], Result_45>;
|
|
1502
1646
|
/**
|
|
1503
1647
|
* / The condense checkpoints in the retained log at or above `startSeq`, oldest first.
|
|
1504
1648
|
* /
|
|
@@ -1510,7 +1654,7 @@ export interface Engram {
|
|
|
1510
1654
|
* / Owner-only like every other archive surface, and for the same structural reason: these rows
|
|
1511
1655
|
* / carry the chain positions and roots of entries whose paths were inside the hash preimage.
|
|
1512
1656
|
*/
|
|
1513
|
-
listCondenseCheckpoints: ActorMethod<[bigint, bigint],
|
|
1657
|
+
listCondenseCheckpoints: ActorMethod<[bigint, bigint], Result_44>;
|
|
1514
1658
|
/**
|
|
1515
1659
|
* / ⟨0.16.0⟩ `metrics()` DELETED — absorbed by `about()`.
|
|
1516
1660
|
* /
|
|
@@ -1519,13 +1663,13 @@ export interface Engram {
|
|
|
1519
1663
|
* / both and know which one owned each field. Every field here survives on `about()`, day-flooring
|
|
1520
1664
|
* / included.
|
|
1521
1665
|
*/
|
|
1522
|
-
listCycleSnapshots: ActorMethod<[bigint, bigint],
|
|
1666
|
+
listCycleSnapshots: ActorMethod<[bigint, bigint], Result_43>;
|
|
1523
1667
|
/**
|
|
1524
1668
|
* / Same `withheld` treatment as listMemoryFiles — the tombstone listing filtered reserved paths
|
|
1525
1669
|
* / for non-owners just as silently, and a caller could not tell a filtered tombstone list from a
|
|
1526
1670
|
* / complete one. Counted before slicing, so policy-hidden rows never blur into paging.
|
|
1527
1671
|
*/
|
|
1528
|
-
listDeletedMemoryFiles: ActorMethod<[bigint, bigint],
|
|
1672
|
+
listDeletedMemoryFiles: ActorMethod<[bigint, bigint], Result_42>;
|
|
1529
1673
|
/**
|
|
1530
1674
|
* / Stays on the engram under B1 (hybrid): withdrawal custody does not leave.
|
|
1531
1675
|
* /
|
|
@@ -1541,7 +1685,7 @@ export interface Engram {
|
|
|
1541
1685
|
* / The item's field is `value`, not `address`: a list may hold a venue value that is no address.
|
|
1542
1686
|
* / Readable by the owner, an active agent or an active guardian, as the old list was.
|
|
1543
1687
|
*/
|
|
1544
|
-
listEip712Destinations: ActorMethod<[Uint8Array | number[], bigint, bigint],
|
|
1688
|
+
listEip712Destinations: ActorMethod<[Uint8Array | number[], bigint, bigint], Result_41>;
|
|
1545
1689
|
/**
|
|
1546
1690
|
* / The registered shapes — E3: encodeTypeString is the display artifact, verbatim.
|
|
1547
1691
|
* / Stays on the engram under B1 (hybrid): EIP-712 signing is custody, and custody does not leave.
|
|
@@ -1554,7 +1698,15 @@ export interface Engram {
|
|
|
1554
1698
|
* / from `eip712FieldRules` — they are part of what the type authorises, so a reader of the list must
|
|
1555
1699
|
* / not have to make a second call to learn them. The row type is `Eip712TypeView`.
|
|
1556
1700
|
*/
|
|
1557
|
-
listEip712Types: ActorMethod<[bigint, bigint],
|
|
1701
|
+
listEip712Types: ActorMethod<[bigint, bigint], Result_40>;
|
|
1702
|
+
/**
|
|
1703
|
+
* / ⟨2026-10-21, round 11 c⟩ Guardians' disputes, oldest first. Same visibility as
|
|
1704
|
+
* / `listRepudiations` and `listRecordNotes`: the owner and ACTIVE guardians read the rows; an
|
|
1705
|
+
* / agent gets an empty page whose `withheld` counts them (ruling 16 B holds — a dispute is the
|
|
1706
|
+
* / guardian's entry, not the agent's); a stranger, a pending guardian and the anonymous caller are
|
|
1707
|
+
* / refused.
|
|
1708
|
+
*/
|
|
1709
|
+
listGuardianDisputes: ActorMethod<[bigint, bigint], Result_39>;
|
|
1558
1710
|
/**
|
|
1559
1711
|
* / Accessible by owner and guardians.
|
|
1560
1712
|
* /
|
|
@@ -1563,7 +1715,7 @@ export interface Engram {
|
|
|
1563
1715
|
* / pause writes" — a claim about who can STOP it. A caller who cannot tell that from "you may not
|
|
1564
1716
|
* / see the roster" has been told the engram is unguarded when it may be fully guarded.
|
|
1565
1717
|
*/
|
|
1566
|
-
listGuardians: ActorMethod<[bigint, bigint],
|
|
1718
|
+
listGuardians: ActorMethod<[bigint, bigint], Result_38>;
|
|
1567
1719
|
/**
|
|
1568
1720
|
* / The export receipts in the retained log at or above `startSeq`, oldest first.
|
|
1569
1721
|
* /
|
|
@@ -1581,7 +1733,7 @@ export interface Engram {
|
|
|
1581
1733
|
* / Read `MemoryRouter.ReceiptPage` before reading `page.total` as a receipt count. It is not one;
|
|
1582
1734
|
* / it is the chain's length, and the declaration says why.
|
|
1583
1735
|
*/
|
|
1584
|
-
listMemoryExportReceipts: ActorMethod<[bigint, bigint],
|
|
1736
|
+
listMemoryExportReceipts: ActorMethod<[bigint, bigint], Result_37>;
|
|
1585
1737
|
/**
|
|
1586
1738
|
* / ⟨0.16.0⟩ THE `withheld` EXEMPLAR — L1 names this exact method as the defect it fixes.
|
|
1587
1739
|
* /
|
|
@@ -1598,8 +1750,17 @@ export interface Engram {
|
|
|
1598
1750
|
* / Note the count is computed from the unfiltered list before slicing, so it reports rows hidden
|
|
1599
1751
|
* / by POLICY, never rows merely off the end of this page — those are `total`'s job. Conflating
|
|
1600
1752
|
* / the two would rebuild the ambiguity in a new place.
|
|
1753
|
+
* /
|
|
1754
|
+
* / ⟨2026-10-21, the owner's round-11 answer k: an author on every file row⟩ Each row also
|
|
1755
|
+
* / carries `lastModifiedBy` (`Types.MemoryFileRow`): the key that wrote the file's current
|
|
1756
|
+
* / version, so a phone's file list can say "changed 2 h ago by Recorder" without a read per
|
|
1757
|
+
* / file. It is what `readMemory` already serves to the same callers under the same gate, so it
|
|
1758
|
+
* / tells no caller anything it could not read. Born `opt` (ADR-0018 rule 1). Looked up only for
|
|
1759
|
+
* / the rows of THIS page (`MemoryRouter.info`), after the slice, so the cost is one lookup per
|
|
1760
|
+
* / row served, never one per file stored. A WIDENED REPLY: a reader that decodes the row by
|
|
1761
|
+
* / position rather than by field name breaks — none in this repository does.
|
|
1601
1762
|
*/
|
|
1602
|
-
listMemoryFiles: ActorMethod<[bigint, bigint],
|
|
1763
|
+
listMemoryFiles: ActorMethod<[bigint, bigint], Result_36>;
|
|
1603
1764
|
/**
|
|
1604
1765
|
* / One page of the memory log, seq-ordered, optionally narrowed to one author.
|
|
1605
1766
|
* /
|
|
@@ -1626,7 +1787,7 @@ export interface Engram {
|
|
|
1626
1787
|
* / with the disclosures that make the page verifiable — the hidden-bound defect the census itself
|
|
1627
1788
|
* / names on previewCondense's row.
|
|
1628
1789
|
*/
|
|
1629
|
-
listMemoryLog: ActorMethod<[bigint, bigint, [] | [Principal]],
|
|
1790
|
+
listMemoryLog: ActorMethod<[bigint, bigint, [] | [Principal]], Result_35>;
|
|
1630
1791
|
/**
|
|
1631
1792
|
* / The caller's OWN spend-approval requests. ⟨0.16.0, L1 + L3 — fixed 2026-08-18⟩
|
|
1632
1793
|
* /
|
|
@@ -1645,7 +1806,7 @@ export interface Engram {
|
|
|
1645
1806
|
* / (The unbounded MAP is filed separately — pruning an approval record destroys evidence of what
|
|
1646
1807
|
* / was asked, which is a retention ruling rather than a shape fix.)
|
|
1647
1808
|
*/
|
|
1648
|
-
listMyApprovalRequests: ActorMethod<[bigint, bigint],
|
|
1809
|
+
listMyApprovalRequests: ActorMethod<[bigint, bigint], Result_34>;
|
|
1649
1810
|
/**
|
|
1650
1811
|
* / The payer's own sessions, live ones first. PAYER-SCOPED: a caller sees only their own, which
|
|
1651
1812
|
* / is why this needs no role — a session id is not a secret from the person who paid for it.
|
|
@@ -1656,7 +1817,7 @@ export interface Engram {
|
|
|
1656
1817
|
* / client would break on — the market paged its own pending withdrawals before its cut for the
|
|
1657
1818
|
* / same reason. The order is the order sessions were opened.
|
|
1658
1819
|
*/
|
|
1659
|
-
listMySessions: ActorMethod<[bigint, bigint],
|
|
1820
|
+
listMySessions: ActorMethod<[bigint, bigint], Result_33>;
|
|
1660
1821
|
/**
|
|
1661
1822
|
* /
|
|
1662
1823
|
* / ⟨0.16.0, L3⟩ Paged and enveloped like every other `list*`, and the envelope here is uniformity
|
|
@@ -1671,7 +1832,7 @@ export interface Engram {
|
|
|
1671
1832
|
* / IT recorded, so this chain is what a caller composes with when currency matters — which it
|
|
1672
1833
|
* / cannot do if it needs a role here.
|
|
1673
1834
|
*/
|
|
1674
|
-
listOwnershipTransfers: ActorMethod<[bigint, bigint],
|
|
1835
|
+
listOwnershipTransfers: ActorMethod<[bigint, bigint], Result_32>;
|
|
1675
1836
|
/**
|
|
1676
1837
|
* / ⟨2026-09-29, the platform's question from the build review⟩ OWNER-ONLY: how many payment
|
|
1677
1838
|
* / signatures each agent has obtained today, and the daily limit (200, `PaymentSignCap`). The
|
|
@@ -1689,7 +1850,7 @@ export interface Engram {
|
|
|
1689
1850
|
* / engram enforces for it — beside the agents, never a row among them
|
|
1690
1851
|
* / (`PaymentSignCap.marketplaceRow`). Null when no marketplace is set.
|
|
1691
1852
|
*/
|
|
1692
|
-
listPaymentSignatureCounts: ActorMethod<[bigint, bigint],
|
|
1853
|
+
listPaymentSignatureCounts: ActorMethod<[bigint, bigint], Result_31>;
|
|
1693
1854
|
/**
|
|
1694
1855
|
* / Agent records removed by a reset. Each row is a NAMED record with the fields `principal`,
|
|
1695
1856
|
* / `name`, `registeredAt` and `purgedAt` — read them BY NAME, never by position.
|
|
@@ -1731,7 +1892,7 @@ export interface Engram {
|
|
|
1731
1892
|
* / earlier ending, or the reset) — the facts `resyncAgentEdges` re-sends. The stored rows are
|
|
1732
1893
|
* / served as they are.
|
|
1733
1894
|
*/
|
|
1734
|
-
listPurgedAgents: ActorMethod<[bigint, bigint],
|
|
1895
|
+
listPurgedAgents: ActorMethod<[bigint, bigint], Result_30>;
|
|
1735
1896
|
/**
|
|
1736
1897
|
* / ⟨0.16.0⟩ ONE ACCESSOR, folding `readReadLog` and `getDenialLog` — and the fold only became
|
|
1737
1898
|
* / safe because of a change made earlier in this same leg.
|
|
@@ -1794,7 +1955,15 @@ export interface Engram {
|
|
|
1794
1955
|
* / on the chained record — the same `RecordView` filter, and `withheld` counts what it removed
|
|
1795
1956
|
* / together with what `successFilter` removed. WHAT WOULD MAKE THIS WRONG: see `listAuditEntries`.
|
|
1796
1957
|
*/
|
|
1797
|
-
listReadLog: ActorMethod<[[] | [boolean], bigint, bigint],
|
|
1958
|
+
listReadLog: ActorMethod<[[] | [boolean], bigint, bigint], Result_29>;
|
|
1959
|
+
/**
|
|
1960
|
+
* / ⟨2026-10-21, round 11 b⟩ The owner's notes, oldest first. Same visibility as
|
|
1961
|
+
* / `listRepudiations`, for the same reason: the owner and ACTIVE guardians read the rows; an agent
|
|
1962
|
+
* / reads only the entries it caused (follow-up 16 B), and every note is the owner's, so an agent
|
|
1963
|
+
* / gets an empty page whose `withheld` counts the notes in its window — never "there are none". A
|
|
1964
|
+
* / stranger, a pending guardian and the anonymous caller are refused.
|
|
1965
|
+
*/
|
|
1966
|
+
listRecordNotes: ActorMethod<[bigint, bigint], Result_28>;
|
|
1798
1967
|
/**
|
|
1799
1968
|
* / Same visibility as listAuditEntries: the owner, this engram's agents, and ACTIVE guardians
|
|
1800
1969
|
* / see disputes. An unauthorized read REFUSES — it does not return an empty list, because an
|
|
@@ -1811,7 +1980,18 @@ export interface Engram {
|
|
|
1811
1980
|
* / WOULD MAKE THIS WRONG: a ruling that an agent may see the disputes of its own writes; this would
|
|
1812
1981
|
* / then have to look up each disputed version's writer, which it does not do today.
|
|
1813
1982
|
*/
|
|
1814
|
-
listRepudiations: ActorMethod<[bigint, bigint],
|
|
1983
|
+
listRepudiations: ActorMethod<[bigint, bigint], Result_27>;
|
|
1984
|
+
/**
|
|
1985
|
+
* / ⟨2026-10-21, the owner's round-11 answer f⟩ OWNER-ONLY: the sign-ins, each with the name its app
|
|
1986
|
+
* / registered. The same tokens, in the same order and paged the same way, as `listBearerTokens`,
|
|
1987
|
+
* / each beside `clientName` — the RFC 7591 `client_name` the app registered when the token was
|
|
1988
|
+
* / issued (`People.SignIn` says when it is null, and that it is the app's own claim). A phone
|
|
1989
|
+
* / owner read "localhost" for every app signed in through a local bridge and could not tell two
|
|
1990
|
+
* / apps apart. A NEW method rather than a field on `BearerToken`: that record is stored (M0170)
|
|
1991
|
+
* / and `listBearerTokens`' reply is shipped (never widened). An agent, a guardian, a stranger and
|
|
1992
|
+
* / the anonymous caller are refused, by `listBearerTokens`' own gate and for its reason.
|
|
1993
|
+
*/
|
|
1994
|
+
listSignIns: ActorMethod<[bigint, bigint], Result_26>;
|
|
1815
1995
|
/**
|
|
1816
1996
|
* / Owner: advance the review cursor — "I have seen everything up to and including uptoAuditId"
|
|
1817
1997
|
* / (null = everything at the current head). Bounded so the attestation can never cover entries
|
|
@@ -1823,7 +2003,20 @@ export interface Engram {
|
|
|
1823
2003
|
* / and this never inspects an operation or a role. Widening what the review shows therefore
|
|
1824
2004
|
* / changes only which ids the console can pass here — it cannot desynchronise the cursor.
|
|
1825
2005
|
*/
|
|
1826
|
-
markAgentWritesReviewed: ActorMethod<[[] | [bigint]],
|
|
2006
|
+
markAgentWritesReviewed: ActorMethod<[[] | [bigint]], Result_13>;
|
|
2007
|
+
/**
|
|
2008
|
+
* / ⟨2026-10-21, the owner's round-11 answer g⟩ AN AGENT READS ITS OWN GRANT — to the calling key
|
|
2009
|
+
* / only (`People.AgentGrant`): what it may read, where it may write, its rate, and the payment
|
|
2010
|
+
* / limits enforced against that key. It reveals nothing a refusal does not already say, and lets
|
|
2011
|
+
* / an agent correct itself before it writes rather than after the owner explains a refusal by
|
|
2012
|
+
* / hand. `getSpendPolicy` and `listAgents` stay owner-only; this answers one row, the caller's.
|
|
2013
|
+
* /
|
|
2014
|
+
* / WHO: an ACTIVE agent (`Gated.authorize(#agentOrOwner)`). Refused, each by its own text: the
|
|
2015
|
+
* / owner by name (`People.OWNER_HAS_NO_GRANT`), a revoked or resigned agent ("Agent is revoked" /
|
|
2016
|
+
* / "Agent has resigned" — an ended agent may do nothing, and its old grant would read as powers),
|
|
2017
|
+
* / a guardian and a stranger ("Not authorized"), the anonymous caller. A query: it writes nothing.
|
|
2018
|
+
*/
|
|
2019
|
+
myGrant: ActorMethod<[], Result_25>;
|
|
1827
2020
|
/**
|
|
1828
2021
|
* / The AGENT's current key nominates the key that will replace it. Nothing moves yet: the new
|
|
1829
2022
|
* / key must accept, by its own call, within 24 hours (`acceptAgentKeyNomination`). One pending
|
|
@@ -1862,8 +2055,8 @@ export interface Engram {
|
|
|
1862
2055
|
* / WHAT WOULD MAKE THIS WRONG: an await added between `ChildAllowance.take` and the registry call; the
|
|
1863
2056
|
* / registry's `CHILD_MIN_ATTACHED_CYCLES` moving without `CHILD_ATTACH_CYCLES`.
|
|
1864
2057
|
*/
|
|
1865
|
-
openChildEngram: ActorMethod<[],
|
|
1866
|
-
openSession: ActorMethod<[SessionConfig, PaymentSignature],
|
|
2058
|
+
openChildEngram: ActorMethod<[], Result_24>;
|
|
2059
|
+
openSession: ActorMethod<[SessionConfig, PaymentSignature], Result_23>;
|
|
1867
2060
|
/**
|
|
1868
2061
|
* / Withdraw tokens to the owner's principal. This is the ONLY way to
|
|
1869
2062
|
* / move tokens out of the engram to an external address, and the
|
|
@@ -1871,7 +2064,7 @@ export interface Engram {
|
|
|
1871
2064
|
* / NOT freeze-gated: the owner always controls their own funds.
|
|
1872
2065
|
* / Guardian freeze only blocks agent/public operations.
|
|
1873
2066
|
*/
|
|
1874
|
-
ownerWithdraw: ActorMethod<[TokenAmount, [] | [ActionAuth]],
|
|
2067
|
+
ownerWithdraw: ActorMethod<[TokenAmount, [] | [ActionAuth]], Result_13>;
|
|
1875
2068
|
/**
|
|
1876
2069
|
* / ⟨0.16.0⟩ `payRentFromEarnings` DELETED — ruled TWICE (B1 and B2), and it was the single
|
|
1877
2070
|
* / clearest violation of the OSS/platform split in this repo.
|
|
@@ -1928,12 +2121,17 @@ export interface Engram {
|
|
|
1928
2121
|
* / engagement on the agent's track record, and what to do. Before, the reply was `#Ok` with the
|
|
1929
2122
|
* / record alone even when the registry had refused the start, so the agent was never told.
|
|
1930
2123
|
*/
|
|
1931
|
-
pairAgent: ActorMethod<[{ enrolment: Enrolment; code: string }],
|
|
2124
|
+
pairAgent: ActorMethod<[{ enrolment: Enrolment; code: string }], Result_22>;
|
|
1932
2125
|
/**
|
|
1933
2126
|
* / ⟨0.16.0, L2.2 — renamed from `guardianPauseWrites`⟩ Same correction as freezePayments above:
|
|
1934
2127
|
* / owner-or-guardian, and `resumeWrites` never carried the prefix either.
|
|
1935
2128
|
*/
|
|
1936
2129
|
pauseWrites: ActorMethod<[], Result_1>;
|
|
2130
|
+
/**
|
|
2131
|
+
* / ⟨2026-10-21, the owner's round-11 answer d⟩ `pauseWrites` with a reason; everything said of
|
|
2132
|
+
* / `freezePaymentsWithReason` holds, with `canPauseWrites` as the guardian's grant.
|
|
2133
|
+
*/
|
|
2134
|
+
pauseWritesWithReason: ActorMethod<[string], Result_1>;
|
|
1937
2135
|
/**
|
|
1938
2136
|
* / What condensing through `toSeq` would do, and whether it is unlocked. COMMITS NOTHING — it is
|
|
1939
2137
|
* / a query, so it structurally cannot; a preview that wrote would be its own trap.
|
|
@@ -1954,7 +2152,7 @@ export interface Engram {
|
|
|
1954
2152
|
* / `unlocked` is the export-receipt gate ONLY. It is not a promise the condense will land: the
|
|
1955
2153
|
* / history-budget delta is checked at commit time and can still refuse a short prefix.
|
|
1956
2154
|
*/
|
|
1957
|
-
previewCondense: ActorMethod<[bigint],
|
|
2155
|
+
previewCondense: ActorMethod<[bigint], Result_21>;
|
|
1958
2156
|
/**
|
|
1959
2157
|
* / A quote for a session this caller has not opened and is not committed to — the intent a
|
|
1960
2158
|
* / buyer signs against. Pure dry run, no state, no funds.
|
|
@@ -1984,6 +2182,26 @@ export interface Engram {
|
|
|
1984
2182
|
* / `expiryNs`. Same value, same meaning; only the name carries the unit now.
|
|
1985
2183
|
*/
|
|
1986
2184
|
previewOpenSession: ActorMethod<[], SessionIntent>;
|
|
2185
|
+
/**
|
|
2186
|
+
* / ⟨2026-10-21, the owner's round-11 answer k: a trim preview⟩ What a PROPOSED history policy
|
|
2187
|
+
* / would remove from the store as it stands — "about N old copies in F files would be removed" —
|
|
2188
|
+
* / asked BEFORE the owner saves it. A query: nothing is saved, armed or evicted.
|
|
2189
|
+
* /
|
|
2190
|
+
* / WHO: the OWNER only (`#ownerOnly`). An agent, a guardian, a stranger and the anonymous caller
|
|
2191
|
+
* / are each refused with `requireOwner`'s words; the setter it previews is owner-only too.
|
|
2192
|
+
* /
|
|
2193
|
+
* / HOW: the proposal must pass the setter's own checks (`retentionEntriesRefusal`), so the preview
|
|
2194
|
+
* / never answers for a policy the setter would refuse. The guards a save would arm are computed
|
|
2195
|
+
* / exactly as the setter computes them (`RetentionPolicy.armGuards`), and each file is planned by
|
|
2196
|
+
* / the planner the sweep executes (`MemoryRouter.previewEviction` → `Retention.plan`), as the
|
|
2197
|
+
* / owner (the sweep's `maintainPrincipal`), AT THE INSTANT its guard lets go — so a rule that
|
|
2198
|
+
* / waits 14 days is counted as it will stand then, when the agent floor has released more. Per
|
|
2199
|
+
* / rule: copies, files, bytes and `notBeforeNs`. The count is "about": writes before the rule
|
|
2200
|
+
* / takes effect change it.
|
|
2201
|
+
* / HONEST WHEN CUT SHORT: `complete = false` when the planning budget
|
|
2202
|
+
* / (`MemoryRouter.PREVIEW_MAX_DROPS`) ran out — the totals are then a floor, and say so.
|
|
2203
|
+
*/
|
|
2204
|
+
previewRetention: ActorMethod<[Array<[string, RetentionClassSpec]>], Result_20>;
|
|
1987
2205
|
/**
|
|
1988
2206
|
* / Read one memory file at its current version.
|
|
1989
2207
|
* /
|
|
@@ -2000,7 +2218,7 @@ export interface Engram {
|
|
|
2000
2218
|
* / (`sessionReadContext` and the MCP reads). A caller measuring engram usage from this method
|
|
2001
2219
|
* / will measure nothing.
|
|
2002
2220
|
*/
|
|
2003
|
-
readMemory: ActorMethod<[string],
|
|
2221
|
+
readMemory: ActorMethod<[string], Result_11>;
|
|
2004
2222
|
/**
|
|
2005
2223
|
* / Read many paths in one call. Per-path Results are KEPT — partial success is the point, and
|
|
2006
2224
|
* / one unreadable path must not fail the other nine.
|
|
@@ -2018,7 +2236,7 @@ export interface Engram {
|
|
|
2018
2236
|
* / path, each with its own Result — a refused RESERVED path sits beside a readable one, which is
|
|
2019
2237
|
* / a genuine per-path fact.
|
|
2020
2238
|
*/
|
|
2021
|
-
readMemoryBatch: ActorMethod<[Array<string>],
|
|
2239
|
+
readMemoryBatch: ActorMethod<[Array<string>], Result_19>;
|
|
2022
2240
|
/**
|
|
2023
2241
|
* / ⟨0.16.0⟩ `getMemoryRetentionGuards` DELETED — folded into `getMemoryRetentionPolicy` above.
|
|
2024
2242
|
* / It was the second L2.1 array-returning `get*`, and separating it from the policy it modifies
|
|
@@ -2030,7 +2248,7 @@ export interface Engram {
|
|
|
2030
2248
|
* / see it cannot know whether it has the whole range, which is how silent truncation gets
|
|
2031
2249
|
* / reintroduced. Loop while `more` is true, advancing by the bytes actually returned.
|
|
2032
2250
|
*/
|
|
2033
|
-
readMemoryBytes: ActorMethod<[string, bigint, bigint, [] | [bigint]],
|
|
2251
|
+
readMemoryBytes: ActorMethod<[string, bigint, bigint, [] | [bigint]], Result_18>;
|
|
2034
2252
|
/**
|
|
2035
2253
|
* / The escrow exit for a session whose settle cannot pay.
|
|
2036
2254
|
* /
|
|
@@ -2095,7 +2313,7 @@ export interface Engram {
|
|
|
2095
2313
|
* / the amount can be read back — a session closed in the same moment as the recovery and cleaned up
|
|
2096
2314
|
* / during its transfer — it answers `#Other` naming the block, never a guessed amount.
|
|
2097
2315
|
*/
|
|
2098
|
-
recoverEscrow: ActorMethod<[string, bigint],
|
|
2316
|
+
recoverEscrow: ActorMethod<[string, bigint], Result_17>;
|
|
2099
2317
|
/**
|
|
2100
2318
|
* / ⟨0.16.0, L1⟩ A REDEMPTION PATH, where the arm choice is a disclosure decision.
|
|
2101
2319
|
* /
|
|
@@ -2111,7 +2329,7 @@ export interface Engram {
|
|
|
2111
2329
|
* / owner's invite gave them and that they cannot act until approved; before, that took a second
|
|
2112
2330
|
* / read they had no reason to know to make.
|
|
2113
2331
|
*/
|
|
2114
|
-
registerGuardian: ActorMethod<[string],
|
|
2332
|
+
registerGuardian: ActorMethod<[string], Result_16>;
|
|
2115
2333
|
/**
|
|
2116
2334
|
* / Remove a per-caller override so that caller reverts to — and keeps TRACKING — the global caps.
|
|
2117
2335
|
* /
|
|
@@ -2150,12 +2368,25 @@ export interface Engram {
|
|
|
2150
2368
|
* / line, so the roster is theirs and its contents are not a secret being withheld from them.
|
|
2151
2369
|
*/
|
|
2152
2370
|
removeGuardian: ActorMethod<[Principal], Result_1>;
|
|
2371
|
+
/**
|
|
2372
|
+
* / ⟨2026-10-21, the owner's round-11 answer a⟩ OWNER-ONLY: give an agent a new name. A name was
|
|
2373
|
+
* / fixed at the invite, and two agents both called "agent" is how the 2026-10-20 session started.
|
|
2374
|
+
* / Only the VALUE of the stored `AgentRecord.name` changes — no new state, no reshaped record —
|
|
2375
|
+
* / and the change is on the record as `agent.rename` (`principal=<key> name=<new name>`, the name
|
|
2376
|
+
* / last). An ended agent may be renamed too (`People.renameTarget` says why).
|
|
2377
|
+
* / Refused: an agent (itself included), a guardian and a stranger by `requireOwner`'s "Not owner",
|
|
2378
|
+
* / the anonymous caller by its own text; a name that is empty, over `MAX_NAME_LENGTH` or holds a
|
|
2379
|
+
* / line break is `#Invalid` (`People.nameRefusal`); an unknown key is `#NotFound`; the agent's
|
|
2380
|
+
* / current name is `#Conflict`. Nothing changes on any refusal. Not alerted: the owner is the one
|
|
2381
|
+
* / renaming (`ActionAlerts.classify` answers null for `agent.rename`).
|
|
2382
|
+
*/
|
|
2383
|
+
renameAgent: ActorMethod<[Principal, string], Result_1>;
|
|
2153
2384
|
/**
|
|
2154
2385
|
* / Owner disavows a specific memory write, in the open. Marks — never deletes: the content and
|
|
2155
2386
|
* / the original audit entry stay exactly where they were; this appends a chained
|
|
2156
2387
|
* / `memory.repudiate` entry and lists the (path, version) so readers can see the dispute.
|
|
2157
2388
|
*/
|
|
2158
|
-
repudiateMemoryWrite: ActorMethod<[string, bigint, string],
|
|
2389
|
+
repudiateMemoryWrite: ActorMethod<[string, bigint, string], Result_13>;
|
|
2159
2390
|
/**
|
|
2160
2391
|
* / ⚠ OWNER-ONLY BULK RESET. Destructive, and wider than its name suggests.
|
|
2161
2392
|
* /
|
|
@@ -2185,7 +2416,7 @@ export interface Engram {
|
|
|
2185
2416
|
* / long-lived enough for the rent model to apply, the reset entry is not guaranteed to still be
|
|
2186
2417
|
* / there. `agentPurgeLog` is the evidence that does not age out — which is why it exists.
|
|
2187
2418
|
*/
|
|
2188
|
-
resetEngram: ActorMethod<[],
|
|
2419
|
+
resetEngram: ActorMethod<[], Result_15>;
|
|
2189
2420
|
/**
|
|
2190
2421
|
* / ⟨2026-09-28, owner decision: an agent can resign from an engram, and the resignation is
|
|
2191
2422
|
* / recorded⟩ The AGENT ends its own engagement with this engram.
|
|
@@ -2237,7 +2468,7 @@ export interface Engram {
|
|
|
2237
2468
|
* / each such engagement under `cannotBeRecorded` (key, root, invite, and how and when it ended),
|
|
2238
2469
|
* / apart from `notRecorded`, so the owner sees them rather than silence.
|
|
2239
2470
|
*/
|
|
2240
|
-
resyncAgentEdges: ActorMethod<[],
|
|
2471
|
+
resyncAgentEdges: ActorMethod<[], Result_14>;
|
|
2241
2472
|
/**
|
|
2242
2473
|
* / Return to managed custody: the engram adds the registry back as a controller ALONGSIDE the
|
|
2243
2474
|
* / owner — it does not remove the owner. The inverse of `claimSovereignty`, and the reason
|
|
@@ -2299,7 +2530,7 @@ export interface Engram {
|
|
|
2299
2530
|
* / that fails leaves the agents revoked here regardless — a partial notify is not a partial
|
|
2300
2531
|
* / revocation, which is the direction that matters for a panic button.
|
|
2301
2532
|
*/
|
|
2302
|
-
revokeAllAgents: ActorMethod<[],
|
|
2533
|
+
revokeAllAgents: ActorMethod<[], Result_13>;
|
|
2303
2534
|
/**
|
|
2304
2535
|
* / Owner-only panic button: revoke every connector bearer token at once. Returns how many.
|
|
2305
2536
|
* /
|
|
@@ -2310,7 +2541,7 @@ export interface Engram {
|
|
|
2310
2541
|
* /
|
|
2311
2542
|
* / Tokens are re-issuable: revoking them is not permanent the way revoking an agent is.
|
|
2312
2543
|
*/
|
|
2313
|
-
revokeAllBearerTokens: ActorMethod<[],
|
|
2544
|
+
revokeAllBearerTokens: ActorMethod<[], Result_13>;
|
|
2314
2545
|
/**
|
|
2315
2546
|
* / ⟨0.16.0⟩ `removeAllGuardians` DELETED — test-only (L6), and verified NOT part of KILL-SWITCH's
|
|
2316
2547
|
* / mass-revoke set. The destructive phase-07 suite iterates `removeGuardian` instead, so nothing
|
|
@@ -2324,7 +2555,7 @@ export interface Engram {
|
|
|
2324
2555
|
* / Unlike revoking an agent, this costs nothing permanently — an invite is a one-time code,
|
|
2325
2556
|
* / so voiding it and minting a fresh one is the ordinary path.
|
|
2326
2557
|
*/
|
|
2327
|
-
revokeAllInvites: ActorMethod<[],
|
|
2558
|
+
revokeAllInvites: ActorMethod<[], Result_13>;
|
|
2328
2559
|
/**
|
|
2329
2560
|
* / Revoke a bearer token by its public tokenId. Idempotent.
|
|
2330
2561
|
* / Subsequent /mcp requests using this token will be rejected.
|
|
@@ -2403,7 +2634,7 @@ export interface Engram {
|
|
|
2403
2634
|
* / CIPHERTEXT; the key-holding SDK decrypts it. A caller without the key gets bytes it cannot
|
|
2404
2635
|
* / read, not an error.
|
|
2405
2636
|
*/
|
|
2406
|
-
sessionReadContext: ActorMethod<[string],
|
|
2637
|
+
sessionReadContext: ActorMethod<[string], Result_12>;
|
|
2407
2638
|
/**
|
|
2408
2639
|
* / Read one memory file against a PAID x402 session voucher. No role, no invite — the voucher is
|
|
2409
2640
|
* / the authorization, which is what makes this the engram's one rail a stranger can pay to use.
|
|
@@ -2435,7 +2666,7 @@ export interface Engram {
|
|
|
2435
2666
|
* / cent voucher could read `secrets/*`.
|
|
2436
2667
|
* / · Payments are frozen on this engram.
|
|
2437
2668
|
*/
|
|
2438
|
-
sessionReadMemory: ActorMethod<[Voucher, string],
|
|
2669
|
+
sessionReadMemory: ActorMethod<[Voucher, string], Result_11>;
|
|
2439
2670
|
/**
|
|
2440
2671
|
* / Configure action alerts: an https webhook that receives new chained-audit entries matching the
|
|
2441
2672
|
* / enabled event classes (money / approvals / guardian / agentWrites), batched, at most one
|
|
@@ -2481,8 +2712,14 @@ export interface Engram {
|
|
|
2481
2712
|
* / called it an "ops floor: retention enforcement deletes owner backup data silently", mitigated
|
|
2482
2713
|
* / by a `Debug.print` nobody reads. An owner lowering the cap is destroying their own backups;
|
|
2483
2714
|
* / they are told how many, in the reply and in the audit line.
|
|
2715
|
+
* /
|
|
2716
|
+
* / ⟨2026-10-21, the owner's round-11 answers h and m⟩ The number now bounds EACH creator's
|
|
2717
|
+
* / backups of the kind (`Backup.enforceRetention`): an agent's finalize prunes only that agent's
|
|
2718
|
+
* / own, and this setter applies the number to every creator's set, so `prunedBackups` counts
|
|
2719
|
+
* / across all of them. "The write is the read" above went stale for a second phone, which never
|
|
2720
|
+
* / made the write: `getBackupRetention` is the read.
|
|
2484
2721
|
*/
|
|
2485
|
-
setBackupRetention: ActorMethod<[string, bigint],
|
|
2722
|
+
setBackupRetention: ActorMethod<[string, bigint], Result_10>;
|
|
2486
2723
|
/**
|
|
2487
2724
|
* / Override the caps for ONE caller — an agent this owner trusts more, or less, than the rest.
|
|
2488
2725
|
*/
|
|
@@ -2546,7 +2783,12 @@ export interface Engram {
|
|
|
2546
2783
|
*/
|
|
2547
2784
|
setGuardianAlertConfig: ActorMethod<[AlertConfig], Result_1>;
|
|
2548
2785
|
/**
|
|
2549
|
-
* / Per-prefix retention policy.
|
|
2786
|
+
* / Per-prefix retention policy. The longest rule that covers a path wins; anything uncovered
|
|
2787
|
+
* / keeps everything.
|
|
2788
|
+
* /
|
|
2789
|
+
* / ⟨2026-10-21, the owner's round-11 answer i⟩ "Covers" is the folder matcher
|
|
2790
|
+
* / (`AgentPaths.covers`, through `RetentionPolicy.resolve`): a rule ending in "/" governs
|
|
2791
|
+
* / everything beneath it, any other rule exactly one path. It was bare text prefix until that day.
|
|
2550
2792
|
* /
|
|
2551
2793
|
* / A CHANGE does not take effect immediately, in EITHER direction: every prefix whose EFFECTIVE
|
|
2552
2794
|
* / class moves is guarded for the same window as the agent floor, so history cannot be
|
|
@@ -2738,7 +2980,7 @@ export interface Engram {
|
|
|
2738
2980
|
maxPriorityFeePerGas: bigint;
|
|
2739
2981
|
},
|
|
2740
2982
|
],
|
|
2741
|
-
|
|
2983
|
+
Result_9
|
|
2742
2984
|
>;
|
|
2743
2985
|
/**
|
|
2744
2986
|
* / Sign an EIP-3009 authorization for x402 payment. Agent-accessible.
|
|
@@ -2777,6 +3019,28 @@ export interface Engram {
|
|
|
2777
3019
|
],
|
|
2778
3020
|
Result_3
|
|
2779
3021
|
>;
|
|
3022
|
+
/**
|
|
3023
|
+
* / ⟨2026-10-21, the owner's round-11 answer e⟩ A GUARDIAN STEPS DOWN: the caller ends their own
|
|
3024
|
+
* / guardianship of this engram. It removes a power from the one who holds it and grants none.
|
|
3025
|
+
* / Before, only the owner could remove a guardian, so one who wanted out could only stop watching
|
|
3026
|
+
* / without anyone knowing — worse than an honest exit on the record.
|
|
3027
|
+
* /
|
|
3028
|
+
* / WHO: anyone holding a guardian record here, `#Pending` or `#Active`; never refused for the
|
|
3029
|
+
* / record's state. The owner is refused by name (`People.OWNER_IS_NO_GUARDIAN`: their way is
|
|
3030
|
+
* / `removeGuardian`); an agent or a stranger is `#NotFound` (`People.NOT_A_GUARDIAN`, a fact about
|
|
3031
|
+
* / the caller told to the caller, as `resignAgent` does); the anonymous caller is refused.
|
|
3032
|
+
* /
|
|
3033
|
+
* / WHAT IT RECORDS: one `guardian.stepDown` entry under `#Guardian`
|
|
3034
|
+
* / (`principal=<key> was=active|pending name=<name>`). Being a `guardian.*` operation it reaches
|
|
3035
|
+
* / the owner's and the other guardians' alerts in the #guardian class, on by default, and the
|
|
3036
|
+
* / guardian who left gets one farewell delivery before their channel goes (the drain's lazy
|
|
3037
|
+
* / cleanup in `drainActionAlerts`, as for a removed guardian).
|
|
3038
|
+
* /
|
|
3039
|
+
* / WHAT IT LEAVES: a brake this guardian pulled stays on — lifting one is the owner's; their
|
|
3040
|
+
* / disputes stay on the record. Like `removeGuardian`, it is not terminal: the owner may invite
|
|
3041
|
+
* / the same person again.
|
|
3042
|
+
*/
|
|
3043
|
+
stepDownAsGuardian: ActorMethod<[], Result_1>;
|
|
2780
3044
|
/**
|
|
2781
3045
|
* / OWNER force-close, for a session the payer abandoned.
|
|
2782
3046
|
* /
|
|
@@ -2817,7 +3081,7 @@ export interface Engram {
|
|
|
2817
3081
|
* / class (`SeatWeeks.readRefusal`), never an empty list: an empty list is a real answer ("no agent
|
|
2818
3082
|
* / has paired here"), and a fabricated one would be counted as one.
|
|
2819
3083
|
*/
|
|
2820
|
-
sysGetAgentSeatWeeks: ActorMethod<[],
|
|
3084
|
+
sysGetAgentSeatWeeks: ActorMethod<[], Result_8>;
|
|
2821
3085
|
/**
|
|
2822
3086
|
* / The metrics reader the registry designated reads this engram's paid-rail health, in one call:
|
|
2823
3087
|
* / the balance and the line it must stay above, the memory that line is computed from, the sessions
|
|
@@ -2841,7 +3105,7 @@ export interface Engram {
|
|
|
2841
3105
|
* / to freeze. Called by another canister, a query runs replicated and this engram pays for it —
|
|
2842
3106
|
* / a few million cycles an hour, the cost of being watched.
|
|
2843
3107
|
*/
|
|
2844
|
-
sysGetRailHealth: ActorMethod<[],
|
|
3108
|
+
sysGetRailHealth: ActorMethod<[], Result_7>;
|
|
2845
3109
|
/**
|
|
2846
3110
|
* / The cashier reads how many signatures this engram has produced, per caller and in total.
|
|
2847
3111
|
* / ⟨2026-09-28⟩ The owner's decision of that date: a running counter on the engram, exported to
|
|
@@ -2866,7 +3130,20 @@ export interface Engram {
|
|
|
2866
3130
|
* / only engrams the registry confirms run published code, and read a lower count than last time as
|
|
2867
3131
|
* / a reinstall — the reasoning is at `signaturesByCaller`.
|
|
2868
3132
|
*/
|
|
2869
|
-
sysGetSignatureCounts: ActorMethod<[],
|
|
3133
|
+
sysGetSignatureCounts: ActorMethod<[], Result_6>;
|
|
3134
|
+
/**
|
|
3135
|
+
* / Note a restart the registry just made: what this engram owes for it, the floor a repayment may
|
|
3136
|
+
* / not go under, and until when to keep its timers quiet.
|
|
3137
|
+
* /
|
|
3138
|
+
* / CALLER: the registry that spawned this engram, from inside its owner's `restartMyStoppedEngram`,
|
|
3139
|
+
* / and nobody else (ADR-0020) — the same authority as `sysSetBillerId`. The owner's next conversion
|
|
3140
|
+
* / that lands pays the loan back first. The loan is capped at `RestartRepay.LOAN_MAX_CYCLES` and
|
|
3141
|
+
* / the quiet window at 30 minutes, whatever the registry says.
|
|
3142
|
+
*/
|
|
3143
|
+
sysNoteRestart: ActorMethod<
|
|
3144
|
+
[{ keepCycles: bigint; loan: bigint; quietUntilNs: bigint }],
|
|
3145
|
+
Result_1
|
|
3146
|
+
>;
|
|
2870
3147
|
/**
|
|
2871
3148
|
* / Rent lifecycle notice — how the OWNER (not the agent) learns their subscription lapsed. D6
|
|
2872
3149
|
* / shipped the handoff but every alarm it added talks to the operating service's watchdog; the
|
|
@@ -2955,6 +3232,28 @@ export interface Engram {
|
|
|
2955
3232
|
],
|
|
2956
3233
|
Result_1
|
|
2957
3234
|
>;
|
|
3235
|
+
/**
|
|
3236
|
+
* / Give back what a paid security update advanced this engram and the install did not use.
|
|
3237
|
+
* /
|
|
3238
|
+
* / CALLER: the registry that spawned this engram, right after it installed a security update it
|
|
3239
|
+
* / paid for, and nobody else (ADR-0020). Sends the smallest of: the advance, what this engram holds
|
|
3240
|
+
* / above its balance before the update, and what sits above its 30-day reserve plus send headroom
|
|
3241
|
+
* / (`RestartRepay.giveBack`) — attached to the registry's `sysRepayUpgradeAdvance`, which accepts no
|
|
3242
|
+
* / more than it advanced. The registry writes off what is not returned; nothing is owed after.
|
|
3243
|
+
* / ⟨2026-10-26, the owner's review choice 1B: "take back only what we added; anything left over goes
|
|
3244
|
+
* / to the 90-day write-off"⟩ The registry now names the ONE advance it is asking for (`advanceId`,
|
|
3245
|
+
* / the one its deposit for this install put on its ledger) and `advance` is that advance's amount
|
|
3246
|
+
* / alone — never the sum of every advance this engram has out. The engram passes the id back to
|
|
3247
|
+
* / `sysRepayUpgradeAdvance` unchanged, and the registry settles that advance only. The engram's own
|
|
3248
|
+
* / caps are unchanged (`RestartRepay.giveBack`). HONEST LIMIT, unchanged by 1B: the engram cannot
|
|
3249
|
+
* / tell its owner's top-up from the unused advance, so when the install used part of the advance and
|
|
3250
|
+
* / the owner added compute meanwhile, up to the part the install used can still come from the
|
|
3251
|
+
* / owner's top-up (the cap is the advance, not its unused part).
|
|
3252
|
+
*/
|
|
3253
|
+
sysReturnUpgradeAdvance: ActorMethod<
|
|
3254
|
+
[{ balanceBefore: bigint; advanceId: bigint; advance: bigint }],
|
|
3255
|
+
Result_5
|
|
3256
|
+
>;
|
|
2958
3257
|
/**
|
|
2959
3258
|
* / Point this engram at the biller that converts its tokens → cycles. Settable, not hardcoded:
|
|
2960
3259
|
* / coupling is by principal id, so the same wasm runs against any deployment's biller.
|
|
@@ -2973,6 +3272,23 @@ export interface Engram {
|
|
|
2973
3272
|
* / rather than telling an owner to run a call they can no longer make.
|
|
2974
3273
|
*/
|
|
2975
3274
|
sysSetBillerId: ActorMethod<[Principal], Result_1>;
|
|
3275
|
+
/**
|
|
3276
|
+
* / Give this engram its BIRTH CHAIN: its ancestors' birth records and its own, root first, its own
|
|
3277
|
+
* / last ⟨2026-10-26, the owner's lineage rulings L2C-lite and L3A⟩.
|
|
3278
|
+
* /
|
|
3279
|
+
* / CALLER: the registry that spawned this engram, from its birth push or its sweep's retry, and
|
|
3280
|
+
* / nobody else (ADR-0020) — the same authority as `sysSetBillerId`, through the named gate
|
|
3281
|
+
* / `AccessControl.requireSpawningRegistry`. ⚠ THE REGISTRY'S CLIENT DECLARATION IS HAND-WRITTEN
|
|
3282
|
+
* / (`sysSetBirthChain : ([BirthRecord.BirthRecord]) -> async Wire.Result<()>`, in `mintAndPush`): a
|
|
3283
|
+
* / different reply type here traps inside the registry's callback, and a different name leaves every
|
|
3284
|
+
* / newborn without its record, silently retried. test/lineage-wiring.test.ts holds the two equal.
|
|
3285
|
+
* /
|
|
3286
|
+
* / SET ONCE: the same chain again answers `#Ok` and changes nothing (the registry's sweep may re-send
|
|
3287
|
+
* / a push whose reply was lost); a different one is refused `#Conflict`. THE ENGRAM DOES NOT HASH:
|
|
3288
|
+
* / it checks only that the chain ends with its own record. The fingerprints are the registry's to
|
|
3289
|
+
* / certify and the client's `verifyBirthChain` to check.
|
|
3290
|
+
*/
|
|
3291
|
+
sysSetBirthChain: ActorMethod<[Array<BirthRecord>], Result_1>;
|
|
2976
3292
|
/**
|
|
2977
3293
|
* / Point this engram at the commerce satellite allowed to ask it for signatures. ⟨0.16.0, B1⟩
|
|
2978
3294
|
* /
|
|
@@ -3002,7 +3318,10 @@ export interface Engram {
|
|
|
3002
3318
|
* / A CANISTER ONLY: a person's principal, the anonymous principal or the management canister is
|
|
3003
3319
|
* / refused `#Invalid` and nothing changes — a person named here would be handed this engram's seat
|
|
3004
3320
|
* / counts. Set or replaced, never cleared: the owner's control is the switch
|
|
3005
|
-
* / (`setSeatWeeksReadEnabled`), not the pointer.
|
|
3321
|
+
* / (`setSeatWeeksReadEnabled`), not the pointer.
|
|
3322
|
+
* / ⟨CORRECTED 2026-10-26, the owner's lineage ruling L6A⟩ "Set or replaced" is no longer true: it is
|
|
3323
|
+
* / SET ONCE. The same reader again answers `#Ok` and changes nothing; another is refused `#Conflict`
|
|
3324
|
+
* / (`AccessControl.setOnce` says why). Still never cleared. The chained record entry
|
|
3006
3325
|
* / (`metrics.sysSetMetricsReaderId`) is the evidence of when the read was granted, and to whom.
|
|
3007
3326
|
*/
|
|
3008
3327
|
sysSetMetricsReaderId: ActorMethod<[Principal], Result_1>;
|
|
@@ -3201,6 +3520,15 @@ export interface GenesisNote {
|
|
|
3201
3520
|
version: string;
|
|
3202
3521
|
genesisAtNs: bigint;
|
|
3203
3522
|
}
|
|
3523
|
+
export interface GuardianDispute {
|
|
3524
|
+
about: bigint;
|
|
3525
|
+
atNs: bigint;
|
|
3526
|
+
path: [] | [string];
|
|
3527
|
+
auditId: bigint;
|
|
3528
|
+
version: [] | [bigint];
|
|
3529
|
+
guardian: Principal;
|
|
3530
|
+
reason: string;
|
|
3531
|
+
}
|
|
3204
3532
|
export interface GuardianPermissions {
|
|
3205
3533
|
canFreezePayments: boolean;
|
|
3206
3534
|
canRevokeAgents: boolean;
|
|
@@ -3248,7 +3576,7 @@ export interface KeyNomination {
|
|
|
3248
3576
|
export interface LogPage {
|
|
3249
3577
|
firstAvailableSeq: bigint;
|
|
3250
3578
|
head: Uint8Array | number[];
|
|
3251
|
-
page:
|
|
3579
|
+
page: Page_9;
|
|
3252
3580
|
}
|
|
3253
3581
|
export interface LogPosition {
|
|
3254
3582
|
reads: bigint;
|
|
@@ -3284,6 +3612,12 @@ export interface MemoryFile {
|
|
|
3284
3612
|
lastModifiedBy: Principal;
|
|
3285
3613
|
lastModifiedAtNs: bigint;
|
|
3286
3614
|
}
|
|
3615
|
+
export interface MemoryFileRow {
|
|
3616
|
+
path: string;
|
|
3617
|
+
version: bigint;
|
|
3618
|
+
lastModifiedBy: [] | [Principal];
|
|
3619
|
+
lastModifiedAtNs: bigint;
|
|
3620
|
+
}
|
|
3287
3621
|
export interface MemoryHistory {
|
|
3288
3622
|
evictions: Array<MemoryEviction>;
|
|
3289
3623
|
oldestRetainedVersion: bigint;
|
|
@@ -3433,74 +3767,94 @@ export interface OwnershipTransfer {
|
|
|
3433
3767
|
export interface Page {
|
|
3434
3768
|
total: bigint;
|
|
3435
3769
|
withheld: bigint;
|
|
3436
|
-
items: Array<
|
|
3770
|
+
items: Array<SignIn>;
|
|
3437
3771
|
}
|
|
3438
3772
|
export interface Page_1 {
|
|
3439
3773
|
total: bigint;
|
|
3440
3774
|
withheld: bigint;
|
|
3441
|
-
items: Array<
|
|
3775
|
+
items: Array<Repudiation>;
|
|
3442
3776
|
}
|
|
3443
3777
|
export interface Page_10 {
|
|
3444
3778
|
total: bigint;
|
|
3445
3779
|
withheld: bigint;
|
|
3446
|
-
items: Array<
|
|
3780
|
+
items: Array<MemoryFileRow>;
|
|
3447
3781
|
}
|
|
3448
3782
|
export interface Page_11 {
|
|
3449
3783
|
total: bigint;
|
|
3450
3784
|
withheld: bigint;
|
|
3451
|
-
items: Array<
|
|
3785
|
+
items: Array<ExportReceiptRow>;
|
|
3452
3786
|
}
|
|
3453
3787
|
export interface Page_12 {
|
|
3454
3788
|
total: bigint;
|
|
3455
3789
|
withheld: bigint;
|
|
3456
|
-
items: Array<
|
|
3790
|
+
items: Array<GuardianRecord>;
|
|
3457
3791
|
}
|
|
3458
3792
|
export interface Page_13 {
|
|
3459
3793
|
total: bigint;
|
|
3460
3794
|
withheld: bigint;
|
|
3461
|
-
items: Array<
|
|
3795
|
+
items: Array<GuardianDispute>;
|
|
3462
3796
|
}
|
|
3463
3797
|
export interface Page_14 {
|
|
3464
3798
|
total: bigint;
|
|
3465
3799
|
withheld: bigint;
|
|
3466
|
-
items: Array<
|
|
3800
|
+
items: Array<Eip712TypeView>;
|
|
3467
3801
|
}
|
|
3468
3802
|
export interface Page_15 {
|
|
3469
3803
|
total: bigint;
|
|
3470
3804
|
withheld: bigint;
|
|
3471
|
-
items: Array<
|
|
3805
|
+
items: Array<Eip712Destination>;
|
|
3472
3806
|
}
|
|
3473
3807
|
export interface Page_16 {
|
|
3474
3808
|
total: bigint;
|
|
3475
3809
|
withheld: bigint;
|
|
3476
|
-
items: Array<
|
|
3810
|
+
items: Array<string>;
|
|
3477
3811
|
}
|
|
3478
3812
|
export interface Page_17 {
|
|
3479
3813
|
total: bigint;
|
|
3480
3814
|
withheld: bigint;
|
|
3481
|
-
items: Array<
|
|
3815
|
+
items: Array<CycleSnapshot>;
|
|
3482
3816
|
}
|
|
3483
3817
|
export interface Page_18 {
|
|
3484
3818
|
total: bigint;
|
|
3485
3819
|
withheld: bigint;
|
|
3486
|
-
items: Array<
|
|
3820
|
+
items: Array<CondenseCheckpointRow>;
|
|
3487
3821
|
}
|
|
3488
3822
|
export interface Page_19 {
|
|
3489
3823
|
total: bigint;
|
|
3490
3824
|
withheld: bigint;
|
|
3491
|
-
items: Array<
|
|
3825
|
+
items: Array<BearerToken>;
|
|
3492
3826
|
}
|
|
3493
3827
|
export interface Page_2 {
|
|
3494
3828
|
total: bigint;
|
|
3495
3829
|
withheld: bigint;
|
|
3496
|
-
items: Array<
|
|
3830
|
+
items: Array<RecordNote>;
|
|
3497
3831
|
}
|
|
3498
3832
|
export interface Page_20 {
|
|
3499
3833
|
total: bigint;
|
|
3500
3834
|
withheld: bigint;
|
|
3501
|
-
items: Array<
|
|
3835
|
+
items: Array<BackupMetadata>;
|
|
3502
3836
|
}
|
|
3503
3837
|
export interface Page_21 {
|
|
3838
|
+
total: bigint;
|
|
3839
|
+
withheld: bigint;
|
|
3840
|
+
items: Array<{ status: AgentStatus; principal: Principal; name: string }>;
|
|
3841
|
+
}
|
|
3842
|
+
export interface Page_22 {
|
|
3843
|
+
total: bigint;
|
|
3844
|
+
withheld: bigint;
|
|
3845
|
+
items: Array<AgentRecord>;
|
|
3846
|
+
}
|
|
3847
|
+
export interface Page_23 {
|
|
3848
|
+
total: bigint;
|
|
3849
|
+
withheld: bigint;
|
|
3850
|
+
items: Array<AgentSpendRow>;
|
|
3851
|
+
}
|
|
3852
|
+
export interface Page_24 {
|
|
3853
|
+
total: bigint;
|
|
3854
|
+
withheld: bigint;
|
|
3855
|
+
items: Array<ActivitySnapshot>;
|
|
3856
|
+
}
|
|
3857
|
+
export interface Page_25 {
|
|
3504
3858
|
total: bigint;
|
|
3505
3859
|
withheld: bigint;
|
|
3506
3860
|
items: Array<OwnerRow>;
|
|
@@ -3508,42 +3862,51 @@ export interface Page_21 {
|
|
|
3508
3862
|
export interface Page_3 {
|
|
3509
3863
|
total: bigint;
|
|
3510
3864
|
withheld: bigint;
|
|
3511
|
-
items: Array<
|
|
3865
|
+
items: Array<AuditEntry>;
|
|
3512
3866
|
}
|
|
3513
3867
|
export interface Page_4 {
|
|
3514
3868
|
total: bigint;
|
|
3515
3869
|
withheld: bigint;
|
|
3516
|
-
items: Array<
|
|
3870
|
+
items: Array<PurgedAgent>;
|
|
3517
3871
|
}
|
|
3518
3872
|
export interface Page_5 {
|
|
3519
3873
|
total: bigint;
|
|
3520
3874
|
withheld: bigint;
|
|
3521
|
-
items: Array<
|
|
3875
|
+
items: Array<AgentPaymentSignatures>;
|
|
3522
3876
|
}
|
|
3523
3877
|
export interface Page_6 {
|
|
3524
3878
|
total: bigint;
|
|
3525
3879
|
withheld: bigint;
|
|
3526
|
-
items: Array<
|
|
3880
|
+
items: Array<OwnershipTransfer>;
|
|
3527
3881
|
}
|
|
3528
3882
|
export interface Page_7 {
|
|
3529
3883
|
total: bigint;
|
|
3530
3884
|
withheld: bigint;
|
|
3531
|
-
items: Array<
|
|
3885
|
+
items: Array<EngramSessionState>;
|
|
3532
3886
|
}
|
|
3533
3887
|
export interface Page_8 {
|
|
3534
3888
|
total: bigint;
|
|
3535
3889
|
withheld: bigint;
|
|
3536
|
-
items: Array<
|
|
3890
|
+
items: Array<ApprovalRequest>;
|
|
3537
3891
|
}
|
|
3538
3892
|
export interface Page_9 {
|
|
3539
3893
|
total: bigint;
|
|
3540
3894
|
withheld: bigint;
|
|
3541
|
-
items: Array<
|
|
3895
|
+
items: Array<MemoryLogEvent>;
|
|
3542
3896
|
}
|
|
3543
3897
|
export interface Pairing {
|
|
3544
3898
|
agent: AgentRecord;
|
|
3545
3899
|
trackRecord: TrackRecordNotice;
|
|
3546
3900
|
}
|
|
3901
|
+
export interface PaymentLimits {
|
|
3902
|
+
maxSessionDeposit: [] | [bigint];
|
|
3903
|
+
maxPerDay: [] | [bigint];
|
|
3904
|
+
maxSessionDuration: [] | [bigint];
|
|
3905
|
+
sessionIdleTimeout: [] | [bigint];
|
|
3906
|
+
rateLimitPerMinute: [] | [bigint];
|
|
3907
|
+
maxPerTransaction: [] | [bigint];
|
|
3908
|
+
maxConcurrentSessions: [] | [bigint];
|
|
3909
|
+
}
|
|
3547
3910
|
export interface PaymentSignature {
|
|
3548
3911
|
signature: Uint8Array | number[];
|
|
3549
3912
|
asset: [] | [string];
|
|
@@ -3557,7 +3920,7 @@ export interface PaymentSignature {
|
|
|
3557
3920
|
export interface PaymentSignatureCounts {
|
|
3558
3921
|
day: bigint;
|
|
3559
3922
|
marketplace: [] | [MarketplacePaymentSignatures];
|
|
3560
|
-
agents:
|
|
3923
|
+
agents: Page_5;
|
|
3561
3924
|
limit: bigint;
|
|
3562
3925
|
}
|
|
3563
3926
|
export interface PurgedAgent {
|
|
@@ -3586,9 +3949,15 @@ export interface RailHealth {
|
|
|
3586
3949
|
}
|
|
3587
3950
|
export interface ReceiptPage {
|
|
3588
3951
|
firstAvailableSeq: bigint;
|
|
3589
|
-
page:
|
|
3952
|
+
page: Page_11;
|
|
3590
3953
|
scannedThroughSeq: bigint;
|
|
3591
3954
|
}
|
|
3955
|
+
export interface RecordNote {
|
|
3956
|
+
about: bigint;
|
|
3957
|
+
atNs: bigint;
|
|
3958
|
+
note: string;
|
|
3959
|
+
auditId: bigint;
|
|
3960
|
+
}
|
|
3592
3961
|
export interface RecordPage {
|
|
3593
3962
|
ringFloor: bigint;
|
|
3594
3963
|
total: bigint;
|
|
@@ -3611,76 +3980,86 @@ export interface ResetReport {
|
|
|
3611
3980
|
}
|
|
3612
3981
|
export type Result = { Ok: WriteReceipt } | { Err: Error };
|
|
3613
3982
|
export type Result_1 = { Ok: null } | { Err: Error };
|
|
3614
|
-
export type Result_10 = { Ok:
|
|
3615
|
-
export type Result_11 = { Ok:
|
|
3616
|
-
export type Result_12 = { Ok:
|
|
3617
|
-
export type Result_13 = { Ok:
|
|
3618
|
-
export type Result_14 = { Ok:
|
|
3619
|
-
export type Result_15 = { Ok:
|
|
3620
|
-
export type Result_16 = { Ok:
|
|
3621
|
-
export type Result_17 = { Ok:
|
|
3622
|
-
export type Result_18 = { Ok:
|
|
3623
|
-
export type Result_19 = { Ok:
|
|
3983
|
+
export type Result_10 = { Ok: BackupRetentionReport } | { Err: Error };
|
|
3984
|
+
export type Result_11 = { Ok: MemoryFile } | { Err: Error };
|
|
3985
|
+
export type Result_12 = { Ok: SessionContext } | { Err: Error };
|
|
3986
|
+
export type Result_13 = { Ok: bigint } | { Err: Error };
|
|
3987
|
+
export type Result_14 = { Ok: ResyncReport } | { Err: Error };
|
|
3988
|
+
export type Result_15 = { Ok: ResetReport } | { Err: Error };
|
|
3989
|
+
export type Result_16 = { Ok: GuardianRecord } | { Err: Error };
|
|
3990
|
+
export type Result_17 = { Ok: EngramEscrowRecovery } | { Err: Error };
|
|
3991
|
+
export type Result_18 = { Ok: MemoryByteChunk } | { Err: Error };
|
|
3992
|
+
export type Result_19 = { Ok: Array<BatchReadItem> } | { Err: Error };
|
|
3624
3993
|
export type Result_2 = { Ok: ControlHandover } | { Err: Error };
|
|
3625
|
-
export type Result_20 = { Ok:
|
|
3626
|
-
export type Result_21 = { Ok:
|
|
3627
|
-
export type Result_22 = { Ok:
|
|
3628
|
-
export type Result_23 = { Ok:
|
|
3629
|
-
export type Result_24 = { Ok:
|
|
3630
|
-
export type Result_25 = { Ok:
|
|
3631
|
-
export type Result_26 = { Ok:
|
|
3632
|
-
export type Result_27 = { Ok:
|
|
3633
|
-
export type Result_28 = { Ok:
|
|
3634
|
-
export type Result_29 = { Ok:
|
|
3994
|
+
export type Result_20 = { Ok: RetentionPreview } | { Err: Error };
|
|
3995
|
+
export type Result_21 = { Ok: CondensePreview } | { Err: Error };
|
|
3996
|
+
export type Result_22 = { Ok: Pairing } | { Err: Error };
|
|
3997
|
+
export type Result_23 = { Ok: EngramSessionState } | { Err: Error };
|
|
3998
|
+
export type Result_24 = { Ok: Principal } | { Err: Error };
|
|
3999
|
+
export type Result_25 = { Ok: AgentGrant } | { Err: Error };
|
|
4000
|
+
export type Result_26 = { Ok: Page } | { Err: Error };
|
|
4001
|
+
export type Result_27 = { Ok: Page_1 } | { Err: Error };
|
|
4002
|
+
export type Result_28 = { Ok: Page_2 } | { Err: Error };
|
|
4003
|
+
export type Result_29 = { Ok: Page_3 } | { Err: Error };
|
|
3635
4004
|
export type Result_3 = { Ok: X402SignOutcome } | { Err: Error };
|
|
3636
|
-
export type Result_30 = { Ok:
|
|
3637
|
-
export type Result_31 = { Ok:
|
|
3638
|
-
export type Result_32 = { Ok:
|
|
3639
|
-
export type Result_33 = { Ok:
|
|
3640
|
-
export type Result_34 = { Ok:
|
|
3641
|
-
export type Result_35 = { Ok:
|
|
3642
|
-
export type Result_36 = { Ok:
|
|
3643
|
-
export type Result_37 = { Ok:
|
|
3644
|
-
export type Result_38 = { Ok:
|
|
3645
|
-
export type Result_39 = { Ok:
|
|
4005
|
+
export type Result_30 = { Ok: Page_4 } | { Err: Error };
|
|
4006
|
+
export type Result_31 = { Ok: PaymentSignatureCounts } | { Err: Error };
|
|
4007
|
+
export type Result_32 = { Ok: Page_6 } | { Err: Error };
|
|
4008
|
+
export type Result_33 = { Ok: Page_7 } | { Err: Error };
|
|
4009
|
+
export type Result_34 = { Ok: Page_8 } | { Err: Error };
|
|
4010
|
+
export type Result_35 = { Ok: LogPage } | { Err: Error };
|
|
4011
|
+
export type Result_36 = { Ok: Page_10 } | { Err: Error };
|
|
4012
|
+
export type Result_37 = { Ok: ReceiptPage } | { Err: Error };
|
|
4013
|
+
export type Result_38 = { Ok: Page_12 } | { Err: Error };
|
|
4014
|
+
export type Result_39 = { Ok: Page_13 } | { Err: Error };
|
|
3646
4015
|
export type Result_4 = { Ok: Eip712SignatureOut } | { Err: Error };
|
|
3647
|
-
export type Result_40 = { Ok:
|
|
3648
|
-
export type Result_41 = { Ok:
|
|
3649
|
-
export type Result_42 = { Ok:
|
|
3650
|
-
export type Result_43 = { Ok:
|
|
3651
|
-
export type Result_44 = { Ok:
|
|
3652
|
-
export type Result_45 = { Ok:
|
|
3653
|
-
export type Result_46 = { Ok:
|
|
3654
|
-
export type Result_47 = { Ok:
|
|
3655
|
-
export type Result_48 = { Ok:
|
|
3656
|
-
export type Result_49 = { Ok:
|
|
3657
|
-
export type Result_5 = { Ok:
|
|
3658
|
-
export type Result_50 = { Ok:
|
|
3659
|
-
export type Result_51 = { Ok:
|
|
3660
|
-
export type Result_52 = { Ok:
|
|
3661
|
-
export type Result_53 = { Ok:
|
|
3662
|
-
export type Result_54 = { Ok:
|
|
3663
|
-
export type Result_55 = { Ok:
|
|
3664
|
-
export type Result_56 = { Ok:
|
|
3665
|
-
export type Result_57 = { Ok:
|
|
3666
|
-
export type Result_58 = { Ok:
|
|
3667
|
-
export type Result_59 = { Ok:
|
|
3668
|
-
export type Result_6 = { Ok:
|
|
3669
|
-
export type Result_60 = { Ok:
|
|
3670
|
-
export type Result_61 = { Ok:
|
|
3671
|
-
export type Result_62 = { Ok:
|
|
3672
|
-
export type Result_63 = { Ok:
|
|
3673
|
-
export type Result_64 = { Ok:
|
|
3674
|
-
export type Result_65 = { Ok:
|
|
3675
|
-
export type Result_66 = { Ok:
|
|
3676
|
-
export type
|
|
3677
|
-
export type
|
|
3678
|
-
export type
|
|
3679
|
-
export type
|
|
3680
|
-
export type
|
|
3681
|
-
export type
|
|
3682
|
-
export type
|
|
3683
|
-
export type
|
|
4016
|
+
export type Result_40 = { Ok: Page_14 } | { Err: Error };
|
|
4017
|
+
export type Result_41 = { Ok: Page_15 } | { Err: Error };
|
|
4018
|
+
export type Result_42 = { Ok: Page_16 } | { Err: Error };
|
|
4019
|
+
export type Result_43 = { Ok: Page_17 } | { Err: Error };
|
|
4020
|
+
export type Result_44 = { Ok: CheckpointPage } | { Err: Error };
|
|
4021
|
+
export type Result_45 = { Ok: Page_19 } | { Err: Error };
|
|
4022
|
+
export type Result_46 = { Ok: Page_20 } | { Err: Error };
|
|
4023
|
+
export type Result_47 = { Ok: RecordPage } | { Err: Error };
|
|
4024
|
+
export type Result_48 = { Ok: Page_21 } | { Err: Error };
|
|
4025
|
+
export type Result_49 = { Ok: Page_22 } | { Err: Error };
|
|
4026
|
+
export type Result_5 = { Ok: { returned: bigint } } | { Err: Error };
|
|
4027
|
+
export type Result_50 = { Ok: AgentSpendToday } | { Err: Error };
|
|
4028
|
+
export type Result_51 = { Ok: Page_24 } | { Err: Error };
|
|
4029
|
+
export type Result_52 = { Ok: string } | { Err: Error };
|
|
4030
|
+
export type Result_53 = { Ok: boolean } | { Err: Error };
|
|
4031
|
+
export type Result_54 = { Ok: [] | [string] } | { Err: Error };
|
|
4032
|
+
export type Result_55 = { Ok: WorldIdRpContext } | { Err: Error };
|
|
4033
|
+
export type Result_56 = { Ok: WorldIdConfig } | { Err: Error };
|
|
4034
|
+
export type Result_57 = { Ok: WalletBalances } | { Err: Error };
|
|
4035
|
+
export type Result_58 = { Ok: StorageReport } | { Err: Error };
|
|
4036
|
+
export type Result_59 = { Ok: SpendingPolicy } | { Err: Error };
|
|
4037
|
+
export type Result_6 = { Ok: SignatureCounts } | { Err: Error };
|
|
4038
|
+
export type Result_60 = { Ok: SpendCeiling } | { Err: Error };
|
|
4039
|
+
export type Result_61 = { Ok: SigningFloorStatus } | { Err: Error };
|
|
4040
|
+
export type Result_62 = { Ok: { paths: Array<string> } } | { Err: Error };
|
|
4041
|
+
export type Result_63 = { Ok: OwnerConsole } | { Err: Error };
|
|
4042
|
+
export type Result_64 = { Ok: MemoryRetentionPolicy } | { Err: Error };
|
|
4043
|
+
export type Result_65 = { Ok: MemoryHistory } | { Err: Error };
|
|
4044
|
+
export type Result_66 = { Ok: AlertStatus } | { Err: Error };
|
|
4045
|
+
export type Result_67 = { Ok: EvmAddresses } | { Err: Error };
|
|
4046
|
+
export type Result_68 = { Ok: Uint8Array | number[] } | { Err: Error };
|
|
4047
|
+
export type Result_69 = { Ok: ChildOpening } | { Err: Error };
|
|
4048
|
+
export type Result_7 = { Ok: RailHealth } | { Err: Error };
|
|
4049
|
+
export type Result_70 = { Ok: ChildAllowanceRow } | { Err: Error };
|
|
4050
|
+
export type Result_71 = { Ok: Brakes } | { Err: Error };
|
|
4051
|
+
export type Result_72 = { Ok: Array<BirthRecord> } | { Err: Error };
|
|
4052
|
+
export type Result_73 = { Ok: BackupRetention } | { Err: Error };
|
|
4053
|
+
export type Result_74 = { Ok: BackupMetadata } | { Err: Error };
|
|
4054
|
+
export type Result_75 = { Ok: AgentWriteReview } | { Err: Error };
|
|
4055
|
+
export type Result_76 = { Ok: Page_25 } | { Err: Error };
|
|
4056
|
+
export type Result_78 = { Ok: MemoryRangeExport } | { Err: Error };
|
|
4057
|
+
export type Result_79 = { Ok: CondenseResult } | { Err: Error };
|
|
4058
|
+
export type Result_8 = { Ok: Array<Seat> } | { Err: Error };
|
|
4059
|
+
export type Result_80 = { Ok: Eip712Registration } | { Err: Error };
|
|
4060
|
+
export type Result_81 = { Ok: { activatesAtNs: bigint } } | { Err: Error };
|
|
4061
|
+
export type Result_82 = { Ok: AgentRecord } | { Err: Error };
|
|
4062
|
+
export type Result_9 = { Ok: SignedTransaction } | { Err: Error };
|
|
3684
4063
|
export interface ResyncReport {
|
|
3685
4064
|
startsAcknowledged: bigint;
|
|
3686
4065
|
cannotBeRecorded: Array<UnrecordableEngagement>;
|
|
@@ -3701,6 +4080,22 @@ export type RetentionClassSpec =
|
|
|
3701
4080
|
thinning: { tail: null } | { logSpaced: { denseTail: bigint } };
|
|
3702
4081
|
};
|
|
3703
4082
|
};
|
|
4083
|
+
export interface RetentionPreview {
|
|
4084
|
+
files: bigint;
|
|
4085
|
+
complete: boolean;
|
|
4086
|
+
planned: bigint;
|
|
4087
|
+
bytes: bigint;
|
|
4088
|
+
copies: bigint;
|
|
4089
|
+
storedFiles: bigint;
|
|
4090
|
+
rules: Array<RetentionPreviewRule>;
|
|
4091
|
+
}
|
|
4092
|
+
export interface RetentionPreviewRule {
|
|
4093
|
+
files: bigint;
|
|
4094
|
+
notBeforeNs: [] | [bigint];
|
|
4095
|
+
prefix: string;
|
|
4096
|
+
bytes: bigint;
|
|
4097
|
+
copies: bigint;
|
|
4098
|
+
}
|
|
3704
4099
|
export type Role =
|
|
3705
4100
|
| { Anonymous: null }
|
|
3706
4101
|
| { Viewer: null }
|
|
@@ -3755,6 +4150,10 @@ export interface SessionIntent {
|
|
|
3755
4150
|
expiryNs: bigint;
|
|
3756
4151
|
suggestedDeposit: bigint;
|
|
3757
4152
|
}
|
|
4153
|
+
export interface SignIn {
|
|
4154
|
+
token: BearerToken;
|
|
4155
|
+
clientName: [] | [string];
|
|
4156
|
+
}
|
|
3758
4157
|
export interface SignatureCounts {
|
|
3759
4158
|
total: bigint;
|
|
3760
4159
|
byCaller: Array<CallerSignatureCount>;
|