feat: add search routes

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-467b56c7f84bbc387cccfda48345431547f7e621bfb06f005ea5844de77f1858.yml
-openapi_spec_hash: ad37dbb38f5802754d614f1bb51e1b21
-config_hash: adc4dc768447fe1323ab69965879aef4
+configured_endpoints: 120
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-4e14f08c6f1c6bc43d4ade3d273ed496dcd340f54f94f5186bfae7855bfc41d2.yml
+openapi_spec_hash: 68cc3920d034bba6b9e1ccfc34ec42f7
+config_hash: f306cb189924fda3d07cc8a7c437b8f1

api.md

@@ -248,17 +248,13 @@ Methods:
 - <code title="get /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives/archives.ts">retrieve</a>(archiveID) -> Archive</code>
 - <code title="patch /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives/archives.ts">update</a>(archiveID, { ...params }) -> Archive</code>
 - <code title="get /v1/archives/">client.archives.<a href="./src/resources/archives/archives.ts">list</a>({ ...params }) -> ArchivesArrayPage</code>
-- <code title="delete /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives/archives.ts">delete</a>(archiveID) -> Archive</code>
+- <code title="delete /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives/archives.ts">delete</a>(archiveID) -> void</code>
 
 ## Passages
 
-Types:
-
-- <code><a href="./src/resources/archives/passages.ts">PassageCreateResponse</a></code>
-
 Methods:
 
-- <code title="post /v1/archives/{archive_id}/passages">client.archives.passages.<a href="./src/resources/archives/passages.ts">create</a>(archiveID, { ...params }) -> PassageCreateResponse</code>
+- <code title="post /v1/archives/{archive_id}/passages">client.archives.passages.<a href="./src/resources/archives/passages.ts">create</a>(archiveID, { ...params }) -> Passage</code>
 - <code title="delete /v1/archives/{archive_id}/passages/{passage_id}">client.archives.passages.<a href="./src/resources/archives/passages.ts">delete</a>(passageID, { ...params }) -> void</code>
 
 # Folders
@@ -549,6 +545,31 @@ Methods:
 - <code title="patch /v1/groups/{group_id}/reset-messages">client.groups.messages.<a href="./src/resources/groups/messages.ts">reset</a>(groupID) -> unknown</code>
 - <code title="post /v1/groups/{group_id}/messages/stream">client.groups.messages.<a href="./src/resources/groups/messages.ts">stream</a>(groupID, { ...params }) -> unknown</code>
 
+# Messages
+
+Types:
+
+- <code><a href="./src/resources/messages.ts">MessageSearchRequest</a></code>
+- <code><a href="./src/resources/messages.ts">MessageSearchResult</a></code>
+- <code><a href="./src/resources/messages.ts">MessageListResponse</a></code>
+- <code><a href="./src/resources/messages.ts">MessageSearchResponse</a></code>
+
+Methods:
+
+- <code title="get /v1/messages/">client.messages.<a href="./src/resources/messages.ts">list</a>({ ...params }) -> MessageListResponse</code>
+- <code title="post /v1/messages/search">client.messages.<a href="./src/resources/messages.ts">search</a>({ ...params }) -> MessageSearchResponse</code>
+
+# Passages
+
+Types:
+
+- <code><a href="./src/resources/passages.ts">Passage</a></code>
+- <code><a href="./src/resources/passages.ts">PassageSearchResponse</a></code>
+
+Methods:
+
+- <code title="post /v1/passages/search">client.passages.<a href="./src/resources/passages.ts">search</a>({ ...params }) -> PassageSearchResponse</code>
+
 # Batches
 
 Types:

src/client.ts

@@ -38,6 +38,16 @@ import {
   AccessTokenListResponse,
   AccessTokens,
 } from './resources/access-tokens';
