feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 106
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-f59f1c7d33001d60b5190f68aa49eacec90f05dbe694620b8916152c3922051d.yml
 openapi_spec_hash: 804edd2e834493906dc430145402be3b
-config_hash: e6c3e48e220b264936ee6df8b996ab12
+config_hash: de16e52db65de71ac35adcdb665a74f5

api.md

@@ -403,16 +403,24 @@ Methods:
 
 - <code title="get /v1/inspect/routes">client.routes.<a href="./src/resources/routes.ts">list</a>() -> RouteListResponse</code>
 
+# Moderations
+
+Types:
+
+- <code><a href="./src/resources/moderations.ts">CreateResponse</a></code>
+
+Methods:
+
+- <code title="post /v1/openai/v1/moderations">client.moderations.<a href="./src/resources/moderations.ts">create</a>({ ...params }) -> CreateResponse</code>
+
 # Safety
 
 Types:
 
-- <code><a href="./src/resources/safety.ts">CreateResponse</a></code>
 - <code><a href="./src/resources/safety.ts">RunShieldResponse</a></code>
 
 Methods:
 
-- <code title="post /v1/openai/v1/moderations">client.safety.<a href="./src/resources/safety.ts">create</a>({ ...params }) -> CreateResponse</code>
 - <code title="post /v1/safety/run-shield">client.safety.<a href="./src/resources/safety.ts">runShield</a>({ ...params }) -> RunShieldResponse</code>
 
 # Shields

src/index.ts

@@ -68,15 +68,10 @@ import {
   ModelRegisterParams,
   Models,
 } from './resources/models';
+import { CreateResponse, ModerationCreateParams, Moderations } from './resources/moderations';
 import { ListProvidersResponse, ProviderListResponse, Providers } from './resources/providers';
 import { ListRoutesResponse, RouteListResponse, Routes } from './resources/routes';
