@gpt-platform/client 0.10.3 → 0.10.4

package/dist/index.mjs

@@ -1272,7 +1272,7 @@ function buildUserAgent(sdkVersion, appInfo) {
 }
 
 // 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
@@ -2393,6 +2393,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",
@@ -2584,6 +2589,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}",
@@ -3189,6 +3203,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",
@@ -6954,6 +6973,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}",
@@ -7337,6 +7365,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}",
@@ -25418,6 +25451,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
+        );
+      }
     }
   };
 }
@@ -29995,11 +30116,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 = {};
@@ -33219,6 +33437,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. */
@@ -34320,6 +34564,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.
    */
@@ -34539,6 +34808,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);