llama-stack-client 0.3.4-rc3 → 0.4.0-rc1

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

@@ -3,14 +3,23 @@
 //
 // 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 { isRequestOptions } from '../../core';
 import * as Core from '../../core';
+import * as FileBatchesAPI from './file-batches';
+import {
+  FileBatchCreateParams,
+  FileBatchListFilesParams,
+  FileBatches,
+  ListVectorStoreFilesInBatchResponse,
+  VectorStoreFileBatches,
+} from './file-batches';
 import * as FilesAPI from './files';
 import {
+  FileContentParams,
   FileContentResponse,
   FileCreateParams,
   FileDeleteResponse,
@@ -24,19 +33,22 @@ import { OpenAICursorPage, type OpenAICursorPageParams } from '../../pagination'
 
 export class VectorStores extends APIResource {
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
+  fileBatches: FileBatchesAPI.FileBatches = new FileBatchesAPI.FileBatches(this._client);
 
   /**
    * Creates a vector store.
+   *
+   * Generate an OpenAI-compatible vector store with the given parameters.
    */
   create(body: VectorStoreCreateParams, options?: Core.RequestOptions): Core.APIPromise<VectorStore> {
-    return this._client.post('/v1/openai/v1/vector_stores', { body, ...options });
+    return this._client.post('/v1/vector_stores', { body, ...options });
   }
 
   /**
    * Retrieves a vector store.
    */
   retrieve(vectorStoreId: string, options?: Core.RequestOptions): Core.APIPromise<VectorStore> {
-    return this._client.get(`/v1/openai/v1/vector_stores/${vectorStoreId}`, options);
+    return this._client.get(`/v1/vector_stores/${vectorStoreId}`, options);
   }
 
   /**
@@ -47,7 +59,7 @@ export class VectorStores extends APIResource {
     body: VectorStoreUpdateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<VectorStore> {
-    return this._client.post(`/v1/openai/v1/vector_stores/${vectorStoreId}`, { body, ...options });
+    return this._client.post(`/v1/vector_stores/${vectorStoreId}`, { body, ...options });
   }
 
   /**
@@ -65,29 +77,28 @@ export class VectorStores extends APIResource {
     if (isRequestOptions(query)) {
       return this.list({}, query);
     }
-    return this._client.getAPIList('/v1/openai/v1/vector_stores', VectorStoresOpenAICursorPage, {
-      query,
-      ...options,
-    });
+    return this._client.getAPIList('/v1/vector_stores', VectorStoresOpenAICursorPage, { query, ...options });
   }
 
   /**
    * Delete a vector store.
    */
   delete(vectorStoreId: string, options?: Core.RequestOptions): Core.APIPromise<VectorStoreDeleteResponse> {
-    return this._client.delete(`/v1/openai/v1/vector_stores/${vectorStoreId}`, options);
+    return this._client.delete(`/v1/vector_stores/${vectorStoreId}`, options);
   }
 
   /**
-   * Search for chunks in a vector store. Searches a vector store for relevant chunks
-   * based on a query and optional file attribute filters.
+   * Search for chunks in a vector store.
+   *
+   * Searches a vector store for relevant chunks based on a query and optional file
+   * attribute filters.
    */
   search(
     vectorStoreId: string,
     body: VectorStoreSearchParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<VectorStoreSearchResponse> {
-    return this._client.post(`/v1/openai/v1/vector_stores/${vectorStoreId}/search`, { body, ...options });
+    return this._client.post(`/v1/vector_stores/${vectorStoreId}/search`, { body, ...options });
   }
 }
 
@@ -97,120 +108,60 @@ export class VectorStoresOpenAICursorPage extends OpenAICursorPage<VectorStore>
  * Response from listing vector stores.
  */
 export interface ListVectorStoresResponse {
-  /**
-   * List of vector store objects
-   */
   data: Array<VectorStore>;
 
-  /**
-   * Whether there are more vector stores available beyond this page
-   */
-  has_more: boolean;
+  first_id?: string | null;
 
-  /**
-   * Object type identifier, always "list"
-   */
-  object: string;
+  has_more?: boolean;
 
-  /**
-   * (Optional) ID of the first vector store in the list for pagination
-   */
-  first_id?: string;
+  last_id?: string | null;
 
-  /**
-   * (Optional) ID of the last vector store in the list for pagination
-   */
-  last_id?: string;
+  object?: string;
 }
 
 /**
  * OpenAI Vector Store object.
  */
 export interface VectorStore {
-  /**
-   * Unique identifier for the vector store
-   */
   id: string;
 
-  /**
-   * Timestamp when the vector store was created
-   */
   created_at: number;
 
   /**
-   * File processing status counts for the vector store
+   * File processing status counts for a vector store.
    */
   file_counts: VectorStore.FileCounts;
 
-  /**
-   * Set of key-value pairs that can be attached to the vector store
-   */
-  metadata: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  expires_after?: { [key: string]: unknown } | null;
 
-  /**
-   * Object type identifier, always "vector_store"
-   */
-  object: string;
+  expires_at?: number | null;
 
-  /**
-   * Current status of the vector store
-   */
-  status: string;
+  last_active_at?: number | null;
 
-  /**
-   * Storage space used by the vector store in bytes
-   */
-  usage_bytes: number;
+  metadata?: { [key: string]: unknown };
 
-  /**
-   * (Optional) Expiration policy for the vector store
-   */
-  expires_after?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  name?: string | null;
 
-  /**
-   * (Optional) Timestamp when the vector store will expire
-   */
-  expires_at?: number;
+  object?: string;
 
-  /**
-   * (Optional) Timestamp of last activity on the vector store
-   */
-  last_active_at?: number;
+  status?: string;
 
-  /**
-   * (Optional) Name of the vector store
-   */
-  name?: string;
+  usage_bytes?: number;
 }
 
 export namespace VectorStore {
   /**
-   * File processing status counts for the vector store
+   * File processing status counts for a vector store.
    */
   export interface FileCounts {
-    /**
-     * Number of files that had their processing cancelled
-     */
     cancelled: number;
 
-    /**
-     * Number of files that have been successfully processed
-     */
     completed: number;
 
-    /**
-     * Number of files that failed to process
-     */
     failed: number;
 
-    /**
-     * Number of files currently being processed
-     */
     in_progress: number;
 
-    /**
-     * Total number of files in the vector store
-     */
     total: number;
   }
 }
@@ -219,50 +170,26 @@ export namespace VectorStore {
  * Response from deleting a vector store.
  */
 export interface VectorStoreDeleteResponse {
-  /**
-   * Unique identifier of the deleted vector store
-   */
   id: string;
 
-  /**
-   * Whether the deletion operation was successful
-   */
-  deleted: boolean;
+  deleted?: boolean;
 
-  /**
-   * Object type identifier for the deletion response
-   */
-  object: string;
+  object?: string;
 }
 
 /**
  * Paginated response from searching a vector store.
  */
 export interface VectorStoreSearchResponse {
-  /**
-   * List of search result objects
-   */
   data: Array<VectorStoreSearchResponse.Data>;
 
-  /**
-   * Whether there are more results available beyond this page
-   */
-  has_more: boolean;
+  search_query: Array<string>;
 
-  /**
-   * Object type identifier for the search results page
-   */
-  object: string;
+  has_more?: boolean;
 
-  /**
-   * The original search query that was executed
-   */
-  search_query: string;
+  next_page?: string | null;
 
-  /**
-   * (Optional) Token for retrieving the next page of results
-   */
-  next_page?: string;
+  object?: string;
 }
 
 export namespace VectorStoreSearchResponse {
@@ -270,30 +197,15 @@ export namespace VectorStoreSearchResponse {
    * Response from searching a vector store.
    */
   export interface Data {
-    /**
-     * List of content items matching the search query
-     */
     content: Array<Data.Content>;
 
-    /**
-     * Unique identifier of the file containing the result
-     */
     file_id: string;
 
-    /**
-     * Name of the file containing the result
-     */
     filename: string;
 
-    /**
-     * Relevance score for this search result
-     */
     score: number;
 
-    /**
-     * (Optional) Key-value attributes associated with the file
-     */
-    attributes?: { [key: string]: string | number | boolean };
+    attributes?: { [key: string]: string | number | boolean } | null;
   }
 
   export namespace Data {
@@ -301,146 +213,159 @@ export namespace VectorStoreSearchResponse {
      * Content item from a vector store file or search result.
      */
     export interface Content {
+      text: string;
+
+      type: 'text';
+
       /**
-       * The actual text content
+       * `ChunkMetadata` is backend metadata for a `Chunk` that is used to store
+       * additional information about the chunk that will not be used in the context
+       * during inference, but is required for backend functionality. The `ChunkMetadata`
+       * is set during chunk creation in `MemoryToolRuntimeImpl().insert()`and is not
+       * expected to change after. Use `Chunk.metadata` for metadata that will be used in
+       * the context during inference.
        */
-      text: string;
+      chunk_metadata?: Content.ChunkMetadata | null;
 
+      embedding?: Array<number> | null;
+
+      metadata?: { [key: string]: unknown } | null;
+    }
+
+    export namespace Content {
       /**
-       * Content type, currently only "text" is supported
+       * `ChunkMetadata` is backend metadata for a `Chunk` that is used to store
+       * additional information about the chunk that will not be used in the context
+       * during inference, but is required for backend functionality. The `ChunkMetadata`
+       * is set during chunk creation in `MemoryToolRuntimeImpl().insert()`and is not
+       * expected to change after. Use `Chunk.metadata` for metadata that will be used in
+       * the context during inference.
        */
-      type: 'text';
+      export interface ChunkMetadata {
+        chunk_embedding_dimension?: number | null;
+
+        chunk_embedding_model?: string | null;
+
+        chunk_id?: string | null;
+
+        chunk_tokenizer?: string | null;
+
+        chunk_window?: string | null;
+
+        content_token_count?: number | null;
+
+        created_timestamp?: number | null;
+
+        document_id?: string | null;
+
+        metadata_token_count?: number | null;
+
+        source?: string | null;
+
+        updated_timestamp?: number | null;
+      }
     }
   }
 }
 
 export interface VectorStoreCreateParams {
   /**
-   * The chunking strategy used to chunk the file(s). If not set, will use the `auto`
-   * strategy.
+   * Automatic chunking strategy for vector store files.
    */
-  chunking_strategy?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  chunking_strategy?:
+    | VectorStoreCreateParams.VectorStoreChunkingStrategyAuto
+    | VectorStoreCreateParams.VectorStoreChunkingStrategyStatic
+    | null;
 
-  /**
-   * The dimension of the embedding vectors (default: 384).
-   */
-  embedding_dimension?: number;
+  expires_after?: { [key: string]: unknown } | null;
 
-  /**
-   * The embedding model to use for this vector store.
-   */
-  embedding_model?: string;
+  file_ids?: Array<string> | null;
 
-  /**
-   * The expiration policy for a vector store.
-   */
-  expires_after?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * A list of File IDs that the vector store should use. Useful for tools like
-   * `file_search` that can access files.
-   */
-  file_ids?: Array<string>;
+  name?: string | null;
 
-  /**
-   * Set of 16 key-value pairs that can be attached to an object.
-   */
-  metadata?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  [k: string]: unknown;
+}
 
+export namespace VectorStoreCreateParams {
   /**
-   * A name for the vector store.
+   * Automatic chunking strategy for vector store files.
    */
-  name?: string;
+  export interface VectorStoreChunkingStrategyAuto {
+    type?: 'auto';
+  }
 
   /**
-   * The ID of the provider to use for this vector store.
+   * Static chunking strategy with configurable parameters.
    */
-  provider_id?: string;
+  export interface VectorStoreChunkingStrategyStatic {
+    /**
+     * Configuration for static chunking strategy.
+     */
+    static: VectorStoreChunkingStrategyStatic.Static;
+
+    type?: 'static';
+  }
+
+  export namespace VectorStoreChunkingStrategyStatic {
+    /**
+     * Configuration for static chunking strategy.
+     */
+    export interface Static {
+      chunk_overlap_tokens?: number;
+
+      max_chunk_size_tokens?: number;
+    }
+  }
 }
 
 export interface VectorStoreUpdateParams {
-  /**
-   * The expiration policy for a vector store.
-   */
-  expires_after?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  expires_after?: { [key: string]: unknown } | null;
 
-  /**
-   * Set of 16 key-value pairs that can be attached to an object.
-   */
-  metadata?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * The name of the vector store.
-   */
-  name?: string;
+  name?: string | null;
 }
 
 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;
+  before?: string | null;
 
-  /**
-   * Sort order by the `created_at` timestamp of the objects. `asc` for ascending
-   * order and `desc` for descending order.
-   */
-  order?: string;
+  order?: string | null;
 }
 
 export interface VectorStoreSearchParams {
-  /**
-   * The query string or array for performing the search.
-   */
   query: string | Array<string>;
 
-  /**
-   * Filters based on file attributes to narrow the search results.
-   */
-  filters?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+  filters?: { [key: string]: unknown } | null;
 
-  /**
-   * Maximum number of results to return (1 to 50 inclusive, default 10).
-   */
-  max_num_results?: number;
+  max_num_results?: number | null;
 
   /**
-   * Ranking options for fine-tuning the search results.
+   * Options for ranking and filtering search results.
    */
-  ranking_options?: VectorStoreSearchParams.RankingOptions;
+  ranking_options?: VectorStoreSearchParams.RankingOptions | null;
 
-  /**
-   * Whether to rewrite the natural language query for vector search (default false)
-   */
-  rewrite_query?: boolean;
+  rewrite_query?: boolean | null;
 
-  /**
-   * The search mode to use - "keyword", "vector", or "hybrid" (default "vector")
-   */
-  search_mode?: string;
+  search_mode?: string | null;
 }
 
 export namespace VectorStoreSearchParams {
   /**
-   * Ranking options for fine-tuning the search results.
+   * Options for ranking and filtering search results.
    */
   export interface RankingOptions {
-    /**
-     * (Optional) Name of the ranking algorithm to use
-     */
-    ranker?: string;
+    ranker?: string | null;
 
-    /**
-     * (Optional) Minimum relevance score threshold for results
-     */
-    score_threshold?: number;
+    score_threshold?: number | null;
   }
 }
 
 VectorStores.VectorStoresOpenAICursorPage = VectorStoresOpenAICursorPage;
 VectorStores.Files = Files;
 VectorStores.VectorStoreFilesOpenAICursorPage = VectorStoreFilesOpenAICursorPage;
+VectorStores.FileBatches = FileBatches;
 
 export declare namespace VectorStores {
   export {
@@ -464,5 +389,14 @@ export declare namespace VectorStores {
     type FileCreateParams as FileCreateParams,
     type FileUpdateParams as FileUpdateParams,
     type FileListParams as FileListParams,
+    type FileContentParams as FileContentParams,
+  };
+
+  export {
+    FileBatches as FileBatches,
+    type ListVectorStoreFilesInBatchResponse as ListVectorStoreFilesInBatchResponse,
+    type VectorStoreFileBatches as VectorStoreFileBatches,
+    type FileBatchCreateParams as FileBatchCreateParams,
+    type FileBatchListFilesParams as FileBatchListFilesParams,
   };
 }

package/src/resources/vector-stores.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.
 
 export * from './vector-stores/index';

package/src/version.ts

@@ -4,4 +4,4 @@
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
 
-export const VERSION = '0.3.4rc3'; // x-release-please-version
+export const VERSION = '0.4.0rc1'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.3.4rc3";
+export declare const VERSION = "0.4.0rc1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -6,5 +6,5 @@
 // the root directory of this source tree.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.3.4rc3'; // x-release-please-version
+exports.VERSION = '0.4.0rc1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -3,5 +3,5 @@
 //
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
-export const VERSION = '0.3.4rc3'; // x-release-please-version
+export const VERSION = '0.4.0rc1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map