feat: add passage deletion route to sdk

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 114
+configured_endpoints: 115
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-26312e06e05b7fa971782db5f8edbbbe2d3c13e0073fe9481b966d8edd6fedc7.yml
 openapi_spec_hash: 41d6c5e06810ee240202f8e4dd1142cf
-config_hash: a81f1a6c73e9aadbac66af8534ce8edc
+config_hash: d290a6d98369e3135a785ad352fb2996

api.md

@@ -230,16 +230,22 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/archives.ts">Archive</a></code>
-- <code><a href="./src/resources/archives.ts">VectorDBProvider</a></code>
+- <code><a href="./src/resources/archives/archives.ts">Archive</a></code>
+- <code><a href="./src/resources/archives/archives.ts">VectorDBProvider</a></code>
 
 Methods:
 
-- <code title="post /v1/archives/">client.archives.<a href="./src/resources/archives.ts">create</a>({ ...params }) -> Archive</code>
-- <code title="get /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives.ts">retrieve</a>(archiveID) -> Archive</code>
-- <code title="get /v1/archives/">client.archives.<a href="./src/resources/archives.ts">list</a>({ ...params }) -> ArchivesArrayPage</code>
-- <code title="delete /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives.ts">delete</a>(archiveID) -> Archive</code>
-- <code title="patch /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives.ts">modify</a>(archiveID, { ...params }) -> Archive</code>
+- <code title="post /v1/archives/">client.archives.<a href="./src/resources/archives/archives.ts">create</a>({ ...params }) -> Archive</code>
+- <code title="get /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives/archives.ts">retrieve</a>(archiveID) -> 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="patch /v1/archives/{archive_id}">client.archives.<a href="./src/resources/archives/archives.ts">modify</a>(archiveID, { ...params }) -> Archive</code>
+
+## Passages
+
+Methods:
+
+- <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
 

src/client.ts

@@ -29,15 +29,6 @@ import * as API from './resources/index';
 import * as TopLevelAPI from './resources/top-level';
 import { HealthResponse } from './resources/top-level';
 import { APIPromise } from './core/api-promise';
