@warmhub/sdk-ts 0.87.0 → 0.88.0

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/index.d.ts CHANGED
@@ -90,14 +90,14 @@ type AccessResolveResult$1 = {
90
90
  orgName: string;
91
91
  repoName: string;
92
92
  visible: boolean;
93
- scopes: Array<'repo:read' | 'repo:checkpoint-read' | 'repo:write' | 'repo:configure' | 'repo:admin' | 'repo:action-callback'>;
93
+ scopes: Array<string>;
94
94
  allowedMatches?: Array<string>;
95
95
  repoDurableId?: string;
96
96
  }>;
97
97
  orgs: Array<{
98
98
  orgName: string;
99
99
  visible: boolean;
100
- scopes: Array<'org:read' | 'org:configure' | 'org:admin' | 'org:action-callback'>;
100
+ scopes: Array<string>;
101
101
  }>;
102
102
  };
103
103
  type AuthSyncResult = {
@@ -119,10 +119,15 @@ type OperationEventReceiptV1$1 = {
119
119
  operations: Array<{
120
120
  opIndex?: number;
121
121
  name: string;
122
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
122
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
123
123
  version: number;
124
124
  dataHash: string;
125
125
  status?: 'applied' | 'noop';
126
+ affirmations?: {
127
+ added: Array<string>;
128
+ removed: Array<string>;
129
+ ignored: Array<string>;
130
+ };
126
131
  warnings?: {
127
132
  undeclaredFields?: Array<string>;
128
133
  undeclaredFieldsTruncated?: true;
@@ -143,7 +148,7 @@ type OperationEventReceiptV1$1 = {
143
148
  } | {
144
149
  opIndex?: number;
145
150
  name: string;
146
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
151
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
147
152
  version?: number;
148
153
  dataHash?: string;
149
154
  status?: 'success' | 'noop' | 'failed';
@@ -192,6 +197,11 @@ type OperationEventReceiptV1$1 = {
192
197
  removalMilestone: string;
193
198
  }>;
194
199
  };
200
+ affirmations?: {
201
+ added: Array<string>;
202
+ removed: Array<string>;
203
+ ignored: Array<string>;
204
+ };
195
205
  }>;
196
206
  outcome: 'event' | 'no_event';
197
207
  requestDigest: string;
@@ -290,7 +300,7 @@ type ComponentDetail = {
290
300
  active: boolean;
291
301
  version: {
292
302
  version: number;
293
- operation: 'add' | 'revise' | 'retract';
303
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm';
294
304
  data: unknown;
295
305
  dataHash: string;
296
306
  } | null;
@@ -307,6 +317,7 @@ type ComponentDetail = {
307
317
  data?: unknown;
308
318
  active: boolean;
309
319
  aboutWref?: string;
320
+ affirmedWrefs?: Array<string>;
310
321
  roles?: Array<'from' | 'to' | 'ends' | 'first' | 'second'>;
311
322
  metadata?: {
312
323
  durableId: string;
@@ -347,10 +358,15 @@ type ComponentInstallResult$1 = {
347
358
  operations: Array<{
348
359
  opIndex?: number;
349
360
  name: string;
350
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
361
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
351
362
  version: number;
352
363
  dataHash: string;
353
364
  status?: 'applied' | 'noop';
365
+ affirmations?: {
366
+ added: Array<string>;
367
+ removed: Array<string>;
368
+ ignored: Array<string>;
369
+ };
354
370
  warnings?: {
355
371
  undeclaredFields?: Array<string>;
356
372
  undeclaredFieldsTruncated?: true;
@@ -371,7 +387,7 @@ type ComponentInstallResult$1 = {
371
387
  } | {
372
388
  opIndex?: number;
373
389
  name: string;
374
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
390
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
375
391
  version?: number;
376
392
  dataHash?: string;
377
393
  status?: 'success' | 'noop' | 'failed';
@@ -420,6 +436,11 @@ type ComponentInstallResult$1 = {
420
436
  removalMilestone: string;
421
437
  }>;
422
438
  };
439
+ affirmations?: {
440
+ added: Array<string>;
441
+ removed: Array<string>;
442
+ ignored: Array<string>;
443
+ };
423
444
  }>;
424
445
  outcome: 'event' | 'no_event';
425
446
  requestDigest: string;
@@ -485,10 +506,15 @@ type ComponentUninstallResult$1 = {
485
506
  operations: Array<{
486
507
  opIndex?: number;
487
508
  name: string;
488
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
509
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
489
510
  version: number;
490
511
  dataHash: string;
491
512
  status?: 'applied' | 'noop';
513
+ affirmations?: {
514
+ added: Array<string>;
515
+ removed: Array<string>;
516
+ ignored: Array<string>;
517
+ };
492
518
  warnings?: {
493
519
  undeclaredFields?: Array<string>;
494
520
  undeclaredFieldsTruncated?: true;
@@ -509,7 +535,7 @@ type ComponentUninstallResult$1 = {
509
535
  } | {
510
536
  opIndex?: number;
511
537
  name: string;
512
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
538
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
513
539
  version?: number;
514
540
  dataHash?: string;
515
541
  status?: 'success' | 'noop' | 'failed';
@@ -558,6 +584,11 @@ type ComponentUninstallResult$1 = {
558
584
  removalMilestone: string;
559
585
  }>;
560
586
  };
587
+ affirmations?: {
588
+ added: Array<string>;
589
+ removed: Array<string>;
590
+ ignored: Array<string>;
591
+ };
561
592
  }>;
562
593
  outcome: 'event' | 'no_event';
563
594
  requestDigest: string;
@@ -589,9 +620,16 @@ type GrantCreateInput = {
589
620
  orgName: string;
590
621
  repoName: string;
591
622
  idempotencyKey: string;
592
- grantee: {
593
- principalId: string;
594
- principalKind: 'member' | 'pat' | 'component';
623
+ recipient: {
624
+ kind: 'member';
625
+ email: string;
626
+ } | {
627
+ kind: 'pat';
628
+ name: string;
629
+ } | {
630
+ kind: 'component';
631
+ orgName: string;
632
+ componentName: string;
595
633
  };
596
634
  coverage?: {
597
635
  include: Array<string>;
@@ -718,12 +756,14 @@ type StreamAppendInput$1 = {
718
756
  kind: 'shape';
719
757
  name: string;
720
758
  data: unknown;
759
+ affirmedTargets?: never;
721
760
  skipExisting?: boolean;
722
761
  } | {
723
762
  operation: 'add';
724
763
  kind: 'thing';
725
764
  name: string;
726
765
  data: unknown;
766
+ affirmedTargets?: never;
727
767
  skipExisting?: boolean;
728
768
  } | {
729
769
  operation: 'add';
@@ -731,6 +771,7 @@ type StreamAppendInput$1 = {
731
771
  name: string;
732
772
  about: string;
733
773
  data: unknown;
774
+ affirmedTargets?: Array<string>;
734
775
  skipExisting?: boolean;
735
776
  } | {
736
777
  operation: 'add';
@@ -738,12 +779,14 @@ type StreamAppendInput$1 = {
738
779
  name: string;
739
780
  type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
740
781
  members: Array<string>;
782
+ affirmedTargets?: never;
741
783
  skipExisting?: boolean;
742
784
  } | {
743
785
  operation: 'revise';
744
786
  kind: 'shape';
745
787
  name: string;
746
788
  data: unknown;
789
+ affirmedTargets?: never;
747
790
  expectedVersion?: number;
748
791
  active?: never;
749
792
  leaseId?: string;
@@ -752,6 +795,7 @@ type StreamAppendInput$1 = {
752
795
  kind: 'thing';
753
796
  name: string;
754
797
  data: unknown;
798
+ affirmedTargets?: never;
755
799
  expectedVersion?: number;
756
800
  active?: never;
757
801
  leaseId?: string;
@@ -760,6 +804,7 @@ type StreamAppendInput$1 = {
760
804
  kind: 'assertion';
761
805
  name: string;
762
806
  data: unknown;
807
+ affirmedTargets?: Array<string>;
763
808
  expectedVersion?: number;
764
809
  active?: never;
765
810
  leaseId?: string;
@@ -769,6 +814,7 @@ type StreamAppendInput$1 = {
769
814
  name: string;
770
815
  type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
771
816
  members: Array<string>;
817
+ affirmedTargets?: never;
772
818
  expectedVersion?: number;
773
819
  leaseId?: string;
774
820
  } | {
@@ -778,6 +824,14 @@ type StreamAppendInput$1 = {
778
824
  reason?: string;
779
825
  expectedVersion?: number;
780
826
  leaseId?: string;
827
+ } | {
828
+ operation: 'reaffirm';
829
+ kind?: 'assertion';
830
+ name: string;
831
+ add?: Array<string>;
832
+ remove?: Array<string>;
833
+ expectedVersion?: number;
834
+ leaseId?: string;
781
835
  } | {
782
836
  operation: 'rename';
783
837
  name: string;
@@ -795,7 +849,7 @@ type StreamAppendResult$1 = {
795
849
  results: Array<{
796
850
  opIndex?: number;
797
851
  name: string;
798
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
852
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
799
853
  version?: number;
800
854
  dataHash?: string;
801
855
  status?: 'success' | 'noop' | 'failed';
@@ -844,6 +898,11 @@ type StreamAppendResult$1 = {
844
898
  removalMilestone: string;
845
899
  }>;
846
900
  };
901
+ affirmations?: {
902
+ added: Array<string>;
903
+ removed: Array<string>;
904
+ ignored: Array<string>;
905
+ };
847
906
  }>;
848
907
  repoSeq?: number;
849
908
  createdByEmail?: string;
@@ -884,10 +943,15 @@ type StreamAppendResult$1 = {
884
943
  operations: Array<{
885
944
  opIndex?: number;
886
945
  name: string;
887
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
946
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
888
947
  version: number;
889
948
  dataHash: string;
890
949
  status?: 'applied' | 'noop';
950
+ affirmations?: {
951
+ added: Array<string>;
952
+ removed: Array<string>;
953
+ ignored: Array<string>;
954
+ };
891
955
  warnings?: {
892
956
  undeclaredFields?: Array<string>;
893
957
  undeclaredFieldsTruncated?: true;
@@ -908,7 +972,7 @@ type StreamAppendResult$1 = {
908
972
  } | {
909
973
  opIndex?: number;
910
974
  name: string;
911
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
975
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
912
976
  version?: number;
913
977
  dataHash?: string;
914
978
  status?: 'success' | 'noop' | 'failed';
@@ -957,6 +1021,11 @@ type StreamAppendResult$1 = {
957
1021
  removalMilestone: string;
958
1022
  }>;
959
1023
  };
1024
+ affirmations?: {
1025
+ added: Array<string>;
1026
+ removed: Array<string>;
1027
+ ignored: Array<string>;
1028
+ };
960
1029
  }>;
961
1030
  outcome: 'event' | 'no_event';
962
1031
  requestDigest: string;
@@ -977,10 +1046,15 @@ type StreamAppendResult$1 = {
977
1046
  operations: Array<{
978
1047
  opIndex?: number;
979
1048
  name: string;
980
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1049
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
981
1050
  version: number;
982
1051
  dataHash: string;
983
1052
  status?: 'applied' | 'noop';
1053
+ affirmations?: {
1054
+ added: Array<string>;
1055
+ removed: Array<string>;
1056
+ ignored: Array<string>;
1057
+ };
984
1058
  warnings?: {
985
1059
  undeclaredFields?: Array<string>;
986
1060
  undeclaredFieldsTruncated?: true;
@@ -1001,7 +1075,7 @@ type StreamAppendResult$1 = {
1001
1075
  } | {
1002
1076
  opIndex?: number;
1003
1077
  name: string;
1004
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1078
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1005
1079
  version?: number;
1006
1080
  dataHash?: string;
1007
1081
  status?: 'success' | 'noop' | 'failed';
@@ -1050,6 +1124,11 @@ type StreamAppendResult$1 = {
1050
1124
  removalMilestone: string;
1051
1125
  }>;
1052
1126
  };
1127
+ affirmations?: {
1128
+ added: Array<string>;
1129
+ removed: Array<string>;
1130
+ ignored: Array<string>;
1131
+ };
1053
1132
  }>;
1054
1133
  outcome: 'event' | 'no_event';
1055
1134
  requestDigest: string;
@@ -1066,10 +1145,15 @@ type CommitApplyCompatibilityResult$1 = {
1066
1145
  operations: Array<{
1067
1146
  opIndex?: number;
1068
1147
  name: string;
1069
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1148
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1070
1149
  version: number;
1071
1150
  dataHash: string;
1072
1151
  status?: 'applied' | 'noop';
1152
+ affirmations?: {
1153
+ added: Array<string>;
1154
+ removed: Array<string>;
1155
+ ignored: Array<string>;
1156
+ };
1073
1157
  warnings?: {
1074
1158
  undeclaredFields?: Array<string>;
1075
1159
  undeclaredFieldsTruncated?: true;
@@ -1118,10 +1202,15 @@ type CommitApplyCompatibilityResult$1 = {
1118
1202
  operations: Array<{
1119
1203
  opIndex?: number;
1120
1204
  name: string;
1121
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1205
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1122
1206
  version: number;
1123
1207
  dataHash: string;
1124
1208
  status?: 'applied' | 'noop';
1209
+ affirmations?: {
1210
+ added: Array<string>;
1211
+ removed: Array<string>;
1212
+ ignored: Array<string>;
1213
+ };
1125
1214
  warnings?: {
1126
1215
  undeclaredFields?: Array<string>;
1127
1216
  undeclaredFieldsTruncated?: true;
@@ -1142,7 +1231,7 @@ type CommitApplyCompatibilityResult$1 = {
1142
1231
  } | {
1143
1232
  opIndex?: number;
1144
1233
  name: string;
1145
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1234
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1146
1235
  version?: number;
1147
1236
  dataHash?: string;
1148
1237
  status?: 'success' | 'noop' | 'failed';
@@ -1191,6 +1280,11 @@ type CommitApplyCompatibilityResult$1 = {
1191
1280
  removalMilestone: string;
1192
1281
  }>;
1193
1282
  };
1283
+ affirmations?: {
1284
+ added: Array<string>;
1285
+ removed: Array<string>;
1286
+ ignored: Array<string>;
1287
+ };
1194
1288
  }>;
1195
1289
  outcome: 'event' | 'no_event';
1196
1290
  requestDigest: string;
@@ -1237,10 +1331,15 @@ type CollectionMutationCompatibilityResult = {
1237
1331
  operations: Array<{
1238
1332
  opIndex?: number;
1239
1333
  name: string;
1240
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1334
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1241
1335
  version: number;
1242
1336
  dataHash: string;
1243
1337
  status?: 'applied' | 'noop';
1338
+ affirmations?: {
1339
+ added: Array<string>;
1340
+ removed: Array<string>;
1341
+ ignored: Array<string>;
1342
+ };
1244
1343
  warnings?: {
1245
1344
  undeclaredFields?: Array<string>;
1246
1345
  undeclaredFieldsTruncated?: true;
@@ -1261,7 +1360,7 @@ type CollectionMutationCompatibilityResult = {
1261
1360
  } | {
1262
1361
  opIndex?: number;
1263
1362
  name: string;
1264
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1363
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1265
1364
  version?: number;
1266
1365
  dataHash?: string;
1267
1366
  status?: 'success' | 'noop' | 'failed';
@@ -1310,6 +1409,11 @@ type CollectionMutationCompatibilityResult = {
1310
1409
  removalMilestone: string;
1311
1410
  }>;
1312
1411
  };
1412
+ affirmations?: {
1413
+ added: Array<string>;
1414
+ removed: Array<string>;
1415
+ ignored: Array<string>;
1416
+ };
1313
1417
  }>;
1314
1418
  outcome: 'event' | 'no_event';
1315
1419
  requestDigest: string;
@@ -1330,10 +1434,15 @@ type CollectionMutationCompatibilityResult = {
1330
1434
  operations: Array<{
1331
1435
  opIndex?: number;
1332
1436
  name: string;
1333
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1437
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1334
1438
  version: number;
1335
1439
  dataHash: string;
1336
1440
  status?: 'applied' | 'noop';
1441
+ affirmations?: {
1442
+ added: Array<string>;
1443
+ removed: Array<string>;
1444
+ ignored: Array<string>;
1445
+ };
1337
1446
  warnings?: {
1338
1447
  undeclaredFields?: Array<string>;
1339
1448
  undeclaredFieldsTruncated?: true;
@@ -1354,7 +1463,7 @@ type CollectionMutationCompatibilityResult = {
1354
1463
  } | {
1355
1464
  opIndex?: number;
1356
1465
  name: string;
1357
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1466
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1358
1467
  version?: number;
1359
1468
  dataHash?: string;
1360
1469
  status?: 'success' | 'noop' | 'failed';
@@ -1403,6 +1512,11 @@ type CollectionMutationCompatibilityResult = {
1403
1512
  removalMilestone: string;
1404
1513
  }>;
1405
1514
  };
1515
+ affirmations?: {
1516
+ added: Array<string>;
1517
+ removed: Array<string>;
1518
+ ignored: Array<string>;
1519
+ };
1406
1520
  }>;
1407
1521
  outcome: 'event' | 'no_event';
1408
1522
  requestDigest: string;
@@ -1426,10 +1540,15 @@ type RenameCompatibilityResult = {
1426
1540
  operations: Array<{
1427
1541
  opIndex?: number;
1428
1542
  name: string;
1429
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1543
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1430
1544
  version: number;
1431
1545
  dataHash: string;
1432
1546
  status?: 'applied' | 'noop';
1547
+ affirmations?: {
1548
+ added: Array<string>;
1549
+ removed: Array<string>;
1550
+ ignored: Array<string>;
1551
+ };
1433
1552
  warnings?: {
1434
1553
  undeclaredFields?: Array<string>;
1435
1554
  undeclaredFieldsTruncated?: true;
@@ -1450,7 +1569,7 @@ type RenameCompatibilityResult = {
1450
1569
  } | {
1451
1570
  opIndex?: number;
1452
1571
  name: string;
1453
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1572
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1454
1573
  version?: number;
1455
1574
  dataHash?: string;
1456
1575
  status?: 'success' | 'noop' | 'failed';
@@ -1499,6 +1618,11 @@ type RenameCompatibilityResult = {
1499
1618
  removalMilestone: string;
1500
1619
  }>;
1501
1620
  };
1621
+ affirmations?: {
1622
+ added: Array<string>;
1623
+ removed: Array<string>;
1624
+ ignored: Array<string>;
1625
+ };
1502
1626
  }>;
1503
1627
  outcome: 'event' | 'no_event';
1504
1628
  requestDigest: string;
@@ -1519,10 +1643,15 @@ type RenameCompatibilityResult = {
1519
1643
  operations: Array<{
1520
1644
  opIndex?: number;
1521
1645
  name: string;
1522
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1646
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1523
1647
  version: number;
1524
1648
  dataHash: string;
1525
1649
  status?: 'applied' | 'noop';
1650
+ affirmations?: {
1651
+ added: Array<string>;
1652
+ removed: Array<string>;
1653
+ ignored: Array<string>;
1654
+ };
1526
1655
  warnings?: {
1527
1656
  undeclaredFields?: Array<string>;
1528
1657
  undeclaredFieldsTruncated?: true;
@@ -1543,7 +1672,7 @@ type RenameCompatibilityResult = {
1543
1672
  } | {
1544
1673
  opIndex?: number;
1545
1674
  name: string;
1546
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1675
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1547
1676
  version?: number;
1548
1677
  dataHash?: string;
1549
1678
  status?: 'success' | 'noop' | 'failed';
@@ -1592,6 +1721,11 @@ type RenameCompatibilityResult = {
1592
1721
  removalMilestone: string;
1593
1722
  }>;
1594
1723
  };
1724
+ affirmations?: {
1725
+ added: Array<string>;
1726
+ removed: Array<string>;
1727
+ ignored: Array<string>;
1728
+ };
1595
1729
  }>;
1596
1730
  outcome: 'event' | 'no_event';
1597
1731
  requestDigest: string;
@@ -1601,7 +1735,7 @@ type RenameCompatibilityResult = {
1601
1735
  };
1602
1736
  type ShapeChangeCompatibilityResult = {
1603
1737
  name: string;
1604
- operation: 'add' | 'revise' | 'retract' | 'noop';
1738
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
1605
1739
  version: number;
1606
1740
  dataHash: string;
1607
1741
  event: {
@@ -1618,10 +1752,15 @@ type ShapeChangeCompatibilityResult = {
1618
1752
  operations: Array<{
1619
1753
  opIndex?: number;
1620
1754
  name: string;
1621
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1755
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1622
1756
  version: number;
1623
1757
  dataHash: string;
1624
1758
  status?: 'applied' | 'noop';
1759
+ affirmations?: {
1760
+ added: Array<string>;
1761
+ removed: Array<string>;
1762
+ ignored: Array<string>;
1763
+ };
1625
1764
  warnings?: {
1626
1765
  undeclaredFields?: Array<string>;
1627
1766
  undeclaredFieldsTruncated?: true;
@@ -1642,7 +1781,7 @@ type ShapeChangeCompatibilityResult = {
1642
1781
  } | {
1643
1782
  opIndex?: number;
1644
1783
  name: string;
1645
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1784
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1646
1785
  version?: number;
1647
1786
  dataHash?: string;
1648
1787
  status?: 'success' | 'noop' | 'failed';
@@ -1691,6 +1830,11 @@ type ShapeChangeCompatibilityResult = {
1691
1830
  removalMilestone: string;
1692
1831
  }>;
1693
1832
  };
1833
+ affirmations?: {
1834
+ added: Array<string>;
1835
+ removed: Array<string>;
1836
+ ignored: Array<string>;
1837
+ };
1694
1838
  }>;
1695
1839
  outcome: 'event' | 'no_event';
1696
1840
  requestDigest: string;
@@ -1711,10 +1855,15 @@ type ShapeChangeCompatibilityResult = {
1711
1855
  operations: Array<{
1712
1856
  opIndex?: number;
1713
1857
  name: string;
1714
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1858
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1715
1859
  version: number;
1716
1860
  dataHash: string;
1717
1861
  status?: 'applied' | 'noop';
1862
+ affirmations?: {
1863
+ added: Array<string>;
1864
+ removed: Array<string>;
1865
+ ignored: Array<string>;
1866
+ };
1718
1867
  warnings?: {
1719
1868
  undeclaredFields?: Array<string>;
1720
1869
  undeclaredFieldsTruncated?: true;
@@ -1735,7 +1884,7 @@ type ShapeChangeCompatibilityResult = {
1735
1884
  } | {
1736
1885
  opIndex?: number;
1737
1886
  name: string;
1738
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1887
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1739
1888
  version?: number;
1740
1889
  dataHash?: string;
1741
1890
  status?: 'success' | 'noop' | 'failed';
@@ -1784,6 +1933,11 @@ type ShapeChangeCompatibilityResult = {
1784
1933
  removalMilestone: string;
1785
1934
  }>;
1786
1935
  };
1936
+ affirmations?: {
1937
+ added: Array<string>;
1938
+ removed: Array<string>;
1939
+ ignored: Array<string>;
1940
+ };
1787
1941
  }>;
1788
1942
  outcome: 'event' | 'no_event';
1789
1943
  requestDigest: string;
@@ -1793,7 +1947,7 @@ type ShapeChangeCompatibilityResult = {
1793
1947
  };
1794
1948
  type ShapeRemoveCompatibilityResult = {
1795
1949
  name: string;
1796
- operation: 'add' | 'revise' | 'retract' | 'noop';
1950
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
1797
1951
  version: number;
1798
1952
  dataHash: string;
1799
1953
  removed: true;
@@ -1811,10 +1965,15 @@ type ShapeRemoveCompatibilityResult = {
1811
1965
  operations: Array<{
1812
1966
  opIndex?: number;
1813
1967
  name: string;
1814
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1968
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1815
1969
  version: number;
1816
1970
  dataHash: string;
1817
1971
  status?: 'applied' | 'noop';
1972
+ affirmations?: {
1973
+ added: Array<string>;
1974
+ removed: Array<string>;
1975
+ ignored: Array<string>;
1976
+ };
1818
1977
  warnings?: {
1819
1978
  undeclaredFields?: Array<string>;
1820
1979
  undeclaredFieldsTruncated?: true;
@@ -1835,7 +1994,7 @@ type ShapeRemoveCompatibilityResult = {
1835
1994
  } | {
1836
1995
  opIndex?: number;
1837
1996
  name: string;
1838
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
1997
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1839
1998
  version?: number;
1840
1999
  dataHash?: string;
1841
2000
  status?: 'success' | 'noop' | 'failed';
@@ -1884,6 +2043,11 @@ type ShapeRemoveCompatibilityResult = {
1884
2043
  removalMilestone: string;
1885
2044
  }>;
1886
2045
  };
2046
+ affirmations?: {
2047
+ added: Array<string>;
2048
+ removed: Array<string>;
2049
+ ignored: Array<string>;
2050
+ };
1887
2051
  }>;
1888
2052
  outcome: 'event' | 'no_event';
1889
2053
  requestDigest: string;
@@ -1904,10 +2068,15 @@ type ShapeRemoveCompatibilityResult = {
1904
2068
  operations: Array<{
1905
2069
  opIndex?: number;
1906
2070
  name: string;
1907
- operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
2071
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1908
2072
  version: number;
1909
2073
  dataHash: string;
1910
2074
  status?: 'applied' | 'noop';
2075
+ affirmations?: {
2076
+ added: Array<string>;
2077
+ removed: Array<string>;
2078
+ ignored: Array<string>;
2079
+ };
1911
2080
  warnings?: {
1912
2081
  undeclaredFields?: Array<string>;
1913
2082
  undeclaredFieldsTruncated?: true;
@@ -1928,7 +2097,7 @@ type ShapeRemoveCompatibilityResult = {
1928
2097
  } | {
1929
2098
  opIndex?: number;
1930
2099
  name: string;
1931
- operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
2100
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
1932
2101
  version?: number;
1933
2102
  dataHash?: string;
1934
2103
  status?: 'success' | 'noop' | 'failed';
@@ -1977,6 +2146,11 @@ type ShapeRemoveCompatibilityResult = {
1977
2146
  removalMilestone: string;
1978
2147
  }>;
1979
2148
  };
2149
+ affirmations?: {
2150
+ added: Array<string>;
2151
+ removed: Array<string>;
2152
+ ignored: Array<string>;
2153
+ };
1980
2154
  }>;
1981
2155
  outcome: 'event' | 'no_event';
1982
2156
  requestDigest: string;
@@ -2032,7 +2206,7 @@ type ShapeGetResult = {
2032
2206
  active: boolean;
2033
2207
  version: {
2034
2208
  version: number;
2035
- operation: 'add' | 'revise' | 'retract';
2209
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm';
2036
2210
  data: unknown;
2037
2211
  dataHash: string;
2038
2212
  } | null;
@@ -2045,7 +2219,7 @@ type ShapeListResult = {
2045
2219
  active: boolean;
2046
2220
  version: {
2047
2221
  version: number;
2048
- operation: 'add' | 'revise' | 'retract';
2222
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm';
2049
2223
  data: unknown;
2050
2224
  dataHash: string;
2051
2225
  } | null;
@@ -2064,10 +2238,11 @@ type ThingHistoryResult = {
2064
2238
  thingName?: string;
2065
2239
  thingKind?: string;
2066
2240
  shapeName?: string;
2067
- operation: 'add' | 'revise' | 'retract';
2241
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm';
2068
2242
  retractReason?: string;
2069
2243
  data?: unknown;
2070
2244
  aboutWref?: string;
2245
+ affirmedWrefs?: Array<string>;
2071
2246
  active: boolean;
2072
2247
  createdAt: number;
2073
2248
  committerWref?: string;
@@ -2105,6 +2280,7 @@ type ThingGetManyResult$1 = {
2105
2280
  active: boolean;
2106
2281
  synthesized?: boolean;
2107
2282
  aboutWref?: string;
2283
+ affirmedWrefs?: Array<string>;
2108
2284
  committerWref?: string;
2109
2285
  createdBy?: string;
2110
2286
  revisedBy?: string;
@@ -2475,6 +2651,7 @@ type ViewEvaluateResult$1 = {
2475
2651
  data?: unknown;
2476
2652
  active: boolean;
2477
2653
  aboutWref?: string;
2654
+ affirmedWrefs?: Array<string>;
2478
2655
  roles?: Array<'from' | 'to' | 'ends' | 'first' | 'second'>;
2479
2656
  metadata?: {
2480
2657
  durableId: string;
@@ -2491,12 +2668,30 @@ type ViewEvaluateResult$1 = {
2491
2668
  };
2492
2669
 
2493
2670
  /**
2494
- * Input for idempotently creating an inline-coverage repository Grant.
2671
+ * How a Grant names its recipient. The server resolves the selector to one
2672
+ * exact actor and stores only that, so the grant keeps meaning the same actor
2673
+ * even after the name is reused.
2674
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/grantrecipientselector/
2675
+ */
2676
+ type GrantRecipientSelector = GrantCreateInput['recipient'];
2677
+ type GrantCreateIdentity = Omit<GrantCreateInput, 'orgName' | 'repoName' | 'coverage' | 'viewRef'>;
2678
+ /**
2679
+ * Input for idempotently creating a repository Grant.
2680
+ *
2681
+ * A Grant draws its coverage from exactly one source: inline `coverage`, or
2682
+ * `viewRef` naming a View (`View/<name>`, or `View/<name>@vN` to pin one
2683
+ * definition). The union makes that exclusive at the call site rather than
2684
+ * leaving it to a server round trip; the server stores the View's durable
2685
+ * identity, so the Grant keeps meaning the same View after a rename.
2495
2686
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/grantcreateoptions/
2496
2687
  */
2497
- type GrantCreateOptions = Omit<GrantCreateInput, 'orgName' | 'repoName' | 'coverage' | 'viewRef'> & {
2688
+ type GrantCreateOptions = GrantCreateIdentity & ({
2498
2689
  coverage: NonNullable<GrantCreateInput['coverage']>;
2499
- };
2690
+ viewRef?: never;
2691
+ } | {
2692
+ viewRef: NonNullable<GrantCreateInput['viewRef']>;
2693
+ coverage?: never;
2694
+ });
2500
2695
  /** @internal */
2501
2696
  type GrantListOptions = Partial<Omit<GrantListInput, 'orgName' | 'repoName'>>;
2502
2697
  /**
@@ -2540,7 +2735,57 @@ type RepositoryCheckpointAccess = Omit<RepositoryCheckpointAccess$1, 'expiresAt'
2540
2735
  expiresAt: Date;
2541
2736
  };
2542
2737
 
2543
- declare const COMMIT_OPERATIONS: readonly ["add", "revise", "retract", "rename"];
2738
+ /**
2739
+ * The coarse organization capability scopes this SDK build knows about.
2740
+ *
2741
+ * The org-side twin of `REPO_AUTH_SCOPES`, with the same open-wire caveat: a
2742
+ * newer backend can return a scope missing from this tuple.
2743
+ * @see https://docs.warmhub.ai/sdk-reference/variables/org_auth_scopes/
2744
+ */
2745
+ declare const ORG_AUTH_SCOPES: readonly ["org:read", "org:configure", "org:admin", "org:action-callback"];
2746
+ /**
2747
+ * An organization capability scope this build knows about. The DOMAIN type,
2748
+ * which stays closed — the wire type is an open string. See `ORG_AUTH_SCOPES`.
2749
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/orgauthscope/
2750
+ */
2751
+ type OrgAuthScope = (typeof ORG_AUTH_SCOPES)[number];
2752
+ /**
2753
+ * Is `value` one of the org scopes this build knows about? The sibling of
2754
+ * `isKnownRepoAuthScope`; see that function for why the guard exists.
2755
+ * @see https://docs.warmhub.ai/sdk-reference/functions/isknownorgauthscope/
2756
+ */
2757
+ declare function isKnownOrgAuthScope(value: string): value is OrgAuthScope;
2758
+
2759
+ /**
2760
+ * The coarse repository capability scopes this SDK build knows about.
2761
+ *
2762
+ * The `access.resolve` response types `scopes` as an open string, so a newer
2763
+ * backend can return a scope missing from this tuple. Use it to enumerate the
2764
+ * capabilities this build understands, not to validate a response.
2765
+ * @see https://docs.warmhub.ai/sdk-reference/variables/repo_auth_scopes/
2766
+ */
2767
+ declare const REPO_AUTH_SCOPES: readonly ["repo:read", "repo:checkpoint-read", "repo:write", "repo:configure", "repo:admin", "repo:action-callback"];
2768
+ /**
2769
+ * A repository capability scope this build knows about. The DOMAIN type, which
2770
+ * stays closed — the wire type is an open string. See `REPO_AUTH_SCOPES`.
2771
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repoauthscope/
2772
+ */
2773
+ type RepoAuthScope = (typeof REPO_AUTH_SCOPES)[number];
2774
+ /**
2775
+ * Is `value` one of the repo scopes this build knows about?
2776
+ *
2777
+ * The `access.resolve` response types `scopes` as an open string
2778
+ * (`openVocabulary(REPO_AUTH_SCOPES)`), so a client can receive a scope minted
2779
+ * by a newer backend. This guard is how a caller that wants to distinguish
2780
+ * known from unknown values does so; it is documentation plus a narrowing
2781
+ * helper, never a validation gate on a response. Server-side validation of a
2782
+ * *requested* scope stays closed — see `VALID_SCOPES` in
2783
+ * `@warmhub/backend/token/scope-constants`.
2784
+ * @see https://docs.warmhub.ai/sdk-reference/functions/isknownrepoauthscope/
2785
+ */
2786
+ declare function isKnownRepoAuthScope(value: string): value is RepoAuthScope;
2787
+
2788
+ declare const COMMIT_OPERATIONS: readonly ["add", "revise", "retract", "reaffirm", "rename"];
2544
2789
  type CommitOperation = (typeof COMMIT_OPERATIONS)[number];
2545
2790
  declare const COMMIT_OPERATION_KINDS: readonly ["shape", "thing", "assertion", "collection"];
2546
2791
  type CommitOperationKind = (typeof COMMIT_OPERATION_KINDS)[number];
@@ -2749,6 +2994,11 @@ interface AddOperation {
2749
2994
  * Shape-validated data payload for shape, thing, or assertion adds.
2750
2995
  */
2751
2996
  data?: unknown;
2997
+ /**
2998
+ * Pinned target wrefs (`Shape/name@vN`) the assertion's claim is affirmed
2999
+ * for. Assertion adds only; the `about` pin never seeds an affirmation.
3000
+ */
3001
+ affirmedTargets?: string[];
2752
3002
  /**
2753
3003
  * Collection type. Used only for collection adds.
2754
3004
  */
@@ -2797,6 +3047,12 @@ interface ReviseOperation {
2797
3047
  * New shape-validated data payload.
2798
3048
  */
2799
3049
  data?: unknown;
3050
+ /**
3051
+ * Complete affirmation set for the changed claim (assertion revises only).
3052
+ * Omitted clears the snapshot — prior affirmations never transfer to
3053
+ * changed claim data.
3054
+ */
3055
+ affirmedTargets?: string[];
2800
3056
  /**
2801
3057
  * Collection type. Required when `kind` is `collection`.
2802
3058
  */
@@ -2860,6 +3116,49 @@ interface RetractOperation {
2860
3116
  */
2861
3117
  leaseId?: string;
2862
3118
  }
3119
+ /**
3120
+ * Reaffirm operation accepted by `client.commit.apply`. Edits an assertion's
3121
+ * affirmation snapshot — the set of pinned target versions the claim is
3122
+ * affirmed for — without changing claim data. Mints a new assertion version
3123
+ * with body and dataHash copied from the current one.
3124
+ *
3125
+ * @see https://docs.warmhub.ai/writes/operations/#reaffirm-operations
3126
+ */
3127
+ interface ReaffirmOperation {
3128
+ /**
3129
+ * Operation discriminator. Required.
3130
+ */
3131
+ operation: 'reaffirm';
3132
+ /**
3133
+ * Assertion to reaffirm: `Shape/name`.
3134
+ */
3135
+ name: string;
3136
+ /**
3137
+ * Optional kind safety hint; reaffirm applies only to assertions.
3138
+ */
3139
+ kind?: 'assertion';
3140
+ /**
3141
+ * Pinned target wrefs (`Shape/name@vN`) to affirm. A target already in the
3142
+ * set is reported as `ignored`, not an error.
3143
+ */
3144
+ add?: string[];
3145
+ /**
3146
+ * Pinned target wrefs to stop affirming. A target not in the set is
3147
+ * reported as `ignored`, not an error. Prior versions keep their snapshots.
3148
+ */
3149
+ remove?: string[];
3150
+ /**
3151
+ * Optional optimistic-concurrency precondition, as on revise/retract. The
3152
+ * new set is computed from the live current snapshot, so concurrent deltas
3153
+ * merge without it; supply it when the edit must apply to the exact version
3154
+ * you read.
3155
+ */
3156
+ expectedVersion?: number;
3157
+ /**
3158
+ * Optional read-lease token (#3625), as on revise/retract.
3159
+ */
3160
+ leaseId?: string;
3161
+ }
2863
3162
  /**
2864
3163
  * Rename operation accepted by `client.commit.apply` (#4848). Rewrites a thing's
2865
3164
  * or shape's name in place — a version-less metadata op that records a from→to
@@ -2918,7 +3217,7 @@ interface RenameOperation {
2918
3217
  *
2919
3218
  * @see https://docs.warmhub.ai/sdk/write-methods/#typing-operation-arrays
2920
3219
  */
2921
- type Operation = AddOperation | ReviseOperation | RetractOperation | RenameOperation;
3220
+ type Operation = AddOperation | ReviseOperation | RetractOperation | ReaffirmOperation | RenameOperation;
2922
3221
 
2923
3222
  /**
2924
3223
  * Default number of operations the SDK sends per stream append chunk.
@@ -2967,6 +3266,8 @@ type SubmittedStreamResult = {
2967
3266
  resolvedName?: string;
2968
3267
  retryable?: boolean;
2969
3268
  warnings?: NonNullable<StreamAppendResult$1['results'][number]['warnings']>;
3269
+ /** Per-target reaffirm outcome; present only on reaffirm results. */
3270
+ affirmations?: NonNullable<StreamAppendResult$1['results'][number]['affirmations']>;
2970
3271
  }>;
2971
3272
  /** One exact immutable receipt per stream chunk, in submission order. */
2972
3273
  receipts: OperationEventReceiptV1$1[];
@@ -3339,6 +3640,11 @@ interface BaseAddOp {
3339
3640
  * Shape-validated data payload for shape, thing, or assertion adds.
3340
3641
  */
3341
3642
  readonly data?: unknown;
3643
+ /**
3644
+ * Pinned target wrefs (`Shape/name@vN`) the assertion's claim is affirmed
3645
+ * for (assertion adds/revises only).
3646
+ */
3647
+ readonly affirmedTargets?: readonly string[];
3342
3648
  /**
3343
3649
  * When true, an existing target returns `noop` instead of failing.
3344
3650
  */
@@ -3416,6 +3722,11 @@ interface ReviseOp {
3416
3722
  * New shape-validated data payload.
3417
3723
  */
3418
3724
  readonly data?: unknown;
3725
+ /**
3726
+ * Pinned target wrefs (`Shape/name@vN`) the assertion's claim is affirmed
3727
+ * for (assertion adds/revises only).
3728
+ */
3729
+ readonly affirmedTargets?: readonly string[];
3419
3730
  /**
3420
3731
  * Collection type. Required when `kind` is `collection`.
3421
3732
  */
@@ -3473,11 +3784,46 @@ interface RetractOp {
3473
3784
  */
3474
3785
  readonly leaseId?: string;
3475
3786
  }
3787
+ /**
3788
+ * Builder reaffirm operation. Edits an assertion's affirmation snapshot (the
3789
+ * pinned target versions the claim is affirmed for) without changing claim
3790
+ * data.
3791
+ */
3792
+ interface ReaffirmOp {
3793
+ /**
3794
+ * Operation discriminator. Always `reaffirm`.
3795
+ */
3796
+ readonly operation: 'reaffirm';
3797
+ /**
3798
+ * Assertion to reaffirm: `Shape/name`.
3799
+ */
3800
+ readonly name: string;
3801
+ /**
3802
+ * Optional kind safety hint; reaffirm applies only to assertions.
3803
+ */
3804
+ readonly kind?: 'assertion';
3805
+ /**
3806
+ * Pinned target wrefs (`Shape/name@vN`) to affirm.
3807
+ */
3808
+ readonly add?: readonly string[];
3809
+ /**
3810
+ * Pinned target wrefs to stop affirming.
3811
+ */
3812
+ readonly remove?: readonly string[];
3813
+ /**
3814
+ * Optional optimistic-concurrency precondition, as on revise/retract.
3815
+ */
3816
+ readonly expectedVersion?: number;
3817
+ /**
3818
+ * Optional read-lease token (#3625), as on revise/retract.
3819
+ */
3820
+ readonly leaseId?: string;
3821
+ }
3476
3822
  /**
3477
3823
  * Operation queued by `OperationBuilder`.
3478
3824
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/operationbuilderop/
3479
3825
  */
3480
- type OperationBuilderOp = AddOp | CollectionAddOp | ReviseOp | RetractOp;
3826
+ type OperationBuilderOp = AddOp | CollectionAddOp | ReviseOp | RetractOp | ReaffirmOp;
3481
3827
  type OperationSubmitResult$1 = SubmittedStreamResult;
3482
3828
  /**
3483
3829
  * Client-side validation diagnostic returned by `OperationBuilder.validate`.
@@ -3592,6 +3938,14 @@ declare class OperationBuilder {
3592
3938
  * @see https://docs.warmhub.ai/sdk-reference/classes/operationbuilder/#retract
3593
3939
  */
3594
3940
  retract(target: string | Omit<RetractOp, 'operation'>): this;
3941
+ /**
3942
+ * Add a reaffirm operation.
3943
+ *
3944
+ * Edits the assertion's affirmation snapshot: `add`/`remove` carry pinned
3945
+ * target wrefs (`Shape/name@vN`) and compose in one operation.
3946
+ * @see https://docs.warmhub.ai/sdk-reference/classes/operationbuilder/#reaffirm
3947
+ */
3948
+ reaffirm(op: Omit<ReaffirmOp, 'operation'>): this;
3595
3949
  /**
3596
3950
  * Return the queued operations.
3597
3951
  *
@@ -4534,6 +4888,11 @@ type ThingItem = {
4534
4888
  active?: boolean;
4535
4889
  data?: unknown;
4536
4890
  aboutWref?: string;
4891
+ /**
4892
+ * Pinned target wrefs the assertion's current version affirms. Assertions
4893
+ * only; targets the reader cannot see are suppressed per-target.
4894
+ */
4895
+ affirmedWrefs?: string[];
4537
4896
  roles?: CollectionMembershipRole[];
4538
4897
  metadata?: ThingMetadata;
4539
4898
  [key: string]: unknown;
@@ -4605,6 +4964,11 @@ type ThingDetail = {
4605
4964
  /** True on synthesized empty stubs from getReadme/getAgents when no row exists yet. */
4606
4965
  synthesized?: boolean;
4607
4966
  aboutWref?: string;
4967
+ /**
4968
+ * Pinned target wrefs the returned assertion version affirms. Assertions
4969
+ * only; targets the reader cannot see are suppressed per-target.
4970
+ */
4971
+ affirmedWrefs?: string[];
4608
4972
  committerWref?: string;
4609
4973
  /**
4610
4974
  * #4848 Phase C: the thing's creator (first-version author), a peer of the
@@ -4956,6 +5320,12 @@ type FilterOptions = {
4956
5320
  kind?: CommitOperationKind;
4957
5321
  /** Filter assertions whose `about` target wref matches the supplied value. */
4958
5322
  about?: string;
5323
+ /**
5324
+ * Filter to active assertions whose current version affirms exactly this
5325
+ * pinned target version (`Shape/name@vN`). Pinned-only; cannot be combined
5326
+ * with `match` glob patterns.
5327
+ */
5328
+ affirmedAbout?: string;
4959
5329
  /** Glob pattern matched against record names (for example `Player/*`). */
4960
5330
  match?: string;
4961
5331
  /** Include retracted versions in the result set. */
@@ -4985,7 +5355,7 @@ type FilterOptions = {
4985
5355
  sinceRepoSeq?: number;
4986
5356
  };
4987
5357
  /** @internal */
4988
- type ThingQueryChangesOptions = Omit<FilterOptions, 'cursor' | 'includeRetracted' | 'sinceRepoSeq'> & {
5358
+ type ThingQueryChangesOptions = Omit<FilterOptions, 'cursor' | 'includeRetracted' | 'sinceRepoSeq' | 'affirmedAbout'> & {
4989
5359
  sinceRepoSeq: number;
4990
5360
  };
4991
5361
  /**
@@ -4997,7 +5367,7 @@ type ThingQueryChangesOptions = Omit<FilterOptions, 'cursor' | 'includeRetracted
4997
5367
  *
4998
5368
  * @see https://docs.warmhub.ai/sdk/read-semantics/#search-modes
4999
5369
  */
5000
- type SearchOptions = Omit<FilterOptions, 'where' | 'role' | 'sinceRepoSeq'> & {
5370
+ type SearchOptions = Omit<FilterOptions, 'where' | 'role' | 'sinceRepoSeq' | 'affirmedAbout'> & {
5001
5371
  /** Restrict the search to assertions about this wref target. */
5002
5372
  about?: string;
5003
5373
  /** Search mode: `text` (BM25), `vector` (semantic), or `hybrid` (combined). Defaults to `text`. */
@@ -5014,7 +5384,7 @@ type SearchOptions = Omit<FilterOptions, 'where' | 'role' | 'sinceRepoSeq'> & {
5014
5384
  * pagination fields (`limit`, `cursor`) are ignored.
5015
5385
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/countoptions/
5016
5386
  */
5017
- type CountOptions = Omit<FilterOptions, 'role'>;
5387
+ type CountOptions = Omit<FilterOptions, 'role' | 'affirmedAbout'>;
5018
5388
  /**
5019
5389
  * Options for `client.thing.refs` — wref-field reverse and forward lookups.
5020
5390
  *
@@ -7062,4 +7432,4 @@ declare class WarmHubClient {
7062
7432
  private watchRepoQuery;
7063
7433
  }
7064
7434
 
7065
- export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionDeliveryTarget, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedItem, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAddOp, type CollectionAddType, type CollectionContainsOptions, type CollectionContainsResult, type CollectionCreateOptions, type CollectionDiffOptions, type CollectionDiffResult, type CollectionMember, type CollectionMembersOptions, type CollectionMembersPage, type CollectionMembershipRole, type CollectionMutationResult, type CollectionQuerySourceOptions, type CollectionReadDataMode, type CollectionReadSummary, type CollectionReviseOptions, type CollectionStatsOptions, type CollectionStatsResult, type CollectionTag, type CollectionType, type CommitApplyCompatibilityResult, type ComponentHistory, type ComponentHistoryOptions, type ComponentInfo, type ComponentInstallOptions, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallOptions, type ComponentUninstallResult, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, type Grant, type GrantCreateOptions, type GrantListOptions, type GrantListResult, type GrantRevokeResult, type HeadResult, type HistoryResult, type HistoryVersion, type HomepageFeaturedListsResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, type Operation, OperationBuilder, type OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationEventReceiptV1, type OperationSubmitResult, type OrgAccessResult, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, type RefLink, type RefsOptions, type RefsResult, type RenameOperation, type RenameOptions, type RenameResult, type RepoAccessResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoExploreBrowseOptions, type RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, type RepoInfo, type RepoLicense, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RepositoryCheckpointAccess, type RepositoryCheckpointStatus, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeRemoveOptions, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingChanges, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadChangesOptions, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type ThingQueryChangesOptions, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, type ViewEvaluateOptions, type ViewEvaluateResult, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, aggregateSubmittedStreamResult, completedOperationsFrom, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, createOperationEventRequestId, createOperationEventSubmissionId, isConnectionError, isDefiniteStreamAppendRejection, isRetryable, isWarmHubError, normalizeWref, offsetChunkResultIndexes, operationEventStreamRequestId, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };
7435
+ export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionDeliveryTarget, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedItem, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAddOp, type CollectionAddType, type CollectionContainsOptions, type CollectionContainsResult, type CollectionCreateOptions, type CollectionDiffOptions, type CollectionDiffResult, type CollectionMember, type CollectionMembersOptions, type CollectionMembersPage, type CollectionMembershipRole, type CollectionMutationResult, type CollectionQuerySourceOptions, type CollectionReadDataMode, type CollectionReadSummary, type CollectionReviseOptions, type CollectionStatsOptions, type CollectionStatsResult, type CollectionTag, type CollectionType, type CommitApplyCompatibilityResult, type ComponentHistory, type ComponentHistoryOptions, type ComponentInfo, type ComponentInstallOptions, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallOptions, type ComponentUninstallResult, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, type Grant, type GrantCreateOptions, type GrantListOptions, type GrantListResult, type GrantRecipientSelector, type GrantRevokeResult, type HeadResult, type HistoryResult, type HistoryVersion, type HomepageFeaturedListsResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, ORG_AUTH_SCOPES, type Operation, OperationBuilder, type OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationEventReceiptV1, type OperationSubmitResult, type OrgAccessResult, type OrgAuthScope, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, REPO_AUTH_SCOPES, type ReaffirmOperation, type RefLink, type RefsOptions, type RefsResult, type RenameOperation, type RenameOptions, type RenameResult, type RepoAccessResult, type RepoAuthScope, type RepoConfigureStatsView, type RepoDescribeResult, type RepoExploreBrowseOptions, type RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, type RepoInfo, type RepoLicense, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RepositoryCheckpointAccess, type RepositoryCheckpointStatus, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeRemoveOptions, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingChanges, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadChangesOptions, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type ThingQueryChangesOptions, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, type ViewEvaluateOptions, type ViewEvaluateResult, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, aggregateSubmittedStreamResult, completedOperationsFrom, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, createOperationEventRequestId, createOperationEventSubmissionId, isConnectionError, isDefiniteStreamAppendRejection, isKnownOrgAuthScope, isKnownRepoAuthScope, isRetryable, isWarmHubError, normalizeWref, offsetChunkResultIndexes, operationEventStreamRequestId, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };