feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 105
+configured_endpoints: 106
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-ab9c9bf2527d3b4179e2bc3e6495c64d43c42b2ea8dc1a55d472986e1a1430a0.yml
 openapi_spec_hash: b93c85fb747e3c29134451d2f364ce8b
-config_hash: 0394c2b14022becb0352c36afcdfbafe
+config_hash: b0cd3ed9be70b0310bc685a4014eb0a5

api.md

@@ -412,6 +412,7 @@ Types:
 
 Methods:
 
+- <code title="post /v1/openai/v1/moderations">client.safety.<a href="./src/resources/safety.ts">openaiModerations</a>({ ...params }) -> OpenAIModerationsResponse</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

@@ -74,6 +74,7 @@ import {
   OpenAIModerationsResponse,
   RunShieldResponse,
   Safety,
+  SafetyOpenAIModerationsParams,
   SafetyRunShieldParams,
 } from './resources/safety';
 import {
@@ -606,6 +607,7 @@ export declare namespace LlamaStackClient {
     Safety as Safety,
     type OpenAIModerationsResponse as OpenAIModerationsResponse,
     type RunShieldResponse as RunShieldResponse,
+    type SafetyOpenAIModerationsParams as SafetyOpenAIModerationsParams,
     type SafetyRunShieldParams as SafetyRunShieldParams,
   };
 

src/resources/index.ts

@@ -110,6 +110,7 @@ export {
   Safety,
   type OpenAIModerationsResponse,
   type RunShieldResponse,
+  type SafetyOpenAIModerationsParams,
   type SafetyRunShieldParams,
 } from './safety';
 export {

src/resources/safety.ts

@@ -5,6 +5,16 @@ 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.
+   */
+  openaiModerations(
+    body: SafetyOpenAIModerationsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<OpenAIModerationsResponse> {
+    return this._client.post('/v1/openai/v1/moderations', { body, ...options });
+  }
+
   /**
    * Run a shield.
    */
@@ -63,6 +73,19 @@ export interface RunShieldResponse {
   violation?: Shared.SafetyViolation;
 }
 
+export interface SafetyOpenAIModerationsParams {
+  /**
+   * 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.
@@ -84,6 +107,7 @@ export declare namespace Safety {
   export {
     type OpenAIModerationsResponse as OpenAIModerationsResponse,
     type RunShieldResponse as RunShieldResponse,
+    type SafetyOpenAIModerationsParams as SafetyOpenAIModerationsParams,
     type SafetyRunShieldParams as SafetyRunShieldParams,
   };
 }

tests/api-resources/safety.test.ts

@@ -6,6 +6,21 @@ 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('openaiModerations: only required params', async () => {
+    const responsePromise = client.safety.openaiModerations({ input: 'string' });
+    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('openaiModerations: required and optional params', async () => {
+    const response = await client.safety.openaiModerations({ input: 'string', model: 'model' });
+  });
+
   test('runShield: only required params', async () => {
     const responsePromise = client.safety.runShield({
       messages: [{ content: 'string', role: 'user' }],