openai-mcp-test 0.0.1

package/src/resources/evals/runs.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './runs/index';

package/src/resources/evals.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './evals/index';

package/src/resources/files.ts

@@ -0,0 +1,229 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { CursorPage, type CursorPageParams, PagePromise } from '../core/pagination';
+import { type Uploadable } from '../core/uploads';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { multipartFormRequestOptions } from '../internal/uploads';
+import { path } from '../internal/utils/path';
+
+export class Files extends APIResource {
+  /**
+   * Upload a file that can be used across various endpoints. Individual files can be
+   * up to 512 MB, and each project can store up to 2.5 TB of files in total. There
+   * is no organization-wide storage limit.
+   *
+   * - The Assistants API supports files up to 2 million tokens and of specific file
+   *   types. See the
+   *   [Assistants Tools guide](https://platform.openai.com/docs/assistants/tools)
+   *   for details.
+   * - The Fine-tuning API only supports `.jsonl` files. The input also has certain
+   *   required formats for fine-tuning
+   *   [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input)
+   *   or
+   *   [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
+   *   models.
+   * - The Batch API only supports `.jsonl` files up to 200 MB in size. The input
+   *   also has a specific required
+   *   [format](https://platform.openai.com/docs/api-reference/batch/request-input).
+   *
+   * Please [contact us](https://help.openai.com/) if you need to increase these
+   * storage limits.
+   */
+  create(body: FileCreateParams, options?: RequestOptions): APIPromise<FileObject> {
+    return this._client.post('/files', multipartFormRequestOptions({ body, ...options }, this._client));
+  }
+
+  /**
+   * Returns information about a specific file.
+   */
+  retrieve(fileID: string, options?: RequestOptions): APIPromise<FileObject> {
+    return this._client.get(path`/files/${fileID}`, options);
+  }
+
+  /**
+   * Returns a list of files.
+   */
+  list(
+    query: FileListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<FileObjectsPage, FileObject> {
+    return this._client.getAPIList('/files', CursorPage<FileObject>, { query, ...options });
+  }
+
+  /**
+   * Delete a file and remove it from all vector stores.
+   */
+  delete(fileID: string, options?: RequestOptions): APIPromise<FileDeleted> {
+    return this._client.delete(path`/files/${fileID}`, options);
+  }
+
+  /**
+   * Returns the contents of the specified file.
+   */
+  content(fileID: string, options?: RequestOptions): APIPromise<Response> {
+    return this._client.get(path`/files/${fileID}/content`, {
+      ...options,
+      headers: buildHeaders([{ Accept: 'application/binary' }, options?.headers]),
+      __binaryResponse: true,
+    });
+  }
+}
+
+export type FileObjectsPage = CursorPage<FileObject>;
+
+export type FileContent = string;
+
+export interface FileDeleted {
+  id: string;
+
+  deleted: boolean;
+
+  object: 'file';
+}
+
+/**
+ * The `File` object represents a document that has been uploaded to OpenAI.
+ */
+export interface FileObject {
+  /**
+   * The file identifier, which can be referenced in the API endpoints.
+   */
+  id: string;
+
+  /**
+   * The size of the file, in bytes.
+   */
+  bytes: number;
+
+  /**
+   * The Unix timestamp (in seconds) for when the file was created.
+   */
+  created_at: number;
+
+  /**
+   * The name of the file.
+   */
+  filename: string;
+
+  /**
+   * The object type, which is always `file`.
+   */
+  object: 'file';
+
+  /**
+   * The intended purpose of the file. Supported values are `assistants`,
+   * `assistants_output`, `batch`, `batch_output`, `fine-tune`, `fine-tune-results`,
+   * `vision`, and `user_data`.
+   */
+  purpose:
+    | 'assistants'
+    | 'assistants_output'
+    | 'batch'
+    | 'batch_output'
+    | 'fine-tune'
+    | 'fine-tune-results'
+    | 'vision'
+    | 'user_data';
+
+  /**
+   * @deprecated Deprecated. The current status of the file, which can be either
+   * `uploaded`, `processed`, or `error`.
+   */
+  status: 'uploaded' | 'processed' | 'error';
+
+  /**
+   * The Unix timestamp (in seconds) for when the file will expire.
+   */
+  expires_at?: number;
+
+  /**
+   * @deprecated Deprecated. For details on why a fine-tuning training file failed
+   * validation, see the `error` field on `fine_tuning.job`.
+   */
+  status_details?: string;
+}
+
+/**
+ * The intended purpose of the uploaded file. One of:
+ *
+ * - `assistants`: Used in the Assistants API
+ * - `batch`: Used in the Batch API
+ * - `fine-tune`: Used for fine-tuning
+ * - `vision`: Images used for vision fine-tuning
+ * - `user_data`: Flexible file type for any purpose
+ * - `evals`: Used for eval data sets
+ */
+export type FilePurpose = 'assistants' | 'batch' | 'fine-tune' | 'vision' | 'user_data' | 'evals';
+
+export interface FileCreateParams {
+  /**
+   * The File object (not file name) to be uploaded.
+   */
+  file: Uploadable;
+
+  /**
+   * The intended purpose of the uploaded file. One of:
+   *
+   * - `assistants`: Used in the Assistants API
+   * - `batch`: Used in the Batch API
+   * - `fine-tune`: Used for fine-tuning
+   * - `vision`: Images used for vision fine-tuning
+   * - `user_data`: Flexible file type for any purpose
+   * - `evals`: Used for eval data sets
+   */
+  purpose: FilePurpose;
+
+  /**
+   * The expiration policy for a file. By default, files with `purpose=batch` expire
+   * after 30 days and all other files are persisted until they are manually deleted.
+   */
+  expires_after?: FileCreateParams.ExpiresAfter;
+}
+
+export namespace FileCreateParams {
+  /**
+   * The expiration policy for a file. By default, files with `purpose=batch` expire
+   * after 30 days and all other files are persisted until they are manually deleted.
+   */
+  export interface ExpiresAfter {
+    /**
+     * Anchor timestamp after which the expiration policy applies. Supported anchors:
+     * `created_at`.
+     */
+    anchor: 'created_at';
+
+    /**
+     * The number of seconds after the anchor time that the file will expire. Must be
+     * between 3600 (1 hour) and 2592000 (30 days).
+     */
+    seconds: number;
+  }
+}
+
+export interface FileListParams extends CursorPageParams {
+  /**
+   * Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+   * order and `desc` for descending order.
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Only return files with the given purpose.
+   */
+  purpose?: string;
+}
+
+export declare namespace Files {
+  export {
+    type FileContent as FileContent,
+    type FileDeleted as FileDeleted,
+    type FileObject as FileObject,
+    type FilePurpose as FilePurpose,
+    type FileObjectsPage as FileObjectsPage,
+    type FileCreateParams as FileCreateParams,
+    type FileListParams as FileListParams,
+  };
+}

package/src/resources/fine-tuning/alpha/alpha.ts

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as GradersAPI from './graders';
+import {
+  GraderRunParams,
+  GraderRunResponse,
+  GraderValidateParams,
+  GraderValidateResponse,
+  Graders,
+} from './graders';
+
+export class Alpha extends APIResource {
+  graders: GradersAPI.Graders = new GradersAPI.Graders(this._client);
+}
+
+Alpha.Graders = Graders;
+
+export declare namespace Alpha {
+  export {
+    Graders as Graders,
+    type GraderRunResponse as GraderRunResponse,
+    type GraderValidateResponse as GraderValidateResponse,
+    type GraderRunParams as GraderRunParams,
+    type GraderValidateParams as GraderValidateParams,
+  };
+}

package/src/resources/fine-tuning/alpha/graders.ts

@@ -0,0 +1,171 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as GraderModelsAPI from '../../graders/grader-models';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Graders extends APIResource {
+  /**
+   * Run a grader.
+   *
+   * @example
+   * ```ts
+   * const response = await client.fineTuning.alpha.graders.run({
+   *   grader: {
+   *     input: 'input',
+   *     name: 'name',
+   *     operation: 'eq',
+   *     reference: 'reference',
+   *     type: 'string_check',
+   *   },
+   *   model_sample: 'model_sample',
+   * });
+   * ```
+   */
+  run(body: GraderRunParams, options?: RequestOptions): APIPromise<GraderRunResponse> {
+    return this._client.post('/fine_tuning/alpha/graders/run', { body, ...options });
+  }
+
+  /**
+   * Validate a grader.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.fineTuning.alpha.graders.validate({
+   *     grader: {
+   *       input: 'input',
+   *       name: 'name',
+   *       operation: 'eq',
+   *       reference: 'reference',
+   *       type: 'string_check',
+   *     },
+   *   });
+   * ```
+   */
+  validate(body: GraderValidateParams, options?: RequestOptions): APIPromise<GraderValidateResponse> {
+    return this._client.post('/fine_tuning/alpha/graders/validate', { body, ...options });
+  }
+}
+
+export interface GraderRunResponse {
+  metadata: GraderRunResponse.Metadata;
+
+  model_grader_token_usage_per_model: { [key: string]: unknown };
+
+  reward: number;
+
+  sub_rewards: { [key: string]: unknown };
+}
+
+export namespace GraderRunResponse {
+  export interface Metadata {
+    errors: Metadata.Errors;
+
+    execution_time: number;
+
+    name: string;
+
+    sampled_model_name: string | null;
+
+    scores: { [key: string]: unknown };
+
+    token_usage: number | null;
+
+    type: string;
+  }
+
+  export namespace Metadata {
+    export interface Errors {
+      formula_parse_error: boolean;
+
+      invalid_variable_error: boolean;
+
+      model_grader_parse_error: boolean;
+
+      model_grader_refusal_error: boolean;
+
+      model_grader_server_error: boolean;
+
+      model_grader_server_error_details: string | null;
+
+      other_error: boolean;
+
+      python_grader_runtime_error: boolean;
+
+      python_grader_runtime_error_details: string | null;
+
+      python_grader_server_error: boolean;
+
+      python_grader_server_error_type: string | null;
+
+      sample_parse_error: boolean;
+
+      truncated_observation_error: boolean;
+
+      unresponsive_reward_error: boolean;
+    }
+  }
+}
+
+export interface GraderValidateResponse {
+  /**
+   * The grader used for the fine-tuning job.
+   */
+  grader?:
+    | GraderModelsAPI.StringCheckGrader
+    | GraderModelsAPI.TextSimilarityGrader
+    | GraderModelsAPI.PythonGrader
+    | GraderModelsAPI.ScoreModelGrader
+    | GraderModelsAPI.MultiGrader;
+}
+
+export interface GraderRunParams {
+  /**
+   * The grader used for the fine-tuning job.
+   */
+  grader:
+    | GraderModelsAPI.StringCheckGrader
+    | GraderModelsAPI.TextSimilarityGrader
+    | GraderModelsAPI.PythonGrader
+    | GraderModelsAPI.ScoreModelGrader
+    | GraderModelsAPI.MultiGrader;
+
+  /**
+   * The model sample to be evaluated. This value will be used to populate the
+   * `sample` namespace. See
+   * [the guide](https://platform.openai.com/docs/guides/graders) for more details.
+   * The `output_json` variable will be populated if the model sample is a valid JSON
+   * string.
+   */
+  model_sample: string;
+
+  /**
+   * The dataset item provided to the grader. This will be used to populate the
+   * `item` namespace. See
+   * [the guide](https://platform.openai.com/docs/guides/graders) for more details.
+   */
+  item?: unknown;
+}
+
+export interface GraderValidateParams {
+  /**
+   * The grader used for the fine-tuning job.
+   */
+  grader:
+    | GraderModelsAPI.StringCheckGrader
+    | GraderModelsAPI.TextSimilarityGrader
+    | GraderModelsAPI.PythonGrader
+    | GraderModelsAPI.ScoreModelGrader
+    | GraderModelsAPI.MultiGrader;
+}
+
+export declare namespace Graders {
+  export {
+    type GraderRunResponse as GraderRunResponse,
+    type GraderValidateResponse as GraderValidateResponse,
+    type GraderRunParams as GraderRunParams,
+    type GraderValidateParams as GraderValidateParams,
+  };
+}

package/src/resources/fine-tuning/alpha/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Alpha } from './alpha';
+export {
+  Graders,
+  type GraderRunResponse,
+  type GraderValidateResponse,
+  type GraderRunParams,
+  type GraderValidateParams,
+} from './graders';

package/src/resources/fine-tuning/alpha.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './alpha/index';

package/src/resources/fine-tuning/checkpoints/checkpoints.ts

@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as PermissionsAPI from './permissions';
+import {
+  PermissionCreateParams,
+  PermissionCreateResponse,
+  PermissionCreateResponsesPage,
+  PermissionDeleteParams,
+  PermissionDeleteResponse,
+  PermissionRetrieveParams,
+  PermissionRetrieveResponse,
+  Permissions,
+} from './permissions';
+
+export class Checkpoints extends APIResource {
+  permissions: PermissionsAPI.Permissions = new PermissionsAPI.Permissions(this._client);
+}
+
+Checkpoints.Permissions = Permissions;
+
+export declare namespace Checkpoints {
+  export {
+    Permissions as Permissions,
+    type PermissionCreateResponse as PermissionCreateResponse,
+    type PermissionRetrieveResponse as PermissionRetrieveResponse,
+    type PermissionDeleteResponse as PermissionDeleteResponse,
+    type PermissionCreateResponsesPage as PermissionCreateResponsesPage,
+    type PermissionCreateParams as PermissionCreateParams,
+    type PermissionRetrieveParams as PermissionRetrieveParams,
+    type PermissionDeleteParams as PermissionDeleteParams,
+  };
+}

package/src/resources/fine-tuning/checkpoints/index.ts

@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Checkpoints } from './checkpoints';
+export {
+  Permissions,
+  type PermissionCreateResponse,
+  type PermissionRetrieveResponse,
+  type PermissionDeleteResponse,
+  type PermissionCreateParams,
+  type PermissionRetrieveParams,
+  type PermissionDeleteParams,
+  type PermissionCreateResponsesPage,
+} from './permissions';