@warmhub/sdk-ts 0.86.0 → 0.88.0

package/dist/index.d.ts

@@ -90,14 +90,14 @@ type AccessResolveResult$1 = {
         orgName: string;
         repoName: string;
         visible: boolean;
-        scopes: Array<'repo:read' | 'repo:checkpoint-read' | 'repo:write' | 'repo:configure' | 'repo:admin' | 'repo:action-callback'>;
+        scopes: Array<string>;
         allowedMatches?: Array<string>;
         repoDurableId?: string;
     }>;
     orgs: Array<{
         orgName: string;
         visible: boolean;
-        scopes: Array<'org:read' | 'org:configure' | 'org:admin' | 'org:action-callback'>;
+        scopes: Array<string>;
     }>;
 };
 type AuthSyncResult = {
@@ -119,10 +119,15 @@ type OperationEventReceiptV1$1 = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
         warnings?: {
             undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -143,7 +148,7 @@ type OperationEventReceiptV1$1 = {
     } | {
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -192,6 +197,11 @@ type OperationEventReceiptV1$1 = {
                 removalMilestone: string;
             }>;
         };
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
     }>;
     outcome: 'event' | 'no_event';
     requestDigest: string;
@@ -290,7 +300,7 @@ type ComponentDetail = {
         active: boolean;
         version: {
             version: number;
-            operation: 'add' | 'revise' | 'retract';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm';
             data: unknown;
             dataHash: string;
         } | null;
@@ -307,6 +317,7 @@ type ComponentDetail = {
         data?: unknown;
         active: boolean;
         aboutWref?: string;
+        affirmedWrefs?: Array<string>;
         roles?: Array<'from' | 'to' | 'ends' | 'first' | 'second'>;
         metadata?: {
             durableId: string;
@@ -347,10 +358,15 @@ type ComponentInstallResult$1 = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -371,7 +387,7 @@ type ComponentInstallResult$1 = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -420,6 +436,11 @@ type ComponentInstallResult$1 = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -485,10 +506,15 @@ type ComponentUninstallResult$1 = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -509,7 +535,7 @@ type ComponentUninstallResult$1 = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -558,6 +584,11 @@ type ComponentUninstallResult$1 = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -583,6 +614,90 @@ type Capabilities = {
     minSupportedClients: Record<string, string>;
     writeContractVersion: number;
     features: Record<string, boolean>;
+    honoredClientFlags: Array<string>;
+};
+type GrantCreateInput = {
+    orgName: string;
+    repoName: string;
+    idempotencyKey: string;
+    recipient: {
+        kind: 'member';
+        email: string;
+    } | {
+        kind: 'pat';
+        name: string;
+    } | {
+        kind: 'component';
+        orgName: string;
+        componentName: string;
+    };
+    coverage?: {
+        include: Array<string>;
+        exclude?: Array<string>;
+    };
+    viewRef?: string;
+    ops: Array<string>;
+};
+type GrantListInput = {
+    orgName: string;
+    repoName: string;
+    limit: number;
+    cursor?: string;
+};
+type GrantListResult$1 = {
+    items: Array<{
+        id: string;
+        grantee: {
+            principalId: string;
+            principalKind: 'anonymous' | 'member' | 'pat' | 'component';
+        };
+        issuer: {
+            principalId: string;
+            principalKind: 'anonymous' | 'member' | 'pat' | 'component';
+        };
+        idempotencyKey: string;
+        requestHash: string;
+        coverage: {
+            include: Array<string>;
+            exclude?: Array<string>;
+        } | null;
+        viewRef: string | null;
+        ops: Array<string>;
+        createdBy: string;
+        createdAt: string;
+        revokedAt: string | null;
+        revokedBy: string | null;
+        revokedReason: string | null;
+    }>;
+    nextCursor?: string;
+};
+type GrantRevokeResult$1 = {
+    grantId: string;
+    revoked: boolean;
+};
+type GrantView = {
+    id: string;
+    grantee: {
+        principalId: string;
+        principalKind: 'anonymous' | 'member' | 'pat' | 'component';
+    };
+    issuer: {
+        principalId: string;
+        principalKind: 'anonymous' | 'member' | 'pat' | 'component';
+    };
+    idempotencyKey: string;
+    requestHash: string;
+    coverage: {
+        include: Array<string>;
+        exclude?: Array<string>;
+    } | null;
+    viewRef: string | null;
+    ops: Array<string>;
+    createdBy: string;
+    createdAt: string;
+    revokedAt: string | null;
+    revokedBy: string | null;
+    revokedReason: string | null;
 };
 type HomepageFeaturedListsResult$1 = {
     lists: Array<{
@@ -641,12 +756,14 @@ type StreamAppendInput$1 = {
         kind: 'shape';
         name: string;
         data: unknown;
+        affirmedTargets?: never;
         skipExisting?: boolean;
     } | {
         operation: 'add';
         kind: 'thing';
         name: string;
         data: unknown;
+        affirmedTargets?: never;
         skipExisting?: boolean;
     } | {
         operation: 'add';
@@ -654,6 +771,7 @@ type StreamAppendInput$1 = {
         name: string;
         about: string;
         data: unknown;
+        affirmedTargets?: Array<string>;
         skipExisting?: boolean;
     } | {
         operation: 'add';
@@ -661,12 +779,14 @@ type StreamAppendInput$1 = {
         name: string;
         type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
         members: Array<string>;
+        affirmedTargets?: never;
         skipExisting?: boolean;
     } | {
         operation: 'revise';
         kind: 'shape';
         name: string;
         data: unknown;
+        affirmedTargets?: never;
         expectedVersion?: number;
         active?: never;
         leaseId?: string;
@@ -675,6 +795,7 @@ type StreamAppendInput$1 = {
         kind: 'thing';
         name: string;
         data: unknown;
+        affirmedTargets?: never;
         expectedVersion?: number;
         active?: never;
         leaseId?: string;
@@ -683,6 +804,7 @@ type StreamAppendInput$1 = {
         kind: 'assertion';
         name: string;
         data: unknown;
+        affirmedTargets?: Array<string>;
         expectedVersion?: number;
         active?: never;
         leaseId?: string;
@@ -692,6 +814,7 @@ type StreamAppendInput$1 = {
         name: string;
         type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
         members: Array<string>;
+        affirmedTargets?: never;
         expectedVersion?: number;
         leaseId?: string;
     } | {
@@ -701,6 +824,14 @@ type StreamAppendInput$1 = {
         reason?: string;
         expectedVersion?: number;
         leaseId?: string;
+    } | {
+        operation: 'reaffirm';
+        kind?: 'assertion';
+        name: string;
+        add?: Array<string>;
+        remove?: Array<string>;
+        expectedVersion?: number;
+        leaseId?: string;
     } | {
         operation: 'rename';
         name: string;
@@ -718,7 +849,7 @@ type StreamAppendResult$1 = {
     results: Array<{
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -767,12 +898,16 @@ type StreamAppendResult$1 = {
                 removalMilestone: string;
             }>;
         };
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
     }>;
     repoSeq?: number;
     createdByEmail?: string;
     appendTotalMs?: number;
     appendResolveRepoMs?: number;
-    appendTokenResolveMs?: number;
     appendApplyMs?: number;
     applySubphases?: {
         addThingMs?: number;
@@ -783,7 +918,6 @@ type StreamAppendResult$1 = {
         reviseCollectionMs?: number;
         preparePinnedLoadShapeFieldsMs?: number;
         preparePinnedPinWrefsMs?: number;
-        preparePinnedResolveTokensMs?: number;
         preparePinnedValidateMs?: number;
         operationLoopMs?: number;
         persistMs?: number;
@@ -809,10 +943,15 @@ type StreamAppendResult$1 = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
         warnings?: {
             undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -833,7 +972,7 @@ type StreamAppendResult$1 = {
     } | {
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -882,6 +1021,11 @@ type StreamAppendResult$1 = {
                 removalMilestone: string;
             }>;
         };
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
     }>;
     outcome: 'event' | 'no_event';
     requestDigest: string;
@@ -902,10 +1046,15 @@ type StreamAppendResult$1 = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -926,7 +1075,7 @@ type StreamAppendResult$1 = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -975,6 +1124,11 @@ type StreamAppendResult$1 = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -991,10 +1145,15 @@ type CommitApplyCompatibilityResult$1 = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
         warnings?: {
             undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -1043,10 +1202,15 @@ type CommitApplyCompatibilityResult$1 = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -1067,7 +1231,7 @@ type CommitApplyCompatibilityResult$1 = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -1116,6 +1280,11 @@ type CommitApplyCompatibilityResult$1 = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -1162,10 +1331,15 @@ type CollectionMutationCompatibilityResult = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
         warnings?: {
             undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -1186,7 +1360,7 @@ type CollectionMutationCompatibilityResult = {
     } | {
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -1235,6 +1409,11 @@ type CollectionMutationCompatibilityResult = {
                 removalMilestone: string;
             }>;
         };
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
     }>;
     outcome: 'event' | 'no_event';
     requestDigest: string;
@@ -1255,10 +1434,15 @@ type CollectionMutationCompatibilityResult = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -1279,7 +1463,7 @@ type CollectionMutationCompatibilityResult = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -1328,6 +1512,11 @@ type CollectionMutationCompatibilityResult = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -1351,10 +1540,15 @@ type RenameCompatibilityResult = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
         warnings?: {
             undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -1375,7 +1569,7 @@ type RenameCompatibilityResult = {
     } | {
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -1424,6 +1618,11 @@ type RenameCompatibilityResult = {
                 removalMilestone: string;
             }>;
         };
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
     }>;
     outcome: 'event' | 'no_event';
     requestDigest: string;
@@ -1444,10 +1643,15 @@ type RenameCompatibilityResult = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -1468,7 +1672,7 @@ type RenameCompatibilityResult = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -1517,6 +1721,11 @@ type RenameCompatibilityResult = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -1526,7 +1735,7 @@ type RenameCompatibilityResult = {
 };
 type ShapeChangeCompatibilityResult = {
     name: string;
-    operation: 'add' | 'revise' | 'retract' | 'noop';
+    operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
     version: number;
     dataHash: string;
     event: {
@@ -1543,10 +1752,15 @@ type ShapeChangeCompatibilityResult = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
         warnings?: {
             undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -1567,7 +1781,7 @@ type ShapeChangeCompatibilityResult = {
     } | {
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -1616,6 +1830,11 @@ type ShapeChangeCompatibilityResult = {
                 removalMilestone: string;
             }>;
         };
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
     }>;
     outcome: 'event' | 'no_event';
     requestDigest: string;
@@ -1636,10 +1855,15 @@ type ShapeChangeCompatibilityResult = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -1660,7 +1884,7 @@ type ShapeChangeCompatibilityResult = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -1709,6 +1933,11 @@ type ShapeChangeCompatibilityResult = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -1718,7 +1947,7 @@ type ShapeChangeCompatibilityResult = {
 };
 type ShapeRemoveCompatibilityResult = {
     name: string;
-    operation: 'add' | 'revise' | 'retract' | 'noop';
+    operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
     version: number;
     dataHash: string;
     removed: true;
@@ -1736,10 +1965,15 @@ type ShapeRemoveCompatibilityResult = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
         warnings?: {
             undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -1760,7 +1994,7 @@ type ShapeRemoveCompatibilityResult = {
     } | {
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -1809,6 +2043,11 @@ type ShapeRemoveCompatibilityResult = {
                 removalMilestone: string;
             }>;
         };
+        affirmations?: {
+            added: Array<string>;
+            removed: Array<string>;
+            ignored: Array<string>;
+        };
     }>;
     outcome: 'event' | 'no_event';
     requestDigest: string;
@@ -1829,10 +2068,15 @@ type ShapeRemoveCompatibilityResult = {
         operations: Array<{
             opIndex?: number;
             name: string;
-            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version: number;
             dataHash: string;
             status?: 'applied' | 'noop';
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
             warnings?: {
                 undeclaredFields?: Array<string>;
                 undeclaredFieldsTruncated?: true;
@@ -1853,7 +2097,7 @@ type ShapeRemoveCompatibilityResult = {
         } | {
             opIndex?: number;
             name: string;
-            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'noop';
             version?: number;
             dataHash?: string;
             status?: 'success' | 'noop' | 'failed';
@@ -1902,6 +2146,11 @@ type ShapeRemoveCompatibilityResult = {
                     removalMilestone: string;
                 }>;
             };
+            affirmations?: {
+                added: Array<string>;
+                removed: Array<string>;
+                ignored: Array<string>;
+            };
         }>;
         outcome: 'event' | 'no_event';
         requestDigest: string;
@@ -1957,7 +2206,7 @@ type ShapeGetResult = {
     active: boolean;
     version: {
         version: number;
-        operation: 'add' | 'revise' | 'retract';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm';
         data: unknown;
         dataHash: string;
     } | null;
@@ -1970,7 +2219,7 @@ type ShapeListResult = {
         active: boolean;
         version: {
             version: number;
-            operation: 'add' | 'revise' | 'retract';
+            operation: 'add' | 'revise' | 'retract' | 'reaffirm';
             data: unknown;
             dataHash: string;
         } | null;
@@ -1989,10 +2238,11 @@ type ThingHistoryResult = {
         thingName?: string;
         thingKind?: string;
         shapeName?: string;
-        operation: 'add' | 'revise' | 'retract';
+        operation: 'add' | 'revise' | 'retract' | 'reaffirm';
         retractReason?: string;
         data?: unknown;
         aboutWref?: string;
+        affirmedWrefs?: Array<string>;
         active: boolean;
         createdAt: number;
         committerWref?: string;
@@ -2030,6 +2280,7 @@ type ThingGetManyResult$1 = {
         active: boolean;
         synthesized?: boolean;
         aboutWref?: string;
+        affirmedWrefs?: Array<string>;
         committerWref?: string;
         createdBy?: string;
         revisedBy?: string;
@@ -2381,6 +2632,77 @@ type WireScopeEntry$1 = {
     permissions: Array<string>;
     allowedMatches?: Array<string>;
 };
+type ViewEvaluateInput = {
+    orgName: string;
+    repoName: string;
+    wref: string;
+    limit?: number;
+    cursor?: string;
+};
+type ViewEvaluateResult$1 = {
+    items: Array<{
+        wref: string;
+        name: string;
+        kind: 'shape' | 'thing' | 'assertion' | 'collection';
+        shapeName?: string;
+        componentRef?: string;
+        version: number;
+        createdAt: number;
+        data?: unknown;
+        active: boolean;
+        aboutWref?: string;
+        affirmedWrefs?: Array<string>;
+        roles?: Array<'from' | 'to' | 'ends' | 'first' | 'second'>;
+        metadata?: {
+            durableId: string;
+            createdOn: number;
+            revisedOn: number;
+        };
+    }>;
+    nextCursor?: string;
+    repoSeq?: number;
+    view: {
+        wref: string;
+        version: number;
+    };
+};
+
+/**
+ * How a Grant names its recipient. The server resolves the selector to one
+ * exact actor and stores only that, so the grant keeps meaning the same actor
+ * even after the name is reused.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/grantrecipientselector/
+ */
+type GrantRecipientSelector = GrantCreateInput['recipient'];
+type GrantCreateIdentity = Omit<GrantCreateInput, 'orgName' | 'repoName' | 'coverage' | 'viewRef'>;
+/**
+ * Input for idempotently creating a repository Grant.
+ *
+ * A Grant draws its coverage from exactly one source: inline `coverage`, or
+ * `viewRef` naming a View (`View/<name>`, or `View/<name>@vN` to pin one
+ * definition). The union makes that exclusive at the call site rather than
+ * leaving it to a server round trip; the server stores the View's durable
+ * identity, so the Grant keeps meaning the same View after a rename.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/grantcreateoptions/
+ */
+type GrantCreateOptions = GrantCreateIdentity & ({
+    coverage: NonNullable<GrantCreateInput['coverage']>;
+    viewRef?: never;
+} | {
+    viewRef: NonNullable<GrantCreateInput['viewRef']>;
+    coverage?: never;
+});
+/** @internal */
+type GrantListOptions = Partial<Omit<GrantListInput, 'orgName' | 'repoName'>>;
+/**
+ * An immutable active or revoked repository Grant record.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/grant/
+ */
+type Grant = GrantView;
+/** @internal */
+type GrantListResult = GrantListResult$1;
+/** @internal */
+type GrantRevokeResult = GrantRevokeResult$1;
 
 type DateMappedRepositoryCheckpointStatus<T> = T extends {
     createdAt: number;
@@ -2413,7 +2735,57 @@ type RepositoryCheckpointAccess = Omit<RepositoryCheckpointAccess$1, 'expiresAt'
     expiresAt: Date;
 };
 
-declare const COMMIT_OPERATIONS: readonly ["add", "revise", "retract", "rename"];
+/**
+ * The coarse organization capability scopes this SDK build knows about.
+ *
+ * The org-side twin of `REPO_AUTH_SCOPES`, with the same open-wire caveat: a
+ * newer backend can return a scope missing from this tuple.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/org_auth_scopes/
+ */
+declare const ORG_AUTH_SCOPES: readonly ["org:read", "org:configure", "org:admin", "org:action-callback"];
+/**
+ * An organization capability scope this build knows about. The DOMAIN type,
+ * which stays closed — the wire type is an open string. See `ORG_AUTH_SCOPES`.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/orgauthscope/
+ */
+type OrgAuthScope = (typeof ORG_AUTH_SCOPES)[number];
+/**
+ * Is `value` one of the org scopes this build knows about? The sibling of
+ * `isKnownRepoAuthScope`; see that function for why the guard exists.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/isknownorgauthscope/
+ */
+declare function isKnownOrgAuthScope(value: string): value is OrgAuthScope;
+
+/**
+ * The coarse repository capability scopes this SDK build knows about.
+ *
+ * The `access.resolve` response types `scopes` as an open string, so a newer
+ * backend can return a scope missing from this tuple. Use it to enumerate the
+ * capabilities this build understands, not to validate a response.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/repo_auth_scopes/
+ */
+declare const REPO_AUTH_SCOPES: readonly ["repo:read", "repo:checkpoint-read", "repo:write", "repo:configure", "repo:admin", "repo:action-callback"];
+/**
+ * A repository capability scope this build knows about. The DOMAIN type, which
+ * stays closed — the wire type is an open string. See `REPO_AUTH_SCOPES`.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repoauthscope/
+ */
+type RepoAuthScope = (typeof REPO_AUTH_SCOPES)[number];
+/**
+ * Is `value` one of the repo scopes this build knows about?
+ *
+ * The `access.resolve` response types `scopes` as an open string
+ * (`openVocabulary(REPO_AUTH_SCOPES)`), so a client can receive a scope minted
+ * by a newer backend. This guard is how a caller that wants to distinguish
+ * known from unknown values does so; it is documentation plus a narrowing
+ * helper, never a validation gate on a response. Server-side validation of a
+ * *requested* scope stays closed — see `VALID_SCOPES` in
+ * `@warmhub/backend/token/scope-constants`.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/isknownrepoauthscope/
+ */
+declare function isKnownRepoAuthScope(value: string): value is RepoAuthScope;
+
+declare const COMMIT_OPERATIONS: readonly ["add", "revise", "retract", "reaffirm", "rename"];
 type CommitOperation = (typeof COMMIT_OPERATIONS)[number];
 declare const COMMIT_OPERATION_KINDS: readonly ["shape", "thing", "assertion", "collection"];
 type CommitOperationKind = (typeof COMMIT_OPERATION_KINDS)[number];
@@ -2622,6 +2994,11 @@ interface AddOperation {
      * Shape-validated data payload for shape, thing, or assertion adds.
      */
     data?: unknown;
+    /**
+     * Pinned target wrefs (`Shape/name@vN`) the assertion's claim is affirmed
+     * for. Assertion adds only; the `about` pin never seeds an affirmation.
+     */
+    affirmedTargets?: string[];
     /**
      * Collection type. Used only for collection adds.
      */
@@ -2670,6 +3047,12 @@ interface ReviseOperation {
      * New shape-validated data payload.
      */
     data?: unknown;
+    /**
+     * Complete affirmation set for the changed claim (assertion revises only).
+     * Omitted clears the snapshot — prior affirmations never transfer to
+     * changed claim data.
+     */
+    affirmedTargets?: string[];
     /**
      * Collection type. Required when `kind` is `collection`.
      */
@@ -2733,6 +3116,49 @@ interface RetractOperation {
      */
     leaseId?: string;
 }
+/**
+ * Reaffirm operation accepted by `client.commit.apply`. Edits an assertion's
+ * affirmation snapshot — the set of pinned target versions the claim is
+ * affirmed for — without changing claim data. Mints a new assertion version
+ * with body and dataHash copied from the current one.
+ *
+ * @see https://docs.warmhub.ai/writes/operations/#reaffirm-operations
+ */
+interface ReaffirmOperation {
+    /**
+     * Operation discriminator. Required.
+     */
+    operation: 'reaffirm';
+    /**
+     * Assertion to reaffirm: `Shape/name`.
+     */
+    name: string;
+    /**
+     * Optional kind safety hint; reaffirm applies only to assertions.
+     */
+    kind?: 'assertion';
+    /**
+     * Pinned target wrefs (`Shape/name@vN`) to affirm. A target already in the
+     * set is reported as `ignored`, not an error.
+     */
+    add?: string[];
+    /**
+     * Pinned target wrefs to stop affirming. A target not in the set is
+     * reported as `ignored`, not an error. Prior versions keep their snapshots.
+     */
+    remove?: string[];
+    /**
+     * Optional optimistic-concurrency precondition, as on revise/retract. The
+     * new set is computed from the live current snapshot, so concurrent deltas
+     * merge without it; supply it when the edit must apply to the exact version
+     * you read.
+     */
+    expectedVersion?: number;
+    /**
+     * Optional read-lease token (#3625), as on revise/retract.
+     */
+    leaseId?: string;
+}
 /**
  * Rename operation accepted by `client.commit.apply` (#4848). Rewrites a thing's
  * or shape's name in place — a version-less metadata op that records a from→to
@@ -2791,7 +3217,7 @@ interface RenameOperation {
  *
  * @see https://docs.warmhub.ai/sdk/write-methods/#typing-operation-arrays
  */
-type Operation = AddOperation | ReviseOperation | RetractOperation | RenameOperation;
+type Operation = AddOperation | ReviseOperation | RetractOperation | ReaffirmOperation | RenameOperation;
 
 /**
  * Default number of operations the SDK sends per stream append chunk.
@@ -2840,6 +3266,8 @@ type SubmittedStreamResult = {
         resolvedName?: string;
         retryable?: boolean;
         warnings?: NonNullable<StreamAppendResult$1['results'][number]['warnings']>;
+        /** Per-target reaffirm outcome; present only on reaffirm results. */
+        affirmations?: NonNullable<StreamAppendResult$1['results'][number]['affirmations']>;
     }>;
     /** One exact immutable receipt per stream chunk, in submission order. */
     receipts: OperationEventReceiptV1$1[];
@@ -3212,6 +3640,11 @@ interface BaseAddOp {
      * Shape-validated data payload for shape, thing, or assertion adds.
      */
     readonly data?: unknown;
+    /**
+     * Pinned target wrefs (`Shape/name@vN`) the assertion's claim is affirmed
+     * for (assertion adds/revises only).
+     */
+    readonly affirmedTargets?: readonly string[];
     /**
      * When true, an existing target returns `noop` instead of failing.
      */
@@ -3289,6 +3722,11 @@ interface ReviseOp {
      * New shape-validated data payload.
      */
     readonly data?: unknown;
+    /**
+     * Pinned target wrefs (`Shape/name@vN`) the assertion's claim is affirmed
+     * for (assertion adds/revises only).
+     */
+    readonly affirmedTargets?: readonly string[];
     /**
      * Collection type. Required when `kind` is `collection`.
      */
@@ -3346,11 +3784,46 @@ interface RetractOp {
      */
     readonly leaseId?: string;
 }
+/**
+ * Builder reaffirm operation. Edits an assertion's affirmation snapshot (the
+ * pinned target versions the claim is affirmed for) without changing claim
+ * data.
+ */
+interface ReaffirmOp {
+    /**
+     * Operation discriminator. Always `reaffirm`.
+     */
+    readonly operation: 'reaffirm';
+    /**
+     * Assertion to reaffirm: `Shape/name`.
+     */
+    readonly name: string;
+    /**
+     * Optional kind safety hint; reaffirm applies only to assertions.
+     */
+    readonly kind?: 'assertion';
+    /**
+     * Pinned target wrefs (`Shape/name@vN`) to affirm.
+     */
+    readonly add?: readonly string[];
+    /**
+     * Pinned target wrefs to stop affirming.
+     */
+    readonly remove?: readonly string[];
+    /**
+     * Optional optimistic-concurrency precondition, as on revise/retract.
+     */
+    readonly expectedVersion?: number;
+    /**
+     * Optional read-lease token (#3625), as on revise/retract.
+     */
+    readonly leaseId?: string;
+}
 /**
  * Operation queued by `OperationBuilder`.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/operationbuilderop/
  */
-type OperationBuilderOp = AddOp | CollectionAddOp | ReviseOp | RetractOp;
+type OperationBuilderOp = AddOp | CollectionAddOp | ReviseOp | RetractOp | ReaffirmOp;
 type OperationSubmitResult$1 = SubmittedStreamResult;
 /**
  * Client-side validation diagnostic returned by `OperationBuilder.validate`.
@@ -3465,6 +3938,14 @@ declare class OperationBuilder {
      * @see https://docs.warmhub.ai/sdk-reference/classes/operationbuilder/#retract
      */
     retract(target: string | Omit<RetractOp, 'operation'>): this;
+    /**
+     * Add a reaffirm operation.
+     *
+     * Edits the assertion's affirmation snapshot: `add`/`remove` carry pinned
+     * target wrefs (`Shape/name@vN`) and compose in one operation.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/operationbuilder/#reaffirm
+     */
+    reaffirm(op: Omit<ReaffirmOp, 'operation'>): this;
     /**
      * Return the queued operations.
      *
@@ -3630,6 +4111,13 @@ interface WarmHubClientOptions {
         name?: string;
         version?: string;
     };
+    /**
+     * Client-declared opt-in flags sent on `X-WarmHub-Client-Flags`. Flag names
+     * are defined by the backend deployment; see your deployment's
+     * documentation. Grammar-checked here; validated and honored only by the
+     * server. Untrusted intent — never an authz signal.
+     */
+    clientFlags?: readonly string[];
 }
 
 /**
@@ -4400,6 +4888,11 @@ type ThingItem = {
     active?: boolean;
     data?: unknown;
     aboutWref?: string;
+    /**
+     * Pinned target wrefs the assertion's current version affirms. Assertions
+     * only; targets the reader cannot see are suppressed per-target.
+     */
+    affirmedWrefs?: string[];
     roles?: CollectionMembershipRole[];
     metadata?: ThingMetadata;
     [key: string]: unknown;
@@ -4471,6 +4964,11 @@ type ThingDetail = {
     /** True on synthesized empty stubs from getReadme/getAgents when no row exists yet. */
     synthesized?: boolean;
     aboutWref?: string;
+    /**
+     * Pinned target wrefs the returned assertion version affirms. Assertions
+     * only; targets the reader cannot see are suppressed per-target.
+     */
+    affirmedWrefs?: string[];
     committerWref?: string;
     /**
      * #4848 Phase C: the thing's creator (first-version author), a peer of the
@@ -4545,6 +5043,18 @@ type ThingHeadRequest = {
 };
 /** @internal */
 type ThingHead = HeadResult;
+/**
+ * Page options for evaluating a stored View.
+ *
+ * The View definition version is selected by the single versionable `wref`
+ * passed to `view.evaluate`; there is no separate version option.
+ */
+/** @internal */
+type ViewEvaluateOptions = Omit<ViewEvaluateInput, 'orgName' | 'repoName' | 'wref'>;
+/** One page of live results from a selected stored View definition. */
+/** @internal */
+type ViewEvaluateResult = ViewEvaluateResult$1;
+
 /** @internal */
 type LiveWatchResult = {
     updates: number;
@@ -4810,6 +5320,12 @@ type FilterOptions = {
     kind?: CommitOperationKind;
     /** Filter assertions whose `about` target wref matches the supplied value. */
     about?: string;
+    /**
+     * Filter to active assertions whose current version affirms exactly this
+     * pinned target version (`Shape/name@vN`). Pinned-only; cannot be combined
+     * with `match` glob patterns.
+     */
+    affirmedAbout?: string;
     /** Glob pattern matched against record names (for example `Player/*`). */
     match?: string;
     /** Include retracted versions in the result set. */
@@ -4839,7 +5355,7 @@ type FilterOptions = {
     sinceRepoSeq?: number;
 };
 /** @internal */
-type ThingQueryChangesOptions = Omit<FilterOptions, 'cursor' | 'includeRetracted' | 'sinceRepoSeq'> & {
+type ThingQueryChangesOptions = Omit<FilterOptions, 'cursor' | 'includeRetracted' | 'sinceRepoSeq' | 'affirmedAbout'> & {
     sinceRepoSeq: number;
 };
 /**
@@ -4851,7 +5367,7 @@ type ThingQueryChangesOptions = Omit<FilterOptions, 'cursor' | 'includeRetracted
  *
  * @see https://docs.warmhub.ai/sdk/read-semantics/#search-modes
  */
-type SearchOptions = Omit<FilterOptions, 'where' | 'role' | 'sinceRepoSeq'> & {
+type SearchOptions = Omit<FilterOptions, 'where' | 'role' | 'sinceRepoSeq' | 'affirmedAbout'> & {
     /** Restrict the search to assertions about this wref target. */
     about?: string;
     /** Search mode: `text` (BM25), `vector` (semantic), or `hybrid` (combined). Defaults to `text`. */
@@ -4868,7 +5384,7 @@ type SearchOptions = Omit<FilterOptions, 'where' | 'role' | 'sinceRepoSeq'> & {
  * pagination fields (`limit`, `cursor`) are ignored.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/countoptions/
  */
-type CountOptions = Omit<FilterOptions, 'role'>;
+type CountOptions = Omit<FilterOptions, 'role' | 'affirmedAbout'>;
 /**
  * Options for `client.thing.refs` — wref-field reverse and forward lookups.
  *
@@ -5091,10 +5607,11 @@ declare function isConnectionError(error: unknown): boolean;
  */
 declare function connectionErrorMessage(url: string): string;
 /**
- * Returns true when `version` is strictly older than `minimum`. Both
- * arguments must be valid SemVer; non-parseable inputs return false for this
- * legacy read-side helper. Write admission validates both values separately
- * and fails closed.
+ * Returns true when `version` is strictly older than `minimum`. This is the
+ * parse boundary for the read-side compatibility hint: both arguments arrive
+ * as unproved strings, and a string that is not SemVer returns false rather
+ * than failing the read. Write admission parses both values separately and
+ * fails closed.
  *
  * @internal
  */
@@ -5145,10 +5662,14 @@ declare class WarmHubClient {
     private readonly accessToken;
     /** Resolved `X-WarmHub-Client` identity; defaults to this SDK's name/version. */
     private readonly clientIdentity;
+    /** Normalized `clientFlags` option; stamped on every request. */
+    private readonly clientFlags;
     protected readonly functionLogMode: FunctionLogMode;
     protected readonly getToken?: () => Promise<string | undefined>;
     private readonly trpc;
     private compatibilityCheck?;
+    private overrideNoticePrinted;
+    private noteCompatibilityOverride;
     private assertWriteCompatible;
     private createCompatibilityLink;
     /**
@@ -6177,6 +6698,55 @@ declare class WarmHubClient {
         revise: (orgName: string, repoName: string, wref: string, opts: CollectionReviseOptions) => Promise<CollectionMutationResult>;
         stats: (orgName: string | undefined, repoName: string | undefined, wref: string, opts?: CollectionStatsOptions) => Promise<CollectionStatsResult>;
     };
+    /**
+     * Execute stored View definitions against the repository's live read model.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/warmhubclient/#view
+     */
+    readonly view: {
+        /**
+         * Evaluate one identity-scoped or pinned View definition and return one page.
+         *
+         * The `wref` is the sole definition selector. Cursors are short-lived resume
+         * tokens for the same query and result scope. If the selected identity-scoped
+         * View changes, the backend may reject a saved cursor with
+         * `CURSOR_EPOCH_INVALID`; restart the query without `cursor`.
+         */
+        evaluate: (orgName: string, repoName: string, wref: string, opts?: ViewEvaluateOptions) => Promise<ViewEvaluateResult>;
+        /**
+         * Iterate every live result from an identity-scoped or pinned View.
+         *
+         * The iterator preserves the caller's page size and optional resume cursor,
+         * and rejects non-advancing or cyclic backend cursors.
+         *
+         * Cursors resume the same query and result scope. If the backend reports
+         * `CURSOR_EPOCH_INVALID`, restart the query without `cursor`.
+         */
+        evaluateIter: (orgName: string, repoName: string, wref: string, opts?: ViewEvaluateOptions) => AsyncIterableIterator<ThingItem>;
+        /**
+         * Materialize every live result from an identity-scoped or pinned View.
+         *
+         * Use `max` to guard memory usage. The call throws `VALIDATION_ERROR` only
+         * after more than `max` items have actually been observed.
+         *
+         * Cursors resume the same query and result scope. If the backend reports
+         * `CURSOR_EPOCH_INVALID`, restart the query without `cursor`.
+         */
+        evaluateAll: (orgName: string, repoName: string, wref: string, opts?: ViewEvaluateOptions & {
+            max?: number;
+        }) => Promise<ThingItem[]>;
+    };
+    /**
+     * Create and administer immutable repository Grants.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/warmhubclient/#grant
+     */
+    readonly grant: {
+        create: (orgName: string, repoName: string, input: GrantCreateOptions) => Promise<Grant>;
+        get: (orgName: string, repoName: string, grantId: string) => Promise<Grant>;
+        list: (orgName: string, repoName: string, opts?: GrantListOptions) => Promise<GrantListResult>;
+        revoke: (orgName: string, repoName: string, grantId: string, opts?: {
+            reason?: string;
+        }) => Promise<GrantRevokeResult>;
+    };
     /**
      * Read surface for things, assertions, histories, references, search, and in-place thing renames.
      * @see https://docs.warmhub.ai/sdk-reference/classes/warmhubclient/#thing
@@ -6851,8 +7421,9 @@ declare class WarmHubClient {
     };
     private openSse;
     /**
-     * Stamp the `X-WarmHub-Client` self-identification header, unless the caller
-     * already set it on the request (a per-request header wins over the default).
+     * Stamp the `X-WarmHub-Client` self-identification and `X-WarmHub-Client-Flags`
+     * headers, unless the caller already set them on the request (a per-request
+     * header wins over the default).
      */
     private applyClientHeader;
     private fetchWithAuth;
@@ -6861,4 +7432,4 @@ declare class WarmHubClient {
     private watchRepoQuery;
 }
 
-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 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, 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 };
+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 };