@gpt-platform/client 0.10.3 → 0.10.5

package/dist/index.js

@@ -1339,7 +1339,7 @@ function buildUserAgent(sdkVersion, appInfo) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.10.3";
+var SDK_VERSION = "0.10.5";
 var DEFAULT_API_VERSION = "2026-03-23";
 
 // src/base-client.ts
@@ -2305,6 +2305,11 @@ var getSupportTagsWorkspaceByWorkspaceId = (options) => (options.client ?? clien
   url: "/support/tags/workspace/{workspace_id}",
   ...options
 });
+var getClinicalPatientsByIdMedications = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/patients/{id}/medications",
+  ...options
+});
 var getSearchIndexes = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/search/indexes",
@@ -2460,6 +2465,11 @@ var getExtractionBatchesWorkspaceByWorkspaceId = (options) => (options.client ??
   url: "/extraction/batches/workspace/{workspace_id}",
   ...options
 });
+var getExtractionAgents = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/extraction/agents",
+  ...options
+});
 var deleteClinicalPracticeResourcesByIdPermanent = (options) => (options.client ?? client).delete({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/clinical/practice-resources/{id}/permanent",
@@ -2651,6 +2661,15 @@ var patchInvitationsByIdRevoke = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
+var postExtractionAgentsPredict = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/extraction/agents/predict",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var getCatalogTaxonomiesApplicationByApplicationId = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/catalog/taxonomies/application/{application_id}",
@@ -3256,6 +3275,11 @@ var patchStorageFilesByIdRestore = (options) => (options.client ?? client).patch
     ...options.headers
   }
 });
+var getWorkspacesByWorkspaceIdTrainingAnalytics = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/workspaces/{workspace_id}/training/analytics",
+  ...options
+});
 var patchSocialCampaignsByIdCancel = (options) => (options.client ?? client).patch({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/social/campaigns/{id}/cancel",
@@ -5072,6 +5096,11 @@ var getAuditLogs = (options) => (options.client ?? client).get({
   url: "/audit-logs",
   ...options
 });
+var getClinicalClientMedicationsArchived = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications/archived",
+  ...options
+});
 var getEmailInclusionsEmailByOutboundEmailId = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/email/inclusions/email/{outbound_email_id}",
@@ -5666,6 +5695,15 @@ var patchApplicationsById = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
+var patchClinicalClientMedicationsByIdRestore = (options) => (options.client ?? client).patch({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications/{id}/restore",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var patchEmailOutboundEmailsByIdSchedule = (options) => (options.client ?? client).patch({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/email/outbound-emails/{id}/schedule",
@@ -6410,6 +6448,15 @@ var postContentRewriteTone = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var patchClinicalClientMedicationsByIdArchive = (options) => (options.client ?? client).patch({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications/{id}/archive",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var patchStorageFilesByIdSoftDelete = (options) => (options.client ?? client).patch({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/storage-files/{id}/soft-delete",
@@ -6722,6 +6769,20 @@ var getPlans = (options) => (options.client ?? client).get({
   url: "/plans",
   ...options
 });
+var getClinicalClientMedications = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications",
+  ...options
+});
+var postClinicalClientMedications = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var postCrmActivities = (options) => (options.client ?? client).post({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/crm/activities",
@@ -6819,6 +6880,20 @@ var patchSchedulingParticipantsByIdRespond = (options) => (options.client ?? cli
     ...options.headers
   }
 });
+var getClinicalClientMedicationsById = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications/{id}",
+  ...options
+});
+var patchClinicalClientMedicationsById = (options) => (options.client ?? client).patch({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications/{id}",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var postAgentsByIdTest = (options) => (options.client ?? client).post({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/agents/{id}/test",
@@ -7021,6 +7096,15 @@ var postUsersAuthResendConfirmation = (options) => (options.client ?? client).po
     ...options.headers
   }
 });
