llama-stack-client 0.2.18 → 0.2.19-rc2

package/src/resources/scoring-functions.ts

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../resource';
 import * as Core from '../core';
-import * as Shared from './shared';
 
 export class ScoringFunctions extends APIResource {
   /**
@@ -49,7 +48,7 @@ export interface ScoringFn {
 
   provider_id: string;
 
-  return_type: Shared.ReturnType;
+  return_type: ScoringFn.ReturnType;
 
   /**
    * The resource type, always scoring_function
@@ -66,6 +65,22 @@ export interface ScoringFn {
   provider_resource_id?: string;
 }
 
+export namespace ScoringFn {
+  export interface ReturnType {
+    type:
+      | 'string'
+      | 'number'
+      | 'boolean'
+      | 'array'
+      | 'object'
+      | 'json'
+      | 'union'
+      | 'chat_completion_input'
+      | 'completion_input'
+      | 'agent_turn_input';
+  }
+}
+
 /**
  * Parameters for LLM-as-judge scoring function configuration.
  */
@@ -155,7 +170,7 @@ export interface ScoringFunctionRegisterParams {
    */
   description: string;
 
-  return_type: Shared.ReturnType;
+  return_type: ScoringFunctionRegisterParams.ReturnType;
 
   /**
    * The ID of the scoring function to register.
@@ -179,6 +194,22 @@ export interface ScoringFunctionRegisterParams {
   provider_scoring_fn_id?: string;
 }
 
+export namespace ScoringFunctionRegisterParams {
+  export interface ReturnType {
+    type:
+      | 'string'
+      | 'number'
+      | 'boolean'
+      | 'array'
+      | 'object'
+      | 'json'
+      | 'union'
+      | 'chat_completion_input'
+      | 'completion_input'
+      | 'agent_turn_input';
+  }
+}
+
 export declare namespace ScoringFunctions {
   export {
     type ListScoringFunctionsResponse as ListScoringFunctionsResponse,

package/src/resources/shared.ts

@@ -132,29 +132,7 @@ export interface ChatCompletionResponse {
   /**
    * (Optional) List of metrics associated with the API response
    */
-  metrics?: Array<ChatCompletionResponse.Metric>;
-}
-
-export namespace ChatCompletionResponse {
-  /**
-   * A metric value included in API responses.
-   */
-  export interface Metric {
-    /**
-     * The name of the metric
-     */
-    metric: string;
-
-    /**
-     * The numeric value of the metric
-     */
-    value: number;
-
-    /**
-     * (Optional) The unit of measurement for the metric value
-     */
-    unit?: string;
-  }
+  metrics?: Array<Metric>;
 }
 
 /**
@@ -235,7 +213,7 @@ export namespace ContentDelta {
     /**
      * Either an in-progress tool call string or the final parsed tool call
      */
-    tool_call: Shared.ToolCallOrString;
+    tool_call: string | Shared.ToolCall;
 
     /**
      * Discriminator type of the delta. Always "tool_call"
@@ -494,6 +472,26 @@ export namespace InterleavedContentItem {
  */
 export type Message = UserMessage | SystemMessage | ToolResponseMessage | CompletionMessage;
 
+/**
+ * A metric value included in API responses.
+ */
+export interface Metric {
+  /**
+   * The name of the metric
+   */
+  metric: string;
+
+  /**
+   * The numeric value of the metric
+   */
+  value: number;
+
+  /**
+   * (Optional) The unit of measurement for the metric value
+   */
+  unit?: string;
+}
+
 /**
  * Parameter type for string values.
  */
@@ -781,20 +779,6 @@ export namespace ResponseFormat {
   }
 }
 
-export interface ReturnType {
-  type:
-    | 'string'
-    | 'number'
-    | 'boolean'
-    | 'array'
-    | 'object'
-    | 'json'
-    | 'union'
-    | 'chat_completion_input'
-    | 'completion_input'
-    | 'agent_turn_input';
-}
-
 /**
  * Details of a safety violation detected by content moderation.
  */
@@ -949,11 +933,6 @@ export interface ToolCall {
   arguments_json?: string;
 }
 
-/**
- * Either an in-progress tool call string or the final parsed tool call
- */
-export type ToolCallOrString = string | ToolCall;
-
 export interface ToolParamDefinition {
   param_type: string;
 

package/src/resources/telemetry.ts

@@ -48,6 +48,21 @@ export class Telemetry extends APIResource {
     });
   }
 
+  /**
+   * Query metrics.
+   */
+  queryMetrics(
+    metricName: string,
+    body: TelemetryQueryMetricsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TelemetryQueryMetricsResponse> {
+    return (
+      this._client.post(`/v1/telemetry/metrics/${metricName}`, { body, ...options }) as Core.APIPromise<{
+        data: TelemetryQueryMetricsResponse;
+      }>
+    )._thenUnwrap((obj) => obj.data);
+  }
+
   /**
    * Query spans.
    */
@@ -401,6 +416,68 @@ export interface TelemetryGetSpanResponse {
  */
 export type TelemetryGetSpanTreeResponse = { [key: string]: SpanWithStatus };
 
+/**
+ * List of metric series matching the query criteria
+ */
+export type TelemetryQueryMetricsResponse =
+  Array<TelemetryQueryMetricsResponse.TelemetryQueryMetricsResponseItem>;
+
+export namespace TelemetryQueryMetricsResponse {
+  /**
+   * A time series of metric data points.
+   */
+  export interface TelemetryQueryMetricsResponseItem {
+    /**
+     * List of labels associated with this metric series
+     */
+    labels: Array<TelemetryQueryMetricsResponseItem.Label>;
+
+    /**
+     * The name of the metric
+     */
+    metric: string;
+
+    /**
+     * List of data points in chronological order
+     */
+    values: Array<TelemetryQueryMetricsResponseItem.Value>;
+  }
+
+  export namespace TelemetryQueryMetricsResponseItem {
+    /**
+     * A label associated with a metric.
+     */
+    export interface Label {
+      /**
+       * The name of the label
+       */
+      name: string;
+
+      /**
+       * The value of the label
+       */
+      value: string;
+    }
+
+    /**
+     * A single data point in a metric time series.
+     */
+    export interface Value {
+      /**
+       * Unix timestamp when the metric value was recorded
+       */
+      timestamp: number;
+
+      unit: string;
+
+      /**
+       * The numeric value of the metric at this timestamp
+       */
+      value: number;
+    }
+  }
+}
+
 /**
  * List of spans matching the query criteria
  */
@@ -477,6 +554,55 @@ export interface TelemetryLogEventParams {
   ttl_seconds: number;
 }
 
+export interface TelemetryQueryMetricsParams {
+  /**
+   * The type of query to perform.
+   */
+  query_type: 'range' | 'instant';
+
+  /**
+   * The start time of the metric to query.
+   */
+  start_time: number;
+
+  /**
+   * The end time of the metric to query.
+   */
+  end_time?: number;
+
+  /**
+   * The granularity of the metric to query.
+   */
+  granularity?: string;
+
+  /**
+   * The label matchers to apply to the metric.
+   */
+  label_matchers?: Array<TelemetryQueryMetricsParams.LabelMatcher>;
+}
+
+export namespace TelemetryQueryMetricsParams {
+  /**
+   * A matcher for filtering metrics by label values.
+   */
+  export interface LabelMatcher {
+    /**
+     * The name of the label to match
+     */
+    name: string;
+
+    /**
+     * The comparison operator to use for matching
+     */
+    operator: '=' | '!=' | '=~' | '!~';
+
+    /**
+     * The value to match against
+     */
+    value: string;
+  }
+}
+
 export interface TelemetryQuerySpansParams {
   /**
    * The attribute filters to apply to the spans.
@@ -547,10 +673,12 @@ export declare namespace Telemetry {
     type Trace as Trace,
     type TelemetryGetSpanResponse as TelemetryGetSpanResponse,
     type TelemetryGetSpanTreeResponse as TelemetryGetSpanTreeResponse,
+    type TelemetryQueryMetricsResponse as TelemetryQueryMetricsResponse,
     type TelemetryQuerySpansResponse as TelemetryQuerySpansResponse,
     type TelemetryQueryTracesResponse as TelemetryQueryTracesResponse,
     type TelemetryGetSpanTreeParams as TelemetryGetSpanTreeParams,
     type TelemetryLogEventParams as TelemetryLogEventParams,
+    type TelemetryQueryMetricsParams as TelemetryQueryMetricsParams,
     type TelemetryQuerySpansParams as TelemetryQuerySpansParams,
     type TelemetryQueryTracesParams as TelemetryQueryTracesParams,
     type TelemetrySaveSpansToDatasetParams as TelemetrySaveSpansToDatasetParams,

package/src/resources/vector-stores/files.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../resource';
 import { isRequestOptions } from '../../core';
 import * as Core from '../../core';
+import { OpenAICursorPage, type OpenAICursorPageParams } from '../../pagination';
 
 export class Files extends APIResource {
   /**
@@ -49,17 +50,24 @@ export class Files extends APIResource {
     vectorStoreId: string,
     query?: FileListParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<FileListResponse>;
-  list(vectorStoreId: string, options?: Core.RequestOptions): Core.APIPromise<FileListResponse>;
+  ): Core.PagePromise<VectorStoreFilesOpenAICursorPage, VectorStoreFile>;
+  list(
+    vectorStoreId: string,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<VectorStoreFilesOpenAICursorPage, VectorStoreFile>;
   list(
     vectorStoreId: string,
     query: FileListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.APIPromise<FileListResponse> {
+  ): Core.PagePromise<VectorStoreFilesOpenAICursorPage, VectorStoreFile> {
     if (isRequestOptions(query)) {
       return this.list(vectorStoreId, {}, query);
     }
-    return this._client.get(`/v1/openai/v1/vector_stores/${vectorStoreId}/files`, { query, ...options });
+    return this._client.getAPIList(
+      `/v1/openai/v1/vector_stores/${vectorStoreId}/files`,
+      VectorStoreFilesOpenAICursorPage,
+      { query, ...options },
+    );
   }
 
   /**
@@ -85,6 +93,8 @@ export class Files extends APIResource {
   }
 }
 
+export class VectorStoreFilesOpenAICursorPage extends OpenAICursorPage<VectorStoreFile> {}
+
 /**
  * OpenAI Vector Store File object.
  */
@@ -196,36 +206,6 @@ export namespace VectorStoreFile {
   }
 }
 
-/**
- * Response from listing files in a vector store.
- */
-export interface FileListResponse {
-  /**
-   * List of vector store file objects
-   */
-  data: Array<VectorStoreFile>;
-
-  /**
-   * Whether there are more files available beyond this page
-   */
-  has_more: boolean;
-
-  /**
-   * Object type identifier, always "list"
-   */
-  object: string;
-
-  /**
-   * (Optional) ID of the first file in the list for pagination
-   */
-  first_id?: string;
-
-  /**
-   * (Optional) ID of the last file in the list for pagination
-   */
-  last_id?: string;
-}
-
 /**
  * Response from deleting a vector store file.
  */
@@ -358,13 +338,7 @@ export interface FileUpdateParams {
   attributes: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
 }
 
-export interface FileListParams {
-  /**
-   * (Optional) A cursor for use in pagination. `after` is an object ID that defines
-   * your place in the list.
-   */
-  after?: string;
-
+export interface FileListParams extends OpenAICursorPageParams {
   /**
    * (Optional) A cursor for use in pagination. `before` is an object ID that defines
    * your place in the list.
@@ -376,12 +350,6 @@ export interface FileListParams {
    */
   filter?: 'completed' | 'in_progress' | 'cancelled' | 'failed';
 
-  /**
-   * (Optional) A limit on the number of objects to be returned. Limit can range
-   * between 1 and 100, and the default is 20.
-   */
-  limit?: number;
-
   /**
    * (Optional) Sort order by the `created_at` timestamp of the objects. `asc` for
    * ascending order and `desc` for descending order.
@@ -389,12 +357,14 @@ export interface FileListParams {
   order?: string;
 }
 
+Files.VectorStoreFilesOpenAICursorPage = VectorStoreFilesOpenAICursorPage;
+
 export declare namespace Files {
   export {
     type VectorStoreFile as VectorStoreFile,
-    type FileListResponse as FileListResponse,
     type FileDeleteResponse as FileDeleteResponse,
     type FileContentResponse as FileContentResponse,
+    VectorStoreFilesOpenAICursorPage as VectorStoreFilesOpenAICursorPage,
     type FileCreateParams as FileCreateParams,
     type FileUpdateParams as FileUpdateParams,
     type FileListParams as FileListParams,

package/src/resources/vector-stores/index.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
+  VectorStoreFilesOpenAICursorPage,
   Files,
   type VectorStoreFile,
-  type FileListResponse,
   type FileDeleteResponse,
   type FileContentResponse,
   type FileCreateParams,
@@ -11,6 +11,7 @@ export {
   type FileListParams,
 } from './files';
 export {
+  VectorStoresOpenAICursorPage,
   VectorStores,
   type ListVectorStoresResponse,
   type VectorStore,

package/src/resources/vector-stores/vector-stores.ts

@@ -9,11 +9,12 @@ import {
   FileCreateParams,
   FileDeleteResponse,
   FileListParams,
-  FileListResponse,
   FileUpdateParams,
   Files,
   VectorStoreFile,
+  VectorStoreFilesOpenAICursorPage,
 } from './files';
+import { OpenAICursorPage, type OpenAICursorPageParams } from '../../pagination';
 
 export class VectorStores extends APIResource {
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
@@ -49,16 +50,19 @@ export class VectorStores extends APIResource {
   list(
     query?: VectorStoreListParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<ListVectorStoresResponse>;
-  list(options?: Core.RequestOptions): Core.APIPromise<ListVectorStoresResponse>;
+  ): Core.PagePromise<VectorStoresOpenAICursorPage, VectorStore>;
+  list(options?: Core.RequestOptions): Core.PagePromise<VectorStoresOpenAICursorPage, VectorStore>;
   list(
     query: VectorStoreListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.APIPromise<ListVectorStoresResponse> {
+  ): Core.PagePromise<VectorStoresOpenAICursorPage, VectorStore> {
     if (isRequestOptions(query)) {
       return this.list({}, query);
     }
-    return this._client.get('/v1/openai/v1/vector_stores', { query, ...options });
+    return this._client.getAPIList('/v1/openai/v1/vector_stores', VectorStoresOpenAICursorPage, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -81,6 +85,8 @@ export class VectorStores extends APIResource {
   }
 }
 
+export class VectorStoresOpenAICursorPage extends OpenAICursorPage<VectorStore> {}
+
 /**
  * Response from listing vector stores.
  */
@@ -363,25 +369,13 @@ export interface VectorStoreUpdateParams {
   name?: string;
 }
 
-export interface VectorStoreListParams {
-  /**
-   * A cursor for use in pagination. `after` is an object ID that defines your place
-   * in the list.
-   */
-  after?: string;
-
+export interface VectorStoreListParams extends OpenAICursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list.
    */
   before?: string;
 
-  /**
-   * A limit on the number of objects to be returned. Limit can range between 1 and
-   * 100, and the default is 20.
-   */
-  limit?: number;
-
   /**
    * Sort order by the `created_at` timestamp of the objects. `asc` for ascending
    * order and `desc` for descending order.
@@ -438,7 +432,9 @@ export namespace VectorStoreSearchParams {
   }
 }
 
+VectorStores.VectorStoresOpenAICursorPage = VectorStoresOpenAICursorPage;
 VectorStores.Files = Files;
+VectorStores.VectorStoreFilesOpenAICursorPage = VectorStoreFilesOpenAICursorPage;
 
 export declare namespace VectorStores {
   export {
@@ -446,6 +442,7 @@ export declare namespace VectorStores {
     type VectorStore as VectorStore,
     type VectorStoreDeleteResponse as VectorStoreDeleteResponse,
     type VectorStoreSearchResponse as VectorStoreSearchResponse,
+    VectorStoresOpenAICursorPage as VectorStoresOpenAICursorPage,
     type VectorStoreCreateParams as VectorStoreCreateParams,
     type VectorStoreUpdateParams as VectorStoreUpdateParams,
     type VectorStoreListParams as VectorStoreListParams,
@@ -455,9 +452,9 @@ export declare namespace VectorStores {
   export {
     Files as Files,
     type VectorStoreFile as VectorStoreFile,
-    type FileListResponse as FileListResponse,
     type FileDeleteResponse as FileDeleteResponse,
     type FileContentResponse as FileContentResponse,
+    VectorStoreFilesOpenAICursorPage as VectorStoreFilesOpenAICursorPage,
     type FileCreateParams as FileCreateParams,
     type FileUpdateParams as FileUpdateParams,
     type FileListParams as FileListParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.18'; // x-release-please-version
+export const VERSION = '0.2.19rc2'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.18";
+export declare const VERSION = "0.2.19rc2";
 //# sourceMappingURL=version.d.ts.map

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,cAAc,CAAC"}

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.2.18'; // x-release-please-version
+exports.VERSION = '0.2.19rc2'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,WAAW,CAAC,CAAC,2BAA2B"}

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.2.18'; // x-release-please-version
+export const VERSION = '0.2.19rc2'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,2BAA2B"}