fix(api): add missing file rank enum + more metadata (#1360)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 74
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai-5d30684c3118d049682ea30cdb4dbef39b97d51667da484689193dc40162af32.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai-b524aed1c2c5c928aa4e2c546f5dbb364e7b4d5027daf05e42e210b05a97c3c6.yml

src/resources/beta/threads/runs/steps.ts

@@ -279,9 +279,10 @@ export namespace FileSearchToolCall {
      */
     export interface RankingOptions {
       /**
-       * The ranker used for the file search.
+       * The ranker to use for the file search. If not specified will use the `auto`
+       * ranker.
        */
-      ranker: 'default_2024_08_21';
+      ranker: 'auto' | 'default_2024_08_21';
 
       /**
        * The score threshold for the file search. All values must be a floating point

src/resources/fine-tuning/jobs/jobs.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../../resource';
 import { isRequestOptions } from '../../../core';
 import * as Core from '../../../core';
+import * as Shared from '../../shared';
 import * as CheckpointsAPI from './checkpoints';
 import {
   CheckpointListParams,
@@ -195,6 +196,16 @@ export interface FineTuningJob {
    */
   integrations?: Array<FineTuningJobWandbIntegrationObject> | null;
 
+  /**
+   * Set of 16 key-value pairs that can be attached to an object. This can be useful
+   * for storing additional information about the object in a structured format, and
+   * querying for objects via API or the dashboard.
+   *
+   * Keys are strings with a maximum length of 64 characters. Values are strings with
+   * a maximum length of 512 characters.
+   */
+  metadata?: Shared.Metadata | null;
+
   /**
    * The method used for fine-tuning.
    */
@@ -476,6 +487,16 @@ export interface JobCreateParams {
    */
   integrations?: Array<JobCreateParams.Integration> | null;
 
+  /**
+   * Set of 16 key-value pairs that can be attached to an object. This can be useful
+   * for storing additional information about the object in a structured format, and
+   * querying for objects via API or the dashboard.
+   *
+   * Keys are strings with a maximum length of 64 characters. Values are strings with
+   * a maximum length of 512 characters.
+   */
+  metadata?: Shared.Metadata | null;
+
   /**
    * The method used for fine-tuning.
    */
@@ -690,7 +711,13 @@ export namespace JobCreateParams {
   }
 }
 
-export interface JobListParams extends CursorPageParams {}
+export interface JobListParams extends CursorPageParams {
+  /**
+   * Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
+   * Alternatively, set `metadata=null` to indicate no metadata.
+   */
+  metadata?: Record<string, string> | null;
+}
 
 export interface JobListEventsParams extends CursorPageParams {}
 

tests/api-resources/fine-tuning/jobs/jobs.test.ts

@@ -34,6 +34,7 @@ describe('resource jobs', () => {
           wandb: { project: 'my-wandb-project', entity: 'entity', name: 'name', tags: ['custom-tag'] },
         },
       ],
+      metadata: { foo: 'string' },
       method: {
         dpo: {
           hyperparameters: {
@@ -93,7 +94,10 @@ describe('resource jobs', () => {
   test('list: request options and params are passed correctly', async () => {
     // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
     await expect(
-      client.fineTuning.jobs.list({ after: 'after', limit: 0 }, { path: '/_stainless_unknown_path' }),
+      client.fineTuning.jobs.list(
+        { after: 'after', limit: 0, metadata: { foo: 'string' } },
+        { path: '/_stainless_unknown_path' },
+      ),
     ).rejects.toThrow(OpenAI.NotFoundError);
   });