+var postSocialCampaignsByIdPreviewAdaptations = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/social/campaigns/{id}/preview-adaptations",
+  ...options,
+  headers: {
+    "Content-Type": "application/vnd.api+json",
+    ...options.headers
+  }
+});
 var getCrawlerResultsById = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/crawler/results/{id}",
@@ -7236,6 +7320,11 @@ var postEmailInclusions = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var deleteClinicalClientMedicationsByIdPermanent = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/clinical/client-medications/{id}/permanent",
+  ...options
+});
 var getAccessLogs = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/access-logs",
@@ -7404,6 +7493,11 @@ var postExtractionDocumentsBulkReprocess = (options) => (options.client ?? clien
     ...options.headers
   }
 });
+var getExtractionAgentsById = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/extraction/agents/{id}",
+  ...options
+});
 var getApplicationsBySlugBySlug = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/applications/by-slug/{slug}",
@@ -12577,6 +12671,18 @@ function createClinicalNamespace(rb) {
         { path: { id: patientId } },
         options
       ),
+      /**
+       * List medications for a patient (related resource).
+       *
+       * @param patientId - Patient UUID or CRM Contact UUID
+       * @param options - Request options
+       * @returns Array of {@link ClinicalClientMedication} records
+       */
+      medications: async (patientId, options) => rb.execute(
+        getClinicalPatientsByIdMedications,
+        { path: { id: patientId } },
+        options
+      ),
       /**
        * List resource assignments for a patient (related resource).
        *
@@ -13607,6 +13713,163 @@ function createClinicalNamespace(rb) {
        */
       bulkCreate: async (attrs, options) => rb.rawPost(`/clinical/client-supplements/bulk`, { data: attrs }, options).then((r) => r.data)
     },
