feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 18
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lemma%2Flemma-a75cf89a2fe32bce9d7b4b491fd796350e9c7dfdfa59ac5ebd17d0a58ebf1034.yml
-openapi_spec_hash: 3015325a0bbffd4fffb26c77c0890542
+configured_endpoints: 17
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lemma%2Flemma-584f07ea035720c85ecac56802077189e3ef8e2970d3a7f9ffb75a605df61fef.yml
+openapi_spec_hash: 941d7b54bafb4c217116dc8fea329900
 config_hash: 6c5faee7a7075551800a7dd39e968e1f

api.md

@@ -6,7 +6,6 @@ Types:
 - <code><a href="./src/resources/datasets.ts">DatasetListResponse</a></code>
 - <code><a href="./src/resources/datasets.ts">DatasetDeleteResponse</a></code>
 - <code><a href="./src/resources/datasets.ts">DatasetGenerateDatasetResponse</a></code>
-- <code><a href="./src/resources/datasets.ts">DatasetGenerateDownloadURLResponse</a></code>
 - <code><a href="./src/resources/datasets.ts">DatasetGenerateSchemaResponse</a></code>
 - <code><a href="./src/resources/datasets.ts">DatasetGenerateValidatorsResponse</a></code>
 
@@ -17,7 +16,6 @@ Methods:
 - <code title="get /datasets">client.datasets.<a href="./src/resources/datasets.ts">list</a>() -> DatasetListResponse</code>
 - <code title="delete /datasets/{dataset_id}">client.datasets.<a href="./src/resources/datasets.ts">delete</a>(datasetID) -> DatasetDeleteResponse</code>
 - <code title="post /datasets/generate-dataset">client.datasets.<a href="./src/resources/datasets.ts">generateDataset</a>({ ...params }) -> DatasetGenerateDatasetResponse</code>
-- <code title="get /datasets/{dataset_id}/generate-download-url">client.datasets.<a href="./src/resources/datasets.ts">generateDownloadURL</a>(datasetID) -> string</code>
 - <code title="post /datasets/generate-schema">client.datasets.<a href="./src/resources/datasets.ts">generateSchema</a>({ ...params }) -> DatasetGenerateSchemaResponse</code>
 - <code title="post /datasets/generate-validators">client.datasets.<a href="./src/resources/datasets.ts">generateValidators</a>({ ...params }) -> DatasetGenerateValidatorsResponse</code>
 

src/client.ts

