@sanity/client 8.2.0 → 8.4.0

package/src/context/types.gen.ts

@@ -0,0 +1,2428 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+  '/{apiVersion}/context/knowledge-bases': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * List knowledge bases
+     * @description Returns the organization's knowledge bases visible to the caller, cursor-paginated.
+     */
+    get: operations['listKnowledgeBases']
+    put?: never
+    /**
+     * Create a knowledge base
+     * @description Creates a knowledge base bound to a Sanity dataset, where its content documents will be stored.
+     */
+    post: operations['createKnowledgeBase']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * Get a knowledge base
+     * @description Returns the knowledge base object: metadata and state. Resolves from the id alone, the public id (`kb...`) or the uuid; access is decided against the knowledge base's own organization, and an id the caller cannot read returns 404. For the built content, use the outline or entries endpoints.
+     */
+    get: operations['getKnowledgeBase']
+    put?: never
+    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.
+     */
+    delete: operations['deleteKnowledgeBase']
+    options?: never
+    head?: never
+    /**
+     * Update a knowledge base
+     * @description Edits the name and description, or the recurring refresh controls (`refreshEnabled`, `refreshFrequency`). Refresh fields return 422 for knowledge bases with no web or dataset source. Disabling pauses the schedule; manual refresh still works.
+     */
+    patch: operations['updateKnowledgeBase']
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/build': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Trigger a knowledge base build
+     * @description Queues a build over the current corpus and returns a job id right away. If a build is already running, you get that job instead of a second one.
+     */
+    post: operations['buildKnowledgeBase']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/build/cancel': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Cancel an in-progress build
+     * @description Cancels the running build and resets the knowledge base so it can be rebuilt.
+     */
+    post: operations['cancelKnowledgeBaseBuild']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/entries/{entryPath}/rebuild': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Rebuild an entry from its sources
+     * @description Queues a re-write of the entry at this path from its cited sources and the active instructions, and returns a job id right away. The response also names the other entries citing any of the same sources: a source-tied rule affects every page citing that source, so those may change too.
+     */
+    post: operations['rebuildEntry']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/imports': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * List imports
+     * @description Everything added to this knowledge base, one row per import: a file upload, web crawl, dataset bind, or inline text. Cursor-paginated. The sources each import produced live under `/sources`.
+     */
+    get: operations['listImports']
+    put?: never
+    /**
+     * Create an import (text, crawl, or dataset)
+     * @description Adds content, discriminated on `type`: `text` for inline content, `crawl` for a website, `dataset` for a GROQ-filtered Sanity dataset. Each variant queues processing and returns a job id to poll. For files, use `POST .../imports/uploads` instead. Re-adding an existing crawl url returns 409 `webSourceRootConflict`; exceeding the crawl root limit returns 409 `webSourceRootLimitExceeded`. Supports the `Idempotency-Key` header.
+     */
+    post: operations['createImport']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/imports/uploads': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    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.
+     */
+    post: operations['startUpload']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/imports/uploads/{importId}/complete': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Complete a file-upload import
+     * @description Call after the file bytes are uploaded to the signed URL. Starts processing and returns a job id to poll.
+     */
+    post: operations['completeUpload']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/imports/{importId}': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * Get a single import
+     * @description Returns one import with its kind and processing status.
+     */
+    get: operations['getImport']
+    put?: never
+    post?: never
+    /**
+     * Delete an import
+     * @description Removes the import and every source it produced, and cancels its ingest if one is still running. Use it to discard something added by mistake.
+     */
+    delete: operations['deleteImport']
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/imports/{importId}/download': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * Get a download URL for an import
+     * @description Mints a short-lived signed URL serving the import's original bytes as an attachment. Use it before `expiresAt`; the bytes never pass through this API. Only file and text imports carry original bytes; crawls and dataset binds return 409 `importInvalidState`.
+     */
+    get: operations['downloadImport']
+    put?: never
+    post?: never
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/instructions': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    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.
+     */
+    post: operations['createInstruction']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/instructions/{instructionId}': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    post?: never
+    /**
+     * Delete an instruction
+     * @description Deletes the rule. Builds stop honoring it from the next run.
+     */
+    delete: operations['deleteInstruction']
+    options?: never
+    head?: never
+    /**
+     * Edit an instruction
+     * @description Edits the statement or scope. The change applies from the next build. Any edit re-affirms the rule: an archived rule returns to active, re-anchored to the sources' current content.
+     */
+    patch: operations['updateInstruction']
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/issues/apply': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Apply accepted issues to a Context
+     * @description Queues a job that applies accepted issues, rewrites the affected entries, and commits a new revision. Returns a job id. Issue ids that no longer exist are skipped.
+     */
+    post: operations['applyIssues']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/issues/{issueId}/dismiss': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Dismiss an issue
+     * @description Marks the issue rejected. Idempotent: dismissing an issue that already left the queue returns it as-is. 422 `issueDocumentInvalid` when the document was hand-edited into an unverifiable shape; 409 `issueTransitionConflict` on a concurrent edit, safe to retry.
+     */
+    post: operations['dismissIssue']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/issues/{issueId}/reopen': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Reopen an accepted conflict
+     * @description Returns an accepted conflict to triage, clearing its resolution and deleting the instruction it minted. Idempotent for issues that are not accepted conflicts.
+     */
+    post: operations['reopenIssue']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/issues/{issueId}/resolve': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    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.
+     */
+    post: operations['resolveIssue']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/jobs/{jobId}': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * 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.
+     */
+    get: operations['getJob']
+    put?: never
+    post?: never
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/refresh': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    get?: never
+    put?: never
+    /**
+     * Trigger an incremental refresh
+     * @description Queues a refresh: recrawls each web source, diffs the corpus against the last build, and files change issues. Returns a job id, with `started: false` when a refresh was already in flight. Supports the `Idempotency-Key` header.
+     */
+    post: operations['refreshKnowledgeBase']
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/sources': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * List sources
+     * @description The distilled units builds cite: the pages, files, and documents your imports expanded into. Read-only; add content via `/imports`. Cursor-paginated, filter by `status`.
+     */
+    get: operations['listSources']
+    put?: never
+    post?: never
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/sources/{sourceId}': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * Get a single source
+     * @description Returns one source with its metadata and processing status.
+     */
+    get: operations['getSource']
+    put?: never
+    post?: never
+    /**
+     * Delete a source
+     * @description Removes the source immediately. Entries are not modified here — citations to it are cleaned up by the next build or check for changes, where entries left without sources become removal proposals. Human-edited entries are never modified.
+     */
+    delete: operations['deleteSource']
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/knowledge-bases/{knowledgeBaseId}/sources/{sourceId}/content': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    /**
+     * Read a source's distilled content
+     * @description The distilled markdown builds cite, the same text the pipeline itself reads. Use it to verify an issue's claims against the sources its `citedSourceIds` name. Optional `startLine` and `endLine` (1-indexed, inclusive) fetch just a span. JSON by default; `?format=markdown` returns the raw text. 409 `sourceNotDistilled` until distillation has produced content.
+     */
+    get: operations['getSourceContent']
+    put?: never
+    post?: never
+    delete?: never
+    options?: never
+    head?: never
+    patch?: never
+    trace?: never
+  }
+  '/{apiVersion}/context/organizations/{organizationId}/conversations/{threadId}': {
+    parameters: {
+      query?: never
+      header?: never
+      path?: never
+      cookie?: never
+    }
+    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` and model fields only overwrite when present. Last write per thread wins — retries are safe.
+     */
+    put: operations['saveConversation']
+    post?: never
+    delete?: never
+    options?: never
+    head?: never
+    /**
+     * Record a classification verdict
+     * @description Records the classification your own model produced for one thread: exactly one of `coreMetrics` (a verdict — the server stamps `classifiedAt` and clears any recorded failure) or `classificationError` (why classification failed; an earlier verdict stays untouched). No revision guard — like the ingest upsert the writer is an automated classifier, so last write wins and a re-classification simply overwrites.
+     */
+    patch: operations['classifyConversation']
+    trace?: never
+  }
+}
+export type webhooks = Record<string, never>
+export interface components {
+  schemas: {
+    /** @description A `sanity.context.conversation` document, one agent conversation transcript with its classification, stored in the organization store. Not returned by any endpoint raw; published so GROQ reads can be typed. Write through the conversation ingest and classify endpoints, never with a raw client. */
+    ConversationDoc: {
+      _id: string
+      _rev: string
+      /** Format: date-time */
+      _createdAt: string
+      /** Format: date-time */
+      _updatedAt: string
+      /** @enum {string} */
+      _type: 'sanity.context.conversation'
+      /** @enum {number} */
+      schemaVersion: 1
+      organizationId: string
+      threadId: string
+      /** @description ConversationMetadata */
+      metadata: {
+        [key: string]: string | string[]
+      } | null
+      /** Format: date-time */
+      startedAt: string
+      /** Format: date-time */
+      messagesUpdatedAt: string
+      messages: {
+        /** @enum {string} */
+        role: 'user' | 'assistant' | 'system' | 'tool'
+        /** @default null */
+        content: string | null
+        /** @default null */
+        toolName: string | null
+        /**
+         * @default null
+         * @enum {string|null}
+         */
+        toolType: 'call' | 'result' | null
+      }[]
+      modelProvider: string | null
+      modelId: string | null
+      /** @description ConversationTokenUsage */
+      tokenUsage: {
+        inputTokens?: number
+        outputTokens?: number
+        totalTokens?: number
+      } | null
+      /** @description ConversationCoreMetrics */
+      coreMetrics: {
+        successScore?: number
+        /** @enum {string} */
+        sentiment?: 'positive' | 'neutral' | 'negative'
+        contentGaps?: string[]
+      } | null
+      /** Format: date-time */
+      classifiedAt: string | null
+      classificationError: string | null
+    }
+    /** @description A `sanity.context.entry` document, one outline node stored in the bound dataset. Not returned by any endpoint; published so GROQ reads against the dataset can be typed. The entries endpoints serve the validated wire view. */
+    EntryDoc: {
+      _id: string
+      _rev: string
+      /** Format: date-time */
+      _createdAt: string
+      /** Format: date-time */
+      _updatedAt: string
+      knowledgeBaseId: string
+      /** @enum {string} */
+      _type: 'sanity.context.entry'
+      schemaVersion: number
+      revisionId: string
+      path: string
+      title: string
+      tldr?: {
+        scope: string
+        excludes: string
+        neighbors?: string[]
+        /** @enum {string} */
+        centrality: 'core' | 'standard' | 'peripheral'
+      }
+      body?: string
+      topicHeadings?: string[]
+      citations?: {
+        sourceId: string
+        supports?: string
+        spans?: {
+          sourceLineStart: number
+          sourceLineEnd: number
+          quote: string
+        }[]
+        claim?: {
+          exact: string
+          prefix?: string
+          suffix?: string
+        }
+        /** @enum {string} */
+        groundingState?: 'drifted'
+        _key: string
+        /** @enum {string} */
+        _type: 'sanity.context.citation'
+        filename: string
+        mime?: string
+        excerpt?: string
+      }[]
+      /** @enum {string} */
+      status: 'virtual' | 'outlined' | 'filled' | 'stale' | 'generation_failed'
+      generatedAt: string
+    }
+    /** @description A `sanity.context.instruction` document, a standing decision steering every build, stored in the bound dataset. Not returned by any endpoint; published so GROQ reads against the dataset can be typed. Write through the instructions endpoints, never with a raw client. */
+    InstructionDoc:
+      | {
+          _id: string
+          _rev: string
+          /** Format: date-time */
+          _createdAt: string
+          /** Format: date-time */
+          _updatedAt: string
+          knowledgeBaseId: string
+          /** @enum {string} */
+          _type: 'sanity.context.instruction'
+          /** @enum {number} */
+          schemaVersion: 1
+          statement: string
+          scopeSources:
+            | {
+                _key: string
+                sourceId: string
+                contentHash: string
+              }[]
+            | null
+          /** @enum {string} */
+          status: 'active' | 'archived'
+          archivedAt: string | null
+          archivedReason: string | null
+          /** @enum {string} */
+          origin: 'conflict'
+          sourceIssueId: string
+        }
+      | {
+          _id: string
+          _rev: string
+          /** Format: date-time */
+          _createdAt: string
+          /** Format: date-time */
+          _updatedAt: string
+          knowledgeBaseId: string
+          /** @enum {string} */
+          _type: 'sanity.context.instruction'
+          /** @enum {number} */
+          schemaVersion: 1
+          statement: string
+          scopeSources:
+            | {
+                _key: string
+                sourceId: string
+                contentHash: string
+              }[]
+            | null
+          /** @enum {string} */
+          status: 'active' | 'archived'
+          archivedAt: string | null
+          archivedReason: string | null
+          /** @enum {string} */
+          origin: 'human'
+          /** @enum {string|null} */
+          sourceIssueId: null
+        }
+    /** @description A `sanity.context.issue` document, a build finding awaiting triage, stored in the bound dataset. Not returned by any endpoint; published so GROQ reads and trigger filters can be typed. Status transitions flow through the issues endpoints, which own the state machine. One invariant the schema cannot express: only a `conflict` issue ever carries a non-null `resolution`. */
+    IssueDoc:
+      | {
+          _id: string
+          _rev: string
+          /** Format: date-time */
+          _createdAt: string
+          /** Format: date-time */
+          _updatedAt: string
+          knowledgeBaseId: string
+          /** @enum {string} */
+          _type: 'sanity.context.issue'
+          /** @enum {number} */
+          schemaVersion: 1
+          /** @description IssueContent */
+          content: {
+            /** @enum {string} */
+            kind:
+              | 'conflict'
+              | 'gap'
+              | 'update_required'
+              | 'add_entry'
+              | 'remove_entry'
+              | 'split_entry'
+              | 'merge_entry'
+            /** @enum {string} */
+            severity: 'critical' | 'suggestion'
+            scopePath: string
+            issue: string
+            suggestedFix: string
+            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
+          /** @enum {string} */
+          status: 'open'
+          /** @enum {string|null} */
+          resolution: null
+          /** @enum {string|null} */
+          resolvedAt: null
+          /** @enum {string|null} */
+          resolvedBy: null
+        }
+      | {
+          _id: string
+          _rev: string
+          /** Format: date-time */
+          _createdAt: string
+          /** Format: date-time */
+          _updatedAt: string
+          knowledgeBaseId: string
+          /** @enum {string} */
+          _type: 'sanity.context.issue'
+          /** @enum {number} */
+          schemaVersion: 1
+          /** @description IssueContent */
+          content: {
+            /** @enum {string} */
+            kind:
+              | 'conflict'
+              | 'gap'
+              | 'update_required'
+              | 'add_entry'
+              | 'remove_entry'
+              | 'split_entry'
+              | 'merge_entry'
+            /** @enum {string} */
+            severity: 'critical' | 'suggestion'
+            scopePath: string
+            issue: string
+            suggestedFix: string
+            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
+          /** @enum {string} */
+          status: 'accepted'
+          /** Format: date-time */
+          resolvedAt: string
+          resolvedBy: {
+            id: string
+            /** @enum {string} */
+            kind: 'user' | 'robot'
+          } | null
+          /** @enum {string|null} */
+          resolution: 'keep_existing' | 'accept_new' | null
+        }
+      | {
+          _id: string
+          _rev: string
+          /** Format: date-time */
+          _createdAt: string
+          /** Format: date-time */
+          _updatedAt: string
+          knowledgeBaseId: string
+          /** @enum {string} */
+          _type: 'sanity.context.issue'
+          /** @enum {number} */
+          schemaVersion: 1
+          /** @description IssueContent */
+          content: {
+            /** @enum {string} */
+            kind:
+              | 'conflict'
+              | 'gap'
+              | 'update_required'
+              | 'add_entry'
+              | 'remove_entry'
+              | 'split_entry'
+              | 'merge_entry'
+            /** @enum {string} */
+            severity: 'critical' | 'suggestion'
+            scopePath: string
+            issue: string
+            suggestedFix: string
+            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
+          /** @enum {string} */
+          status: 'rejected'
+          /** Format: date-time */
+          resolvedAt: string
+          resolvedBy: {
+            id: string
+            /** @enum {string} */
+            kind: 'user' | 'robot'
+          } | null
+          /** @enum {string|null} */
+          resolution: null
+        }
+    /** @description A `sanity.context.mcp` document, an org-owned MCP endpoint configuration stored in the organization store. Not returned by any endpoint raw; published so GROQ reads and trigger filters can be typed. Write through the mcp endpoints, never with a raw client. The mcp endpoints serve the validated wire view. */
+    McpDoc: {
+      _id: string
+      _rev: string
+      /** Format: date-time */
+      _createdAt: string
+      /** Format: date-time */
+      _updatedAt: string
+      /** @enum {string} */
+      _type: 'sanity.context.mcp'
+      /** @enum {number} */
+      schemaVersion: 1
+      organizationId: string
+      publicId: string
+      title: string
+      name: string
+      sources: (
+        | {
+            /** @enum {string} */
+            type: 'knowledge-base'
+            id: string
+          }
+        | {
+            /** @enum {string} */
+            type: 'dataset'
+            id: string
+          }
+      )[]
+      instructions: string | null
+      groqFilter: string | null
+    }
+  }
+  responses: never
+  parameters: never
+  requestBodies: never
+  headers: never
+  pathItems: never
+}
+export type $defs = Record<string, never>
+export interface operations {
+  listKnowledgeBases: {
+    parameters: {
+      query: {
+        cursor?: string
+        limit?: number
+        organizationId: string
+      }
+      header?: never
+      path: {
+        apiVersion: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            data: {
+              /** Format: uuid */
+              id: string
+              publicId: string
+              organizationId: string
+              title: string
+              description: string
+              /** @enum {string} */
+              state: 'created' | 'building' | 'ready' | 'review' | 'stale' | 'paused'
+              activeJobId: string | null
+              isBuilding: boolean
+              buildStageState: {
+                jobId: string
+                stages: {
+                  /** @enum {string} */
+                  id:
+                    | 'tldr'
+                    | 'map'
+                    | 'triage'
+                    | 'plan'
+                    | 'organize'
+                    | 'arrange'
+                    | 'write'
+                    | 'review'
+                    | 'polish'
+                  /** @enum {string} */
+                  status: 'pending' | 'running' | 'done' | 'failed'
+                  units?: {
+                    /** @enum {string} */
+                    unit: 'sources' | 'groups' | 'entries' | 'rounds'
+                    done: number
+                    total?: number
+                  }
+                }[]
+              } | null
+              /** Format: date-time */
+              lastCheckedAt: string | null
+              /** Format: date-time */
+              lastChangedAt: string | null
+              hasPendingChanges: boolean
+              pendingChanges: {
+                added: number
+                changed: number
+                removed: number
+              } | null
+              pipelineOutdated: boolean
+              rebuildRecommended: {
+                reason: string
+                /** Format: date-time */
+                at: string
+              } | null
+              hasWebSource: boolean
+              hasDatasetSource: boolean
+              sourceUsage: {
+                used: number
+                limit: number
+              } | null
+              refreshEnabled: boolean
+              /** @enum {string} */
+              refreshFrequency: 'weekly' | 'monthly'
+              /** Format: date-time */
+              refreshNextRunAt: string | null
+              refreshInFlight: boolean
+              openIssueCount: number
+              instructionCount: number
+              /** Format: date-time */
+              createdAt: string
+              /** Format: date-time */
+              updatedAt: string
+            }[]
+            nextCursor: string | null
+          }
+        }
+      }
+    }
+  }
+  createKnowledgeBase: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        apiVersion: string
+      }
+      cookie?: never
+    }
+    requestBody: {
+      content: {
+        'application/json': {
+          organizationId: string
+          title: string
+          description: string
+        }
+      }
+    }
+    responses: {
+      /** @description KnowledgeBase */
+      201: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            id: string
+            publicId: string
+            organizationId: string
+            title: string
+            description: string
+            /** @enum {string} */
+            state: 'created' | 'building' | 'ready' | 'review' | 'stale' | 'paused'
+            activeJobId: string | null
+            isBuilding: boolean
+            buildStageState: {
+              jobId: string
+              stages: {
+                /** @enum {string} */
+                id:
+                  | 'tldr'
+                  | 'map'
+                  | 'triage'
+                  | 'plan'
+                  | 'organize'
+                  | 'arrange'
+                  | 'write'
+                  | 'review'
+                  | 'polish'
+                /** @enum {string} */
+                status: 'pending' | 'running' | 'done' | 'failed'
+                units?: {
+                  /** @enum {string} */
+                  unit: 'sources' | 'groups' | 'entries' | 'rounds'
+                  done: number
+                  total?: number
+                }
+              }[]
+            } | null
+            /** Format: date-time */
+            lastCheckedAt: string | null
+            /** Format: date-time */
+            lastChangedAt: string | null
+            hasPendingChanges: boolean
+            pendingChanges: {
+              added: number
+              changed: number
+              removed: number
+            } | null
+            pipelineOutdated: boolean
+            rebuildRecommended: {
+              reason: string
+              /** Format: date-time */
+              at: string
+            } | null
+            hasWebSource: boolean
+            hasDatasetSource: boolean
+            sourceUsage: {
+              used: number
+              limit: number
+            } | null
+            refreshEnabled: boolean
+            /** @enum {string} */
+            refreshFrequency: 'weekly' | 'monthly'
+            /** Format: date-time */
+            refreshNextRunAt: string | null
+            refreshInFlight: boolean
+            openIssueCount: number
+            instructionCount: number
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            updatedAt: string
+          }
+        }
+      }
+    }
+  }
+  getKnowledgeBase: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description KnowledgeBase */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            id: string
+            publicId: string
+            organizationId: string
+            title: string
+            description: string
+            /** @enum {string} */
+            state: 'created' | 'building' | 'ready' | 'review' | 'stale' | 'paused'
+            activeJobId: string | null
+            isBuilding: boolean
+            buildStageState: {
+              jobId: string
+              stages: {
+                /** @enum {string} */
+                id:
+                  | 'tldr'
+                  | 'map'
+                  | 'triage'
+                  | 'plan'
+                  | 'organize'
+                  | 'arrange'
+                  | 'write'
+                  | 'review'
+                  | 'polish'
+                /** @enum {string} */
+                status: 'pending' | 'running' | 'done' | 'failed'
+                units?: {
+                  /** @enum {string} */
+                  unit: 'sources' | 'groups' | 'entries' | 'rounds'
+                  done: number
+                  total?: number
+                }
+              }[]
+            } | null
+            /** Format: date-time */
+            lastCheckedAt: string | null
+            /** Format: date-time */
+            lastChangedAt: string | null
+            hasPendingChanges: boolean
+            pendingChanges: {
+              added: number
+              changed: number
+              removed: number
+            } | null
+            pipelineOutdated: boolean
+            rebuildRecommended: {
+              reason: string
+              /** Format: date-time */
+              at: string
+            } | null
+            hasWebSource: boolean
+            hasDatasetSource: boolean
+            sourceUsage: {
+              used: number
+              limit: number
+            } | null
+            refreshEnabled: boolean
+            /** @enum {string} */
+            refreshFrequency: 'weekly' | 'monthly'
+            /** Format: date-time */
+            refreshNextRunAt: string | null
+            refreshInFlight: boolean
+            openIssueCount: number
+            instructionCount: number
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            updatedAt: string
+          }
+        }
+      }
+    }
+  }
+  deleteKnowledgeBase: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      204: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': null
+        }
+      }
+    }
+  }
+  updateKnowledgeBase: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody: {
+      content: {
+        'application/json': {
+          title?: string
+          description?: string
+          refreshEnabled?: boolean
+          /** @enum {string} */
+          refreshFrequency?: 'weekly' | 'monthly'
+        }
+      }
+    }
+    responses: {
+      /** @description KnowledgeBase */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            id: string
+            publicId: string
+            organizationId: string
+            title: string
+            description: string
+            /** @enum {string} */
+            state: 'created' | 'building' | 'ready' | 'review' | 'stale' | 'paused'
+            activeJobId: string | null
+            isBuilding: boolean
+            buildStageState: {
+              jobId: string
+              stages: {
+                /** @enum {string} */
+                id:
+                  | 'tldr'
+                  | 'map'
+                  | 'triage'
+                  | 'plan'
+                  | 'organize'
+                  | 'arrange'
+                  | 'write'
+                  | 'review'
+                  | 'polish'
+                /** @enum {string} */
+                status: 'pending' | 'running' | 'done' | 'failed'
+                units?: {
+                  /** @enum {string} */
+                  unit: 'sources' | 'groups' | 'entries' | 'rounds'
+                  done: number
+                  total?: number
+                }
+              }[]
+            } | null
+            /** Format: date-time */
+            lastCheckedAt: string | null
+            /** Format: date-time */
+            lastChangedAt: string | null
+            hasPendingChanges: boolean
+            pendingChanges: {
+              added: number
+              changed: number
+              removed: number
+            } | null
+            pipelineOutdated: boolean
+            rebuildRecommended: {
+              reason: string
+              /** Format: date-time */
+              at: string
+            } | null
+            hasWebSource: boolean
+            hasDatasetSource: boolean
+            sourceUsage: {
+              used: number
+              limit: number
+            } | null
+            refreshEnabled: boolean
+            /** @enum {string} */
+            refreshFrequency: 'weekly' | 'monthly'
+            /** Format: date-time */
+            refreshNextRunAt: string | null
+            refreshInFlight: boolean
+            openIssueCount: number
+            instructionCount: number
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            updatedAt: string
+          }
+        }
+      }
+    }
+  }
+  buildKnowledgeBase: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description JobAccepted */
+      202: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            jobId: string
+          }
+        }
+      }
+    }
+  }
+  cancelKnowledgeBaseBuild: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            cancelled: boolean
+          }
+        }
+      }
+    }
+  }
+  rebuildEntry: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        entryPath: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description RebuildEntryResponse */
+      202: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            jobId: string
+            affectedEntries: {
+              id: string
+              path: string
+              title: string
+            }[]
+          }
+        }
+      }
+    }
+  }
+  listImports: {
+    parameters: {
+      query?: {
+        cursor?: string
+        limit?: number
+      }
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            data: {
+              /** Format: uuid */
+              id: string
+              /** Format: uuid */
+              knowledgeBaseId: string
+              name: string | null
+              sizeBytes: number | null
+              /** @enum {string} */
+              status: 'uploading' | 'processing' | 'complete' | 'failed'
+              /** @enum {string} */
+              sourceKind: 'web' | 'file' | 'dataset'
+              /** Format: date-time */
+              lastCheckedAt: string | null
+              sourceCount: number
+              totalDistillableCount: number
+              distilledCount: number
+              unsupportedCount: number
+              statusDetail: string | null
+              error: string | null
+              /** @description CrawlOptions */
+              crawlOptions: {
+                includePaths?: string[]
+                excludePaths?: string[]
+                maxDepth?: number
+                sitemapOnly?: boolean
+                ignoreQueryParameters?: boolean
+                pageLimit?: number
+              } | null
+              /** @description DatasetSourceBinding */
+              datasetSource: {
+                sanityProjectId: string
+                sanityDatasetId: string
+                query: string
+              } | null
+              /** @description Actor */
+              createdBy: {
+                id: string | null
+                displayName: string | null
+              } | null
+              /** Format: date-time */
+              createdAt: string
+              /** Format: date-time */
+              completedAt: string | null
+            }[]
+            nextCursor: string | null
+          }
+        }
+      }
+    }
+  }
+  createImport: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    /** @description CreateImportInput */
+    requestBody: {
+      content: {
+        'application/json':
+          | {
+              /** @enum {string} */
+              type: 'text'
+              title: string
+              content: string
+              /**
+               * @default text/markdown
+               * @enum {string}
+               */
+              contentType?: 'text/markdown' | 'text/plain'
+            }
+          | {
+              /** Format: uri */
+              url: string
+              /** @description CrawlOptions */
+              options?: {
+                includePaths?: string[]
+                excludePaths?: string[]
+                maxDepth?: number
+                sitemapOnly?: boolean
+                ignoreQueryParameters?: boolean
+                pageLimit?: number
+              }
+              /** @enum {string} */
+              type: 'crawl'
+            }
+          | {
+              sanityProjectId: string
+              sanityDatasetId: string
+              query: string
+              /** @enum {string} */
+              type: 'dataset'
+            }
+      }
+    }
+    responses: {
+      /** @description JobAccepted */
+      202: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            jobId: string
+          }
+        }
+      }
+    }
+  }
+  startUpload: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody: {
+      content: {
+        'application/json': {
+          filename: string
+          contentType?: string
+        }
+      }
+    }
+    responses: {
+      /** @description Default Response */
+      201: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            importId: string
+            /** Format: uri */
+            uploadUrl: string
+          }
+        }
+      }
+    }
+  }
+  completeUpload: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        importId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description JobAccepted */
+      202: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            jobId: string
+          }
+        }
+      }
+    }
+  }
+  getImport: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        importId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Import */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            id: string
+            /** Format: uuid */
+            knowledgeBaseId: string
+            name: string | null
+            sizeBytes: number | null
+            /** @enum {string} */
+            status: 'uploading' | 'processing' | 'complete' | 'failed'
+            /** @enum {string} */
+            sourceKind: 'web' | 'file' | 'dataset'
+            /** Format: date-time */
+            lastCheckedAt: string | null
+            sourceCount: number
+            totalDistillableCount: number
+            distilledCount: number
+            unsupportedCount: number
+            statusDetail: string | null
+            error: string | null
+            /** @description CrawlOptions */
+            crawlOptions: {
+              includePaths?: string[]
+              excludePaths?: string[]
+              maxDepth?: number
+              sitemapOnly?: boolean
+              ignoreQueryParameters?: boolean
+              pageLimit?: number
+            } | null
+            /** @description DatasetSourceBinding */
+            datasetSource: {
+              sanityProjectId: string
+              sanityDatasetId: string
+              query: string
+            } | null
+            /** @description Actor */
+            createdBy: {
+              id: string | null
+              displayName: string | null
+            } | null
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            completedAt: string | null
+          }
+        }
+      }
+    }
+  }
+  deleteImport: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        importId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      204: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': null
+        }
+      }
+    }
+  }
+  downloadImport: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        importId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uri */
+            url: string
+            /** Format: date-time */
+            expiresAt: string
+          }
+        }
+      }
+    }
+  }
+  createInstruction: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    /** @description CreateInstructionInput */
+    requestBody: {
+      content: {
+        'application/json': {
+          statement: string
+          scopeSourceIds?: string[] | null
+          rebuildPaths?: string[]
+          verified?: boolean
+        }
+      }
+    }
+    responses: {
+      /** @description CreateInstructionResponse */
+      201: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** @description Instruction */
+            instruction: {
+              id: string
+              knowledgeBaseId: string
+              /** @enum {string} */
+              origin: 'conflict' | 'human'
+              /** @enum {string} */
+              status: 'active' | 'archived'
+              statement: string
+              scopeSourceIds: string[] | null
+              /** Format: date-time */
+              archivedAt: string | null
+              archivedReason: string | null
+              sourceIssueId: string | null
+              /** @description Actor */
+              createdBy: {
+                id: string | null
+                displayName: string | null
+              } | null
+              /** @description Actor */
+              updatedBy: {
+                id: string | null
+                displayName: string | null
+              } | null
+              /** Format: date-time */
+              createdAt: string
+              /** Format: date-time */
+              updatedAt: string | null
+            }
+            rebuildJobId: string | null
+          }
+        }
+      }
+    }
+  }
+  deleteInstruction: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        instructionId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      204: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': null
+        }
+      }
+    }
+  }
+  updateInstruction: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        instructionId: string
+      }
+      cookie?: never
+    }
+    /** @description UpdateInstructionInput */
+    requestBody: {
+      content: {
+        'application/json': {
+          statement?: string
+          scopeSourceIds?: string[] | null
+        }
+      }
+    }
+    responses: {
+      /** @description Instruction */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            id: string
+            knowledgeBaseId: string
+            /** @enum {string} */
+            origin: 'conflict' | 'human'
+            /** @enum {string} */
+            status: 'active' | 'archived'
+            statement: string
+            scopeSourceIds: string[] | null
+            /** Format: date-time */
+            archivedAt: string | null
+            archivedReason: string | null
+            sourceIssueId: string | null
+            /** @description Actor */
+            createdBy: {
+              id: string | null
+              displayName: string | null
+            } | null
+            /** @description Actor */
+            updatedBy: {
+              id: string | null
+              displayName: string | null
+            } | null
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            updatedAt: string | null
+          }
+        }
+      }
+    }
+  }
+  applyIssues: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody: {
+      content: {
+        'application/json': {
+          issueIds: string[]
+        }
+      }
+    }
+    responses: {
+      /** @description JobAccepted */
+      202: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            jobId: string
+          }
+        }
+      }
+    }
+  }
+  dismissIssue: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        issueId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Issue */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            id: string
+            knowledgeBaseId: string
+            /** @description IssueContent */
+            content: {
+              /** @enum {string} */
+              kind:
+                | 'conflict'
+                | 'gap'
+                | 'update_required'
+                | 'add_entry'
+                | 'remove_entry'
+                | 'split_entry'
+                | 'merge_entry'
+              /** @enum {string} */
+              severity: 'critical' | 'suggestion'
+              scopePath: string
+              issue: string
+              suggestedFix: string
+              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
+            /** @description IssueResolvedBy */
+            resolvedBy: {
+              id: string
+              /** @enum {string} */
+              kind: 'user' | 'robot'
+            } | null
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            resolvedAt: string | null
+          }
+        }
+      }
+    }
+  }
+  reopenIssue: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        issueId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Issue */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            id: string
+            knowledgeBaseId: string
+            /** @description IssueContent */
+            content: {
+              /** @enum {string} */
+              kind:
+                | 'conflict'
+                | 'gap'
+                | 'update_required'
+                | 'add_entry'
+                | 'remove_entry'
+                | 'split_entry'
+                | 'merge_entry'
+              /** @enum {string} */
+              severity: 'critical' | 'suggestion'
+              scopePath: string
+              issue: string
+              suggestedFix: string
+              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
+            /** @description IssueResolvedBy */
+            resolvedBy: {
+              id: string
+              /** @enum {string} */
+              kind: 'user' | 'robot'
+            } | null
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            resolvedAt: string | null
+          }
+        }
+      }
+    }
+  }
+  resolveIssue: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        issueId: string
+      }
+      cookie?: never
+    }
+    requestBody: {
+      content: {
+        'application/json': {
+          /** @enum {string} */
+          resolution: 'keep_existing' | 'accept_new'
+        }
+      }
+    }
+    responses: {
+      /** @description ResolveIssueResponse */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** @description Issue */
+            issue: {
+              id: string
+              knowledgeBaseId: string
+              /** @description IssueContent */
+              content: {
+                /** @enum {string} */
+                kind:
+                  | 'conflict'
+                  | 'gap'
+                  | 'update_required'
+                  | 'add_entry'
+                  | 'remove_entry'
+                  | 'split_entry'
+                  | 'merge_entry'
+                /** @enum {string} */
+                severity: 'critical' | 'suggestion'
+                scopePath: string
+                issue: string
+                suggestedFix: string
+                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
+              /** @description IssueResolvedBy */
+              resolvedBy: {
+                id: string
+                /** @enum {string} */
+                kind: 'user' | 'robot'
+              } | null
+              /** Format: date-time */
+              createdAt: string
+              /** Format: date-time */
+              resolvedAt: string | null
+            }
+            jobId: string | null
+          }
+        }
+      }
+    }
+  }
+  getJob: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        jobId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Job */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            id: string
+            /** @enum {string} */
+            status: 'pending' | 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled'
+            /** Format: date-time */
+            startedAt: string | null
+            /** Format: date-time */
+            completedAt: string | null
+            result?: unknown
+            error?: string | null
+          }
+        }
+      }
+    }
+  }
+  refreshKnowledgeBase: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description RefreshAccepted */
+      202: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            jobId: string
+            started: boolean
+          }
+        }
+      }
+    }
+  }
+  listSources: {
+    parameters: {
+      query?: {
+        cursor?: string
+        limit?: number
+        status?: 'pending' | 'processing' | 'ready' | 'failed' | 'skipped'
+        importId?: string
+        ids?: string
+      }
+      header?: never
+      path: {
+        knowledgeBaseId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            data: {
+              /** Format: uuid */
+              id: string
+              /** Format: uuid */
+              knowledgeBaseId: string
+              filename: string
+              /** @enum {string} */
+              kind: 'web' | 'file' | 'dataset'
+              sizeBytes: number
+              /** @enum {string} */
+              status: 'pending' | 'processing' | 'ready' | 'failed' | 'skipped'
+              tldr: string | null
+              topics: string[] | null
+              canonicalUrl: string | null
+              /** Format: date-time */
+              fetchedAt: string | null
+              /** Format: date-time */
+              distilledAt: string | null
+              /** Format: date-time */
+              createdAt: string
+            }[]
+            nextCursor: string | null
+          }
+        }
+      }
+    }
+  }
+  getSource: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        sourceId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Source */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            id: string
+            /** Format: uuid */
+            knowledgeBaseId: string
+            filename: string
+            /** @enum {string} */
+            kind: 'web' | 'file' | 'dataset'
+            sizeBytes: number
+            /** @enum {string} */
+            status: 'pending' | 'processing' | 'ready' | 'failed' | 'skipped'
+            tldr: string | null
+            topics: string[] | null
+            canonicalUrl: string | null
+            /** Format: date-time */
+            fetchedAt: string | null
+            /** Format: date-time */
+            distilledAt: string | null
+            /** Format: date-time */
+            createdAt: string
+          }
+        }
+      }
+    }
+  }
+  deleteSource: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        sourceId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description Default Response */
+      204: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': null
+        }
+      }
+    }
+  }
+  getSourceContent: {
+    parameters: {
+      query?: {
+        /** @description Output representation. `json` (default) returns the structured resource; `markdown` / `plain` return the rendered, LLM-ready text. */
+        format?: 'json' | 'markdown' | 'plain'
+        startLine?: number
+        endLine?: number
+      }
+      header?: never
+      path: {
+        knowledgeBaseId: string
+        sourceId: string
+      }
+      cookie?: never
+    }
+    requestBody?: never
+    responses: {
+      /** @description SourceContent */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            /** Format: uuid */
+            sourceId: string
+            content: string
+            totalLines: number
+            slice: {
+              start: number
+              end: number
+            }
+          }
+          'text/markdown': string
+          'text/plain': string
+        }
+      }
+    }
+  }
+  saveConversation: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        threadId: string
+      }
+      cookie?: never
+    }
+    /** @description SaveConversationInput */
+    requestBody: {
+      content: {
+        'application/json': {
+          messages: {
+            /** @enum {string} */
+            role: 'user' | 'assistant' | 'system' | 'tool'
+            /** @default null */
+            content?: string | null
+            /** @default null */
+            toolName?: string | null
+            /**
+             * @default null
+             * @enum {string|null}
+             */
+            toolType?: 'call' | 'result' | null
+          }[]
+          modelProvider?: string
+          modelId?: string
+          /** @description ConversationTokenUsage */
+          tokenUsage?: {
+            inputTokens?: number
+            outputTokens?: number
+            totalTokens?: number
+          }
+          /** @description ConversationMetadata */
+          metadata?: {
+            [key: string]: string | string[]
+          }
+        }
+      }
+    }
+    responses: {
+      /** @description Conversation */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            id: string
+            threadId: string
+            /** @description ConversationMetadata */
+            metadata: {
+              [key: string]: string | string[]
+            } | null
+            /** Format: date-time */
+            startedAt: string
+            /** Format: date-time */
+            messagesUpdatedAt: string
+            messages: {
+              /** @enum {string} */
+              role: 'user' | 'assistant' | 'system' | 'tool'
+              /** @default null */
+              content: string | null
+              /** @default null */
+              toolName: string | null
+              /**
+               * @default null
+               * @enum {string|null}
+               */
+              toolType: 'call' | 'result' | null
+            }[]
+            modelProvider: string | null
+            modelId: string | null
+            /** @description ConversationTokenUsage */
+            tokenUsage: {
+              inputTokens?: number
+              outputTokens?: number
+              totalTokens?: number
+            } | null
+            /** @description ConversationCoreMetrics */
+            coreMetrics: {
+              successScore?: number
+              /** @enum {string} */
+              sentiment?: 'positive' | 'neutral' | 'negative'
+              contentGaps?: string[]
+            } | null
+            /** Format: date-time */
+            classifiedAt: string | null
+            classificationError: string | null
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            updatedAt: string
+          }
+        }
+      }
+    }
+  }
+  classifyConversation: {
+    parameters: {
+      query?: never
+      header?: never
+      path: {
+        threadId: string
+      }
+      cookie?: never
+    }
+    /** @description ClassifyConversationInput */
+    requestBody: {
+      content: {
+        'application/json': {
+          coreMetrics?: {
+            successScore: number
+            /** @enum {string} */
+            sentiment: 'positive' | 'neutral' | 'negative'
+            contentGaps: string[]
+          }
+          classificationError?: string
+        }
+      }
+    }
+    responses: {
+      /** @description Conversation */
+      200: {
+        headers: {
+          [name: string]: unknown
+        }
+        content: {
+          'application/json': {
+            id: string
+            threadId: string
+            /** @description ConversationMetadata */
+            metadata: {
+              [key: string]: string | string[]
+            } | null
+            /** Format: date-time */
+            startedAt: string
+            /** Format: date-time */
+            messagesUpdatedAt: string
+            messages: {
+              /** @enum {string} */
+              role: 'user' | 'assistant' | 'system' | 'tool'
+              /** @default null */
+              content: string | null
+              /** @default null */
+              toolName: string | null
+              /**
+               * @default null
+               * @enum {string|null}
+               */
+              toolType: 'call' | 'result' | null
+            }[]
+            modelProvider: string | null
+            modelId: string | null
+            /** @description ConversationTokenUsage */
+            tokenUsage: {
+              inputTokens?: number
+              outputTokens?: number
+              totalTokens?: number
+            } | null
+            /** @description ConversationCoreMetrics */
+            coreMetrics: {
+              successScore?: number
+              /** @enum {string} */
+              sentiment?: 'positive' | 'neutral' | 'negative'
+              contentGaps?: string[]
+            } | null
+            /** Format: date-time */
+            classifiedAt: string | null
+            classificationError: string | null
+            /** Format: date-time */
+            createdAt: string
+            /** Format: date-time */
+            updatedAt: string
+          }
+        }
+      }
+    }
+  }
+}