@letta-ai/letta-client 1.0.0-alpha.13 → 1.0.0-alpha.15

package/resources/templates/agents.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agents.mjs","sourceRoot":"","sources":["../../src/resources/templates/agents.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;OAEG;IACH,MAAM,CAAC,eAAuB,EAAE,MAAyB,EAAE,OAAwB;QACjF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,iBAAiB,UAAU,IAAI,eAAe,SAAS,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"agents.mjs","sourceRoot":"","sources":["../../src/resources/templates/agents.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;OAEG;IACH,MAAM,CACJ,eAAuB,EACvB,OAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,iBAAiB,eAAe,SAAS,EAAE;YACtE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/src/client.ts

@@ -196,6 +196,11 @@ export interface ClientOptions {
 
   projectID?: string | null | undefined;
 
+  /**
+   * Deprecated, please use project_id instead.
+   */
+  project?: string | null | undefined;
+
   /**
    * Specifies the environment to use for the API.
    *
@@ -280,6 +285,7 @@ export interface ClientOptions {
 export class Letta {
   apiKey: string;
   projectID: string | null;
+  project: string | null;
 
   baseURL: string;
   maxRetries: number;
@@ -298,6 +304,7 @@ export class Letta {
    *
    * @param {string | undefined} [opts.apiKey=process.env['LETTA_API_KEY'] ?? undefined]
    * @param {string | null | undefined} [opts.projectID]
+   * @param {string | null | undefined} [opts.project]
    * @param {Environment} [opts.environment=cloud] - Specifies the environment URL to use for the API.
    * @param {string} [opts.baseURL=process.env['LETTA_BASE_URL'] ?? https://api.letta.com] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
@@ -311,6 +318,7 @@ export class Letta {
     baseURL = readEnv('LETTA_BASE_URL'),
     apiKey = readEnv('LETTA_API_KEY'),
     projectID = null,
+    project = null,
     ...opts
   }: ClientOptions = {}) {
     if (apiKey === undefined) {
@@ -322,6 +330,7 @@ export class Letta {
     const options: ClientOptions = {
       apiKey,
       projectID,
+      project,
       ...opts,
       baseURL,
       environment: opts.environment ?? 'cloud',
@@ -352,6 +361,7 @@ export class Letta {
 
     this.apiKey = apiKey;
     this.projectID = projectID;
+    this.project = project;
   }
 
   /**
@@ -370,6 +380,7 @@ export class Letta {
       fetchOptions: this.fetchOptions,
       apiKey: this.apiKey,
       projectID: this.projectID,
+      project: this.project,
       ...options,
     });
     return client;
@@ -840,7 +851,8 @@ export class Letta {
         'X-Stainless-Retry-Count': String(retryCount),
         ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
         ...getPlatformHeaders(),
-        'X-Project': this.projectID,
+        'X-Project-Id': this.projectID,
+        'X-Project': this.project,
       },
       await this.authHeaders(options),
       this._options.defaultHeaders,

package/src/core/pagination.ts

@@ -264,7 +264,7 @@ export interface NextFilesPageParams {
   order_by?: string | null;
 }
 
-export class NextFilesPage<Item extends { next_cursor: string | null }>
+export class NextFilesPage<Item extends { id: string }>
   extends AbstractPage<Item>
   implements NextFilesPageResponse<Item>
 {
@@ -304,8 +304,8 @@ export class NextFilesPage<Item extends { next_cursor: string | null }>
 
     const isForwards = !(typeof this.options.query === 'object' && 'before' in (this.options.query || {}));
     if (isForwards) {
-      const nextCursor = files[files.length - 1]?.next_cursor;
-      if (!nextCursor) {
+      const id = files[files.length - 1]?.id;
+      if (!id) {
         return null;
       }
 
@@ -313,13 +313,13 @@ export class NextFilesPage<Item extends { next_cursor: string | null }>
         ...this.options,
         query: {
           ...maybeObj(this.options.query),
-          after: nextCursor,
+          after: id,
         },
       };
     }
 
-    const nextCursor = files[0]?.next_cursor;
-    if (!nextCursor) {
+    const id = files[0]?.id;
+    if (!id) {
       return null;
     }
 
@@ -327,7 +327,7 @@ export class NextFilesPage<Item extends { next_cursor: string | null }>
       ...this.options,
       query: {
         ...maybeObj(this.options.query),
-        before: nextCursor,
+        before: id,
       },
     };
   }

package/src/resources/agents/agents.ts

@@ -22,6 +22,7 @@ import {
   FileCloseResponse,
   FileListParams,
   FileListResponse,
+  FileListResponsesNextFilesPage,
   FileOpenParams,
   FileOpenResponse,
   Files,
@@ -42,6 +43,7 @@ import {
   ApprovalRequestMessage,
   ApprovalResponseMessage,
   AssistantMessage,
+  EventMessage,
   HiddenReasoningMessage,
   ImageContent,
   JobStatus,
@@ -72,6 +74,7 @@ import {
   ReasoningMessage,
   RedactedReasoningContent,
   Run,
+  SummaryMessage,
   SystemMessage,
   TextContent,
   ToolCall,
@@ -1709,6 +1712,7 @@ export declare namespace Agents {
     type FileCloseResponse as FileCloseResponse,
     type FileCloseAllResponse as FileCloseAllResponse,
     type FileOpenResponse as FileOpenResponse,
+    type FileListResponsesNextFilesPage as FileListResponsesNextFilesPage,
     type FileListParams as FileListParams,
     type FileCloseParams as FileCloseParams,
     type FileOpenParams as FileOpenParams,
@@ -1733,6 +1737,7 @@ export declare namespace Agents {
     type ApprovalRequestMessage as ApprovalRequestMessage,
     type ApprovalResponseMessage as ApprovalResponseMessage,
     type AssistantMessage as AssistantMessage,
+    type EventMessage as EventMessage,
     type HiddenReasoningMessage as HiddenReasoningMessage,
     type ImageContent as ImageContent,
     type JobStatus as JobStatus,
@@ -1752,6 +1757,7 @@ export declare namespace Agents {
     type ReasoningMessage as ReasoningMessage,
     type RedactedReasoningContent as RedactedReasoningContent,
     type Run as Run,
+    type SummaryMessage as SummaryMessage,
     type SystemMessage as SystemMessage,
     type TextContent as TextContent,
     type ToolCall as ToolCall,

package/src/resources/agents/files.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { NextFilesPage, type NextFilesPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -13,8 +14,11 @@ export class Files extends APIResource {
     agentID: string,
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FileListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/files`, { query, ...options });
+  ): PagePromise<FileListResponsesNextFilesPage, FileListResponse> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/files`, NextFilesPage<FileListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -51,128 +55,80 @@ export class Files extends APIResource {
   }
 }
 
+export type FileListResponsesNextFilesPage = NextFilesPage<FileListResponse>;
+
 /**
- * Paginated response for agent files
+ * Response model for agent file attachments showing file status in agent context
  */
 export interface FileListResponse {
   /**
-   * List of file attachments for the agent
+   * Unique identifier of the file-agent relationship
    */
-  files: Array<FileListResponse.File>;
+  id: string;
 
   /**
-   * Whether more results exist after this page
+   * Unique identifier of the file
    */
-  has_more: boolean;
+  file_id: string;
 
   /**
-   * Cursor for fetching the next page (file-agent relationship ID)
+   * Name of the file
    */
-  next_cursor?: string | null;
-}
-
-export namespace FileListResponse {
-  /**
-   * Response model for agent file attachments showing file status in agent context
-   */
-  export interface File {
-    /**
-     * Unique identifier of the file-agent relationship
-     */
-    id: string;
-
-    /**
-     * Unique identifier of the file
-     */
-    file_id: string;
-
-    /**
-     * Name of the file
-     */
-    file_name: string;
-
-    /**
-     * Unique identifier of the folder/source
-     */
-    folder_id: string;
-
-    /**
-     * Name of the folder/source
-     */
-    folder_name: string;
-
-    /**
-     * Whether the file is currently open in the agent's context
-     */
-    is_open: boolean;
-
-    /**
-     * Ending line number if file was opened with line range
-     */
-    end_line?: number | null;
-
-    /**
-     * Timestamp of last access by the agent
-     */
-    last_accessed_at?: string | null;
-
-    /**
-     * Starting line number if file was opened with line range
-     */
-    start_line?: number | null;
-
-    /**
-     * Portion of the file visible to the agent if open
-     */
-    visible_content?: string | null;
-  }
-}
-
-export type FileCloseResponse = unknown;
+  file_name: string;
 
-export type FileCloseAllResponse = Array<string>;
+  /**
+   * Unique identifier of the folder/source
+   */
+  folder_id: string;
 
-export type FileOpenResponse = Array<string>;
+  /**
+   * Name of the folder/source
+   */
+  folder_name: string;
 
-export interface FileListParams {
   /**
-   * File ID cursor for pagination. Returns files that come after this file ID in the
-   * specified sort order
+   * Whether the file is currently open in the agent's context
    */
-  after?: string | null;
+  is_open: boolean;
 
   /**
-   * File ID cursor for pagination. Returns files that come before this file ID in
-   * the specified sort order
+   * Ending line number if file was opened with line range
    */
-  before?: string | null;
+  end_line?: number | null;
 
   /**
-   * @deprecated Pagination cursor from previous response (deprecated, use
-   * before/after)
+   * Timestamp of last access by the agent
    */
-  cursor?: string | null;
+  last_accessed_at?: string | null;
 
   /**
-   * Filter by open status (true for open files, false for closed files)
+   * Starting line number if file was opened with line range
    */
-  is_open?: boolean | null;
+  start_line?: number | null;
 
   /**
-   * Maximum number of files to return
+   * Portion of the file visible to the agent if open
    */
-  limit?: number | null;
+  visible_content?: string | null;
+}
+
+export type FileCloseResponse = unknown;
+
+export type FileCloseAllResponse = Array<string>;
 
+export type FileOpenResponse = Array<string>;
+
+export interface FileListParams extends NextFilesPageParams {
   /**
-   * Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
+   * @deprecated Pagination cursor from previous response (deprecated, use
+   * before/after)
    */
-  order?: 'asc' | 'desc';
+  cursor?: string | null;
 
   /**
-   * Field to sort by
+   * Filter by open status (true for open files, false for closed files)
    */
-  order_by?: 'created_at';
+  is_open?: boolean | null;
 }
 
 export interface FileCloseParams {
@@ -195,6 +151,7 @@ export declare namespace Files {
     type FileCloseResponse as FileCloseResponse,
     type FileCloseAllResponse as FileCloseAllResponse,
     type FileOpenResponse as FileOpenResponse,
+    type FileListResponsesNextFilesPage as FileListResponsesNextFilesPage,
     type FileListParams as FileListParams,
     type FileCloseParams as FileCloseParams,
     type FileOpenParams as FileOpenParams,

package/src/resources/agents/index.ts

@@ -50,6 +50,7 @@ export {
   type FileListParams,
   type FileCloseParams,
   type FileOpenParams,
+  type FileListResponsesNextFilesPage,
 } from './files';
 export {
   Folders,
@@ -65,6 +66,7 @@ export {
   type ApprovalRequestMessage,
   type ApprovalResponseMessage,
   type AssistantMessage,
+  type EventMessage,
   type HiddenReasoningMessage,
   type ImageContent,
   type JobStatus,
@@ -84,6 +86,7 @@ export {
   type ReasoningMessage,
   type RedactedReasoningContent,
   type Run,
+  type SummaryMessage,
   type SystemMessage,
   type TextContent,
   type ToolCall,