+    /**
+     * Manage medication prescriptions for clinical patients.
+     */
+    clientMedications: {
+      /**
+       * List medication prescriptions, filtered by patient/workspace.
+       *
+       * @param params - Filter/pagination parameters
+       * @param options - Request options
+       * @returns Array of {@link ClinicalClientMedication} records
+       */
+      list: async (params, options) => rb.execute(
+        getClinicalClientMedications,
+        { query: params ?? {} },
+        options
+      ),
+      /**
+       * Get a single medication prescription by ID.
+       *
+       * @param id - ClientMedication UUID
+       * @param options - Request options
+       * @returns {@link ClinicalClientMedication} record
+       */
+      get: async (id, options) => rb.execute(
+        getClinicalClientMedicationsById,
+        { path: { id } },
+        options
+      ),
+      /**
+       * Create a new medication prescription.
+       *
+       * @param attributes - Medication creation attributes. Must include `workspace_id`,
+       *   `patient_id`, and `name`.
+       * @param options - Request options
+       * @returns Created {@link ClinicalClientMedication} record
+       */
+      create: async (attributes, options) => rb.execute(
+        postClinicalClientMedications,
+        {
+          body: { data: { type: "clinical-client-medication", attributes } }
+        },
+        options
+      ),
+      /**
+       * Update a medication prescription.
+       *
+       * @param id - ClientMedication UUID
+       * @param attributes - Fields to update (PATCH semantics)
+       * @param options - Request options
+       * @returns Updated {@link ClinicalClientMedication} record
+       */
+      update: async (id, attributes, options) => rb.execute(
+        patchClinicalClientMedicationsById,
+        {
+          path: { id },
+          body: {
+            data: { type: "clinical-client-medication", id, attributes }
+          }
+        },
+        options
+      ),
+      /**
+       * Delete (archive) a medication prescription.
+       *
+       * @deprecated Use {@link archive} instead.
+       * @param id - ClientMedication UUID
+       * @param options - Request options
+       * @returns Archived {@link ClinicalClientMedication} record
+       */
+      delete: async (id, options) => rb.execute(
+        patchClinicalClientMedicationsByIdArchive,
+        {
+          path: { id },
+          body: {
+            data: { type: "clinical-client-medication", id, attributes: {} }
+          }
+        },
+        options
+      ),
+      /**
+       * Archive (soft-delete) a medication prescription.
+       *
+       * @param id - ClientMedication UUID
+       * @param options - Request options
+       * @returns Archived {@link ClinicalClientMedication} record
+       */
+      archive: async (id, options) => rb.execute(
+        patchClinicalClientMedicationsByIdArchive,
+        {
+          path: { id },
+          body: {
+            data: { type: "clinical-client-medication", id, attributes: {} }
+          }
+        },
+        options
+      ),
+      /**
+       * Restore an archived medication prescription.
+       *
+       * @param id - ClientMedication UUID
+       * @param options - Request options
+       * @returns Restored {@link ClinicalClientMedication} record
+       */
+      restore: async (id, options) => rb.execute(
+        patchClinicalClientMedicationsByIdRestore,
+        {
+          path: { id },
+          body: {
+            data: { type: "clinical-client-medication", id, attributes: {} }
+          }
+        },
+        options
+      ),
+      /**
+       * Permanently delete a medication prescription. Irreversible.
+       *
+       * @param id - ClientMedication UUID
+       * @param options - Request options
+       * @returns `true` on success
+       */
+      permanentDelete: async (id, options) => rb.executeDelete(
+        deleteClinicalClientMedicationsByIdPermanent,
+        { path: { id } },
+        options
+      ),
+      /**
+       * List archived (soft-deleted) medication prescriptions.
+       *
+       * @param params - Filter/pagination parameters
+       * @param options - Request options
+       * @returns Array of archived {@link ClinicalClientMedication} records
+       */
+      listArchived: async (params, options) => rb.execute(
+        getClinicalClientMedicationsArchived,
+        { query: params ?? {} },
+        options
+      ),
+      /**
+       * Create multiple medications in a single request.
+       *
+       * @param attrs - Bulk creation attributes with workspace_id and medications array
+       * @param options - Request options
+       * @returns Array of creation results with id and status per medication
+       *
+       * @example
+       * ```typescript
+       * const results = await client.clinical.clientMedications.bulkCreate({
+       *   workspace_id: 'ws_123',
+       *   medications: [
+       *     { patient_id: 'pat_1', name: 'Metformin', source: 'ehr_import' },
+       *     { patient_id: 'pat_1', name: 'Lisinopril', source: 'ehr_import' },
+       *   ],
+       * });
+       * ```
+       */
+      bulkCreate: async (attrs, options) => rb.rawPost(`/clinical/client-medications/bulk`, { data: attrs }, options).then((r) => r.data)
+    },
     /**
      * Manage clinical deliveries (care plan items sent to patients).
      */
@@ -25485,6 +25748,94 @@ function createExtractionNamespace(rb) {
           options
         );
       }