-import {
-  Archive,
-  ArchiveCreateParams,
-  ArchiveListParams,
-  ArchiveModifyParams,
-  Archives,
-  ArchivesArrayPage,
-  VectorDBProvider,
-} from './resources/archives';
 import { TagListParams, TagListResponse, Tags } from './resources/tags';
 import {
   NpmRequirement,
@@ -85,6 +76,15 @@ import {
   TerminalToolRule,
   TextResponseFormat,
 } from './resources/agents/agents';
+import {
+  Archive,
+  ArchiveCreateParams,
+  ArchiveListParams,
+  ArchiveModifyParams,
+  Archives,
+  ArchivesArrayPage,
+  VectorDBProvider,
+} from './resources/archives/archives';
 import {
   BatchCancelResponse,
   BatchCreateParams,

src/resources/agents/agents.ts

@@ -2,9 +2,8 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from './agents';
-import * as ArchivesAPI from '../archives';
 import * as ToolsAPI from '../tools';
-import * as AgentsArchivesAPI from './archives';
+import * as ArchivesAPI from './archives';
 import {
   ArchiveAttachParams,
   ArchiveAttachResponse,
@@ -110,6 +109,7 @@ import {
 } from './messages';
 import * as AgentsToolsAPI from './tools';
 import { ToolAttachParams, ToolDetachParams, ToolListParams, ToolUpdateApprovalParams, Tools } from './tools';
+import * as ArchivesArchivesAPI from '../archives/archives';
 import * as BlocksBlocksAPI from '../blocks/blocks';
 import * as GroupsGroupsAPI from '../groups/groups';
 import * as IdentitiesIdentitiesAPI from '../identities/identities';
@@ -130,7 +130,7 @@ export class Agents extends APIResource {
   folders: FoldersAPI.Folders = new FoldersAPI.Folders(this._client);
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
   groups: GroupsAPI.Groups = new GroupsAPI.Groups(this._client);
-  archives: AgentsArchivesAPI.Archives = new AgentsArchivesAPI.Archives(this._client);
+  archives: ArchivesAPI.Archives = new ArchivesAPI.Archives(this._client);
   identities: IdentitiesAPI.Identities = new IdentitiesAPI.Identities(this._client);
 
   /**
@@ -720,7 +720,7 @@ export namespace AgentState {
     /**
      * The vector database provider used for this source's passages
      */
-    vector_db_provider?: ArchivesAPI.VectorDBProvider;
+    vector_db_provider?: ArchivesArchivesAPI.VectorDBProvider;
   }
 
   export interface OpenAIModelSettings {

src/resources/agents/folders.ts

@@ -1,8 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as ArchivesAPI from '../archives';
 import * as AgentsAPI from './agents';
+import * as ArchivesAPI from '../archives/archives';
 import * as ModelsAPI from '../models/models';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';

src/resources/archives.ts

@@ -1,152 +1,3 @@
 // 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 { APIPromise } from '../core/api-promise';
-import { ArrayPage, type ArrayPageParams, PagePromise } from '../core/pagination';
-import { RequestOptions } from '../internal/request-options';
-import { path } from '../internal/utils/path';
-
-export class Archives extends APIResource {
-  /**
-   * Create a new archive.
-   */
-  create(body: ArchiveCreateParams, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.post('/v1/archives/', { body, ...options });
-  }
-
-  /**
-   * Get a single archive by its ID.
-   */
-  retrieve(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.get(path`/v1/archives/${archiveID}`, options);
-  }
-
-  /**
-   * Get a list of all archives for the current organization with optional filters
-   * and pagination.
-   */
-  list(
-    query: ArchiveListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ArchivesArrayPage, Archive> {
-    return this._client.getAPIList('/v1/archives/', ArrayPage<Archive>, { query, ...options });
-  }
-
-  /**
-   * Delete an archive by its ID.
-   */
-  delete(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.delete(path`/v1/archives/${archiveID}`, options);
-  }
-
-  /**
-   * Update an existing archive's name and/or description.
-   */
-  modify(archiveID: string, body: ArchiveModifyParams, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.patch(path`/v1/archives/${archiveID}`, { body, ...options });
-  }
-}
-
-export type ArchivesArrayPage = ArrayPage<Archive>;
-
-/**
- * Representation of an archive - a collection of archival passages that can be
- * shared between agents.
- */
-export interface Archive {
-  /**
-   * The human-friendly ID of the Archive
-   */
-  id: string;
-
-  /**
-   * The creation date of the archive
-   */
-  created_at: string;
-
-  /**
-   * Embedding configuration for passages in this archive
-   */
-  embedding_config: ModelsAPI.EmbeddingConfig;
-
-  /**
-   * The name of the archive
-   */
-  name: string;
-
-  /**
-   * The id of the user that made this object.
-   */
-  created_by_id?: string | null;
-
-  /**
-   * A description of the archive
-   */
-  description?: string | null;
-
-  /**
-   * The id of the user that made this object.
-   */
-  last_updated_by_id?: string | null;
-
-  /**
-   * Additional metadata
-   */
-  metadata?: { [key: string]: unknown } | null;
-
-  /**
-   * The timestamp when the object was last updated.
-   */
-  updated_at?: string | null;
-
-  /**
-   * The vector database provider used for this archive's passages
-   */
-  vector_db_provider?: VectorDBProvider;
-}
-
-/**
- * Supported vector database providers for archival memory
- */
-export type VectorDBProvider = 'native' | 'tpuf' | 'pinecone';
-
-export interface ArchiveCreateParams {
-  /**
-   * Embedding configuration for the archive
-   */
-  embedding_config: ModelsAPI.EmbeddingConfig;
-
-  name: string;
-
-  description?: string | null;
-}
-
-export interface ArchiveListParams extends ArrayPageParams {
-  /**
-   * Only archives attached to this agent ID
-   */
-  agent_id?: string | null;
-
-  /**
-   * Filter by archive name (exact match)
-   */
-  name?: string | null;
-}
-
-export interface ArchiveModifyParams {
-  description?: string | null;
-
-  name?: string | null;
-}
-
-export declare namespace Archives {
-  export {
-    type Archive as Archive,
-    type VectorDBProvider as VectorDBProvider,
-    type ArchivesArrayPage as ArchivesArrayPage,
-    type ArchiveCreateParams as ArchiveCreateParams,
-    type ArchiveListParams as ArchiveListParams,
-    type ArchiveModifyParams as ArchiveModifyParams,
-  };
-}
+export * from './archives/index';