@gpt-platform/admin 0.10.3 → 0.10.4

package/dist/index.mjs

@@ -814,7 +814,7 @@ var createClient = (config = {}) => {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.10.3";
+var SDK_VERSION = "0.10.4";
 var DEFAULT_API_VERSION = "2026-03-23";
 
 // src/base-client.ts
@@ -1276,6 +1276,31 @@ var RequestBuilder = class {
       throw handleApiError(error);
     }
   }
+  /**
+   * Execute a raw POST to a custom endpoint that returns flat JSON (no data wrapper).
+   * Unlike rawPost (which unwraps data.data), this returns the response body directly.
+   * Used for hand-written Phoenix controllers like DocumentsController.
+   */
+  async rawPostDirect(url, body, options) {
+    const headers = buildHeaders(this.getHeaders, options);
+    try {
+      const result = await this.requestWithRetry(
+        () => this.clientInstance.post({
+          url,
+          headers,
+          ...body !== void 0 && { body },
+          ...options?.signal && { signal: options.signal }
+        })
+      );
+      const { data, error } = result;
+      if (error) {
+        throw handleApiError(enrichError(error, result));
+      }
+      return data;
+    } catch (error) {
+      throw handleApiError(error);
+    }
+  }
   /**
    * Execute a raw PATCH request to a custom (non-generated) endpoint.
    * Used for endpoints implemented as custom Phoenix controllers.
@@ -2103,6 +2128,11 @@ var patchAdminIsvCrmEntityTypesById = (options) => (options.client ?? client).pa
     ...options.headers
   }
 });
+var getAdminWorkspacesByWorkspaceIdTrainingAnalytics = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/workspaces/{workspace_id}/training/analytics",
+  ...options
+});
 var getAdminClinicalMealPlansByPatient = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/clinical/meal-plans/by-patient",
@@ -2861,6 +2891,25 @@ var getAdminClinicalPracticeToolsCatalogArchived = (options) => (options.client
   url: "/admin/clinical/practice-tools/catalog/archived",
   ...options
 });
+var deleteAdminPostProcessingHooksById = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/post-processing-hooks/{id}",
+  ...options
+});
+var getAdminPostProcessingHooksById = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/post-processing-hooks/{id}",
+  ...options
+});
+var patchAdminPostProcessingHooksById = (options) => (options.client ?? client).patch({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/post-processing-hooks/{id}",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var getAdminVoiceRecordingsSessionBySessionId = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/voice/recordings/session/{session_id}",
@@ -3996,6 +4045,15 @@ var getAdminEmailMarketingTemplatesWorkspaceByWorkspaceId = (options) => (option
   url: "/admin/email-marketing/templates/workspace/{workspace_id}",
   ...options
 });
+var postAdminExtractionAgentsPredict = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/extraction/agents/predict",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var postAdminSocialCampaignsByIdGenerateMasterCopy = (options) => (options.client ?? client).post({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/social/campaigns/{id}/generate-master-copy",
@@ -4173,6 +4231,11 @@ var patchAdminLegalDocumentsByIdUnpublish = (options) => (options.client ?? clie
     ...options.headers
   }
 });
+var getAdminExtractionAgents = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/extraction/agents",
+  ...options
+});
 var getAdminWalletUsage = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/wallet/usage",
@@ -4805,6 +4868,11 @@ var getAdminAgentVersionRevisionsById = (options) => (options.client ?? client).
   url: "/admin/agent-version-revisions/{id}",
   ...options
 });
+var getAdminExtractionAgentsById = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/extraction/agents/{id}",
+  ...options
+});
 var getAdminSchedulingEventsByDateRange = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/scheduling/events/by_date_range",
@@ -4953,6 +5021,11 @@ var postAdminWebhookConfigs = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var getAdminWorkspacesAnalyticsBatch = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/workspaces/analytics-batch",
+  ...options
+});
 var getAdminExtractionConfigEnums = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/extraction/config-enums",
@@ -5988,6 +6061,15 @@ var postAdminEmailMarketingTemplatesCompile = (options) => (options.client ?? cl
     ...options.headers
   }
 });
+var postAdminSocialCampaignsByIdPreviewAdaptations = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/social/campaigns/{id}/preview-adaptations",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var getAdminClinicalNotesArchived = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/clinical/notes/archived",
@@ -6607,6 +6689,20 @@ var patchAdminCrawlerSchedulesByIdEnable = (options) => (options.client ?? clien
     ...options.headers
   }
 });
+var getAdminPostProcessingHooks = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/post-processing-hooks",
+  ...options
+});
+var postAdminPostProcessingHooks = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/admin/post-processing-hooks",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var postAdminAgentsByIdAnalyzeTraining = (options) => (options.client ?? client).post({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/admin/agents/{id}/analyze-training",
@@ -9756,6 +9852,21 @@ function createStorageNamespace(rb) {
           { query: { parent_id: parentId } },
           options
         );
+      },
+      /**
+       * Generate a short-lived presigned download URL for a file.
+       *
+       * @param id - The UUID of the file to download.
+       * @param params - Optional parameters (e.g., custom `expires_in` seconds).
+       * @param options - Optional request options.
+       * @returns A promise resolving to the presigned URL and its expiry.
+       */
+      requestDownloadUrl: async (id, params, options) => {
+        return rb.rawPostDirect(
+          `/isv/storage-files/${id}/download-url`,
+          params?.expires_in != null ? { data: { expires_in: params.expires_in } } : void 0,
+          options
+        );
       }
     },
     /**
@@ -13344,6 +13455,32 @@ function createSocialNamespace(rb) {
           },
           options
         );
+      },
+      /**
+       * Preview adapted copy per platform without creating SocialPost records.
+       *
+       * Returns the AI-adapted text for each target platform so the user can
+       * review before committing via `adaptForPlatforms`.
+       *
+       * @param id - Campaign UUID.
+       * @param workspaceId - Workspace UUID.
+       * @param options - Optional request options.
+       * @returns `{ adaptations: [{ platform: string, content: string }] }`
+       */
+      previewAdaptations: async (id, workspaceId, options) => {
+        return rb.execute(
+          postAdminSocialCampaignsByIdPreviewAdaptations,
+          {
+            path: { id },
+            body: {
+              data: {
+                campaign_id: id,
+                workspace_id: workspaceId
+              }
+            }
+          },
+          options
+        );
       }
     },
     /** Trending content discovery — snapshots, items, and watch alerts. */