+    },
+    /** 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 client.extraction.extractionAgents.list();
+       * ```
+       */
+      list: async (options) => {
+        return rb.execute(getExtractionAgents, {}, options);
+      },
+      /**
+       * 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 client.extraction.extractionAgents.get('agent-uuid');
+       * ```
+       */
+      get: async (id, options) => {
+        return rb.execute(
+          getExtractionAgentsById,
+          { path: { id } },
+          options
+        );
+      },
+      /**
+       * Predicts the best extraction agent for a given document based on its
+       * name, description, or file content.
+       *
+       * @param attributes - Prediction input (name, description, file_content, document_id).
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns A prediction result with recommended agents.
+       *
+       * @example
+       * ```typescript
+       * const prediction = await client.extraction.extractionAgents.predict({
+       *   name: 'invoice.pdf',
+       *   file_content: 'Invoice #12345...',
+       * });
+       * ```
+       */
+      predict: async (attributes, options) => {
+        return rb.execute(
+          postExtractionAgentsPredict,
+          {
+            body: {
+              data: { type: "extraction-agent", attributes }
+            }
+          },
+          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 client.extraction.trainingAnalytics.forWorkspace('ws-uuid');
+       * console.log(analytics.avg_confidence, analytics.total_examples);
+       * ```
+       */
+      forWorkspace: async (workspaceId, options) => {
+        return rb.execute(
+          getWorkspacesByWorkspaceIdTrainingAnalytics,
+          { path: { workspace_id: workspaceId } },
+          options
+        );
+      }
     }
   };
 }
@@ -30062,11 +30413,108 @@ function createStorageNamespace(rb) {
           { query: { parent_id: parentId } },
           options
         );
+      },
+      /**
+       * Generate a short-lived presigned download URL for a file.
+       *
+       * Returns a URL that can be used to download the file directly from
+       * object storage (GCS in production, MinIO in dev) without routing
+       * through the application server.
+       *
+       * @param id - The UUID of the file to download.
+       * @param params - Optional parameters (e.g., custom `expires_in` seconds).
+       * @param options - Optional request options (abort signal, custom headers).
+       * @returns A promise resolving to the presigned URL and its expiry.
+       *
+       * @example
+       * ```typescript
+       * const { url, expires_at } = await client.storage.files.requestDownloadUrl(
+       *   'file-uuid',
+       *   { expires_in: 300 }, // 5 minutes
+       * );
+       * // Redirect browser to `url` for direct download
+       * ```
+       */
+      requestDownloadUrl: async (id, params, options) => {
+        return rb.rawPostDirect(
+          `/storage-files/${id}/download-url`,
+          params?.expires_in != null ? { data: { expires_in: params.expires_in } } : void 0,
+          options
+        );
       }
     }
   };
 }
 
+// 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 client.documents.generatePdf({
+     *   html: '<html><body>Report</body></html>',
+     *   store: true,
+     *   workspace_id: 'ws-123',
+     * });
+     * ```
+     */
+    generatePdf: async (params, options) => {
+      return rb.rawPostDirect(
+        "/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 client.documents.emailReport({
+     *   html: '<html><body><h1>Q1 Summary</h1></body></html>',
+     *   to: 'finance@company.com',
+     *   subject: 'Q1 Financial Summary',
+     *   store: true,
+     *   workspace_id: 'ws-123',
+     * });
+     * console.log(result.sent); // true
+     * console.log(result.storage_key); // 'ws-123/documents/...'
+     * ```
+     */
+    emailReport: async (params, options) => {
+      return rb.rawPostDirect(
+        "/documents/pdf/email",
+        params,
+        options
+      );
+    }
+  };
+}
+
 // src/namespaces/threads.ts
 function getBrowserContext() {
   const ctx = {};
@@ -33286,6 +33734,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(
+          postSocialCampaignsByIdPreviewAdaptations,
+          {
+            path: { id },
+            body: {
+              data: {
+                campaign_id: id,
+                workspace_id: workspaceId
+              }
+            }
+          },
+          options
+        );
       }
     },
     /** Trending content discovery — snapshots, items, and watch alerts. */
@@ -33561,28 +34035,251 @@ function createCrmClustersNamespace(rb) {
   };
 }
 
+// src/namespaces/pipeline-executions.ts
+function createPipelineExecutionsNamespace(rb) {
+  return {
+    /**
+     * Get a pipeline execution by ID.
+     *
+     * @param id - Execution UUID.
+     * @param options - Optional request options.
+     * @returns PipelineExecution resource.
+     */
+    async get(id, options) {
+      return rb.rawGet(
+        `/pipeline-executions/${id}`,
+        options
+      );
+    },
+    /**
+     * List pipeline executions for a workspace.
+     *
+     * @param workspaceId - Workspace UUID to filter by.
+     * @param filters - Optional filters (status, pipeline_id).
+     * @param options - Optional request options.
+     * @returns Array of PipelineExecution resources.
+     */
+    async list(workspaceId, filters, options) {
+      const params = new URLSearchParams({ workspace_id: workspaceId });
+      if (filters?.status) params.set("filter[status]", filters.status);
+      if (filters?.pipeline_id)
+        params.set("filter[pipeline_id]", filters.pipeline_id);
+      return rb.rawGet(
+        `/pipeline-executions?${params.toString()}`,
+        options
+      );
+    },
+    /**
+     * List pipeline executions for a specific pipeline.
+     *
+     * @param pipelineId - Pipeline UUID to filter by.
+     * @param options - Optional request options.
+     * @returns Array of PipelineExecution resources for this pipeline.
+     */
+    async listByPipeline(pipelineId, options) {
+      return rb.rawGet(
+        `/pipeline-executions/by-pipeline/${pipelineId}`,
+        options
+      );
+    },
+    /**
+     * Approve the current HITL checkpoint. Pipeline resumes execution.
+     * Only valid when status === "awaiting_approval".
+     *
+     * @param id - Execution UUID.
+     * @param options - Optional request options.
+     * @returns Updated PipelineExecution resource.
+     */
+    async approve(id, options) {
+      return rb.rawPatch(
+        `/pipeline-executions/${id}/approve`,
+        {
+          data: { type: "pipeline-execution", id, attributes: {} }
+        },
+        {
+          ...options,
+          headers: {
+            "Content-Type": "application/vnd.api+json",
+            ...options?.headers
+          }
+        }
+      );
+    },
+    /**
+     * Reject the current HITL checkpoint. Pipeline halts permanently.
+     * Only valid when status === "awaiting_approval".
+     *
+     * @param id - Execution UUID.
+     * @param options - Optional request options.
+     * @returns Updated PipelineExecution resource.
+     */
+    async reject(id, options) {
+      return rb.rawPatch(
+        `/pipeline-executions/${id}/reject`,
+        {
+          data: { type: "pipeline-execution", id, attributes: {} }
+        },
+        {
+          ...options,
+          headers: {
+            "Content-Type": "application/vnd.api+json",
+            ...options?.headers
+          }
+        }
+      );
+    },
+    /**
+     * Edit checkpoint data before approving.
+     * Corrected values flow into downstream pipeline nodes.
+     * Only valid when status === "awaiting_approval".
+     *
+     * @param id - Execution UUID.
+     * @param attributes - Checkpoint data updates.
+     * @param options - Optional request options.
+     * @returns Updated PipelineExecution resource.
+     */
+    async updateCheckpoint(id, attributes, options) {
+      return rb.rawPatch(
+        `/pipeline-executions/${id}/checkpoint`,
+        {
+          data: { type: "pipeline-execution", id, attributes }
+        },
+        {
+          ...options,
+          headers: {
+            "Content-Type": "application/vnd.api+json",
+            ...options?.headers
+          }
+        }
+      );
+    },
+    /**
+     * Set the checkpoint note. Replaces any existing note.
+     * Only valid when status === "awaiting_approval".
+     *
+     * @param id - Execution UUID.
+     * @param note - Note text.
+     * @param options - Optional request options.
+     * @returns Updated PipelineExecution resource.
+     */
+    async addNote(id, note, options) {
+      return rb.rawPatch(
+        `/pipeline-executions/${id}/note`,
+        {
+          data: {
+            type: "pipeline-execution",
+            id,
+            attributes: { checkpoint_notes: note }
+          }
+        },
+        {
+          ...options,
+          headers: {
+            "Content-Type": "application/vnd.api+json",
+            ...options?.headers
+          }
+        }
+      );
+    },
+    /**
+     * Request AI refinement of a specific checkpoint node.
+     * The AI re-runs the node with the given instruction and updates checkpoint_data.
+     * Only valid when status === "awaiting_approval".
+     *
+     * @param id - Execution UUID.
+     * @param nodeId - The pipeline node ID to refine.
+     * @param instruction - Natural language instruction for refinement.
+     * @param options - Optional request options.
+     * @returns Updated PipelineExecution resource.
+     */
+    async aiRefine(id, nodeId, instruction, options) {
+      return rb.rawPatch(
+        `/pipeline-executions/${id}/refine`,
+        {
+          data: {
+            type: "pipeline-execution",
+            id,
+            attributes: { node_id: nodeId, instruction }
+          }
+        },
+        {
+          ...options,
+          headers: {
+            "Content-Type": "application/vnd.api+json",
+            ...options?.headers
+          }
+        }
+      );
+    }
+  };
+}
+
 // src/namespaces/pipelines.ts
 function createPipelinesNamespace(rb) {
   return {
+    /**
+     * List available pipelines.
+     *
+     * @param options - Optional request options.
+     * @returns Array of Pipeline resources.
+     */
+    async list(options) {
+      return rb.rawGet(`/pipelines`, options);
+    },
+    /**
+     * Get a pipeline by ID.
+     *
+     * @param id - Pipeline UUID.
+     * @param options - Optional request options.
+     * @returns Pipeline resource.
+     */
+    async get(id, options) {
+      return rb.rawGet(`/pipelines/${id}`, options);
+    },
+    /**
+     * Get a pipeline by its system slug.
+     *
+     * @param slug - Pipeline system_slug.
+     * @param options - Optional request options.
+     * @returns Pipeline resource.
+     */
+    async getBySlug(slug, options) {
+      return rb.rawGet(`/pipelines/by-slug/${slug}`, options);
+    },
     /**
      * Trigger pipeline execution.
      *
      * @param id - Pipeline UUID.
-     * @param attributes - Execution parameters including workspace_id and input.
+     * @param attributes - Execution parameters including workspace_id and optional input.
      * @param options - Optional request options.
-     * @returns Pipeline execution result map.
+     * @returns Trigger response with execution_id and status.
      */
     async trigger(id, attributes, options) {
-      return rb.rawPost(
+      return rb.rawPostDirect(
         `/pipelines/${id}/trigger`,
         {
-          data: {
-            type: "pipeline",
-            attributes: {
-              pipeline_id: id,
-              ...attributes
-            }
-          }
+          workspace_id: attributes.workspace_id,
+          ...attributes.input ? { input: attributes.input } : {}
+        },
+        options
+      );
+    },
+    /**
+     * Validate pipeline can execute without running it (dry-run).
+     *
+     * Checks: nodes exist, agents are resolvable, graph is valid, permissions OK.
+     * Use this for onboarding validation or pre-flight checks.
+     *
+     * @param id - Pipeline UUID.
+     * @param attributes - Validation parameters including workspace_id.
+     * @param options - Optional request options.
+     * @returns Validation result with validity flag and diagnostic info.
+     */
+    async dryRun(id, attributes, options) {
+      return rb.rawPostDirect(
+        `/pipelines/${id}/dry-run`,
+        {
+          workspace_id: attributes.workspace_id
         },
         options
       );
@@ -34387,6 +35084,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 PUT request to a custom (non-generated) endpoint.
    */
@@ -34606,6 +35328,7 @@ var GptClient = class extends BaseClient {
     this.campaigns = createCampaignsNamespace(rb);
     this.email = createEmailNamespace(rb);
     this.support = createSupportNamespace(rb);
+    this.documents = createDocumentsNamespace(rb);
     this.extraction = createExtractionNamespace(rb);
     this.identity = createIdentityNamespace(rb, this.config?.baseUrl);
     this.portal = createPortalNamespace(rb);
@@ -34621,6 +35344,7 @@ var GptClient = class extends BaseClient {
     this.projects = createProjectsNamespace(rb);
     this.models = createModelsNamespace(rb);
     this.crmClusters = createCrmClustersNamespace(rb);
+    this.pipelineExecutions = createPipelineExecutionsNamespace(rb);
     this.pipelines = createPipelinesNamespace(rb);
     this.accessGrants = createAccessGrantsNamespace(rb);
     this.roles = createRolesNamespace(rb);