@letta-ai/letta-client 1.6.0 → 1.6.2

package/src/resources/folders/files.ts

@@ -10,6 +10,18 @@ import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 
 export class Files extends APIResource {
+  /**
+   * Retrieve a file from a folder by ID.
+   */
+  retrieve(
+    fileID: string,
+    params: FileRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<FileRetrieveResponse> {
+    const { folder_id, ...query } = params;
+    return this._client.get(path`/v1/folders/${folder_id}/files/${fileID}`, { query, ...options });
+  }
+
   /**
    * List paginated files associated with a data folder.
    */
@@ -53,6 +65,94 @@ export class Files extends APIResource {
 
 export type FileListResponsesArrayPage = ArrayPage<FileListResponse>;
 
+/**
+ * Representation of a single FileMetadata
+ */
+export interface FileRetrieveResponse {
+  /**
+   * The human-friendly ID of the File
+   */
+  id: string;
+
+  /**
+   * @deprecated Deprecated: Use `folder_id` field instead. The unique identifier of
+   * the source associated with the document.
+   */
+  source_id: string;
+
+  /**
+   * Number of chunks that have been embedded.
+   */
+  chunks_embedded?: number | null;
+
+  /**
+   * Optional full-text content of the file; only populated on demand due to its
+   * size.
+   */
+  content?: string | null;
+
+  /**
+   * The creation date of the file.
+   */
+  created_at?: string | null;
+
+  /**
+   * Optional error message if the file failed processing.
+   */
+  error_message?: string | null;
+
+  /**
+   * The creation date of the file.
+   */
+  file_creation_date?: string | null;
+
+  /**
+   * The last modified date of the file.
+   */
+  file_last_modified_date?: string | null;
+
+  /**
+   * The name of the file.
+   */
+  file_name?: string | null;
+
+  /**
+   * The path to the file.
+   */
+  file_path?: string | null;
+
+  /**
+   * The size of the file in bytes.
+   */
+  file_size?: number | null;
+
+  /**
+   * The type of the file (MIME type).
+   */
+  file_type?: string | null;
+
+  /**
+   * The original name of the file as uploaded.
+   */
+  original_file_name?: string | null;
+
+  /**
+   * The current processing status of the file (e.g. pending, parsing, embedding,
+   * completed, error).
+   */
+  processing_status?: 'pending' | 'parsing' | 'embedding' | 'completed' | 'error';
+
+  /**
+   * Total number of chunks for the file.
+   */
+  total_chunks?: number | null;
+
+  /**
+   * The update date of the file.
+   */
+  updated_at?: string | null;
+}
+
 /**
  * Representation of a single FileMetadata
  */
@@ -229,6 +329,18 @@ export interface FileUploadResponse {
   updated_at?: string | null;
 }
 
+export interface FileRetrieveParams {
+  /**
+   * Path param: The ID of the source in the format 'source-<uuid4>'
+   */
+  folder_id: string;
+
+  /**
+   * Query param: Whether to include full file content
+   */
+  include_content?: boolean;
+}
+
 export interface FileListParams extends ArrayPageParams {
   /**
    * Whether to include full file content
@@ -262,9 +374,11 @@ export interface FileUploadParams {
 
 export declare namespace Files {
   export {
+    type FileRetrieveResponse as FileRetrieveResponse,
     type FileListResponse as FileListResponse,
     type FileUploadResponse as FileUploadResponse,
     type FileListResponsesArrayPage as FileListResponsesArrayPage,
+    type FileRetrieveParams as FileRetrieveParams,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,

package/src/resources/folders/folders.ts

@@ -9,6 +9,8 @@ import {
   FileListParams,
   FileListResponse,
   FileListResponsesArrayPage,
+  FileRetrieveParams,
+  FileRetrieveResponse,
   FileUploadParams,
   FileUploadResponse,
   Files,
@@ -207,9 +209,11 @@ export declare namespace Folders {
 
   export {
     Files as Files,
+    type FileRetrieveResponse as FileRetrieveResponse,
     type FileListResponse as FileListResponse,
     type FileUploadResponse as FileUploadResponse,
     type FileListResponsesArrayPage as FileListResponsesArrayPage,
+    type FileRetrieveParams as FileRetrieveParams,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,

package/src/resources/folders/index.ts

@@ -3,8 +3,10 @@
 export { Agents, type AgentListResponse, type AgentListParams } from './agents';
 export {
   Files,
+  type FileRetrieveResponse,
   type FileListResponse,
   type FileUploadResponse,
+  type FileRetrieveParams,
   type FileListParams,
   type FileDeleteParams,
   type FileUploadParams,

package/src/resources/models/models.ts

@@ -240,7 +240,8 @@ export interface LlmConfig {
     | 'together'
     | 'bedrock'
     | 'deepseek'
-    | 'xai';
+    | 'xai'
+    | 'zai';
 
   /**
    * The framework compatibility type for the model.
@@ -396,7 +397,8 @@ export interface Model {
     | 'together'
     | 'bedrock'
     | 'deepseek'
-    | 'xai';
+    | 'xai'
+    | 'zai';
 
   /**
    * The actual model name used by the provider
@@ -538,7 +540,8 @@ export type ProviderType =
   | 'openai'
   | 'together'
   | 'vllm'
-  | 'xai';
+  | 'xai'
+  | 'zai';
 
 export type ModelListResponse = Array<Model>;
 

package/src/resources/steps/steps.ts

@@ -187,6 +187,11 @@ export interface Step {
    */
   provider_name?: string | null;
 
+  /**
+   * The API request log ID from cloud-api for correlating steps with API requests.
+   */
+  request_id?: string | null;
+
   /**
    * The unique identifier of the run that this step belongs to. Only included for
    * async calls.

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.6.0'; // x-release-please-version
+export const VERSION = '1.6.2'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.0";
+export declare const VERSION = "1.6.2";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

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

package/version.js

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

package/version.mjs

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