@@ -22,7 +22,6 @@ import {
   DatasetDeleteResponse,
   DatasetGenerateDatasetParams,
   DatasetGenerateDatasetResponse,
-  DatasetGenerateDownloadURLResponse,
   DatasetGenerateSchemaParams,
   DatasetGenerateSchemaResponse,
   DatasetGenerateValidatorsParams,
@@ -775,7 +774,6 @@ export declare namespace Lemma {
     type DatasetListResponse as DatasetListResponse,
     type DatasetDeleteResponse as DatasetDeleteResponse,
     type DatasetGenerateDatasetResponse as DatasetGenerateDatasetResponse,
-    type DatasetGenerateDownloadURLResponse as DatasetGenerateDownloadURLResponse,
     type DatasetGenerateSchemaResponse as DatasetGenerateSchemaResponse,
     type DatasetGenerateValidatorsResponse as DatasetGenerateValidatorsResponse,
     type DatasetCreateParams as DatasetCreateParams,

src/resources/datasets.ts

@@ -4,7 +4,6 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { type Uploadable } from '../core/uploads';
 import { RequestOptions } from '../internal/request-options';
-import { multipartFormRequestOptions } from '../internal/uploads';
 import { path } from '../internal/utils/path';
 
 export class Datasets extends APIResource {
@@ -13,11 +12,6 @@ export class Datasets extends APIResource {
    *
    * Creates a new dataset with the specified name and optional description. The
    * dataset will be associated with the current user's tenant.
-   *
-   * Args: name: The name of the dataset description: Optional description of the
-   * dataset
-   *
-   * Returns: Dataset: The created dataset object with generated ID and metadata
    */
   create(body: DatasetCreateParams, options?: RequestOptions): APIPromise<Dataset> {
     return this._client.post('/datasets', { body, ...options });
@@ -28,10 +22,6 @@ export class Datasets extends APIResource {
    *
    * Retrieves a specific dataset by its ID. The dataset must belong to the current
    * user's tenant.
-   *
-   * Args: dataset_id: The unique identifier of the dataset
-   *
-   * Returns: Dataset: The dataset object with all its metadata
    */
   retrieve(datasetID: string, options?: RequestOptions): APIPromise<Dataset> {
     return this._client.get(path`/datasets/${datasetID}`, options);
@@ -42,8 +32,6 @@ export class Datasets extends APIResource {
    *
    * Retrieves all datasets that belong to the current user's tenant. This includes
    * datasets created by any user within the same tenant.
-   *
-   * Returns: list[Dataset]: A list of all accessible datasets
    */
   list(options?: RequestOptions): APIPromise<DatasetListResponse> {
     return this._client.get('/datasets', options);
@@ -54,10 +42,6 @@ export class Datasets extends APIResource {
    *
    * Permanently deletes a dataset and all its associated data. This action cannot be
    * undone. The dataset must belong to the current user's tenant.
-   *
-   * Args: dataset_id: The unique identifier of the dataset to delete
-   *
-   * Returns: bool: True if the dataset was successfully deleted
    */
   delete(datasetID: string, options?: RequestOptions): APIPromise<DatasetDeleteResponse> {
     return this._client.delete(path`/datasets/${datasetID}`, options);
@@ -69,13 +53,6 @@ export class Datasets extends APIResource {
    * Initiates the generation of a dataset based on the provided schema and
    * validators. The generation process runs asynchronously and will create the
    * specified number of entries.
-   *
-   * Args: dataset_id: The ID of the dataset to generate data for schema: The JSON
-   * schema defining the data structure validators: Optional CEL validators for data
-   * validation entries_required: Number of data entries to generate
-   * data_description: Optional description of the data to generate
-   *
-   * Returns: bool: True if the generation process was successfully initiated
    */
   generateDataset(
     body: DatasetGenerateDatasetParams,
@@ -84,43 +61,19 @@ export class Datasets extends APIResource {
     return this._client.post('/datasets/generate-dataset', { body, ...options });
   }
 
-  /**
-   * Generate a download URL for a dataset.
-   *
-   * Creates a secure, time-limited download URL that allows downloading the dataset
-   * data. The URL can be used to access the dataset file without requiring
-   * authentication.
-   *
-   * Args: dataset_id: The unique identifier of the dataset
-   *
-   * Returns: str: A secure download URL for the dataset
-   */
-  generateDownloadURL(datasetID: string, options?: RequestOptions): APIPromise<string> {
-    return this._client.get(path`/datasets/${datasetID}/generate-download-url`, options);
-  }
-
   /**
    * Generate a JSON schema from seed data.
    *
    * Uses AI to analyze provided seed data (either a PDF file or description) and
    * generate a JSON schema that can be used for dataset generation. The schema
-   * represents the structure of a single record in the dataset.
-   *
-   * Args: seed_file: Optional PDF file containing example data seed_description:
-   * Optional text description of the data structure
-   *
-   * Returns: SchemaGenerationResponse: Contains the generated JSON schema
-   *
-   * Note: Either seed_file or seed_description must be provided.
+   * represents the structure of a single record in the dataset. Either seed_file or
+   * seed_description must be provided.
    */
   generateSchema(
-    body: DatasetGenerateSchemaParams | null | undefined = {},
+    body: DatasetGenerateSchemaParams,
     options?: RequestOptions,
   ): APIPromise<DatasetGenerateSchemaResponse> {
-    return this._client.post(
-      '/datasets/generate-schema',
-      multipartFormRequestOptions({ body, ...options }, this._client),
-    );
+    return this._client.post('/datasets/generate-schema', { body, ...options });
   }
 
   /**
@@ -129,11 +82,6 @@ export class Datasets extends APIResource {
    * Uses AI to analyze a JSON schema and generate Common Expression Language (CEL)
    * validation rules that ensure data integrity and business logic constraints for
    * the dataset.
-   *
-   * Args: schema: The JSON schema to generate validators for seed_description:
-   * Optional context about the data domain
-   *
-   * Returns: ValidatorsGenerationResponse: Contains the generated CEL validators
    */
   generateValidators(
     body: DatasetGenerateValidatorsParams,
@@ -182,8 +130,6 @@ export type DatasetDeleteResponse = boolean;
 
 export type DatasetGenerateDatasetResponse = boolean;
 
-export type DatasetGenerateDownloadURLResponse = string;
-
 /**
  * Response model for schema generation.
  */
@@ -199,32 +145,65 @@ export interface DatasetGenerateValidatorsResponse {
 }
 
 export interface DatasetCreateParams {
+  /**
+   * The name of the dataset
+   */
   name: string;
 
+  /**
+   * Optional description of the dataset
+   */
   description?: string | null;
 }
 
 export interface DatasetGenerateDatasetParams {
+  /**
+   * The ID of the dataset to generate data for
+   */
   dataset_id: string;
 
+  /**
+   * Number of data entries to generate
+   */
   entries_required: number;
 
+  /**
+   * The JSON schema defining the data structure
+   */
   schema: { [key: string]: unknown };
 
+  /**
+   * Optional description of the data to generate
+   */
   data_description?: string | null;
 
+  /**
+   * Optional CEL validators for data validation
+   */
   validators?: string | null;
 }
 
 export interface DatasetGenerateSchemaParams {
+  /**
+   * The seed description to generate a schema from
+   */
   seed_description?: string | null;
 
+  /**
+   * The seed file to generate a schema from
+   */
   seed_file?: Uploadable | null;
 }
 
 export interface DatasetGenerateValidatorsParams {
+  /**
+   * The JSON schema to generate validators for
+   */
   schema: string;
 
+  /**
+   * Optional context about the data domain
+   */
   seed_description?: string | null;
 }
 
@@ -234,7 +213,6 @@ export declare namespace Datasets {
     type DatasetListResponse as DatasetListResponse,
     type DatasetDeleteResponse as DatasetDeleteResponse,
     type DatasetGenerateDatasetResponse as DatasetGenerateDatasetResponse,
-    type DatasetGenerateDownloadURLResponse as DatasetGenerateDownloadURLResponse,
     type DatasetGenerateSchemaResponse as DatasetGenerateSchemaResponse,
     type DatasetGenerateValidatorsResponse as DatasetGenerateValidatorsResponse,
     type DatasetCreateParams as DatasetCreateParams,

src/resources/evaluators.ts

@@ -11,10 +11,6 @@ export class Evaluators extends APIResource {
    *
    * Retrieves detailed information about a specific evaluator. The evaluator must
    * belong to the current user's tenant.
-   *
-   * Args: evaluator_id: The unique identifier of the evaluator
-   *
-   * Returns: Evaluator: The evaluator object with all its configuration
    */
   retrieve(evaluatorID: string, options?: RequestOptions): APIPromise<Evaluator> {
     return this._client.get(path`/evaluators/${evaluatorID}`, options);
@@ -25,11 +21,6 @@ export class Evaluators extends APIResource {
    *
    * Updates the configuration and settings of an existing evaluator. The evaluator
    * must belong to the current user's tenant.
-   *
-   * Args: evaluator_id: The unique identifier of the evaluator to update evaluator:
-   * The updated evaluator configuration
-   *
-   * Returns: Evaluator: The updated evaluator object
    */
   update(evaluatorID: string, body: EvaluatorUpdateParams, options?: RequestOptions): APIPromise<Evaluator> {
     return this._client.put(path`/evaluators/${evaluatorID}`, { body, ...options });
@@ -40,8 +31,6 @@ export class Evaluators extends APIResource {
    *
    * Retrieves all evaluators that belong to the current user's tenant. Evaluators
    * are used to assess the quality of AI model outputs.
-   *
-   * Returns: list[Evaluator]: A list of all accessible evaluators
    */
   list(options?: RequestOptions): APIPromise<EvaluatorListResponse> {
     return this._client.get('/evaluators', options);
@@ -52,10 +41,6 @@ export class Evaluators extends APIResource {
    *
    * Creates a new rubric that defines how to evaluate AI model outputs. Rubrics
    * provide structured criteria for assessment.
-   *
-   * Args: rubric: The rubric object containing evaluation criteria
-   *
-   * Returns: Rubric: The created rubric with generated ID and metadata
    */
   createRubric(
     body: EvaluatorCreateRubricParams,

src/resources/index.ts

@@ -6,7 +6,6 @@ export {
   type DatasetListResponse,
   type DatasetDeleteResponse,
   type DatasetGenerateDatasetResponse,
-  type DatasetGenerateDownloadURLResponse,
   type DatasetGenerateSchemaResponse,
   type DatasetGenerateValidatorsResponse,
   type DatasetCreateParams,

src/resources/logs.ts

@@ -10,10 +10,6 @@ export class Logs extends APIResource {
    *
    * Creates a new log entry to track events, activities, or API usage. Logs are
    * associated with the current tenant.
-   *
-   * Args: log_data: The log entry data including message, level, and metadata
-   *
-   * Returns: Log: The created log entry with generated ID and timestamp
    */
   create(body: LogCreateParams, options?: RequestOptions): APIPromise<Log> {
     return this._client.post('/logs/', { body, ...options });
@@ -24,11 +20,6 @@ export class Logs extends APIResource {
    *
    * Retrieves log entries for the current tenant with cursor-based pagination. Logs
    * provide visibility into system activities and API usage.
-   *
-   * Args: limit: Maximum number of logs to return (1-100) cursor: Pagination cursor
-   * for retrieving the next page
-   *
-   * Returns: list[Log]: A list of log entries with metadata
    */
   list(query: LogListParams | null | undefined = {}, options?: RequestOptions): APIPromise<LogListResponse> {
     return this._client.get('/logs/', { query, ...options });

src/resources/playground.ts

@@ -16,8 +16,14 @@ export class Playground extends APIResource {
 export type PlaygroundRunResponse = unknown;
 
 export interface PlaygroundRunParams {
+  /**
+   * The ID of the prompt to run
+   */
   prompt_id: string;
 
+  /**
+   * Optional ID of the evaluator to use
+   */
   evaluator_id?: string | null;
 }