Sync updates from stainless branch: ehhuang/dev (#21)

Author: ehhuang

src/index.ts

@@ -58,6 +58,14 @@ import {
   Models,
 } from './resources/models';
 import { ListProvidersResponse, ProviderListResponse, Providers } from './resources/providers';
+import {
+  ResponseCreateParams,
+  ResponseCreateParamsNonStreaming,
+  ResponseCreateParamsStreaming,
+  ResponseObject,
+  ResponseObjectStream,
+  Responses,
+} from './resources/responses';
 import { ListRoutesResponse, RouteListResponse, Routes } from './resources/routes';
 import { RunShieldResponse, Safety, SafetyRunShieldParams } from './resources/safety';
 import {
@@ -275,6 +283,7 @@ export class LlamaStackClient extends Core.APIClient {
   toolgroups: API.Toolgroups = new API.Toolgroups(this);
   tools: API.Tools = new API.Tools(this);
   toolRuntime: API.ToolRuntime = new API.ToolRuntime(this);
+  responses: API.Responses = new API.Responses(this);
   agents: API.Agents = new API.Agents(this);
   datasets: API.Datasets = new API.Datasets(this);
   eval: API.Eval = new API.Eval(this);
@@ -342,6 +351,7 @@ export class LlamaStackClient extends Core.APIClient {
 LlamaStackClient.Toolgroups = Toolgroups;
 LlamaStackClient.Tools = Tools;
 LlamaStackClient.ToolRuntime = ToolRuntime;
+LlamaStackClient.Responses = Responses;
 LlamaStackClient.Agents = Agents;
 LlamaStackClient.Datasets = Datasets;
 LlamaStackClient.Eval = Eval;
@@ -396,6 +406,15 @@ export declare namespace LlamaStackClient {
     type ToolRuntimeListToolsParams as ToolRuntimeListToolsParams,
   };
 
+  export {
+    Responses as Responses,
+    type ResponseObject as ResponseObject,
+    type ResponseObjectStream as ResponseObjectStream,
+    type ResponseCreateParams as ResponseCreateParams,
+    type ResponseCreateParamsNonStreaming as ResponseCreateParamsNonStreaming,
+    type ResponseCreateParamsStreaming as ResponseCreateParamsStreaming,
+  };
+
   export {
     Agents as Agents,
     type InferenceStep as InferenceStep,

src/resources/agents/agents.ts

@@ -41,7 +41,7 @@ export class Agents extends APIResource {
   }
 
   /**
-   * Delete an agent by its ID.
+   * Delete an agent by its ID and its associated sessions and turns.
    */
   delete(agentId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
     return this._client.delete(`/v1/agents/${agentId}`, {
@@ -65,6 +65,9 @@ export interface InferenceStep {
    */
   step_id: string;
 
+  /**
+   * Type of the step in an agent turn.
+   */
   step_type: 'inference';
 
   /**
@@ -97,6 +100,9 @@ export interface MemoryRetrievalStep {
    */
   step_id: string;
 
+  /**
+   * Type of the step in an agent turn.
+   */
   step_type: 'memory_retrieval';
 
   /**
@@ -129,6 +135,9 @@ export interface ShieldCallStep {
    */
   step_id: string;
 
+  /**
+   * Type of the step in an agent turn.
+   */
   step_type: 'shield_call';
 
   /**
@@ -161,6 +170,9 @@ export interface ToolExecutionStep {
    */
   step_id: string;
 
+  /**
+   * Type of the step in an agent turn.
+   */
   step_type: 'tool_execution';
 
   /**

src/resources/agents/session.ts

@@ -40,7 +40,7 @@ export class SessionResource extends APIResource {
   }
 
   /**
-   * Delete an agent session by its ID.
+   * Delete an agent session by its ID and its associated turns.
    */
   delete(agentId: string, sessionId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
     return this._client.delete(`/v1/agents/${agentId}/session/${sessionId}`, {

src/resources/benchmarks.ts

@@ -4,16 +4,25 @@ import { APIResource } from '../resource';
 import * as Core from '../core';
 
 export class Benchmarks extends APIResource {
+  /**
+   * Get a benchmark by its ID.
+   */
   retrieve(benchmarkId: string, options?: Core.RequestOptions): Core.APIPromise<Benchmark> {
     return this._client.get(`/v1/eval/benchmarks/${benchmarkId}`, options);
   }
 
+  /**
+   * List all benchmarks.
+   */
   list(options?: Core.RequestOptions): Core.APIPromise<BenchmarkListResponse> {
     return (
       this._client.get('/v1/eval/benchmarks', options) as Core.APIPromise<{ data: BenchmarkListResponse }>
     )._thenUnwrap((obj) => obj.data);
   }
 
+  /**
+   * Register a benchmark.
+   */
   register(body: BenchmarkRegisterParams, options?: Core.RequestOptions): Core.APIPromise<void> {
     return this._client.post('/v1/eval/benchmarks', {
       body,
@@ -32,11 +41,11 @@ export interface Benchmark {
 
   provider_id: string;
 
-  provider_resource_id: string;
-
   scoring_functions: Array<string>;
 
   type: 'benchmark';
+
+  provider_resource_id?: string;
 }
 
 export interface ListBenchmarksResponse {
@@ -46,16 +55,34 @@ export interface ListBenchmarksResponse {
 export type BenchmarkListResponse = Array<Benchmark>;
 
 export interface BenchmarkRegisterParams {
+  /**
+   * The ID of the benchmark to register.
+   */
   benchmark_id: string;
 
+  /**
+   * The ID of the dataset to use for the benchmark.
+   */
   dataset_id: string;
 
+  /**
+   * The scoring functions to use for the benchmark.
+   */
   scoring_functions: Array<string>;
 
+  /**
+   * The metadata to use for the benchmark.
+   */
   metadata?: Record<string, boolean | number | string | Array<unknown> | unknown | null>;
 
+  /**
+   * The ID of the provider benchmark to use for the benchmark.
+   */
   provider_benchmark_id?: string;
 
+  /**
+   * The ID of the provider to use for the benchmark.
+   */
   provider_id?: string;
 }
 

src/resources/chat/chat.ts

@@ -7,6 +7,9 @@ import {
   CompletionCreateParamsNonStreaming,
   CompletionCreateParamsStreaming,
   CompletionCreateResponse,
+  CompletionListParams,
+  CompletionListResponse,
+  CompletionRetrieveResponse,
   Completions,
 } from './completions';
 
@@ -199,8 +202,11 @@ export declare namespace Chat {
   export {
     Completions as Completions,
     type CompletionCreateResponse as CompletionCreateResponse,
+    type CompletionRetrieveResponse as CompletionRetrieveResponse,
+    type CompletionListResponse as CompletionListResponse,
     type CompletionCreateParams as CompletionCreateParams,
     type CompletionCreateParamsNonStreaming as CompletionCreateParamsNonStreaming,
     type CompletionCreateParamsStreaming as CompletionCreateParamsStreaming,
+    type CompletionListParams as CompletionListParams,
   };
 }