@@ -13946,7 +14083,17 @@ function createExtractionNamespace(rb) {
   return {
     /** Document lifecycle — upload, process, review, train, bulk operations. */
     documents: {
-      /** List all extraction documents. */
+      /**
+       * Lists all extraction documents across the platform.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction document objects.
+       *
+       * @example
+       * ```typescript
+       * const docs = await admin.extraction.documents.list();
+       * ```
+       */
       list: async (options) => {
         return rb.execute(
           getAdminExtractionDocuments,
@@ -13954,7 +14101,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get a document by ID. */
+      /**
+       * Retrieves a single extraction document by its unique identifier.
+       *
+       * @param id - The UUID of the document to retrieve.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching extraction document object.
+       *
+       * @example
+       * ```typescript
+       * const doc = await admin.extraction.documents.get('doc-uuid');
+       * console.log(doc.status, doc.filename);
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
           getAdminExtractionDocumentsById,
@@ -13962,7 +14121,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Delete a document. */
+      /**
+       * Permanently deletes an extraction document and its associated results.
+       *
+       * @param id - The UUID of the document to delete.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns `true` when the deletion succeeds.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.documents.delete('doc-uuid');
+       * ```
+       */
       delete: async (id, options) => {
         return rb.executeDelete(
           deleteAdminExtractionDocumentsById,
@@ -13970,7 +14140,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get the rendered view of a document. */
+      /**
+       * Retrieves the rendered view of a document, including page images and
+       * overlay data for visual inspection.
+       *
+       * @param id - The UUID of the document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The document object with rendered view data.
+       *
+       * @example
+       * ```typescript
+       * const view = await admin.extraction.documents.view('doc-uuid');
+       * ```
+       */
       view: async (id, options) => {
         return rb.execute(
           getAdminExtractionDocumentsByIdView,
@@ -13978,7 +14160,20 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get document processing status. */
+      /**
+       * Retrieves the current processing status of a document, including
+       * progress percentage and any error details.
+       *
+       * @param id - The UUID of the document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The document object with current status fields.
+       *
+       * @example
+       * ```typescript
+       * const { status, progress_percent } = await admin.extraction.documents.status('doc-uuid');
+       * console.log(`Status: ${status} (${progress_percent}%)`);
+       * ```
+       */
       status: async (id, options) => {
         return rb.execute(
           getAdminExtractionDocumentsByIdStatus,
@@ -13986,7 +14181,22 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Update document processing status. */
+      /**
+       * Updates the processing status of a document. Used by admin tooling to
+       * manually transition a document between pipeline states.
+       *
+       * @param id - The UUID of the document to update.
+       * @param attributes - The status attributes to set.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction document object.
+       *
+       * @example
+       * ```typescript
+       * const doc = await admin.extraction.documents.updateStatus('doc-uuid', {
+       *   status: 'completed',
+       * });
+       * ```
+       */
       updateStatus: async (id, attributes, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdStatus,
@@ -13999,7 +14209,20 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Reprocess a completed document. */
+      /**
+       * Reprocesses a completed or failed document through the extraction
+       * pipeline from scratch.
+       *
+       * @param id - The UUID of the document to reprocess.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The document object with its new processing status.
+       *
+       * @example
+       * ```typescript
+       * const doc = await admin.extraction.documents.reprocess('doc-uuid');
+       * console.log(`Reprocessing: ${doc.status}`);
+       * ```
+       */
       reprocess: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdReprocess,
@@ -14007,7 +14230,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Cancel a queued or processing document. */
+      /**
+       * Cancels a document that is currently queued or being processed.
+       *
+       * @param id - The UUID of the document to cancel.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The document object with its updated (cancelled) status.
+       *
+       * @example
+       * ```typescript
+       * const doc = await admin.extraction.documents.cancel('doc-uuid');
+       * ```
+       */
       cancel: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdCancel,
@@ -14015,7 +14249,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Dismiss a document from the review queue. */
+      /**
+       * Dismisses a document from the review queue without changing its
+       * underlying data or verification status.
+       *
+       * @param id - The UUID of the document to dismiss.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction document object.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.documents.dismiss('doc-uuid');
+       * ```
+       */
       dismiss: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdDismiss,
@@ -14023,7 +14269,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Exclude a document from training. */
+      /**
+       * Excludes a document from the training dataset. Excluded documents are
+       * not used when retraining extraction models.
+       *
+       * @param id - The UUID of the document to exclude.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction document object.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.documents.exclude('doc-uuid');
+       * ```
+       */
       exclude: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdExclude,
@@ -14031,7 +14289,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Re-include a previously excluded document. */
+      /**
+       * Re-includes a previously excluded document in the training dataset.
+       *
+       * @param id - The UUID of the document to include.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction document object.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.documents.include('doc-uuid');
+       * ```
+       */
       include: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdInclude,
@@ -14039,7 +14308,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Restore a soft-deleted document. */
+      /**
+       * Restores a soft-deleted (trashed) document back to active status.
+       *
+       * @param id - The UUID of the document to restore.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The restored extraction document object.
+       *
+       * @example
+       * ```typescript
+       * const doc = await admin.extraction.documents.restore('doc-uuid');
+       * console.log(`Restored: ${doc.filename}`);
+       * ```
+       */
       restore: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdRestore,
@@ -14047,7 +14328,23 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Update verification status of a document. */
+      /**
+       * Updates the verification status of a document. Used during the human
+       * review step to confirm or reject extracted data.
+       *
+       * @param id - The UUID of the document to update.
+       * @param attributes - Verification attributes to set.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction document object.
+       *
+       * @example
+       * ```typescript
+       * const doc = await admin.extraction.documents.updateVerification('doc-uuid', {
+       *   verification_status: 'verified',
+       *   avg_confidence: 0.95,
+       * });
+       * ```
+       */
       updateVerification: async (id, attributes, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdVerification,
@@ -14060,7 +14357,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Mark a document as trained. */
+      /**
+       * Marks a document as trained, indicating its extraction results have been
+       * incorporated into the model training set.
+       *
+       * @param id - The UUID of the document to mark as trained.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction document object.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.documents.markTrained('doc-uuid');
+       * ```
+       */
       markTrained: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdMarkTrained,
@@ -14068,7 +14377,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Dismiss training flag on a document. */
+      /**
+       * Dismisses the training flag on a document without un-training it.
+       * Useful for clearing training notifications in the review UI.
+       *
+       * @param id - The UUID of the document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction document object.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.documents.dismissTraining('doc-uuid');
+       * ```
+       */
       dismissTraining: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdDismissTraining,
@@ -14076,7 +14397,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Finish a multi-part upload. */
+      /**
+       * Signals the server that a multi-part upload has completed and the
+       * document is ready for processing.
+       *
+       * @param id - The UUID of the document whose upload is being finalized.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The document object transitioned to processing state.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.documents.finishUpload('doc-uuid');
+       * ```
+       */
       finishUpload: async (id, options) => {
         return rb.execute(
           patchAdminExtractionDocumentsByIdFinishUpload,
@@ -14084,31 +14417,82 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Begin a new document upload and get a presigned URL. */
+      /**
+       * Begins a new document upload and returns a presigned URL for direct
+       * browser-to-storage upload.
+       *
+       * @param attributes - Upload attributes including the filename and optional metadata.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns A presigned URL object for uploading the file.
+       *
+       * @example
+       * ```typescript
+       * const presigned = await admin.extraction.documents.beginUpload({
+       *   filename: 'invoice-2026.pdf',
+       *   content_type: 'application/pdf',
+       *   agent_id: 'agent-uuid',
+       *   workspace_id: 'ws-uuid',
+       * });
+       * // Upload file to presigned.upload_url
+       * ```
+       */
       beginUpload: async (attributes, options) => {
         return rb.execute(
           postAdminExtractionDocumentsBeginUpload,
           {
             body: {
-              data: { type: "presigned-url", attributes }
+              data: { type: "extraction-document", attributes }
             }
           },
           options
         );
       },
-      /** Find an existing document by hash or begin a new upload. */
+      /**
+       * Finds an existing document by file hash (for deduplication) or begins a
+       * new upload if no match is found.
+       *
+       * @param attributes - Attributes for finding or beginning the upload.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns A presigned URL object (or a reference to the existing document).
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.documents.findOrBeginUpload({
+       *   file_hash: 'sha256:abc123...',
+       *   filename: 'invoice-2026.pdf',
+       *   content_type: 'application/pdf',
+       * });
+       * ```
+       */
       findOrBeginUpload: async (attributes, options) => {
         return rb.execute(
           postAdminExtractionDocumentsFindOrBeginUpload,
           {
             body: {
-              data: { type: "presigned-url", attributes }
+              data: { type: "extraction-document", attributes }
             }
           },
           options
         );
       },
-      /** Upload a document directly (single-shot). */
+      /**
+       * Uploads a document directly in a single shot. The server handles storage
+       * placement and immediately enqueues the document for processing.
+       *
+       * @param attributes - Upload attributes including filename and optional storage path.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The created extraction document object.
+       *
+       * @example
+       * ```typescript
+       * const doc = await admin.extraction.documents.upload({
+       *   filename: 'contract.pdf',
+       *   content_type: 'application/pdf',
+       *   agent_id: 'agent-uuid',
+       *   workspace_id: 'ws-uuid',
+       * });
+       * ```
+       */
       upload: async (attributes, options) => {
         return rb.execute(
           postAdminExtractionDocumentsUpload,
@@ -14120,7 +14504,22 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Bulk reprocess multiple documents. */
+      /**
+       * Reprocesses multiple documents in a single bulk operation.
+       *
+       * @param ids - An array of document UUIDs to reprocess.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An operation success result with the count of enqueued documents.
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.documents.bulkReprocess([
+       *   'doc-uuid-1',
+       *   'doc-uuid-2',
+       * ]);
+       * console.log(`Enqueued: ${result.enqueued_count}`);
+       * ```
+       */
       bulkReprocess: async (ids, options) => {
         return rb.execute(
           postAdminExtractionDocumentsBulkReprocess,
@@ -14128,30 +14527,67 @@ function createExtractionNamespace(rb) {
             body: {
               data: {
                 type: "bulk-reprocess-result",
-                attributes: { ids }
+                attributes: { document_ids: ids }
               }
             }
           },
           options
         );
       },
-      /** Bulk delete multiple documents. */
+      /**
+       * Permanently deletes multiple documents in a single bulk operation.
+       *
+       * @param ids - An array of document UUIDs to delete.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An operation success result with the count of deleted documents.
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.documents.bulkDelete([
+       *   'doc-uuid-1',
+       *   'doc-uuid-2',
+       * ]);
+       * console.log(`Deleted: ${result.deleted_count}`);
+       * ```
+       */
       bulkDelete: async (ids, options) => {
         return rb.execute(
           postAdminDocumentsBulkDelete,
           {
             body: {
-              data: { type: "bulk-delete", attributes: { ids } }
+              data: { type: "operation-success", attributes: { ids } }
             }
           },
           options
         );
       },
-      /** Get platform-wide document statistics. */
+      /**
+       * Retrieves platform-wide document statistics including counts by status.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns Aggregate document statistics.
+       *
+       * @example
+       * ```typescript
+       * const stats = await admin.extraction.documents.stats();
+       * console.log(`Total: ${stats.total}, Failed: ${stats.failed}`);
+       * ```
+       */
       stats: async (options) => {
         return rb.execute(getAdminDocumentsStats, {}, options);
       },
-      /** List documents for a specific workspace. */
+      /**
+       * Lists all extraction documents belonging to a specific workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction documents for the workspace.
+       *
+       * @example
+       * ```typescript
+       * const docs = await admin.extraction.documents.listByWorkspace('ws-uuid');
+       * ```
+       */
       listByWorkspace: async (workspaceId, options) => {
         return rb.execute(
           getAdminExtractionDocumentsWorkspaceByWorkspaceId,
@@ -14159,7 +14595,20 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List documents by status for a workspace. */
+      /**
+       * Lists documents filtered by processing status within a workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param status - The processing status to filter by (e.g. `"completed"`, `"failed"`).
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction documents matching the status filter.
+       *
+       * @example
+       * ```typescript
+       * const failed = await admin.extraction.documents.listByStatus('ws-uuid', 'failed');
+       * console.log(`${failed.length} failed documents`);
+       * ```
+       */
       listByStatus: async (workspaceId, status, options) => {
         return rb.execute(
           getAdminExtractionDocumentsWorkspaceByWorkspaceIdByStatusByStatus,
@@ -14167,7 +14616,20 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get the review queue for a workspace. */
+      /**
+       * Returns the review queue for a workspace — documents awaiting human
+       * verification of their extraction results.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of documents in the review queue.
+       *
+       * @example
+       * ```typescript
+       * const queue = await admin.extraction.documents.reviewQueue('ws-uuid');
+       * console.log(`${queue.length} documents awaiting review`);
+       * ```
+       */
       reviewQueue: async (workspaceId, options) => {
         return rb.execute(
           getAdminExtractionDocumentsWorkspaceByWorkspaceIdReviewQueue,
@@ -14175,7 +14637,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List trained documents for a workspace. */
+      /**
+       * Lists documents that have been marked as trained within a workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of trained extraction documents.
+       *
+       * @example
+       * ```typescript
+       * const trained = await admin.extraction.documents.listTrained('ws-uuid');
+       * ```
+       */
       listTrained: async (workspaceId, options) => {
         return rb.execute(
           getAdminExtractionDocumentsWorkspaceByWorkspaceIdTrained,
@@ -14183,7 +14656,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List trashed (soft-deleted) documents for a workspace. */
+      /**
+       * Lists soft-deleted (trashed) documents for a workspace. These can be
+       * restored via the `restore` method.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of trashed extraction documents.
+       *
+       * @example
+       * ```typescript
+       * const trashed = await admin.extraction.documents.listTrashed('ws-uuid');
+       * ```
+       */
       listTrashed: async (workspaceId, options) => {
         return rb.execute(
           getAdminExtractionDocumentsWorkspaceByWorkspaceIdTrashed,
@@ -14191,7 +14676,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List excluded documents for a workspace. */
+      /**
+       * Lists documents that have been excluded from the training dataset
+       * within a workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of excluded extraction documents.
+       *
+       * @example
+       * ```typescript
+       * const excluded = await admin.extraction.documents.listExcluded('ws-uuid');
+       * ```
+       */
       listExcluded: async (workspaceId, options) => {
         return rb.execute(
           getAdminExtractionDocumentsWorkspaceByWorkspaceIdExcluded,
@@ -14199,7 +14696,20 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Dismiss all trained documents in a workspace. */
+      /**
+       * Dismisses all trained-flagged documents in a workspace in one operation.
+       * Useful for clearing training notifications after a batch review.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An operation success result with the dismissed count.
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.documents.dismissAllTrained('ws-uuid');
+       * console.log(`Dismissed ${result.dismissed_count} documents`);
+       * ```
+       */
       dismissAllTrained: async (workspaceId, options) => {
         return rb.execute(
           postAdminWorkspacesByWorkspaceIdExtractionDocumentsDismissAllTrained,
@@ -14213,7 +14723,17 @@ function createExtractionNamespace(rb) {
     },
     /** Extraction result management — CRUD, history, corrections, regeneration. */
     results: {
-      /** List all extraction results. */
+      /**
+       * Lists all extraction results across the platform.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction result objects.
+       *
+       * @example
+       * ```typescript
+       * const results = await admin.extraction.results.list();
+       * ```
+       */
       list: async (options) => {
         return rb.execute(
           getAdminExtractionResults,
@@ -14221,7 +14741,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get an extraction result by ID. */
+      /**
+       * Retrieves a single extraction result by its unique identifier.
+       *
+       * @param id - The UUID of the extraction result.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching extraction result object.
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.results.get('result-uuid');
+       * console.log(result.extracted_data);
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
           getAdminExtractionResultsById,
@@ -14229,7 +14761,21 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Update an extraction result. */
+      /**
+       * Updates an extraction result's metadata (e.g. review status).
+       *
+       * @param id - The UUID of the extraction result to update.
+       * @param attributes - The attributes to update.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction result object.
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.results.update('result-uuid', {
+       *   review_status: 'approved',
+       * });
+       * ```
+       */
       update: async (id, attributes, options) => {
         return rb.execute(
           patchAdminExtractionResultsById,
@@ -14242,7 +14788,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Delete an extraction result. */
+      /**
+       * Permanently deletes an extraction result.
+       *
+       * @param id - The UUID of the extraction result to delete.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns `true` when the deletion succeeds.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.results.delete('result-uuid');
+       * ```
+       */
       delete: async (id, options) => {
         return rb.executeDelete(
           deleteAdminExtractionResultsById,
@@ -14250,7 +14807,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get extraction results for a specific document. */
+      /**
+       * Retrieves all extraction results for a specific document.
+       *
+       * @param documentId - The UUID of the parent document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction results for the document.
+       *
+       * @example
+       * ```typescript
+       * const results = await admin.extraction.results.byDocument('doc-uuid');
+       * ```
+       */
       byDocument: async (documentId, options) => {
         return rb.execute(
           getAdminExtractionResultsDocumentByDocumentId,
@@ -14258,7 +14826,20 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get extraction result version history for a document. */
+      /**
+       * Retrieves the version history of extraction results for a document,
+       * showing how results have changed over reprocessing cycles.
+       *
+       * @param documentId - The UUID of the parent document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of historical extraction result versions.
+       *
+       * @example
+       * ```typescript
+       * const history = await admin.extraction.results.history('doc-uuid');
+       * console.log(`${history.length} result versions`);
+       * ```
+       */
       history: async (documentId, options) => {
         return rb.execute(
           getAdminExtractionResultsDocumentByDocumentIdHistory,
@@ -14266,7 +14847,19 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get partial extraction results for a document (in-progress). */
+      /**
+       * Retrieves partial (in-progress) extraction results for a document that
+       * is still being processed.
+       *
+       * @param documentId - The UUID of the parent document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of partial extraction results available so far.
+       *
+       * @example
+       * ```typescript
+       * const partial = await admin.extraction.results.partial('doc-uuid');
+       * ```
+       */
       partial: async (documentId, options) => {
         return rb.execute(
           getAdminExtractionResultsDocumentByDocumentIdPartial,
@@ -14274,7 +14867,23 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Regenerate an extraction result with optional feedback. */
+      /**
+       * Regenerates an extraction result, optionally incorporating human
+       * feedback or restricting which fields to retry.
+       *
+       * @param id - The UUID of the extraction result to regenerate.
+       * @param attributes - Regeneration parameters (feedback, fields to retry).
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The regenerated extraction result object.
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.results.regenerate('result-uuid', {
+       *   feedback: 'The date field was parsed incorrectly.',
+       *   fields_to_retry: ['invoice_date', 'due_date'],
+       * });
+       * ```
+       */
       regenerate: async (id, attributes, options) => {
         return rb.execute(
           patchAdminExtractionResultsByIdRegenerate,
@@ -14287,7 +14896,25 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Save manual corrections to an extraction result. */
+      /**
+       * Saves manual corrections to an extraction result. The corrections are
+       * stored alongside the original data and can be used for model training.
+       *
+       * @param id - The UUID of the extraction result to correct.
+       * @param attributes - The corrections to save.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction result object with corrections applied.
+       *
+       * @example
+       * ```typescript
+       * const result = await admin.extraction.results.saveCorrections('result-uuid', {
+       *   corrections: [
+       *     { field: 'invoice_number', value: 'INV-2026-001' },
+       *     { field: 'total_amount', value: 1250.00 },
+       *   ],
+       * });
+       * ```
+       */
       saveCorrections: async (id, attributes, options) => {
         return rb.execute(
           patchAdminExtractionResultsByIdSaveCorrections,
@@ -14300,7 +14927,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List extraction results for a workspace. */
+      /**
+       * Lists all extraction results belonging to a specific workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction results for the workspace.
+       *
+       * @example
+       * ```typescript
+       * const results = await admin.extraction.results.listByWorkspace('ws-uuid');
+       * ```
+       */
       listByWorkspace: async (workspaceId, options) => {
         return rb.execute(
           getAdminExtractionResultsWorkspaceByWorkspaceId,
@@ -14311,7 +14949,19 @@ function createExtractionNamespace(rb) {
     },
     /** Batch upload management — create batches, get upload URLs. */
     batches: {
-      /** Get a batch by ID. */
+      /**
+       * Retrieves a single extraction batch by its unique identifier.
+       *
+       * @param id - The UUID of the batch.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching extraction batch object.
+       *
+       * @example
+       * ```typescript
+       * const batch = await admin.extraction.batches.get('batch-uuid');
+       * console.log(`Batch: ${batch.name}, ${batch.document_count} docs`);
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
           getAdminExtractionBatchesById,
@@ -14319,7 +14969,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Delete a batch. */
+      /**
+       * Permanently deletes an extraction batch.
+       *
+       * @param id - The UUID of the batch to delete.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns `true` when the deletion succeeds.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.batches.delete('batch-uuid');
+       * ```
+       */
       delete: async (id, options) => {
         return rb.executeDelete(
           deleteAdminExtractionBatchesById,
@@ -14327,7 +14988,22 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Create a new batch. */
+      /**
+       * Creates a new extraction batch for grouping document uploads.
+       *
+       * @param attributes - Batch creation attributes including workspace ID.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The newly created extraction batch object.
+       *
+       * @example
+       * ```typescript
+       * const batch = await admin.extraction.batches.create({
+       *   name: 'Q1 Invoices',
+       *   workspace_id: 'ws-uuid',
+       *   agent_id: 'agent-uuid',
+       * });
+       * ```
+       */
       create: async (attributes, options) => {
         return rb.execute(
           postAdminExtractionBatches,
@@ -14339,7 +15015,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List batches for a workspace. */
+      /**
+       * Lists all extraction batches belonging to a specific workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction batches for the workspace.
+       *
+       * @example
+       * ```typescript
+       * const batches = await admin.extraction.batches.listByWorkspace('ws-uuid');
+       * ```
+       */
       listByWorkspace: async (workspaceId, options) => {
         return rb.execute(
           getAdminExtractionBatchesWorkspaceByWorkspaceId,
@@ -14347,7 +15034,24 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get presigned upload URLs for a batch. */
+      /**
+       * Retrieves presigned upload URLs for all documents in a batch, enabling
+       * parallel direct-to-storage uploads.
+       *
+       * @param id - The UUID of the batch.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of presigned URL objects, one per document slot.
+       *
+       * @example
+       * ```typescript
+       * const urls = await admin.extraction.batches.getUploadUrls('batch-uuid');
+       * // Upload files in parallel to each presigned URL
+       * await Promise.all(urls.map((u, i) => fetch(u.upload_url, {
+       *   method: 'PUT',
+       *   body: files[i],
+       * })));
+       * ```
+       */
       getUploadUrls: async (id, options) => {
         return rb.execute(
           getAdminExtractionBatchesByIdUploadUrls,
@@ -14358,7 +15062,18 @@ function createExtractionNamespace(rb) {
     },
     /** Export management — create and retrieve data exports. */
     exports: {
-      /** List exports for a workspace. */
+      /**
+       * Lists all extraction exports for a workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction export objects.
+       *
+       * @example
+       * ```typescript
+       * const exports = await admin.extraction.exports.list('ws-uuid');
+       * ```
+       */
       list: async (workspaceId, options) => {
         return rb.execute(
           getAdminWorkspacesByWorkspaceIdExtractionExports,
@@ -14366,7 +15081,23 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Create a new export for a workspace. */
+      /**
+       * Creates a new data export for a workspace in the specified format.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param attributes - Export creation attributes including format.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The newly created extraction export object.
+       *
+       * @example
+       * ```typescript
+       * const exp = await admin.extraction.exports.create('ws-uuid', {
+       *   format: 'csv',
+       *   agent_id: 'agent-uuid',
+       * });
+       * console.log(`Export ${exp.id} created, status: ${exp.status}`);
+       * ```
+       */
       create: async (workspaceId, attributes, options) => {
         return rb.execute(
           postAdminWorkspacesByWorkspaceIdExtractionExports,
@@ -14379,7 +15110,23 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get an export by ID. */
+      /**
+       * Retrieves a single extraction export by ID within a workspace.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param id - The UUID of the export to retrieve.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching extraction export object, including download URL
+       *   when the export is complete.
+       *
+       * @example
+       * ```typescript
+       * const exp = await admin.extraction.exports.get('ws-uuid', 'export-uuid');
+       * if (exp.status === 'completed') {
+       *   console.log(`Download: ${exp.download_url}`);
+       * }
+       * ```
+       */
       get: async (workspaceId, id, options) => {
         return rb.execute(
           getAdminWorkspacesByWorkspaceIdExtractionExportsById,
@@ -14390,7 +15137,17 @@ function createExtractionNamespace(rb) {
     },
     /** Workflow management — configurable extraction pipelines. */
     workflows: {
-      /** List all extraction workflows. */
+      /**
+       * Lists all extraction workflows across the platform.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction workflow objects.
+       *
+       * @example
+       * ```typescript
+       * const workflows = await admin.extraction.workflows.list();
+       * ```
+       */
       list: async (options) => {
         return rb.execute(
           getAdminExtractionWorkflows,
@@ -14398,7 +15155,21 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Create a new extraction workflow. */
+      /**
+       * Creates a new extraction workflow with the specified configuration.
+       *
+       * @param attributes - Workflow creation attributes including name.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The newly created extraction workflow object.
+       *
+       * @example
+       * ```typescript
+       * const workflow = await admin.extraction.workflows.create({
+       *   name: 'Invoice Processing',
+       *   workspace_id: 'ws-uuid',
+       * });
+       * ```
+       */
       create: async (attributes, options) => {
         return rb.execute(
           postAdminExtractionWorkflows,
@@ -14410,7 +15181,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get a workflow by ID. */
+      /**
+       * Retrieves a single extraction workflow by its unique identifier.
+       *
+       * @param id - The UUID of the workflow.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching extraction workflow object.
+       *
+       * @example
+       * ```typescript
+       * const workflow = await admin.extraction.workflows.get('workflow-uuid');
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
           getAdminExtractionWorkflowsById,
@@ -14418,7 +15200,21 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Update a workflow. */
+      /**
+       * Updates an existing extraction workflow's configuration.
+       *
+       * @param id - The UUID of the workflow to update.
+       * @param attributes - The attributes to update.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated extraction workflow object.
+       *
+       * @example
+       * ```typescript
+       * const workflow = await admin.extraction.workflows.update('workflow-uuid', {
+       *   name: 'Updated Invoice Pipeline',
+       * });
+       * ```
+       */
       update: async (id, attributes, options) => {
         return rb.execute(
           patchAdminExtractionWorkflowsById,
@@ -14431,7 +15227,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Delete a workflow. */
+      /**
+       * Permanently deletes an extraction workflow.
+       *
+       * @param id - The UUID of the workflow to delete.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns `true` when the deletion succeeds.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.workflows.delete('workflow-uuid');
+       * ```
+       */
       delete: async (id, options) => {
         return rb.executeDelete(
           deleteAdminExtractionWorkflowsById,
@@ -14442,7 +15249,18 @@ function createExtractionNamespace(rb) {
     },
     /** Config enum management — dropdown and validation values. */
     configEnums: {
-      /** List all config enums. */
+      /**
+       * Lists all config enums used for extraction field validation and
+       * dropdown options.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of config enum objects.
+       *
+       * @example
+       * ```typescript
+       * const enums = await admin.extraction.configEnums.list();
+       * ```
+       */
       list: async (options) => {
         return rb.execute(
           getAdminExtractionConfigEnums,
@@ -14450,7 +15268,23 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Create a new config enum. */
+      /**
+       * Creates a new config enum value for use in extraction field dropdowns
+       * and validation.
+       *
+       * @param attributes - Config enum creation attributes.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The newly created config enum object.
+       *
+       * @example
+       * ```typescript
+       * const enumVal = await admin.extraction.configEnums.create({
+       *   type: 'document_category',
+       *   value: 'invoice',
+       *   label: 'Invoice',
+       * });
+       * ```
+       */
       create: async (attributes, options) => {
         return rb.execute(
           postAdminExtractionConfigEnums,
@@ -14462,7 +15296,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get a config enum by ID. */
+      /**
+       * Retrieves a single config enum by its unique identifier.
+       *
+       * @param id - The UUID of the config enum.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching config enum object.
+       *
+       * @example
+       * ```typescript
+       * const enumVal = await admin.extraction.configEnums.get('enum-uuid');
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
           getAdminExtractionConfigEnumsById,
@@ -14470,7 +15315,21 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Update a config enum. */
+      /**
+       * Updates an existing config enum's label or other mutable attributes.
+       *
+       * @param id - The UUID of the config enum to update.
+       * @param attributes - The attributes to update.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated config enum object.
+       *
+       * @example
+       * ```typescript
+       * const enumVal = await admin.extraction.configEnums.update('enum-uuid', {
+       *   label: 'Updated Label',
+       * });
+       * ```
+       */
       update: async (id, attributes, options) => {
         return rb.execute(
           patchAdminExtractionConfigEnumsById,
@@ -14486,132 +15345,530 @@ function createExtractionNamespace(rb) {
     },
     /** Schema discovery — AI-powered field schema detection. */
     schemaDiscoveries: {
-      /** Run schema discovery on documents. */
+      /**
+       * Runs schema discovery on documents to automatically detect extraction
+       * field schemas using AI.
+       *
+       * @param attributes - Schema discovery attributes (document or workspace scope).
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The created schema discovery object with detected fields.
+       *
+       * @example
+       * ```typescript
+       * const discovery = await admin.extraction.schemaDiscoveries.create({
+       *   document_id: 'doc-uuid',
+       *   workspace_id: 'ws-uuid',
+       * });
+       * console.log(discovery.suggested_fields);
+       * ```
+       */
+      create: async (attributes, options) => {
+        return rb.execute(
+          postAdminExtractionSchemaDiscoveries,
+          {
+            body: {
+              data: { type: "schema-discovery", attributes }
+            }
+          },
+          options
+        );
+      },
+      /**
+       * Retrieves a schema discovery result by its unique identifier.
+       *
+       * @param id - The UUID of the schema discovery.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching schema discovery object.
+       *
+       * @example
+       * ```typescript
+       * const discovery = await admin.extraction.schemaDiscoveries.get('discovery-uuid');
+       * ```
+       */
+      get: async (id, options) => {
+        return rb.execute(
+          getAdminExtractionSchemaDiscoveriesById,
+          { path: { id } },
+          options
+        );
+      },
+      /**
+       * Bootstraps schema discovery for a workspace, analyzing existing
+       * documents to suggest an initial extraction schema.
+       *
+       * @param attributes - Bootstrap attributes (workspace scope).
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The bootstrapped schema discovery object.
+       *
+       * @example
+       * ```typescript
+       * const discovery = await admin.extraction.schemaDiscoveries.bootstrap({
+       *   workspace_id: 'ws-uuid',
+       * });
+       * ```
+       */
+      bootstrap: async (attributes, options) => {
+        return rb.execute(
+          postAdminExtractionSchemaDiscoveriesBootstrap,
+          {
+            body: {
+              data: { type: "schema-discovery", attributes }
+            }
+          },
+          options
+        );
+      }
+    },
+    /** Field mapping — document-to-schema field alignment. */
+    fieldMappings: {
+      /**
+       * Retrieves the current field mapping for a document within a workspace,
+       * showing how extracted fields align with the schema.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param documentId - The UUID of the document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The field mapping result for the document.
+       *
+       * @example
+       * ```typescript
+       * const mapping = await admin.extraction.fieldMappings.get('ws-uuid', 'doc-uuid');
+       * console.log(mapping.mappings);
+       * ```
+       */
+      get: async (workspaceId, documentId, options) => {
+        return rb.execute(
+          getAdminWorkspacesByWorkspaceIdExtractionByDocumentIdMapping,
+          { path: { workspace_id: workspaceId, document_id: documentId } },
+          options
+        );
+      },
+      /**
+       * Creates or updates the field mapping for a document, confirming how
+       * extracted fields should map to schema fields.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param documentId - The UUID of the document.
+       * @param attributes - The mapping attributes including confirmation and mappings.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The created or updated field mapping result.
+       *
+       * @example
+       * ```typescript
+       * const mapping = await admin.extraction.fieldMappings.create(
+       *   'ws-uuid',
+       *   'doc-uuid',
+       *   {
+       *     confirmed: true,
+       *     mappings: [
+       *       { source: 'inv_num', target: 'invoice_number' },
+       *       { source: 'amt', target: 'total_amount' },
+       *     ],
+       *   },
+       * );
+       * ```
+       */
+      create: async (workspaceId, documentId, attributes, options) => {
+        return rb.execute(
+          postAdminWorkspacesByWorkspaceIdExtractionByDocumentIdMapping,
+          {
+            path: { workspace_id: workspaceId, document_id: documentId },
+            body: {
+              data: { type: "field-mapping-result", attributes }
+            }
+          },
+          options
+        );
+      }
+    },
+    /** Shadow comparison results — primary vs shadow extractor quality metrics. */
+    shadowComparisons: {
+      /**
+       * Lists all shadow comparison records across the platform.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of shadow comparison objects.
+       *
+       * @example
+       * ```typescript
+       * const comparisons = await admin.extraction.shadowComparisons.list();
+       * ```
+       */
+      list: async (options) => {
+        return rb.execute(
+          getAdminExtractionShadowComparisons,
+          {},
+          options
+        );
+      },
+      /**
+       * Retrieves a single shadow comparison by its unique identifier.
+       *
+       * @param id - The UUID of the shadow comparison.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching shadow comparison object.
+       *
+       * @example
+       * ```typescript
+       * const comparison = await admin.extraction.shadowComparisons.get('comparison-uuid');
+       * ```
+       */
+      get: async (id, options) => {
+        return rb.execute(
+          getAdminExtractionShadowComparisonsById,
+          { path: { id } },
+          options
+        );
+      },
+      /**
+       * Creates a new shadow comparison record to compare the output of the
+       * primary extractor against a shadow extractor for quality evaluation.
+       *
+       * @param attributes - Shadow comparison creation attributes.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The newly created shadow comparison object.
+       *
+       * @example
+       * ```typescript
+       * const comparison = await admin.extraction.shadowComparisons.create({
+       *   document_id: 'doc-uuid',
+       *   workspace_id: 'ws-uuid',
+       * });
+       * ```
+       */
       create: async (attributes, options) => {
         return rb.execute(
-          postAdminExtractionSchemaDiscoveries,
+          postAdminExtractionShadowComparisons,
           {
             body: {
-              data: { type: "schema-discovery", attributes }
+              data: { type: "shadow-comparison", attributes }
             }
           },
           options
         );
       },
-      /** Get a schema discovery result by ID. */
-      get: async (id, options) => {
-        return rb.execute(
-          getAdminExtractionSchemaDiscoveriesById,
+      /**
+       * Permanently deletes a shadow comparison record.
+       *
+       * @param id - The UUID of the shadow comparison to delete.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns `true` when the deletion succeeds.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.shadowComparisons.delete('comparison-uuid');
+       * ```
+       */
+      delete: async (id, options) => {
+        return rb.executeDelete(
+          deleteAdminExtractionShadowComparisonsById,
           { path: { id } },
           options
         );
       },
-      /** Bootstrap schema discovery for a workspace. */
-      bootstrap: async (attributes, options) => {
+      /**
+       * Retrieves the aggregated analysis report comparing primary vs shadow
+       * extractor performance across all shadow comparison records.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of shadow comparison analysis results.
+       *
+       * @example
+       * ```typescript
+       * const analysis = await admin.extraction.shadowComparisons.analysis();
+       * ```
+       */
+      analysis: async (options) => {
         return rb.execute(
-          postAdminExtractionSchemaDiscoveriesBootstrap,
-          {
-            body: {
-              data: { type: "schema-discovery", attributes }
-            }
-          },
+          getAdminExtractionShadowComparisonsAnalysis,
+          {},
           options
         );
       }
     },
-    /** Field mapping — document-to-schema field alignment. */
-    fieldMappings: {
-      /** Get field mapping for a document. */
-      get: async (workspaceId, documentId, options) => {
+    /** Content analysis results — PII detection, OCR quality, entity extraction. */
+    analyses: {
+      /**
+       * Lists all extraction analysis records across the platform, including
+       * PII detection results and OCR quality metrics.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction analysis objects.
+       *
+       * @example
+       * ```typescript
+       * const analyses = await admin.extraction.analyses.list();
+       * ```
+       */
+      list: async (options) => {
         return rb.execute(
-          getAdminWorkspacesByWorkspaceIdExtractionByDocumentIdMapping,
-          { path: { workspace_id: workspaceId, document_id: documentId } },
+          getAdminExtractionAnalyses,
+          {},
           options
         );
       },
-      /** Create or update field mapping for a document. */
-      create: async (workspaceId, documentId, attributes, options) => {
+      /**
+       * Retrieves a single extraction analysis by its unique identifier.
+       *
+       * @param id - The UUID of the extraction analysis.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching extraction analysis object.
+       *
+       * @example
+       * ```typescript
+       * const analysis = await admin.extraction.analyses.get('analysis-uuid');
+       * console.log(analysis.pii_detected, analysis.ocr_confidence);
+       * ```
+       */
+      get: async (id, options) => {
         return rb.execute(
-          postAdminWorkspacesByWorkspaceIdExtractionByDocumentIdMapping,
-          {
-            path: { workspace_id: workspaceId, document_id: documentId },
-            body: {
-              data: { type: "field-mapping-result", attributes }
-            }
-          },
+          getAdminExtractionAnalysesById,
+          { path: { id } },
           options
         );
       }
     },
-    /** Shadow comparison results — primary vs shadow extractor quality metrics. */
-    shadowComparisons: {
-      /** List all shadow comparisons. */
+    /** Post-processing hooks — configurable hooks that execute after extraction. */
+    postProcessingHooks: {
+      /**
+       * Lists all post-processing hooks across the platform.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of post-processing hook objects.
+       *
+       * @example
+       * ```typescript
+       * const hooks = await admin.extraction.postProcessingHooks.list();
+       * ```
+       */
       list: async (options) => {
         return rb.execute(
-          getAdminExtractionShadowComparisons,
+          getAdminPostProcessingHooks,
           {},
           options
         );
       },
-      /** Get a shadow comparison by ID. */
+      /**
+       * Retrieves a single post-processing hook by its unique identifier.
+       *
+       * @param id - The UUID of the hook.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching post-processing hook object.
+       *
+       * @example
+       * ```typescript
+       * const hook = await admin.extraction.postProcessingHooks.get('hook-uuid');
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
-          getAdminExtractionShadowComparisonsById,
+          getAdminPostProcessingHooksById,
           { path: { id } },
           options
         );
       },
-      /** Create a new shadow comparison record. */
+      /**
+       * Creates a new post-processing hook for the extraction pipeline.
+       *
+       * @param attributes - Hook creation attributes including name, trigger, and type.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The newly created post-processing hook object.
+       *
+       * @example
+       * ```typescript
+       * const hook = await admin.extraction.postProcessingHooks.create({
+       *   name: 'Notify on extraction',
+       *   trigger: 'after_extraction',
+       *   type: 'webhook',
+       *   config: { url: 'https://example.com/hook' },
+       *   workspace_id: 'ws-uuid',
+       * });
+       * ```
+       */
       create: async (attributes, options) => {
         return rb.execute(
-          postAdminExtractionShadowComparisons,
+          postAdminPostProcessingHooks,
           {
             body: {
-              data: { type: "shadow-comparison", attributes }
+              data: { type: "post-processing-hook", attributes }
+            }
+          },
+          options
+        );
+      },
+      /**
+       * Updates an existing post-processing hook's configuration.
+       *
+       * @param id - The UUID of the hook to update.
+       * @param attributes - The attributes to update.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The updated post-processing hook object.
+       *
+       * @example
+       * ```typescript
+       * const hook = await admin.extraction.postProcessingHooks.update('hook-uuid', {
+       *   enabled: false,
+       * });
+       * ```
+       */
+      update: async (id, attributes, options) => {
+        return rb.execute(
+          patchAdminPostProcessingHooksById,
+          {
+            path: { id },
+            body: {
+              data: { id, type: "post-processing-hook", attributes }
             }
           },
           options
         );
       },
-      /** Delete a shadow comparison. */
+      /**
+       * Permanently deletes a post-processing hook.
+       *
+       * @param id - The UUID of the hook to delete.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns `true` when the deletion succeeds.
+       *
+       * @example
+       * ```typescript
+       * await admin.extraction.postProcessingHooks.delete('hook-uuid');
+       * ```
+       */
       delete: async (id, options) => {
         return rb.executeDelete(
-          deleteAdminExtractionShadowComparisonsById,
+          deleteAdminPostProcessingHooksById,
           { path: { id } },
           options
         );
+      }
+    },
+    /** Training analytics — workspace-level extraction training metrics. */
+    trainingAnalytics: {
+      /**
+       * Retrieves training analytics for a specific workspace, including
+       * accuracy trends, correction counts, and low-confidence documents.
+       *
+       * @param workspaceId - The UUID of the workspace.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The training analytics object for the workspace.
+       *
+       * @example
+       * ```typescript
+       * const analytics = await admin.extraction.trainingAnalytics.forWorkspace('ws-uuid');
+       * console.log(analytics.avg_confidence, analytics.total_examples);
+       * ```
+       */
+      forWorkspace: async (workspaceId, options) => {
+        return rb.execute(
+          getAdminWorkspacesByWorkspaceIdTrainingAnalytics,
+          { path: { workspace_id: workspaceId } },
+          options
+        );
       },
-      /** Get the analysis report for shadow comparisons. */
-      analysis: async (options) => {
+      /**
+       * Retrieves training analytics for multiple workspaces in a single
+       * request (max 50). Pass workspace IDs as a comma-separated string.
+       *
+       * @param workspaceIds - Comma-separated workspace UUIDs.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of training analytics objects.
+       *
+       * @example
+       * ```typescript
+       * const batch = await admin.extraction.trainingAnalytics.batch('ws-1,ws-2,ws-3');
+       * ```
+       */
+      batch: async (workspaceIds, options) => {
         return rb.execute(
-          getAdminExtractionShadowComparisonsAnalysis,
-          {},
+          getAdminWorkspacesAnalyticsBatch,
+          { query: { workspace_ids: workspaceIds } },
           options
         );
       }
     },
-    /** Content analysis results — PII detection, OCR quality, entity extraction. */
-    analyses: {
-      /** List all extraction analyses. */
+    /** Extraction agents — list and predict best extraction agents for documents. */
+    extractionAgents: {
+      /**
+       * Lists all available extraction agents (system agents tagged with
+       * "extraction" category).
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of extraction agent objects.
+       *
+       * @example
+       * ```typescript
+       * const agents = await admin.extraction.extractionAgents.list();
+       * ```
+       */
       list: async (options) => {
         return rb.execute(
-          getAdminExtractionAnalyses,
+          getAdminExtractionAgents,
           {},
           options
         );
       },
-      /** Get an extraction analysis by ID. */
+      /**
+       * Retrieves a single extraction agent by its unique identifier.
+       *
+       * @param id - The UUID of the extraction agent.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching extraction agent object.
+       *
+       * @example
+       * ```typescript
+       * const agent = await admin.extraction.extractionAgents.get('agent-uuid');
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
-          getAdminExtractionAnalysesById,
+          getAdminExtractionAgentsById,
           { path: { id } },
           options
         );
+      },
+      /**
+       * Predicts the best extraction agent for a given document based on its
+       * name, description, or file content.
+       *
+       * @param attributes - Prediction input attributes.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns A prediction result with recommended agents.
+       *
+       * @example
+       * ```typescript
+       * const prediction = await admin.extraction.extractionAgents.predict({
+       *   name: 'invoice.pdf',
+       *   description: 'Monthly vendor invoice',
+       *   file_content: 'Invoice #12345...',
+       * });
+       * ```
+       */
+      predict: async (attributes, options) => {
+        return rb.execute(
+          postAdminExtractionAgentsPredict,
+          {
+            body: {
+              data: { type: "extraction-agent", attributes }
+            }
+          },
+          options
+        );
       }
     },
     /** Chunk-entity links — bridge between document chunks and knowledge graph entities. */
     chunkEntityLinks: {
-      /** List all chunk-entity links. */
+      /**
+       * Lists all chunk-entity links across the platform.
+       *
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of chunk-entity link objects.
+       *
+       * @example
+       * ```typescript
+       * const links = await admin.extraction.chunkEntityLinks.list();
+       * ```
+       */
       list: async (options) => {
         return rb.execute(
           getAdminExtractionChunkEntityLinks,
@@ -14619,7 +15876,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** Get a chunk-entity link by ID. */
+      /**
+       * Retrieves a single chunk-entity link by its unique identifier.
+       *
+       * @param id - The UUID of the chunk-entity link.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns The matching chunk-entity link object.
+       *
+       * @example
+       * ```typescript
+       * const link = await admin.extraction.chunkEntityLinks.get('link-uuid');
+       * ```
+       */
       get: async (id, options) => {
         return rb.execute(
           getAdminExtractionChunkEntityLinksById,
@@ -14627,7 +15895,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List links for a specific document. */
+      /**
+       * Lists all chunk-entity links for a specific document.
+       *
+       * @param documentId - The UUID of the document.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of chunk-entity links for the document.
+       *
+       * @example
+       * ```typescript
+       * const links = await admin.extraction.chunkEntityLinks.byDocument('doc-uuid');
+       * ```
+       */
       byDocument: async (documentId, options) => {
         return rb.execute(
           getAdminExtractionChunkEntityLinksDocumentByDocumentId,
@@ -14635,7 +15914,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List links for a specific chunk. */
+      /**
+       * Lists all chunk-entity links for a specific document chunk.
+       *
+       * @param documentChunkId - The UUID of the document chunk.
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of chunk-entity links for the chunk.
+       *
+       * @example
+       * ```typescript
+       * const links = await admin.extraction.chunkEntityLinks.byChunk('chunk-uuid');
+       * ```
+       */
       byChunk: async (documentChunkId, options) => {
         return rb.execute(
           getAdminExtractionChunkEntityLinksChunkByDocumentChunkId,
@@ -14643,7 +15933,18 @@ function createExtractionNamespace(rb) {
           options
         );
       },
-      /** List links for a specific entity. */
+      /**
+       * Lists all chunk-entity links for a specific knowledge graph entity.
+       *
+       * @param graphNodeId - The UUID of the graph node (entity).
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns An array of chunk-entity links for the entity.
+       *
+       * @example
+       * ```typescript
+       * const links = await admin.extraction.chunkEntityLinks.byEntity('node-uuid');
+       * ```
+       */
       byEntity: async (graphNodeId, options) => {
         return rb.execute(
           getAdminExtractionChunkEntityLinksEntityByGraphNodeId,
@@ -21080,6 +22381,72 @@ function createImportsNamespace(rb) {
   };
 }
 
+// src/namespaces/documents.ts
+function createDocumentsNamespace(rb) {
+  return {
+    /**
+     * Generate a PDF from HTML content and store it in platform Storage.
+     *
+     * Always pass `store: true` and `workspace_id` to get a JSON response with
+     * a `storage_key`. Without `store: true`, the server returns raw
+     * `application/pdf` binary which cannot be parsed as JSON by this SDK method.
+     *
+     * HTML input is capped at 2MB by the server.
+     *
+     * @param params - PDF generation parameters. Set `store: true` and provide
+     *   `workspace_id` for JSON response.
+     * @param options - Optional request options (abort signal, custom headers).
+     * @returns A storage key reference for the generated PDF.
+     *
+     * @example
+     * ```typescript
+     * const { storage_key } = await admin.documents.generatePdf({
+     *   html: '<html><body>Report</body></html>',
+     *   store: true,
+     *   workspace_id: 'ws-123',
+     * });
+     * ```
+     */
+    generatePdf: async (params, options) => {
+      return rb.rawPostDirect(
+        "/isv/documents/pdf",
+        params,
+        options
+      );
+    },
+    /**
+     * Generate a PDF from HTML and email it as an attachment.
+     *
+     * The PDF is generated server-side and delivered via platform SMTP.
+     * Optionally stores the PDF in platform Storage alongside the email delivery.
+     *
+     * If storage fails but the email succeeds, the response includes
+     * `storage_error` with the failure reason (email is still delivered).
+     *
+     * @param params - Email report parameters.
+     * @param options - Optional request options (abort signal, custom headers).
+     * @returns Delivery status, optional storage key, and any storage error.
+     *
+     * @example
+     * ```typescript
+     * const result = await admin.documents.emailReport({
+     *   html: '<html><body><h1>Q1 Summary</h1></body></html>',
+     *   to: 'finance@company.com',
+     *   subject: 'Q1 Financial Summary',
+     * });
+     * console.log(result.sent); // true
+     * ```
+     */
+    emailReport: async (params, options) => {
+      return rb.rawPostDirect(
+        "/isv/documents/pdf/email",
+        params,
+        options
+      );
+    }
+  };
+}
+
 // src/gpt-admin.ts
 var GptAdmin = class extends BaseClient {
   constructor(config) {
@@ -21096,7 +22463,7 @@ var GptAdmin = class extends BaseClient {
     this.capabilities = createCapabilitiesNamespace(rb);
     this.apiKeys = createApiKeysNamespace(rb);
     this.extraction = createExtractionNamespace(rb);
-    this.documents = this.extraction.documents;
+    this.documents = createDocumentsNamespace(rb);
     this.executions = createExecutionsNamespace(rb);
     this.storage = createStorageNamespace(rb);
     this.users = createUsersNamespace(rb);