-import {
-  CreateResponse,
-  RunShieldResponse,
-  Safety,
-  SafetyCreateParams,
-  SafetyRunShieldParams,
-} from './resources/safety';
+import { RunShieldResponse, Safety, SafetyRunShieldParams } from './resources/safety';
 import {
   Scoring,
   ScoringScoreBatchParams,
@@ -335,6 +330,7 @@ export class LlamaStackClient extends Core.APIClient {
   postTraining: API.PostTraining = new API.PostTraining(this);
   providers: API.Providers = new API.Providers(this);
   routes: API.Routes = new API.Routes(this);
+  moderations: API.Moderations = new API.Moderations(this);
   safety: API.Safety = new API.Safety(this);
   shields: API.Shields = new API.Shields(this);
   syntheticDataGeneration: API.SyntheticDataGeneration = new API.SyntheticDataGeneration(this);
@@ -413,6 +409,7 @@ LlamaStackClient.Models = Models;
 LlamaStackClient.PostTraining = PostTraining;
 LlamaStackClient.Providers = Providers;
 LlamaStackClient.Routes = Routes;
+LlamaStackClient.Moderations = Moderations;
 LlamaStackClient.Safety = Safety;
 LlamaStackClient.Shields = Shields;
 LlamaStackClient.SyntheticDataGeneration = SyntheticDataGeneration;
@@ -604,10 +601,14 @@ export declare namespace LlamaStackClient {
   };
 
   export {
-    Safety as Safety,
+    Moderations as Moderations,
     type CreateResponse as CreateResponse,
+    type ModerationCreateParams as ModerationCreateParams,
+  };
+
+  export {
+    Safety as Safety,
     type RunShieldResponse as RunShieldResponse,
-    type SafetyCreateParams as SafetyCreateParams,
     type SafetyRunShieldParams as SafetyRunShieldParams,
   };
 

src/resources/index.ts

@@ -86,6 +86,7 @@ export {
   type ModelListResponse,
   type ModelRegisterParams,
 } from './models';
+export { Moderations, type CreateResponse, type ModerationCreateParams } from './moderations';
 export {
   PostTraining,
   type AlgorithmConfig,
@@ -106,13 +107,7 @@ export {
   type ResponseListParams,
 } from './responses/responses';
 export { Routes, type ListRoutesResponse, type RouteListResponse } from './routes';
-export {
-  Safety,
-  type CreateResponse,
-  type RunShieldResponse,
-  type SafetyCreateParams,
-  type SafetyRunShieldParams,
-} from './safety';
+export { Safety, type RunShieldResponse, type SafetyRunShieldParams } from './safety';
 export {
   Scoring,
   type ScoringScoreResponse,

src/resources/moderations.ts

@@ -0,0 +1,85 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import * as Core from '../core';
+
+export class Moderations extends APIResource {
+  /**
+   * Classifies if text and/or image inputs are potentially harmful.
+   */
+  create(body: ModerationCreateParams, options?: Core.RequestOptions): Core.APIPromise<CreateResponse> {
+    return this._client.post('/v1/openai/v1/moderations', { body, ...options });
+  }
+}
+
+/**
+ * A moderation object.
+ */
+export interface CreateResponse {
+  /**
+   * The unique identifier for the moderation request.
+   */
+  id: string;
+
+  /**
+   * The model used to generate the moderation results.
+   */
+  model: string;
+
+  /**
+   * A list of moderation objects
+   */
+  results: Array<CreateResponse.Result>;
+}
+
+export namespace CreateResponse {
+  /**
+   * A moderation object.
+   */
+  export interface Result {
+    /**
+     * Whether any of the below categories are flagged.
+     */
+    flagged: boolean;
+
+    metadata: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+
+    /**
+     * A list of the categories, and whether they are flagged or not.
+     */
+    categories?: { [key: string]: boolean };
+
+    /**
+     * A list of the categories along with the input type(s) that the score applies to.
+     */
+    category_applied_input_types?: { [key: string]: Array<string> };
+
+    /**
+     * A list of the categories along with their scores as predicted by model. Required
+     * set of categories that need to be in response - violence - violence/graphic -
+     * harassment - harassment/threatening - hate - hate/threatening - illicit -
+     * illicit/violent - sexual - sexual/minors - self-harm - self-harm/intent -
+     * self-harm/instructions
+     */
+    category_scores?: { [key: string]: number };
+
+    user_message?: string;
+  }
+}
+
+export interface ModerationCreateParams {
+  /**
+   * Input (or inputs) to classify. Can be a single string, an array of strings, or
+   * an array of multi-modal input objects similar to other models.
+   */
+  input: string | Array<string>;
+
+  /**
+   * The content moderation model you would like to use.
+   */
+  model: string;
+}
+
+export declare namespace Moderations {
+  export { type CreateResponse as CreateResponse, type ModerationCreateParams as ModerationCreateParams };
+}

src/resources/safety.ts

@@ -5,13 +5,6 @@ import * as Core from '../core';
 import * as Shared from './shared';
 
 export class Safety extends APIResource {
-  /**
-   * Classifies if text and/or image inputs are potentially harmful.
-   */
-  create(body: SafetyCreateParams, options?: Core.RequestOptions): Core.APIPromise<CreateResponse> {
-    return this._client.post('/v1/openai/v1/moderations', { body, ...options });
-  }
-
   /**
    * Run a shield.
    */
@@ -20,61 +13,6 @@ export class Safety extends APIResource {
   }
 }
 
-/**
- * A moderation object.
- */
-export interface CreateResponse {
-  /**
-   * The unique identifier for the moderation request.
-   */
-  id: string;
-
-  /**
-   * The model used to generate the moderation results.
-   */
-  model: string;
-
-  /**
-   * A list of moderation objects
-   */
-  results: Array<CreateResponse.Result>;
-}
-
-export namespace CreateResponse {
-  /**
-   * A moderation object.
-   */
-  export interface Result {
-    /**
-     * Whether any of the below categories are flagged.
-     */
-    flagged: boolean;
-
-    metadata: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
-
-    /**
-     * A list of the categories, and whether they are flagged or not.
-     */
-    categories?: { [key: string]: boolean };
-
-    /**
-     * A list of the categories along with the input type(s) that the score applies to.
-     */
-    category_applied_input_types?: { [key: string]: Array<string> };
-
-    /**
-     * A list of the categories along with their scores as predicted by model. Required
-     * set of categories that need to be in response - violence - violence/graphic -
-     * harassment - harassment/threatening - hate - hate/threatening - illicit -
-     * illicit/violent - sexual - sexual/minors - self-harm - self-harm/intent -
-     * self-harm/instructions
-     */
-    category_scores?: { [key: string]: number };
-
-    user_message?: string;
-  }
-}
-
 /**
  * Response from running a safety shield.
  */
@@ -85,19 +23,6 @@ export interface RunShieldResponse {
   violation?: Shared.SafetyViolation;
 }
 
-export interface SafetyCreateParams {
-  /**
-   * Input (or inputs) to classify. Can be a single string, an array of strings, or
-   * an array of multi-modal input objects similar to other models.
-   */
-  input: string | Array<string>;
-
-  /**
-   * The content moderation model you would like to use.
-   */
-  model: string;
-}
-
 export interface SafetyRunShieldParams {
   /**
    * The messages to run the shield on.
@@ -116,10 +41,5 @@ export interface SafetyRunShieldParams {
 }
 
 export declare namespace Safety {
-  export {
-    type CreateResponse as CreateResponse,
-    type RunShieldResponse as RunShieldResponse,
-    type SafetyCreateParams as SafetyCreateParams,
-    type SafetyRunShieldParams as SafetyRunShieldParams,
-  };
+  export { type RunShieldResponse as RunShieldResponse, type SafetyRunShieldParams as SafetyRunShieldParams };
 }

tests/api-resources/moderations.test.ts

@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import LlamaStackClient from 'llama-stack-client';
+import { Response } from 'node-fetch';
+
+const client = new LlamaStackClient({ baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010' });
+
+describe('resource moderations', () => {
+  test('create: only required params', async () => {
+    const responsePromise = client.moderations.create({ input: 'string', model: 'model' });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('create: required and optional params', async () => {
+    const response = await client.moderations.create({ input: 'string', model: 'model' });
+  });
+});

tests/api-resources/safety.test.ts

@@ -6,21 +6,6 @@ import { Response } from 'node-fetch';
 const client = new LlamaStackClient({ baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010' });
 
 describe('resource safety', () => {
-  test('create: only required params', async () => {
-    const responsePromise = client.safety.create({ input: 'string', model: 'model' });
-    const rawResponse = await responsePromise.asResponse();
-    expect(rawResponse).toBeInstanceOf(Response);
-    const response = await responsePromise;
-    expect(response).not.toBeInstanceOf(Response);
-    const dataAndResponse = await responsePromise.withResponse();
-    expect(dataAndResponse.data).toBe(response);
-    expect(dataAndResponse.response).toBe(rawResponse);
-  });
-
-  test('create: required and optional params', async () => {
-    const response = await client.safety.create({ input: 'string', model: 'model' });
-  });
-
   test('runShield: only required params', async () => {
     const responsePromise = client.safety.runShield({
       messages: [{ content: 'string', role: 'user' }],