+import {
+  MessageListParams,
+  MessageListResponse,
+  MessageSearchParams,
+  MessageSearchRequest,
+  MessageSearchResponse,
+  MessageSearchResult,
+  Messages,
+} from './resources/messages';
+import { Passage, PassageSearchParams, PassageSearchResponse, Passages } from './resources/passages';
 import { TagListParams, TagListResponse, Tags } from './resources/tags';
 import {
   NpmRequirement,
@@ -956,6 +966,8 @@ export class Letta {
   tags: API.Tags = new API.Tags(this);
   identities: API.Identities = new API.Identities(this);
   groups: API.Groups = new API.Groups(this);
+  messages: API.Messages = new API.Messages(this);
+  passages: API.Passages = new API.Passages(this);
   batches: API.Batches = new API.Batches(this);
   accessTokens: API.AccessTokens = new API.AccessTokens(this);
 }
@@ -973,6 +985,8 @@ Letta.Templates = Templates;
 Letta.Tags = Tags;
 Letta.Identities = Identities;
 Letta.Groups = Groups;
+Letta.Messages = Messages;
+Letta.Passages = Passages;
 Letta.Batches = Batches;
 Letta.AccessTokens = AccessTokens;
 
@@ -1165,6 +1179,23 @@ export declare namespace Letta {
     type GroupListParams as GroupListParams,
   };
 
+  export {
+    Messages as Messages,
+    type MessageSearchRequest as MessageSearchRequest,
+    type MessageSearchResult as MessageSearchResult,
+    type MessageListResponse as MessageListResponse,
+    type MessageSearchResponse as MessageSearchResponse,
+    type MessageListParams as MessageListParams,
+    type MessageSearchParams as MessageSearchParams,
+  };
+
+  export {
+    Passages as Passages,
+    type Passage as Passage,
+    type PassageSearchResponse as PassageSearchResponse,
+    type PassageSearchParams as PassageSearchParams,
+  };
+
   export {
     Batches as Batches,
     type BatchJob as BatchJob,

src/resources/archives/archives.ts

@@ -2,10 +2,11 @@
 
 import { APIResource } from '../../core/resource';
 import * as PassagesAPI from './passages';
-import { PassageCreateParams, PassageCreateResponse, PassageDeleteParams, Passages } from './passages';
+import { PassageCreateParams, PassageDeleteParams, Passages } from './passages';
 import * as ModelsAPI from '../models/models';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -47,8 +48,11 @@ export class Archives extends APIResource {
   /**
    * Delete an archive by its ID.
    */
-  delete(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.delete(path`/v1/archives/${archiveID}`, options);
+  delete(archiveID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/archives/${archiveID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
   }
 }
 
@@ -163,7 +167,6 @@ export declare namespace Archives {
 
   export {
     Passages as Passages,
-    type PassageCreateResponse as PassageCreateResponse,
     type PassageCreateParams as PassageCreateParams,
     type PassageDeleteParams as PassageDeleteParams,
   };

src/resources/archives/index.ts

@@ -9,9 +9,4 @@ export {
   type ArchiveListParams,
   type ArchivesArrayPage,
 } from './archives';
-export {
-  Passages,
-  type PassageCreateResponse,
-  type PassageCreateParams,
-  type PassageDeleteParams,
-} from './passages';
+export { Passages, type PassageCreateParams, type PassageDeleteParams } from './passages';

src/resources/archives/passages.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as ModelsAPI from '../models/models';
+import * as PassagesAPI from '../passages';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -17,7 +17,7 @@ export class Passages extends APIResource {
     archiveID: string,
     body: PassageCreateParams,
     options?: RequestOptions,
-  ): APIPromise<PassageCreateResponse> {
+  ): APIPromise<PassagesAPI.Passage> {
     return this._client.post(path`/v1/archives/${archiveID}/passages`, { body, ...options });
   }
 
@@ -36,87 +36,6 @@ export class Passages extends APIResource {
   }
 }
 
-/**
- * Representation of a passage, which is stored in archival memory.
- */
-export interface PassageCreateResponse {
-  /**
-   * The embedding of the passage.
-   */
-  embedding: Array<number> | null;
-
-  /**
-   * Configuration for embedding model connection and processing parameters.
-   */
-  embedding_config: ModelsAPI.EmbeddingConfig | null;
-
-  /**
-   * The text of the passage.
-   */
-  text: string;
-
-  /**
-   * The human-friendly ID of the Passage
-   */
-  id?: string;
-
-  /**
-   * The unique identifier of the archive containing this passage.
-   */
-  archive_id?: string | null;
-
-  /**
-   * The creation date of the passage.
-   */
-  created_at?: string;
-
-  /**
-   * The id of the user that made this object.
-   */
-  created_by_id?: string | null;
-
-  /**
-   * The unique identifier of the file associated with the passage.
-   */
-  file_id?: string | null;
-
-  /**
-   * The name of the file (only for source passages).
-   */
-  file_name?: string | null;
-
-  /**
-   * Whether this passage is deleted or not.
-   */
-  is_deleted?: boolean;
-
-  /**
-   * The id of the user that made this object.
-   */
-  last_updated_by_id?: string | null;
-
-  /**
-   * The metadata of the passage.
-   */
-  metadata?: { [key: string]: unknown } | null;
-
-  /**
-   * @deprecated Deprecated: Use `folder_id` field instead. The data source of the
-   * passage.
-   */
-  source_id?: string | null;
-
-  /**
-   * Tags associated with this passage.
-   */
-  tags?: Array<string> | null;
-
-  /**
-   * The timestamp when the object was last updated.
-   */
-  updated_at?: string | null;
-}
-
 export interface PassageCreateParams {
   /**
    * The text content of the passage
@@ -142,9 +61,5 @@ export interface PassageDeleteParams {
 }
 
 export declare namespace Passages {
-  export {
-    type PassageCreateResponse as PassageCreateResponse,
-    type PassageCreateParams as PassageCreateParams,
-    type PassageDeleteParams as PassageDeleteParams,
-  };
+  export { type PassageCreateParams as PassageCreateParams, type PassageDeleteParams as PassageDeleteParams };
 }

src/resources/index.ts

@@ -134,6 +134,15 @@ export {
   type McpServerUpdateParams,
   type McpServerRefreshParams,
 } from './mcp-servers/mcp-servers';
+export {
+  Messages,
+  type MessageSearchRequest,
+  type MessageSearchResult,
+  type MessageListResponse,
+  type MessageSearchResponse,
+  type MessageListParams,
+  type MessageSearchParams,
+} from './messages';
 export {
   Models,
   type EmbeddingConfig,
@@ -145,6 +154,7 @@ export {
   type ModelListResponse,
   type ModelListParams,
 } from './models/models';
+export { Passages, type Passage, type PassageSearchResponse, type PassageSearchParams } from './passages';
 export { Runs, type Job, type StopReasonType, type RunListParams } from './runs/runs';
 export {
   Steps,