@letta-ai/letta-client 1.6.1 → 1.6.3

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/groups/messages.ts

@@ -116,6 +116,13 @@ export interface MessageCreateParams {
    */
   assistant_message_tool_name?: string;
 
+  /**
+   * Client-side tools that the agent can call. When the agent calls a client-side
+   * tool, execution pauses and returns control to the client to execute the tool and
+   * provide the result via a ToolReturn.
+   */
+  client_tools?: Array<MessageCreateParams.ClientTool> | null;
+
   /**
    * @deprecated If set to True, enables reasoning before responses or tool calls
    * from the agent.
@@ -165,6 +172,30 @@ export interface MessageCreateParams {
 }
 
 export namespace MessageCreateParams {
+  /**
+   * Schema for a client-side tool passed in the request.
+   *
+   * Client-side tools are executed by the client, not the server. When the agent
+   * calls a client-side tool, execution pauses and returns control to the client to
+   * execute the tool and provide the result.
+   */
+  export interface ClientTool {
+    /**
+     * The name of the tool function
+     */
+    name: string;
+
+    /**
+     * Description of what the tool does
+     */
+    description?: string | null;
+
+    /**
+     * JSON Schema for the function parameters
+     */
+    parameters?: { [key: string]: unknown } | null;
+  }
+
   /**
    * The style of reasoning content returned by the OpenAI Responses API
    */
@@ -321,6 +352,13 @@ export interface MessageStreamParams {
    */
   background?: boolean;
 
+  /**
+   * Client-side tools that the agent can call. When the agent calls a client-side
+   * tool, execution pauses and returns control to the client to execute the tool and
+   * provide the result via a ToolReturn.
+   */
+  client_tools?: Array<MessageStreamParams.ClientTool> | null;
+
   /**
    * @deprecated If set to True, enables reasoning before responses or tool calls
    * from the agent.
@@ -388,6 +426,30 @@ export interface MessageStreamParams {
 }
 
 export namespace MessageStreamParams {
+  /**
+   * Schema for a client-side tool passed in the request.
+   *
+   * Client-side tools are executed by the client, not the server. When the agent
+   * calls a client-side tool, execution pauses and returns control to the client to
+   * execute the tool and provide the result.
+   */
+  export interface ClientTool {
+    /**
+     * The name of the tool function
+     */
+    name: string;
+
+    /**
+     * Description of what the tool does
+     */
+    description?: string | null;
+
+    /**
+     * JSON Schema for the function parameters
+     */
+    parameters?: { [key: string]: unknown } | null;
+  }
+
   /**
    * The style of reasoning content returned by the OpenAI Responses API
    */

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.1'; // x-release-please-version
+export const VERSION = '1.6.3'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.1";
+export declare const VERSION = "1.6.3";
 //# 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.1'; // x-release-please-version
+exports.VERSION = '1.6.3'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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