@sanity/client 8.7.0 → 8.8.0

package/dist/index.node.d.ts

@@ -1369,6 +1369,7 @@ interface CollaborationCommentDocument extends SanityDocument {
  * Each endpoint pairs the `_key` of a Portable Text block with a character
  * offset into that block's plain text.
  *
+ * @deprecated Use {@link CollaborationCommentAnchor}.
  * @alpha
  */
 interface CollaborationCommentRange {
@@ -1382,8 +1383,8 @@ interface CollaborationCommentRange {
   };
 }
 /**
- * Portable Text covering a comment `range`. Callers can send just the blocks
- * from the `range` start `_key` through end `_key`, or the full field.
+ * Portable Text covering an inline comment anchor. Callers can send just the
+ * blocks from the anchor start `_key` through end `_key`, or the full field.
  *
  * @alpha
  */
@@ -1392,16 +1393,38 @@ type CollaborationCommentFieldValue = Array<{
   _key: string;
   [key: string]: Any;
 }>;
+/**
+ * Where in `path` a comment is anchored.
+ *
+ * For `portable-text`, each endpoint pairs the `_key` of a Portable Text
+ * block with a character offset into that block's plain text. An optional
+ * `fieldValue` is Portable Text covering the anchor. When set, the selection
+ * is resolved from those blocks instead of from the live document.
+ *
+ * @alpha
+ */
+type CollaborationCommentAnchor = {
+  type: 'portable-text';
+  start: {
+    _key: string;
+    offset: number;
+  };
+  end: {
+    _key: string;
+    offset: number;
+  };
+  fieldValue?: CollaborationCommentFieldValue;
+};
 /**
  * Target for a top-level comment. Inline selections require both `path` and
- * `range`; field-level comments may set `path` alone.
+ * `anchor`; field-level comments may set `path` alone.
  *
  * The created comment stores this in a different shape: `path` becomes
- * `target.path.field`, and `range` is resolved against the document into
+ * `target.path.field`, and `anchor` is resolved against the document into
  * `target.path.selection` and `contentSnapshot` rather than being stored.
  *
- * An optional `fieldValue` is Portable Text covering the `range`. When set,
- * the `range` is resolved from those blocks instead of from the live document.
+ * Deprecated `range` + top-level `fieldValue` are still accepted and converted
+ * to a `portable-text` `anchor` before the request is sent.
  *
  * @alpha
  */
@@ -1412,16 +1435,41 @@ type CollaborationCommentTarget = {
 } & ({
   /** Path to the field containing the inline comment selection */
   path: string;
+  anchor: CollaborationCommentAnchor;
+  /**
+   * @deprecated Use `anchor`.
+   */
+  range?: never;
+  /**
+   * @deprecated Use `anchor.fieldValue`.
+   */
+  fieldValue?: never;
+} | {
+  /** Path to the field containing the inline comment selection */
+  path: string;
+  /**
+   * @deprecated Use `anchor`.
+   */
   range: CollaborationCommentRange;
   /**
-   * Portable Text covering the `range`. When set, the `range` is resolved
+   * Portable Text covering the `range`. When set, the selection is resolved
    * from these blocks instead of from the live document.
+   *
+   * @deprecated Use `anchor.fieldValue`.
    */
   fieldValue?: CollaborationCommentFieldValue;
+  anchor?: never;
 } | {
   /** Path to the commented field */
   path?: string;
+  anchor?: never;
+  /**
+   * @deprecated Use `anchor`.
+   */
   range?: never;
+  /**
+   * @deprecated Use `anchor.fieldValue`.
+   */
   fieldValue?: never;
 });
 /**
@@ -1449,7 +1497,11 @@ type CollaborationCommentTarget = {
  *     documentId: 'doc-1',
  *     documentType: 'article',
  *     path: 'body',
- *     range: {start: {_key: 'block-1', offset: 0}, end: {_key: 'block-1', offset: 5}},
+ *     anchor: {
+ *       type: 'portable-text',
+ *       start: {_key: 'block-1', offset: 0},
+ *       end: {_key: 'block-1', offset: 5},
+ *     },
  *   },
  * })
  * ```
@@ -1481,11 +1533,13 @@ type CollaborationCommentCreate = {
 /**
  * Fields that can be updated on an existing comment.
  *
- * A `range` re-anchors the comment within the field it already targets.
+ * An `anchor` re-anchors the comment within the field it already targets.
  * Pass `null` to remove the selection and leave a field-level comment.
- * An optional `fieldValue` is Portable Text covering that `range`; when set,
- * the `range` is resolved from those blocks instead of from the live document.
- * `fieldValue` cannot be sent alone or together with `range: null`.
+ * An optional `fieldValue` on a `portable-text` anchor is resolved from those
+ * blocks instead of from the live document.
+ *
+ * Deprecated `range` + top-level `fieldValue` (and `range: null`) are still
+ * accepted and converted to `anchor` before the request is sent.
  *
  * @alpha
  */
@@ -1495,17 +1549,57 @@ type CollaborationCommentUpdate = {
   /** Cascades to the comment's replies */
   status?: CollaborationCommentStatus;
 } & ({
+  anchor: CollaborationCommentAnchor;
+  /**
+   * @deprecated Use `anchor`.
+   */
+  range?: never;
+  /**
+   * @deprecated Use `anchor.fieldValue`.
+   */
+  fieldValue?: never;
+} | {
+  anchor: null;
+  /**
+   * @deprecated Use `anchor`.
+   */
+  range?: never;
+  /**
+   * @deprecated Use `anchor.fieldValue`.
+   */
+  fieldValue?: never;
+} | {
+  /**
+   * @deprecated Use `anchor`.
+   */
   range: CollaborationCommentRange;
   /**
-   * Portable Text covering the `range`. When set, the `range` is resolved
+   * Portable Text covering the `range`. When set, the selection is resolved
    * from these blocks instead of from the live document.
+   *
+   * @deprecated Use `anchor.fieldValue`.
    */
   fieldValue?: CollaborationCommentFieldValue;
+  anchor?: never;
 } | {
+  /**
+   * @deprecated Use `anchor: null`.
+   */
   range: null;
+  /**
+   * @deprecated Use `anchor.fieldValue`.
+   */
   fieldValue?: never;
+  anchor?: never;
 } | {
+  anchor?: undefined;
+  /**
+   * @deprecated Use `anchor`.
+   */
   range?: undefined;
+  /**
+   * @deprecated Use `anchor.fieldValue`.
+   */
   fieldValue?: never;
 });
 /**
@@ -1783,7 +1877,7 @@ interface paths {
     post?: never;
     /**
      * Delete a knowledge base
-     * @description Removes the knowledge base and everything it owns: sources, imports, and revisions. Content documents in the bound dataset are deleted best-effort, and stored source files are reclaimed by a separate cleanup.
+     * @description Removes the knowledge base and everything it owns: sources, imports, revisions, the content documents in the bound dataset, and the stored source files. Returns 409 `buildInFlight` while a build, refresh, apply, or import is running, since that work would write files back after the delete; retry once it finishes.
      */
     delete: operations['deleteKnowledgeBase'];
     options?: never;
@@ -1890,7 +1984,7 @@ interface paths {
     put?: never;
     /**
      * Start a file-upload import
-     * @description Creates a file-upload import and returns a single-use signed upload URL. PUT the file bytes to it, then call `POST .../imports/uploads/{importId}/complete` to start ingestion. The bytes never pass through this API. Supports the `Idempotency-Key` header.
+     * @description Creates a file-upload import and returns a single-use signed upload URL, valid for one hour. PUT the file bytes to it, then call `POST .../imports/uploads/{importId}/complete` to start ingestion. When `contentType` is set, the PUT must send the same `Content-Type` header; when omitted, the PUT may send any or none. An import that is not completed within 24 hours is deleted. The bytes never pass through this API. Supports the `Idempotency-Key` header.
      */
     post: operations['startUpload'];
     delete?: never;
@@ -1974,7 +2068,7 @@ interface paths {
     put?: never;
     /**
      * Author a human instruction
-     * @description Creates a standing rule that every future build honors. Tie it to one or more sources with `scopeSourceIds`, or leave it null to apply knowledge-base-wide. Pass `rebuildPaths` to immediately rebuild those entries under the new rule; the response carries the rebuild job id, or null when the rebuild could not start (the rule is saved either way). Pass `verified` after a completed synchronous contradiction check to skip the background one; if the requested rebuild fails to start, the background check runs anyway so the contradicting pages get filed as issues.
+     * @description Creates a standing rule for how entries citing its sources are written. Tie it to one or more sources with `scopeSourceIds`; every rule is source-tied. Pass `rebuildPaths` to immediately rebuild those entries under the new rule; the response carries the rebuild job id, or null when the rebuild could not start (the rule is saved either way). Pass `verified` after a completed synchronous contradiction check to skip the background one; if the requested rebuild fails to start, the background check runs anyway so the contradicting pages get filed as issues.
      */
     post: operations['createInstruction'];
     delete?: never;
@@ -2078,7 +2172,7 @@ interface paths {
     put?: never;
     /**
      * Resolve a conflict issue
-     * @description Settles a conflict with one of two choices: `keep_existing` or `accept_new` (rewrites the entry; the returned `jobId` tracks it). Only conflict issues are resolvable, and a dismissed issue must be reopened first. The decision becomes a standing instruction for every future build; `resolvedBy` records who decided.
+     * @description Settles a conflict by choosing a side: `resolution` is an index into `content.sides`. Index 0 of a per-entry conflict is the entry's own position, so choosing it keeps the body; any other side rewrites the entry (the returned `jobId` tracks it). Only conflict issues are resolvable, and a dismissed issue must be reopened first. The decision becomes a standing instruction for every future build; `resolvedBy` records who decided.
      */
     post: operations['resolveIssue'];
     delete?: never;
@@ -2096,7 +2190,7 @@ interface paths {
     };
     /**
      * Get a job by id
-     * @description Returns the status of a job, such as a build or an import. Job ids come from the endpoint that queued the work.
+     * @description Returns the status of a job, such as a build, an import, or a refresh. Job ids come from the endpoint that queued the work.
      */
     get: operations['getJob'];
     put?: never;
@@ -2201,7 +2295,7 @@ interface paths {
     get?: never;
     /**
      * Record a conversation
-     * @description Upserts the conversation telemetry for one thread. `threadId` identifies the conversation within your organization — reuse means the same conversation. Messages replace the stored transcript wholesale; `metadata`, `sharing`, and model fields only overwrite when present. Last write per thread wins — retries are safe. `sharing` records your opt-in to share telemetry with Sanity: metadata-only metrics, or full transcripts.
+     * @description Upserts the conversation telemetry for one thread. `threadId` identifies the conversation within your organization — reuse means the same conversation. Messages replace the stored transcript wholesale; `metadata`, `sharing`, and model fields only overwrite when present. `tokenUsage` accumulates: each save reports one generation call and the stored value is the conversation total, added only when the save changes the transcript so retries never double-count. Report a failure as `error` on the message where it happened: a tool result for a failed tool call, an assistant message for a turn that failed instead of answering. The dashboard highlights conversations with a failed turn and counts failed tool calls separately, since agents often recover from one. Last write per thread wins — retries are safe. `sharing` records your opt-in to share telemetry with Sanity: metadata-only metrics, or full transcripts.
      */
     put: operations['saveConversation'];
     post?: never;
@@ -2252,6 +2346,13 @@ interface components {
          * @enum {string|null}
          */
         toolType: 'call' | 'result' | null;
+        /** @default null */
+        error: string | null;
+        /**
+         * Format: date-time
+         * @default null
+         */
+        timestamp: string | null;
       }[];
       modelProvider: string | null;
       modelId: string | null;
@@ -2400,23 +2501,39 @@ interface components {
       /** @description IssueContent */
       content: {
         /** @enum {string} */
-        kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
+        severity: 'critical' | 'suggestion';
+        scopePath: string;
+        issue: string;
+        suggestedFix: string;
+        /** @enum {string} */
+        kind: 'conflict';
+        claimKey: string;
+        sides: {
+          claim: string;
+          value?: string;
+          entryPaths?: string[];
+          sourceIds?: string[];
+          /** @description ConflictSpan */
+          span?: {
+            sourceId: string;
+            lineStart: number;
+            lineEnd: number;
+          };
+          /** @enum {string} */
+          authority?: 'primary' | 'secondary' | 'community';
+        }[];
+        suggested?: number;
+      } | {
         /** @enum {string} */
         severity: 'critical' | 'suggestion';
         scopePath: string;
         issue: string;
         suggestedFix: string;
+        /** @enum {string} */
+        kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
         citedSourceIds?: string[];
         claimKey?: string;
         involvedScopes?: string[];
-        currentClaim?: string;
-        alternativeClaim?: string;
-        /** @enum {string} */
-        currentAuthority?: 'primary' | 'secondary' | 'community';
-        /** @enum {string} */
-        alternativeAuthority?: 'primary' | 'secondary' | 'community';
-        /** @enum {string} */
-        suggestedResolution?: 'keep_existing' | 'accept_new';
       };
       fingerprint: string;
       revisionId: string | null;
@@ -2443,23 +2560,39 @@ interface components {
       /** @description IssueContent */
       content: {
         /** @enum {string} */
-        kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
+        severity: 'critical' | 'suggestion';
+        scopePath: string;
+        issue: string;
+        suggestedFix: string;
+        /** @enum {string} */
+        kind: 'conflict';
+        claimKey: string;
+        sides: {
+          claim: string;
+          value?: string;
+          entryPaths?: string[];
+          sourceIds?: string[];
+          /** @description ConflictSpan */
+          span?: {
+            sourceId: string;
+            lineStart: number;
+            lineEnd: number;
+          };
+          /** @enum {string} */
+          authority?: 'primary' | 'secondary' | 'community';
+        }[];
+        suggested?: number;
+      } | {
         /** @enum {string} */
         severity: 'critical' | 'suggestion';
         scopePath: string;
         issue: string;
         suggestedFix: string;
+        /** @enum {string} */
+        kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
         citedSourceIds?: string[];
         claimKey?: string;
         involvedScopes?: string[];
-        currentClaim?: string;
-        alternativeClaim?: string;
-        /** @enum {string} */
-        currentAuthority?: 'primary' | 'secondary' | 'community';
-        /** @enum {string} */
-        alternativeAuthority?: 'primary' | 'secondary' | 'community';
-        /** @enum {string} */
-        suggestedResolution?: 'keep_existing' | 'accept_new';
       };
       fingerprint: string;
       revisionId: string | null;
@@ -2472,8 +2605,7 @@ interface components {
         /** @enum {string} */
         kind: 'user' | 'robot';
       } | null;
-      /** @enum {string|null} */
-      resolution: 'keep_existing' | 'accept_new' | null;
+      resolution: number | null;
     } | {
       _id: string;
       _rev: string;
@@ -2489,23 +2621,39 @@ interface components {
       /** @description IssueContent */
       content: {
         /** @enum {string} */
-        kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
+        severity: 'critical' | 'suggestion';
+        scopePath: string;
+        issue: string;
+        suggestedFix: string;
+        /** @enum {string} */
+        kind: 'conflict';
+        claimKey: string;
+        sides: {
+          claim: string;
+          value?: string;
+          entryPaths?: string[];
+          sourceIds?: string[];
+          /** @description ConflictSpan */
+          span?: {
+            sourceId: string;
+            lineStart: number;
+            lineEnd: number;
+          };
+          /** @enum {string} */
+          authority?: 'primary' | 'secondary' | 'community';
+        }[];
+        suggested?: number;
+      } | {
         /** @enum {string} */
         severity: 'critical' | 'suggestion';
         scopePath: string;
         issue: string;
         suggestedFix: string;
+        /** @enum {string} */
+        kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
         citedSourceIds?: string[];
         claimKey?: string;
         involvedScopes?: string[];
-        currentClaim?: string;
-        alternativeClaim?: string;
-        /** @enum {string} */
-        currentAuthority?: 'primary' | 'secondary' | 'community';
-        /** @enum {string} */
-        alternativeAuthority?: 'primary' | 'secondary' | 'community';
-        /** @enum {string} */
-        suggestedResolution?: 'keep_existing' | 'accept_new';
       };
       fingerprint: string;
       revisionId: string | null;
@@ -2627,6 +2775,11 @@ interface operations {
                 used: number;
                 limit: number;
               } | null;
+              /** @description PlanRestriction */
+              buildRestriction: {
+                code: string;
+                message: string;
+              } | null;
               refreshEnabled: boolean;
               /** @enum {string} */
               refreshFrequency: 'weekly' | 'monthly';
@@ -2724,6 +2877,11 @@ interface operations {
               used: number;
               limit: number;
             } | null;
+            /** @description PlanRestriction */
+            buildRestriction: {
+              code: string;
+              message: string;
+            } | null;
             refreshEnabled: boolean;
             /** @enum {string} */
             refreshFrequency: 'weekly' | 'monthly';
@@ -2811,6 +2969,11 @@ interface operations {
               used: number;
               limit: number;
             } | null;
+            /** @description PlanRestriction */
+            buildRestriction: {
+              code: string;
+              message: string;
+            } | null;
             refreshEnabled: boolean;
             /** @enum {string} */
             refreshFrequency: 'weekly' | 'monthly';
@@ -2930,6 +3093,11 @@ interface operations {
               used: number;
               limit: number;
             } | null;
+            /** @description PlanRestriction */
+            buildRestriction: {
+              code: string;
+              message: string;
+            } | null;
             refreshEnabled: boolean;
             /** @enum {string} */
             refreshFrequency: 'weekly' | 'monthly';
@@ -3350,7 +3518,7 @@ interface operations {
       content: {
         'application/json': {
           statement: string;
-          scopeSourceIds?: string[] | null;
+          scopeSourceIds: string[];
           rebuildPaths?: string[];
           verified?: boolean;
         };
@@ -3373,7 +3541,7 @@ interface operations {
               /** @enum {string} */
               status: 'active' | 'archived';
               statement: string;
-              scopeSourceIds: string[] | null;
+              scopeSourceIds: string[];
               /** Format: date-time */
               archivedAt: string | null;
               archivedReason: string | null;
@@ -3437,7 +3605,7 @@ interface operations {
       content: {
         'application/json': {
           statement?: string;
-          scopeSourceIds?: string[] | null;
+          scopeSourceIds?: string[];
         };
       };
     };
@@ -3456,7 +3624,7 @@ interface operations {
             /** @enum {string} */
             status: 'active' | 'archived';
             statement: string;
-            scopeSourceIds: string[] | null;
+            scopeSourceIds: string[];
             /** Format: date-time */
             archivedAt: string | null;
             archivedReason: string | null;
@@ -3534,28 +3702,43 @@ interface operations {
             /** @description IssueContent */
             content: {
               /** @enum {string} */
-              kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
+              severity: 'critical' | 'suggestion';
+              scopePath: string;
+              issue: string;
+              suggestedFix: string;
+              /** @enum {string} */
+              kind: 'conflict';
+              claimKey: string;
+              sides: {
+                claim: string;
+                value?: string;
+                entryPaths?: string[];
+                sourceIds?: string[];
+                /** @description ConflictSpan */
+                span?: {
+                  sourceId: string;
+                  lineStart: number;
+                  lineEnd: number;
+                };
+                /** @enum {string} */
+                authority?: 'primary' | 'secondary' | 'community';
+              }[];
+              suggested?: number;
+            } | {
               /** @enum {string} */
               severity: 'critical' | 'suggestion';
               scopePath: string;
               issue: string;
               suggestedFix: string;
+              /** @enum {string} */
+              kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
               citedSourceIds?: string[];
               claimKey?: string;
               involvedScopes?: string[];
-              currentClaim?: string;
-              alternativeClaim?: string;
-              /** @enum {string} */
-              currentAuthority?: 'primary' | 'secondary' | 'community';
-              /** @enum {string} */
-              alternativeAuthority?: 'primary' | 'secondary' | 'community';
-              /** @enum {string} */
-              suggestedResolution?: 'keep_existing' | 'accept_new';
             };
             /** @enum {string} */
             status: 'open' | 'accepted' | 'rejected';
-            /** @enum {string|null} */
-            resolution: 'keep_existing' | 'accept_new' | null;
+            resolution: number | null;
             /** @description IssueResolvedBy */
             resolvedBy: {
               id: string;
@@ -3595,28 +3778,43 @@ interface operations {
             /** @description IssueContent */
             content: {
               /** @enum {string} */
-              kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
+              severity: 'critical' | 'suggestion';
+              scopePath: string;
+              issue: string;
+              suggestedFix: string;
+              /** @enum {string} */
+              kind: 'conflict';
+              claimKey: string;
+              sides: {
+                claim: string;
+                value?: string;
+                entryPaths?: string[];
+                sourceIds?: string[];
+                /** @description ConflictSpan */
+                span?: {
+                  sourceId: string;
+                  lineStart: number;
+                  lineEnd: number;
+                };
+                /** @enum {string} */
+                authority?: 'primary' | 'secondary' | 'community';
+              }[];
+              suggested?: number;
+            } | {
               /** @enum {string} */
               severity: 'critical' | 'suggestion';
               scopePath: string;
               issue: string;
               suggestedFix: string;
+              /** @enum {string} */
+              kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
               citedSourceIds?: string[];
               claimKey?: string;
               involvedScopes?: string[];
-              currentClaim?: string;
-              alternativeClaim?: string;
-              /** @enum {string} */
-              currentAuthority?: 'primary' | 'secondary' | 'community';
-              /** @enum {string} */
-              alternativeAuthority?: 'primary' | 'secondary' | 'community';
-              /** @enum {string} */
-              suggestedResolution?: 'keep_existing' | 'accept_new';
             };
             /** @enum {string} */
             status: 'open' | 'accepted' | 'rejected';
-            /** @enum {string|null} */
-            resolution: 'keep_existing' | 'accept_new' | null;
+            resolution: number | null;
             /** @description IssueResolvedBy */
             resolvedBy: {
               id: string;
@@ -3645,8 +3843,7 @@ interface operations {
     requestBody: {
       content: {
         'application/json': {
-          /** @enum {string} */
-          resolution: 'keep_existing' | 'accept_new';
+          resolution: number;
         };
       };
     };
@@ -3665,28 +3862,43 @@ interface operations {
               /** @description IssueContent */
               content: {
                 /** @enum {string} */
-                kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
+                severity: 'critical' | 'suggestion';
+                scopePath: string;
+                issue: string;
+                suggestedFix: string;
+                /** @enum {string} */
+                kind: 'conflict';
+                claimKey: string;
+                sides: {
+                  claim: string;
+                  value?: string;
+                  entryPaths?: string[];
+                  sourceIds?: string[];
+                  /** @description ConflictSpan */
+                  span?: {
+                    sourceId: string;
+                    lineStart: number;
+                    lineEnd: number;
+                  };
+                  /** @enum {string} */
+                  authority?: 'primary' | 'secondary' | 'community';
+                }[];
+                suggested?: number;
+              } | {
                 /** @enum {string} */
                 severity: 'critical' | 'suggestion';
                 scopePath: string;
                 issue: string;
                 suggestedFix: string;
+                /** @enum {string} */
+                kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
                 citedSourceIds?: string[];
                 claimKey?: string;
                 involvedScopes?: string[];
-                currentClaim?: string;
-                alternativeClaim?: string;
-                /** @enum {string} */
-                currentAuthority?: 'primary' | 'secondary' | 'community';
-                /** @enum {string} */
-                alternativeAuthority?: 'primary' | 'secondary' | 'community';
-                /** @enum {string} */
-                suggestedResolution?: 'keep_existing' | 'accept_new';
               };
               /** @enum {string} */
               status: 'open' | 'accepted' | 'rejected';
-              /** @enum {string|null} */
-              resolution: 'keep_existing' | 'accept_new' | null;
+              resolution: number | null;
               /** @description IssueResolvedBy */
               resolvedBy: {
                 id: string;
@@ -3800,6 +4012,7 @@ interface operations {
               tldr: string | null;
               topics: string[] | null;
               canonicalUrl: string | null;
+              externalId: string | null;
               /** Format: date-time */
               fetchedAt: string | null;
               /** Format: date-time */
@@ -3845,6 +4058,7 @@ interface operations {
             tldr: string | null;
             topics: string[] | null;
             canonicalUrl: string | null;
+            externalId: string | null;
             /** Format: date-time */
             fetchedAt: string | null;
             /** Format: date-time */
@@ -3943,6 +4157,8 @@ interface operations {
              * @enum {string|null}
              */
             toolType?: 'call' | 'result' | null;
+            /** @default null */
+            error?: string | null;
           }[];
           modelProvider?: string;
           modelId?: string;
@@ -3995,6 +4211,13 @@ interface operations {
                * @enum {string|null}
                */
               toolType: 'call' | 'result' | null;
+              /** @default null */
+              error: string | null;
+              /**
+               * Format: date-time
+               * @default null
+               */
+              timestamp: string | null;
             }[];
             modelProvider: string | null;
             modelId: string | null;
@@ -4082,6 +4305,13 @@ interface operations {
                * @enum {string|null}
                */
               toolType: 'call' | 'result' | null;
+              /** @default null */
+              error: string | null;
+              /**
+               * Format: date-time
+               * @default null
+               */
+              timestamp: string | null;
             }[];
             modelProvider: string | null;
             modelId: string | null;
@@ -4571,22 +4801,37 @@ declare class ContextClient {
         id: string;
         knowledgeBaseId: string;
         content: {
-          kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
           severity: 'critical' | 'suggestion';
           scopePath: string;
           issue: string;
           suggestedFix: string;
+          kind: 'conflict';
+          claimKey: string;
+          sides: {
+            claim: string;
+            value?: string;
+            entryPaths?: string[];
+            sourceIds?: string[];
+            span?: {
+              sourceId: string;
+              lineStart: number;
+              lineEnd: number;
+            };
+            authority?: 'primary' | 'secondary' | 'community';
+          }[];
+          suggested?: number;
+        } | {
+          severity: 'critical' | 'suggestion';
+          scopePath: string;
+          issue: string;
+          suggestedFix: string;
+          kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
           citedSourceIds?: string[];
           claimKey?: string;
           involvedScopes?: string[];
-          currentClaim?: string;
-          alternativeClaim?: string;
-          currentAuthority?: 'primary' | 'secondary' | 'community';
-          alternativeAuthority?: 'primary' | 'secondary' | 'community';
-          suggestedResolution?: 'keep_existing' | 'accept_new';
         };
         status: 'open' | 'accepted' | 'rejected';
-        resolution: 'keep_existing' | 'accept_new' | null;
+        resolution: number | null;
         resolvedBy: {
           id: string;
           kind: 'user' | 'robot';
@@ -4602,22 +4847,37 @@ declare class ContextClient {
       id: string;
       knowledgeBaseId: string;
       content: {
-        kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
         severity: 'critical' | 'suggestion';
         scopePath: string;
         issue: string;
         suggestedFix: string;
+        kind: 'conflict';
+        claimKey: string;
+        sides: {
+          claim: string;
+          value?: string;
+          entryPaths?: string[];
+          sourceIds?: string[];
+          span?: {
+            sourceId: string;
+            lineStart: number;
+            lineEnd: number;
+          };
+          authority?: 'primary' | 'secondary' | 'community';
+        }[];
+        suggested?: number;
+      } | {
+        severity: 'critical' | 'suggestion';
+        scopePath: string;
+        issue: string;
+        suggestedFix: string;
+        kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
         citedSourceIds?: string[];
         claimKey?: string;
         involvedScopes?: string[];
-        currentClaim?: string;
-        alternativeClaim?: string;
-        currentAuthority?: 'primary' | 'secondary' | 'community';
-        alternativeAuthority?: 'primary' | 'secondary' | 'community';
-        suggestedResolution?: 'keep_existing' | 'accept_new';
       };
       status: 'open' | 'accepted' | 'rejected';
-      resolution: 'keep_existing' | 'accept_new' | null;
+      resolution: number | null;
       resolvedBy: {
         id: string;
         kind: 'user' | 'robot';
@@ -4631,22 +4891,37 @@ declare class ContextClient {
       id: string;
       knowledgeBaseId: string;
       content: {
-        kind: 'conflict' | 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
         severity: 'critical' | 'suggestion';
         scopePath: string;
         issue: string;
         suggestedFix: string;
+        kind: 'conflict';
+        claimKey: string;
+        sides: {
+          claim: string;
+          value?: string;
+          entryPaths?: string[];
+          sourceIds?: string[];
+          span?: {
+            sourceId: string;
+            lineStart: number;
+            lineEnd: number;
+          };
+          authority?: 'primary' | 'secondary' | 'community';
+        }[];
+        suggested?: number;
+      } | {
+        severity: 'critical' | 'suggestion';
+        scopePath: string;
+        issue: string;
+        suggestedFix: string;
+        kind: 'gap' | 'update_required' | 'add_entry' | 'remove_entry' | 'split_entry' | 'merge_entry';
         citedSourceIds?: string[];
         claimKey?: string;
         involvedScopes?: string[];
-        currentClaim?: string;
-        alternativeClaim?: string;
-        currentAuthority?: 'primary' | 'secondary' | 'community';
-        alternativeAuthority?: 'primary' | 'secondary' | 'community';
-        suggestedResolution?: 'keep_existing' | 'accept_new';
       };
       status: 'open' | 'accepted' | 'rejected';
-      resolution: 'keep_existing' | 'accept_new' | null;
+      resolution: number | null;
       resolvedBy: {
         id: string;
         kind: 'user' | 'robot';
@@ -4681,7 +4956,7 @@ declare class ContextClient {
       origin: 'conflict' | 'human';
       status: 'active' | 'archived';
       statement: string;
-      scopeSourceIds: string[] | null;
+      scopeSourceIds: string[];
       archivedAt: string | null;
       archivedReason: string | null;
       sourceIssueId: string | null;
@@ -4784,6 +5059,7 @@ declare class ContextClient {
         tldr: string | null;
         topics: string[] | null;
         canonicalUrl: string | null;
+        externalId: string | null;
         fetchedAt: string | null;
         distilledAt: string | null;
         createdAt: string;
@@ -4802,6 +5078,7 @@ declare class ContextClient {
       tldr: string | null;
       topics: string[] | null;
       canonicalUrl: string | null;
+      externalId: string | null;
       fetchedAt: string | null;
       distilledAt: string | null;
       createdAt: string;
@@ -10340,5 +10617,5 @@ declare const createClient: (config: ClientConfig) => SanityClient;
  * @deprecated Use the named export `createClient` instead of the `default` export
  */
 declare const deprecatedCreateClient: (config: ClientConfig) => SanityClient;
-export { Action, ActionError, ActionErrorItem, type AgentActionParam, type AgentActionParams, type AgentActionPath, type AgentActionPathSegment, type AgentActionTarget, AllDocumentIdsMutationOptions, AllDocumentsMutationOptions, AnimatedImageFormat, AnimatedTransformOptions, Any, ApiError, ArchiveReleaseAction, AssetMetadataType, type AssetsClient, AttributeSet, AuthProvider, AuthProviderResponse, BaseActionOptions, BaseMutationOptions, BasePatch, BaseTransaction, ChannelError, ChannelErrorEvent, ClientConfig, ClientError, ClientPerspective, ClientReturn, ClientVariant, ClientVariantConditions, type CollaborationCommentCreate, type CollaborationCommentDocument, type CollaborationCommentFieldValue, type CollaborationCommentMessage, type CollaborationCommentPortableTextBlock, type CollaborationCommentRange, type CollaborationCommentReactionShortName, type CollaborationCommentSelection, type CollaborationCommentStatus, type CollaborationCommentTarget, type CollaborationCommentUpdate, type CollaborationCommentsClient, type CollaborationCommentsListenOptions, type CollaborationCommentsRequestOptions, type CollaborationCommentsWriteOptions, ConnectionFailedError, type ConstantAgentActionParam, ContentSourceMap, ContentSourceMapDocument, ContentSourceMapDocumentBase, ContentSourceMapDocumentValueSource, ContentSourceMapDocuments, ContentSourceMapLiteralSource, ContentSourceMapMapping, ContentSourceMapMappings, type ContentSourceMapParsedPath, type ContentSourceMapParsedPathKeyedSegment, ContentSourceMapPaths, ContentSourceMapRemoteDocument, ContentSourceMapSource, ContentSourceMapUnknownSource, ContentSourceMapValueMapping, types_d_exports as Context, CorsOriginError, CreateAction, CreateReleaseAction, CreateVariantAction, CreateVariantDefinitionAction, CreateVersionAction, CurrentSanityUser, DatasetAclMode, DatasetCreateOptions, DatasetEditOptions, DatasetResponse, type DatasetsClient, DatasetsResponse, DeleteAction, DeleteReleaseAction, DeleteVariantAction, DeleteVariantDefinitionAction, DiscardAction, DiscardVersionAction, DisconnectError, DisconnectEvent, type DocumentAgentActionParam, EXPERIMENTAL_API_WARNING, EditAction, EditReleaseAction, EditVariantAction, EditVariantDefinitionAction, EditableReleaseDocument, EmbeddingsSettings, EmbeddingsSettingsBody, ErrorProps, type EventSourceEvent, type EventSourceInstance, type FieldAgentActionParam, type FilterDefault, FilteredResponseQueryOptions, FirstDocumentIdMutationOptions, FirstDocumentMutationOptions, FitMode, type GenerateInstruction, type GenerateOperation, type GenerateTarget, type GenerateTargetDocument, type GenerateTargetInclude, type GroqAgentActionParam, type HttpError, HttpRequest, IdentifiedSanityDocumentStub, type ImageDescriptionOperation, ImportReleaseAction, InitializedClientConfig, type InitializedStegaConfig, InsertPatch, type InvokeFunctionEvent, type InvokeFunctionOptions, type InvokeFunctionRequest, ListenEvent, ListenEventName, ListenOptions, ListenParams, type LiveClient, LiveEvent, LiveEventGoAway, LiveEventMessage, LiveEventReconnect, LiveEventRestart, LiveEventWelcome, type Logger, MediaLibraryAssetDocument, MediaLibraryAssetInstanceIdentifier, MediaLibraryAssetVersion, MediaLibraryPlaybackInfoOptions, type MediaLibraryVideoClient, MediaLibraryVideoPlaybackTransformations, MessageError, MessageParseError, MultipleActionResult, MultipleMutationResult, Mutation, MutationError, MutationErrorItem, MutationEvent, MutationOperation, MutationSelection, MutationSelectionQueryParams, type ObservableAssetsClient, type ObservableCollaborationCommentsClient, type ObservableDatasetsClient, type ObservableMediaLibraryVideoClient, ObservablePatch, ObservablePatchBuilder, type ObservableProjectsClient, ObservableSanityClient, ObservableTransaction, type ObservableUsersClient, OpenEvent, PartialExcept, Patch, PatchBuilder, type PatchDocument, PatchMutationOperation, type PatchOperation, PatchOperations, PatchSelection, type PatchTarget, type ProjectsClient, type PromptRequest, PublishAction, PublishReleaseAction, PublishVariantAction, QueryOptions, QueryParams, QueryParseError, QueryWithoutParams, RawQueryResponse, RawQuerylessQueryResponse, RawRequestOptions, ReconnectEvent, ReleaseAction, ReleaseCardinality, ReleaseDocument, ReleaseId, ReleaseState, ReleaseType, ReplaceDraftAction, ReplaceVersionAction, RequestHandler, RequestHandlerOptions, RequestObservableOptions, RequestOptions, RequestUrlOptions, Requester, ResetEvent, type ResolveStudioUrl, ResponseQueryOptions, ResumableListenEventNames, ResumableListenOptions, SanityAssetDocument, SanityClient, SanityDocument, SanityDocumentStub, SanityImageAssetDocument, SanityImagePalette, SanityProject, SanityProjectMember, SanityProjectionsByResource, SanityQueries, SanityQueriesByResource, SanityReference, SanitySchemasByResource, SanityUser, ScheduleReleaseAction, ServerError, type ServerSentEvent, SingleActionResult, SingleMutationResult, StackablePerspective, type StegaConfig, type StegaConfigRequiredKeys, StillImageFormat, StoryboardTransformOptions, type StudioBaseRoute, type StudioBaseUrl, type StudioUrl, SyncTag, ThumbnailTransformOptions, type TimeoutErrorLike, Transaction, TransactionAllDocumentIdsMutationOptions, TransactionAllDocumentsMutationOptions, TransactionFirstDocumentIdMutationOptions, TransactionFirstDocumentMutationOptions, TransactionMutationOptions, type TransformDocument, type TransformOperation, type TransformTarget, type TransformTargetDocument, type TransformTargetInclude, type TranslateDocument, type TranslateTarget, type TranslateTargetInclude, UnarchiveReleaseAction, UnfilteredResponseQueryOptions, UnfilteredResponseWithoutQuery, UnpublishAction, UnpublishVariantAction, UnpublishVersionAction, UnscheduleReleaseAction, UploadBody, UploadClientConfig, UploadEvent, UploadProgressEvent, UploadResponseEvent, type UsersClient, VariantAction, VariantDefinitionAction, VersionAction, VideoPlaybackInfo, VideoPlaybackInfoItem, VideoPlaybackInfoItemPublic, VideoPlaybackInfoItemSigned, VideoPlaybackInfoPublic, VideoPlaybackInfoSigned, VideoPlaybackTokens, VideoRenditionInfo, VideoRenditionInfoPublic, VideoRenditionInfoSigned, VideoSubtitleInfo, VideoSubtitleInfoPublic, VideoSubtitleInfoSigned, WelcomeBackEvent, WelcomeEvent, type _listen, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, isTimeoutError, requester, validateApiPerspective };
+export { Action, ActionError, ActionErrorItem, type AgentActionParam, type AgentActionParams, type AgentActionPath, type AgentActionPathSegment, type AgentActionTarget, AllDocumentIdsMutationOptions, AllDocumentsMutationOptions, AnimatedImageFormat, AnimatedTransformOptions, Any, ApiError, ArchiveReleaseAction, AssetMetadataType, type AssetsClient, AttributeSet, AuthProvider, AuthProviderResponse, BaseActionOptions, BaseMutationOptions, BasePatch, BaseTransaction, ChannelError, ChannelErrorEvent, ClientConfig, ClientError, ClientPerspective, ClientReturn, ClientVariant, ClientVariantConditions, type CollaborationCommentAnchor, type CollaborationCommentCreate, type CollaborationCommentDocument, type CollaborationCommentFieldValue, type CollaborationCommentMessage, type CollaborationCommentPortableTextBlock, type CollaborationCommentRange, type CollaborationCommentReactionShortName, type CollaborationCommentSelection, type CollaborationCommentStatus, type CollaborationCommentTarget, type CollaborationCommentUpdate, type CollaborationCommentsClient, type CollaborationCommentsListenOptions, type CollaborationCommentsRequestOptions, type CollaborationCommentsWriteOptions, ConnectionFailedError, type ConstantAgentActionParam, ContentSourceMap, ContentSourceMapDocument, ContentSourceMapDocumentBase, ContentSourceMapDocumentValueSource, ContentSourceMapDocuments, ContentSourceMapLiteralSource, ContentSourceMapMapping, ContentSourceMapMappings, type ContentSourceMapParsedPath, type ContentSourceMapParsedPathKeyedSegment, ContentSourceMapPaths, ContentSourceMapRemoteDocument, ContentSourceMapSource, ContentSourceMapUnknownSource, ContentSourceMapValueMapping, types_d_exports as Context, CorsOriginError, CreateAction, CreateReleaseAction, CreateVariantAction, CreateVariantDefinitionAction, CreateVersionAction, CurrentSanityUser, DatasetAclMode, DatasetCreateOptions, DatasetEditOptions, DatasetResponse, type DatasetsClient, DatasetsResponse, DeleteAction, DeleteReleaseAction, DeleteVariantAction, DeleteVariantDefinitionAction, DiscardAction, DiscardVersionAction, DisconnectError, DisconnectEvent, type DocumentAgentActionParam, EXPERIMENTAL_API_WARNING, EditAction, EditReleaseAction, EditVariantAction, EditVariantDefinitionAction, EditableReleaseDocument, EmbeddingsSettings, EmbeddingsSettingsBody, ErrorProps, type EventSourceEvent, type EventSourceInstance, type FieldAgentActionParam, type FilterDefault, FilteredResponseQueryOptions, FirstDocumentIdMutationOptions, FirstDocumentMutationOptions, FitMode, type GenerateInstruction, type GenerateOperation, type GenerateTarget, type GenerateTargetDocument, type GenerateTargetInclude, type GroqAgentActionParam, type HttpError, HttpRequest, IdentifiedSanityDocumentStub, type ImageDescriptionOperation, ImportReleaseAction, InitializedClientConfig, type InitializedStegaConfig, InsertPatch, type InvokeFunctionEvent, type InvokeFunctionOptions, type InvokeFunctionRequest, ListenEvent, ListenEventName, ListenOptions, ListenParams, type LiveClient, LiveEvent, LiveEventGoAway, LiveEventMessage, LiveEventReconnect, LiveEventRestart, LiveEventWelcome, type Logger, MediaLibraryAssetDocument, MediaLibraryAssetInstanceIdentifier, MediaLibraryAssetVersion, MediaLibraryPlaybackInfoOptions, type MediaLibraryVideoClient, MediaLibraryVideoPlaybackTransformations, MessageError, MessageParseError, MultipleActionResult, MultipleMutationResult, Mutation, MutationError, MutationErrorItem, MutationEvent, MutationOperation, MutationSelection, MutationSelectionQueryParams, type ObservableAssetsClient, type ObservableCollaborationCommentsClient, type ObservableDatasetsClient, type ObservableMediaLibraryVideoClient, ObservablePatch, ObservablePatchBuilder, type ObservableProjectsClient, ObservableSanityClient, ObservableTransaction, type ObservableUsersClient, OpenEvent, PartialExcept, Patch, PatchBuilder, type PatchDocument, PatchMutationOperation, type PatchOperation, PatchOperations, PatchSelection, type PatchTarget, type ProjectsClient, type PromptRequest, PublishAction, PublishReleaseAction, PublishVariantAction, QueryOptions, QueryParams, QueryParseError, QueryWithoutParams, RawQueryResponse, RawQuerylessQueryResponse, RawRequestOptions, ReconnectEvent, ReleaseAction, ReleaseCardinality, ReleaseDocument, ReleaseId, ReleaseState, ReleaseType, ReplaceDraftAction, ReplaceVersionAction, RequestHandler, RequestHandlerOptions, RequestObservableOptions, RequestOptions, RequestUrlOptions, Requester, ResetEvent, type ResolveStudioUrl, ResponseQueryOptions, ResumableListenEventNames, ResumableListenOptions, SanityAssetDocument, SanityClient, SanityDocument, SanityDocumentStub, SanityImageAssetDocument, SanityImagePalette, SanityProject, SanityProjectMember, SanityProjectionsByResource, SanityQueries, SanityQueriesByResource, SanityReference, SanitySchemasByResource, SanityUser, ScheduleReleaseAction, ServerError, type ServerSentEvent, SingleActionResult, SingleMutationResult, StackablePerspective, type StegaConfig, type StegaConfigRequiredKeys, StillImageFormat, StoryboardTransformOptions, type StudioBaseRoute, type StudioBaseUrl, type StudioUrl, SyncTag, ThumbnailTransformOptions, type TimeoutErrorLike, Transaction, TransactionAllDocumentIdsMutationOptions, TransactionAllDocumentsMutationOptions, TransactionFirstDocumentIdMutationOptions, TransactionFirstDocumentMutationOptions, TransactionMutationOptions, type TransformDocument, type TransformOperation, type TransformTarget, type TransformTargetDocument, type TransformTargetInclude, type TranslateDocument, type TranslateTarget, type TranslateTargetInclude, UnarchiveReleaseAction, UnfilteredResponseQueryOptions, UnfilteredResponseWithoutQuery, UnpublishAction, UnpublishVariantAction, UnpublishVersionAction, UnscheduleReleaseAction, UploadBody, UploadClientConfig, UploadEvent, UploadProgressEvent, UploadResponseEvent, type UsersClient, VariantAction, VariantDefinitionAction, VersionAction, VideoPlaybackInfo, VideoPlaybackInfoItem, VideoPlaybackInfoItemPublic, VideoPlaybackInfoItemSigned, VideoPlaybackInfoPublic, VideoPlaybackInfoSigned, VideoPlaybackTokens, VideoRenditionInfo, VideoRenditionInfoPublic, VideoRenditionInfoSigned, VideoSubtitleInfo, VideoSubtitleInfoPublic, VideoSubtitleInfoSigned, WelcomeBackEvent, WelcomeEvent, type _listen, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, isTimeoutError, requester, validateApiPerspective };
 //# sourceMappingURL=index.node.d.ts.map