@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.0

package/src/resources/agents/tools.ts

@@ -1,18 +1,27 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as ToolsAPI from '../tools';
+import { ToolsArrayPage } from '../tools';
 import * as AgentsAPI from './agents';
-import * as ToolsToolsAPI from '../tools/tools';
 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 Tools extends APIResource {
   /**
-   * Get tools from an existing agent
+   * Get tools from an existing agent.
    */
-  list(agentID: string, options?: RequestOptions): APIPromise<ToolListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/tools`, options);
+  list(
+    agentID: string,
+    query: ToolListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ToolsArrayPage, ToolsAPI.Tool> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/tools`, ArrayPage<ToolsAPI.Tool>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -22,7 +31,7 @@ export class Tools extends APIResource {
     toolID: string,
     params: ToolAttachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/tools/attach/${toolID}`, options);
   }
@@ -34,54 +43,71 @@ export class Tools extends APIResource {
     toolID: string,
     params: ToolDetachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/tools/detach/${toolID}`, options);
   }
 
   /**
-   * Attach a tool to an agent.
+   * Modify the approval requirement for a tool attached to an agent.
+   *
+   * Accepts requires_approval via request body (preferred) or query parameter
+   * (deprecated).
    */
-  modifyApproval(
+  updateApproval(
     toolName: string,
-    params: ToolModifyApprovalParams,
+    params: ToolUpdateApprovalParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
-    const { agent_id, requires_approval } = params;
+  ): APIPromise<AgentsAPI.AgentState | null> {
+    const { agent_id, query_requires_approval, ...body } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/tools/approval/${toolName}`, {
-      query: { requires_approval },
+      query: { requires_approval: query_requires_approval },
+      body,
       ...options,
     });
   }
 }
 
-export type ToolListResponse = Array<ToolsToolsAPI.Tool>;
+export interface ToolListParams extends ArrayPageParams {}
 
 export interface ToolAttachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
 export interface ToolDetachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
-export interface ToolModifyApprovalParams {
+export interface ToolUpdateApprovalParams {
   /**
-   * Path param:
+   * Path param: The ID of the agent in the format 'agent-<uuid4>'
    */
   agent_id: string;
 
   /**
-   * Query param:
+   * Body param: Whether the tool requires approval before execution
+   */
+  body_requires_approval: boolean;
+
+  /**
+   * @deprecated Query param: Whether the tool requires approval before execution
    */
-  requires_approval: boolean;
+  query_requires_approval?: boolean | null;
 }
 
 export declare namespace Tools {
   export {
-    type ToolListResponse as ToolListResponse,
+    type ToolListParams as ToolListParams,
     type ToolAttachParams as ToolAttachParams,
     type ToolDetachParams as ToolDetachParams,
-    type ToolModifyApprovalParams as ToolModifyApprovalParams,
+    type ToolUpdateApprovalParams as ToolUpdateApprovalParams,
   };
 }
+
+export { type ToolsArrayPage };

package/src/resources/archives/archives.ts

@@ -0,0 +1,170 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as PassagesAPI from './passages';
+import { PassageCreateParams, PassageCreateResponse, 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 { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Archives extends APIResource {
+  passages: PassagesAPI.Passages = new PassagesAPI.Passages(this._client);
+
+  /**
+   * 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);
+  }
+
+  /**
+   * Update an existing archive's name and/or description.
+   */
+  update(archiveID: string, body: ArchiveUpdateParams, options?: RequestOptions): APIPromise<Archive> {
+    return this._client.patch(path`/v1/archives/${archiveID}`, { body, ...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);
+  }
+}
+
+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 {
+  name: string;
+
+  description?: string | null;
+
+  /**
+   * Embedding model handle for the archive
+   */
+  embedding?: string | null;
+
+  /**
+   * Configuration for embedding model connection and processing parameters.
+   */
+  embedding_config?: ModelsAPI.EmbeddingConfig | null;
+}
+
+export interface ArchiveUpdateParams {
+  description?: string | null;
+
+  name?: 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;
+}
+
+Archives.Passages = Passages;
+
+export declare namespace Archives {
+  export {
+    type Archive as Archive,
+    type VectorDBProvider as VectorDBProvider,
+    type ArchivesArrayPage as ArchivesArrayPage,
+    type ArchiveCreateParams as ArchiveCreateParams,
+    type ArchiveUpdateParams as ArchiveUpdateParams,
+    type ArchiveListParams as ArchiveListParams,
+  };
+
+  export {
+    Passages as Passages,
+    type PassageCreateResponse as PassageCreateResponse,
+    type PassageCreateParams as PassageCreateParams,
+    type PassageDeleteParams as PassageDeleteParams,
+  };
+}

package/src/resources/archives/index.ts

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Archives,
+  type Archive,
+  type VectorDBProvider,
+  type ArchiveCreateParams,
+  type ArchiveUpdateParams,
+  type ArchiveListParams,
+  type ArchivesArrayPage,
+} from './archives';
+export {
+  Passages,
+  type PassageCreateResponse,
+  type PassageCreateParams,
+  type PassageDeleteParams,
+} from './passages';

package/src/resources/archives/passages.ts

@@ -0,0 +1,150 @@
+// 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 { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Passages extends APIResource {
+  /**
+   * Create a new passage in an archive.
+   *
+   * This adds a passage to the archive and creates embeddings for vector storage.
+   */
+  create(
+    archiveID: string,
+    body: PassageCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<PassageCreateResponse> {
+    return this._client.post(path`/v1/archives/${archiveID}/passages`, { body, ...options });
+  }
+
+  /**
+   * Delete a passage from an archive.
+   *
+   * This permanently removes the passage from both the database and vector storage
+   * (if applicable).
+   */
+  delete(passageID: string, params: PassageDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { archive_id } = params;
+    return this._client.delete(path`/v1/archives/${archive_id}/passages/${passageID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * 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
+   */
+  text: string;
+
+  /**
+   * Optional metadata for the passage
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Optional tags for categorizing the passage
+   */
+  tags?: Array<string> | null;
+}
+
+export interface PassageDeleteParams {
+  /**
+   * The ID of the archive in the format 'archive-<uuid4>'
+   */
+  archive_id: string;
+}
+
+export declare namespace Passages {
+  export {
+    type PassageCreateResponse as PassageCreateResponse,
+    type PassageCreateParams as PassageCreateParams,
+    type PassageDeleteParams as PassageDeleteParams,
+  };
+}

package/src/resources/archives.ts

@@ -1,140 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import { APIPromise } from '../core/api-promise';
-import { RequestOptions } from '../internal/request-options';
-
-export class Archives extends APIResource {
-  /**
-   * Create a new archive.
-   */
-  update(body: ArchiveUpdateParams, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.post('/v1/archives/', { body, ...options });
-  }
-
-  /**
-   * Get a list of all archives for the current organization with optional filters
-   * and pagination.
-   */
-  retrieve(
-    query: ArchiveRetrieveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ArchiveRetrieveResponse> {
-    return this._client.get('/v1/archives/', { query, ...options });
-  }
-}
-
-/**
- * Representation of an archive - a collection of archival passages that can be
- * shared between agents.
- *
- * Parameters: id (str): The unique identifier of the archive. name (str): The name
- * of the archive. description (str): A description of the archive. organization_id
- * (str): The organization this archive belongs to. created_at (datetime): The
- * creation date of the archive. metadata (dict): Additional metadata for the
- * archive.
- */
-export interface Archive {
-  /**
-   * The creation date of the archive
-   */
-  created_at: string;
-
-  /**
-   * The name of the archive
-   */
-  name: string;
-
-  /**
-   * The human-friendly ID of the Archive
-   */
-  id?: 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 type ArchiveRetrieveResponse = Array<Archive>;
-
-export interface ArchiveUpdateParams {
-  name: string;
-
-  description?: string | null;
-}
-
-export interface ArchiveRetrieveParams {
-  /**
-   * Archive ID cursor for pagination. Returns archives that come after this archive
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Only archives attached to this agent ID
-   */
-  agent_id?: string | null;
-
-  /**
-   * Archive ID cursor for pagination. Returns archives that come before this archive
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of archives to return
-   */
-  limit?: number | null;
-
-  /**
-   * Filter by archive name (exact match)
-   */
-  name?: string | null;
-
-  /**
-   * Sort order for archives by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-}
-
-export declare namespace Archives {
-  export {
-    type Archive as Archive,
-    type VectorDBProvider as VectorDBProvider,
-    type ArchiveRetrieveResponse as ArchiveRetrieveResponse,
-    type ArchiveUpdateParams as ArchiveUpdateParams,
-    type ArchiveRetrieveParams as ArchiveRetrieveParams,
-  };
-}
+export * from './archives/index';