llama-stack-client 0.3.5 → 0.4.0-rc2

package/src/resources/conversations.ts

@@ -0,0 +1,9 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// This source code is licensed under the terms described in the LICENSE file in
+// the root directory of this source tree.
+//
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './conversations/index';

package/src/resources/embeddings.ts

@@ -3,7 +3,7 @@
 //
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
-
+//
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../resource';
@@ -11,6 +11,8 @@ import * as Core from '../core';
 
 export class Embeddings extends APIResource {
   /**
+   * Create embeddings.
+   *
    * Generate OpenAI-compatible embeddings for the given input using the specified
    * model.
    */
@@ -18,7 +20,7 @@ export class Embeddings extends APIResource {
     body: EmbeddingCreateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<CreateEmbeddingsResponse> {
-    return this._client.post('/v1/openai/v1/embeddings', { body, ...options });
+    return this._client.post('/v1/embeddings', { body, ...options });
   }
 }
 
@@ -26,25 +28,16 @@ export class Embeddings extends APIResource {
  * Response from an OpenAI-compatible embeddings request.
  */
 export interface CreateEmbeddingsResponse {
-  /**
-   * List of embedding data objects
-   */
   data: Array<CreateEmbeddingsResponse.Data>;
 
-  /**
-   * The model that was used to generate the embeddings
-   */
   model: string;
 
   /**
-   * The object type, which will be "list"
-   */
-  object: 'list';
-
-  /**
-   * Usage information
+   * Usage information for an OpenAI-compatible embeddings response.
    */
   usage: CreateEmbeddingsResponse.Usage;
+
+  object?: 'list';
 }
 
 export namespace CreateEmbeddingsResponse {
@@ -52,69 +45,35 @@ export namespace CreateEmbeddingsResponse {
    * A single embedding data object from an OpenAI-compatible embeddings response.
    */
   export interface Data {
-    /**
-     * The embedding vector as a list of floats (when encoding_format="float") or as a
-     * base64-encoded string (when encoding_format="base64")
-     */
     embedding: Array<number> | string;
 
-    /**
-     * The index of the embedding in the input list
-     */
     index: number;
 
-    /**
-     * The object type, which will be "embedding"
-     */
-    object: 'embedding';
+    object?: 'embedding';
   }
 
   /**
-   * Usage information
+   * Usage information for an OpenAI-compatible embeddings response.
    */
   export interface Usage {
-    /**
-     * The number of tokens in the input
-     */
     prompt_tokens: number;
 
-    /**
-     * The total number of tokens used
-     */
     total_tokens: number;
   }
 }
 
 export interface EmbeddingCreateParams {
-  /**
-   * Input text to embed, encoded as a string or array of strings. To embed multiple
-   * inputs in a single request, pass an array of strings.
-   */
   input: string | Array<string>;
 
-  /**
-   * The identifier of the model to use. The model must be an embedding model
-   * registered with Llama Stack and available via the /models endpoint.
-   */
   model: string;
 
-  /**
-   * (Optional) The number of dimensions the resulting output embeddings should have.
-   * Only supported in text-embedding-3 and later models.
-   */
-  dimensions?: number;
+  dimensions?: number | null;
 
-  /**
-   * (Optional) The format to return the embeddings in. Can be either "float" or
-   * "base64". Defaults to "float".
-   */
-  encoding_format?: string;
+  encoding_format?: string | null;
 
-  /**
-   * (Optional) A unique identifier representing your end-user, which can help OpenAI
-   * to monitor and detect abuse.
-   */
-  user?: string;
+  user?: string | null;
+
+  [k: string]: unknown;
 }
 
 export declare namespace Embeddings {

package/src/resources/files.ts

@@ -3,7 +3,7 @@
 //
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
-
+//
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../resource';
@@ -13,24 +13,32 @@ import { OpenAICursorPage, type OpenAICursorPageParams } from '../pagination';
 
 export class Files extends APIResource {
   /**
-   * Upload a file that can be used across various endpoints. The file upload should
-   * be a multipart form request with:
+   * Upload file.
+   *
+   * Upload a file that can be used across various endpoints.
+   *
+   * The file upload should be a multipart form request with:
    *
    * - file: The File object (not file name) to be uploaded.
    * - purpose: The intended purpose of the uploaded file.
+   * - expires_after: Optional form values describing expiration for the file.
    */
   create(body: FileCreateParams, options?: Core.RequestOptions): Core.APIPromise<File> {
-    return this._client.post('/v1/openai/v1/files', Core.multipartFormRequestOptions({ body, ...options }));
+    return this._client.post('/v1/files', Core.multipartFormRequestOptions({ body, ...options }));
   }
 
   /**
+   * Retrieve file.
+   *
    * Returns information about a specific file.
    */
   retrieve(fileId: string, options?: Core.RequestOptions): Core.APIPromise<File> {
-    return this._client.get(`/v1/openai/v1/files/${fileId}`, options);
+    return this._client.get(`/v1/files/${fileId}`, options);
   }
 
   /**
+   * List files.
+   *
    * Returns a list of files that belong to the user's organization.
    */
   list(query?: FileListParams, options?: Core.RequestOptions): Core.PagePromise<FilesOpenAICursorPage, File>;
@@ -42,21 +50,23 @@ export class Files extends APIResource {
     if (isRequestOptions(query)) {
       return this.list({}, query);
     }
-    return this._client.getAPIList('/v1/openai/v1/files', FilesOpenAICursorPage, { query, ...options });
+    return this._client.getAPIList('/v1/files', FilesOpenAICursorPage, { query, ...options });
   }
 
   /**
-   * Delete a file.
+   * Delete file.
    */
   delete(fileId: string, options?: Core.RequestOptions): Core.APIPromise<DeleteFileResponse> {
-    return this._client.delete(`/v1/openai/v1/files/${fileId}`, options);
+    return this._client.delete(`/v1/files/${fileId}`, options);
   }
 
   /**
+   * Retrieve file content.
+   *
    * Returns the contents of the specified file.
    */
   content(fileId: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
-    return this._client.get(`/v1/openai/v1/files/${fileId}/content`, options);
+    return this._client.get(`/v1/files/${fileId}/content`, options);
   }
 }
 
@@ -66,90 +76,48 @@ export class FilesOpenAICursorPage extends OpenAICursorPage<File> {}
  * Response for deleting a file in OpenAI Files API.
  */
 export interface DeleteFileResponse {
-  /**
-   * The file identifier that was deleted
-   */
   id: string;
 
-  /**
-   * Whether the file was successfully deleted
-   */
   deleted: boolean;
 
-  /**
-   * The object type, which is always "file"
-   */
-  object: 'file';
+  object?: 'file';
 }
 
 /**
  * OpenAI File object as defined in the OpenAI Files API.
  */
 export interface File {
-  /**
-   * The file identifier, which can be referenced in the API endpoints
-   */
   id: string;
 
-  /**
-   * The size of the file, in bytes
-   */
   bytes: number;
 
-  /**
-   * The Unix timestamp (in seconds) for when the file was created
-   */
   created_at: number;
 
-  /**
-   * The Unix timestamp (in seconds) for when the file expires
-   */
   expires_at: number;
 
-  /**
-   * The name of the file
-   */
   filename: string;
 
   /**
-   * The object type, which is always "file"
-   */
-  object: 'file';
-
-  /**
-   * The intended purpose of the file
+   * Valid purpose values for OpenAI Files API.
    */
   purpose: 'assistants' | 'batch';
+
+  object?: 'file';
 }
 
 /**
  * Response for listing files in OpenAI Files API.
  */
 export interface ListFilesResponse {
-  /**
-   * List of file objects
-   */
   data: Array<File>;
 
-  /**
-   * ID of the first file in the list for pagination
-   */
   first_id: string;
 
-  /**
-   * Whether there are more files available beyond this page
-   */
   has_more: boolean;
 
-  /**
-   * ID of the last file in the list for pagination
-   */
   last_id: string;
 
-  /**
-   * The object type, which is always "list"
-   */
-  object: 'list';
+  object?: 'list';
 }
 
 export type FileContentResponse = unknown;
@@ -161,19 +129,44 @@ export interface FileCreateParams {
    * Valid purpose values for OpenAI Files API.
    */
   purpose: 'assistants' | 'batch';
+
+  /**
+   * Control expiration of uploaded files.
+   *
+   * Params:
+   *
+   * - anchor, must be "created_at"
+   * - seconds, must be int between 3600 and 2592000 (1 hour to 30 days)
+   */
+  expires_after?: FileCreateParams.ExpiresAfter | null;
+}
+
+export namespace FileCreateParams {
+  /**
+   * Control expiration of uploaded files.
+   *
+   * Params:
+   *
+   * - anchor, must be "created_at"
+   * - seconds, must be int between 3600 and 2592000 (1 hour to 30 days)
+   */
+  export interface ExpiresAfter {
+    anchor: 'created_at';
+
+    seconds: number;
+  }
 }
 
 export interface FileListParams extends OpenAICursorPageParams {
   /**
-   * Sort order by the `created_at` timestamp of the objects. `asc` for ascending
-   * order and `desc` for descending order.
+   * Sort order for paginated responses.
    */
-  order?: 'asc' | 'desc';
+  order?: 'asc' | 'desc' | null;
 
   /**
-   * Only return files with the given purpose.
+   * Valid purpose values for OpenAI Files API.
    */
-  purpose?: 'assistants' | 'batch';
+  purpose?: 'assistants' | 'batch' | null;
 }
 
 Files.FilesOpenAICursorPage = FilesOpenAICursorPage;

package/src/resources/index.ts

@@ -3,30 +3,22 @@
 //
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
-
+//
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export * from './shared';
-export {
-  Agents,
-  type InferenceStep,
-  type MemoryRetrievalStep,
-  type ShieldCallStep,
-  type ToolExecutionStep,
-  type ToolResponse,
-  type AgentCreateResponse,
-  type AgentRetrieveResponse,
-  type AgentListResponse,
-  type AgentCreateParams,
-  type AgentListParams,
-} from './agents/agents';
-export {
-  Benchmarks,
-  type Benchmark,
-  type ListBenchmarksResponse,
-  type BenchmarkListResponse,
-  type BenchmarkRegisterParams,
-} from './benchmarks';
+export { Alpha } from './alpha/alpha';
+export {
+  BatchListResponsesOpenAICursorPage,
+  Batches,
+  type BatchCreateResponse,
+  type BatchRetrieveResponse,
+  type BatchListResponse,
+  type BatchCancelResponse,
+  type BatchCreateParams,
+  type BatchListParams,
+} from './batches';
+export { Beta } from './beta/beta';
 export { Chat, type ChatCompletionChunk } from './chat/chat';
 export {
   Completions,
@@ -36,28 +28,13 @@ export {
   type CompletionCreateParamsStreaming,
 } from './completions';
 export {
-  Datasets,
-  type ListDatasetsResponse,
-  type DatasetRetrieveResponse,
-  type DatasetListResponse,
-  type DatasetIterrowsResponse,
-  type DatasetRegisterResponse,
-  type DatasetAppendrowsParams,
-  type DatasetIterrowsParams,
-  type DatasetRegisterParams,
-} from './datasets';
+  Conversations,
+  type ConversationObject,
+  type ConversationDeleteResponse,
+  type ConversationCreateParams,
+  type ConversationUpdateParams,
+} from './conversations/conversations';
 export { Embeddings, type CreateEmbeddingsResponse, type EmbeddingCreateParams } from './embeddings';
-export {
-  Eval,
-  type BenchmarkConfig,
-  type EvalCandidate,
-  type EvaluateResponse,
-  type Job,
-  type EvalEvaluateRowsParams,
-  type EvalEvaluateRowsAlphaParams,
-  type EvalRunEvalParams,
-  type EvalRunEvalAlphaParams,
-} from './eval/eval';
 export {
   FilesOpenAICursorPage,
   Files,
@@ -68,43 +45,28 @@ export {
   type FileCreateParams,
   type FileListParams,
 } from './files';
-export {
-  Inference,
-  type ChatCompletionResponseStreamChunk,
-  type CompletionResponse,
-  type EmbeddingsResponse,
-  type TokenLogProbs,
-  type InferenceBatchChatCompletionResponse,
-  type InferenceRerankResponse,
-  type InferenceBatchChatCompletionParams,
-  type InferenceBatchCompletionParams,
-  type InferenceChatCompletionParams,
-  type InferenceChatCompletionParamsNonStreaming,
-  type InferenceChatCompletionParamsStreaming,
-  type InferenceCompletionParams,
-  type InferenceCompletionParamsNonStreaming,
-  type InferenceCompletionParamsStreaming,
-  type InferenceEmbeddingsParams,
-  type InferenceRerankParams,
-} from './inference';
-export { Inspect, type HealthInfo, type ProviderInfo, type RouteInfo, type VersionInfo } from './inspect';
+export { Inspect } from './inspect';
 export {
   Models,
   type ListModelsResponse,
   type Model,
+  type ModelRetrieveResponse,
   type ModelListResponse,
+  type ModelRegisterResponse,
   type ModelRegisterParams,
 } from './models/models';
 export { Moderations, type CreateResponse, type ModerationCreateParams } from './moderations';
 export {
-  PostTraining,
-  type AlgorithmConfig,
-  type ListPostTrainingJobsResponse,
-  type PostTrainingJob,
-  type PostTrainingPreferenceOptimizeParams,
-  type PostTrainingSupervisedFineTuneParams,
-} from './post-training/post-training';
-export { Providers, type ListProvidersResponse, type ProviderListResponse } from './providers';
+  Prompts,
+  type ListPromptsResponse,
+  type Prompt,
+  type PromptListResponse,
+  type PromptCreateParams,
+  type PromptRetrieveParams,
+  type PromptUpdateParams,
+  type PromptSetDefaultVersionParams,
+} from './prompts/prompts';
+export { Providers, type ProviderListResponse } from './providers';
 export {
   ResponseListResponsesOpenAICursorPage,
   Responses,
@@ -117,7 +79,7 @@ export {
   type ResponseCreateParamsStreaming,
   type ResponseListParams,
 } from './responses/responses';
-export { Routes, type ListRoutesResponse, type RouteListResponse } from './routes';
+export { Routes, type RouteListResponse, type RouteListParams } from './routes';
 export { Safety, type RunShieldResponse, type SafetyRunShieldParams } from './safety';
 export {
   Scoring,
@@ -141,30 +103,6 @@ export {
   type ShieldListResponse,
   type ShieldRegisterParams,
 } from './shields';
-export {
-  SyntheticDataGeneration,
-  type SyntheticDataGenerationResponse,
-  type SyntheticDataGenerationGenerateParams,
-} from './synthetic-data-generation';
-export {
-  Telemetry,
-  type Event,
-  type QueryCondition,
-  type QuerySpansResponse,
-  type SpanWithStatus,
-  type Trace,
-  type TelemetryGetSpanResponse,
-  type TelemetryGetSpanTreeResponse,
-  type TelemetryQueryMetricsResponse,
-  type TelemetryQuerySpansResponse,
-  type TelemetryQueryTracesResponse,
-  type TelemetryGetSpanTreeParams,
-  type TelemetryLogEventParams,
-  type TelemetryQueryMetricsParams,
-  type TelemetryQuerySpansParams,
-  type TelemetryQueryTracesParams,
-  type TelemetrySaveSpansToDatasetParams,
-} from './telemetry';
 export {
   ToolRuntime,
   type ToolDef,
@@ -172,7 +110,7 @@ export {
   type ToolRuntimeListToolsResponse,
   type ToolRuntimeInvokeToolParams,
   type ToolRuntimeListToolsParams,
-} from './tool-runtime/tool-runtime';
+} from './tool-runtime';
 export {
   Toolgroups,
   type ListToolGroupsResponse,
@@ -180,21 +118,7 @@ export {
   type ToolgroupListResponse,
   type ToolgroupRegisterParams,
 } from './toolgroups';
-export {
-  Tools,
-  type ListToolsResponse,
-  type Tool,
-  type ToolListResponse,
-  type ToolListParams,
-} from './tools';
-export {
-  VectorDBs,
-  type ListVectorDBsResponse,
-  type VectorDBRetrieveResponse,
-  type VectorDBListResponse,
-  type VectorDBRegisterResponse,
-  type VectorDBRegisterParams,
-} from './vector-dbs';
+export { Tools, type ToolListResponse, type ToolListParams } from './tools';
 export {
   VectorIo,
   type QueryChunksResponse,

package/src/resources/inspect.ts

@@ -3,105 +3,25 @@
 //
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
-
+//
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../resource';
 import * as Core from '../core';
+import * as Shared from './shared';
 
 export class Inspect extends APIResource {
   /**
    * Get the current health status of the service.
    */
-  health(options?: Core.RequestOptions): Core.APIPromise<HealthInfo> {
+  health(options?: Core.RequestOptions): Core.APIPromise<Shared.HealthInfo> {
     return this._client.get('/v1/health', options);
   }
 
   /**
    * Get the version of the service.
    */
-  version(options?: Core.RequestOptions): Core.APIPromise<VersionInfo> {
+  version(options?: Core.RequestOptions): Core.APIPromise<Shared.VersionInfo> {
     return this._client.get('/v1/version', options);
   }
 }
-
-/**
- * Health status information for the service.
- */
-export interface HealthInfo {
-  /**
-   * Current health status of the service
-   */
-  status: 'OK' | 'Error' | 'Not Implemented';
-}
-
-/**
- * Information about a registered provider including its configuration and health
- * status.
- */
-export interface ProviderInfo {
-  /**
-   * The API name this provider implements
-   */
-  api: string;
-
-  /**
-   * Configuration parameters for the provider
-   */
-  config: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
-
-  /**
-   * Current health status of the provider
-   */
-  health: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
-
-  /**
-   * Unique identifier for the provider
-   */
-  provider_id: string;
-
-  /**
-   * The type of provider implementation
-   */
-  provider_type: string;
-}
-
-/**
- * Information about an API route including its path, method, and implementing
- * providers.
- */
-export interface RouteInfo {
-  /**
-   * HTTP method for the route
-   */
-  method: string;
-
-  /**
-   * List of provider types that implement this route
-   */
-  provider_types: Array<string>;
-
-  /**
-   * The API endpoint path
-   */
-  route: string;
-}
-
-/**
- * Version information for the service.
- */
-export interface VersionInfo {
-  /**
-   * Version number of the service
-   */
-  version: string;
-}
-
-export declare namespace Inspect {
-  export {
-    type HealthInfo as HealthInfo,
-    type ProviderInfo as ProviderInfo,
-    type RouteInfo as RouteInfo,
-    type VersionInfo as VersionInfo,
-  };
-}

package/src/resources/models/index.ts

@@ -3,14 +3,16 @@
 //
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
-
+//
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export {
   Models,
   type ListModelsResponse,
   type Model,
+  type ModelRetrieveResponse,
   type ModelListResponse,
+  type ModelRegisterResponse,
   type ModelRegisterParams,
 } from './models';
-export { OpenAI, type OpenAIListResponse } from './openai';
+export { OpenAI } from './openai';