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

package/src/resources/agents/folders.ts

@@ -2,8 +2,10 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from './agents';
-import * as SourcesAPI from '../sources/sources';
+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';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -11,8 +13,15 @@ export class Folders extends APIResource {
   /**
    * Get the folders associated with an agent.
    */
-  list(agentID: string, options?: RequestOptions): APIPromise<FolderListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/folders`, options);
+  list(
+    agentID: string,
+    query: FolderListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<FolderListResponsesArrayPage, FolderListResponse> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/folders`, ArrayPage<FolderListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -22,7 +31,7 @@ export class Folders extends APIResource {
     folderID: string,
     params: FolderAttachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/folders/attach/${folderID}`, options);
   }
@@ -34,25 +43,96 @@ export class Folders extends APIResource {
     folderID: string,
     params: FolderDetachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/folders/detach/${folderID}`, options);
   }
 }
 
-export type FolderListResponse = Array<SourcesAPI.Source>;
+export type FolderListResponsesArrayPage = ArrayPage<FolderListResponse>;
+
+/**
+ * (Deprecated: Use Folder) Representation of a source, which is a collection of
+ * files and passages.
+ */
+export interface FolderListResponse {
+  /**
+   * The human-friendly ID of the Source
+   */
+  id: string;
+
+  /**
+   * The embedding configuration used by the source.
+   */
+  embedding_config: ModelsAPI.EmbeddingConfig;
+
+  /**
+   * The name of the source.
+   */
+  name: string;
+
+  /**
+   * The timestamp when the source was created.
+   */
+  created_at?: string | null;
+
+  /**
+   * The id of the user that made this Tool.
+   */
+  created_by_id?: string | null;
+
+  /**
+   * The description of the source.
+   */
+  description?: string | null;
+
+  /**
+   * Instructions for how to use the source.
+   */
+  instructions?: string | null;
+
+  /**
+   * The id of the user that made this Tool.
+   */
+  last_updated_by_id?: string | null;
+
+  /**
+   * Metadata associated with the source.
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * The timestamp when the source was last updated.
+   */
+  updated_at?: string | null;
+
+  /**
+   * The vector database provider used for this source's passages
+   */
+  vector_db_provider?: ArchivesAPI.VectorDBProvider;
+}
+
+export interface FolderListParams extends ArrayPageParams {}
 
 export interface FolderAttachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
 export interface FolderDetachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
 export declare namespace Folders {
   export {
     type FolderListResponse as FolderListResponse,
+    type FolderListResponsesArrayPage as FolderListResponsesArrayPage,
+    type FolderListParams as FolderListParams,
     type FolderAttachParams as FolderAttachParams,
     type FolderDetachParams as FolderDetachParams,
   };

package/src/resources/agents/groups.ts

@@ -0,0 +1,37 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as GroupsGroupsAPI from '../groups/groups';
+import { GroupsArrayPage } from '../groups/groups';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Groups extends APIResource {
+  /**
+   * Lists the groups for an agent.
+   */
+  list(
+    agentID: string,
+    query: GroupListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<GroupsArrayPage, GroupsGroupsAPI.Group> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/groups`, ArrayPage<GroupsGroupsAPI.Group>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export interface GroupListParams extends ArrayPageParams {
+  /**
+   * Manager type to filter groups by
+   */
+  manager_type?: string | null;
+}
+
+export declare namespace Groups {
+  export { type GroupListParams as GroupListParams };
+}
+
+export { type GroupsArrayPage };

package/src/resources/agents/identities.ts

@@ -0,0 +1,51 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+export class Identities extends APIResource {
+  /**
+   * Attach an identity to an agent.
+   */
+  attach(identityID: string, params: IdentityAttachParams, options?: RequestOptions): APIPromise<unknown> {
+    const { agent_id } = params;
+    return this._client.patch(path`/v1/agents/${agent_id}/identities/attach/${identityID}`, options);
+  }
+
+  /**
+   * Detach an identity from an agent.
+   */
+  detach(identityID: string, params: IdentityDetachParams, options?: RequestOptions): APIPromise<unknown> {
+    const { agent_id } = params;
+    return this._client.patch(path`/v1/agents/${agent_id}/identities/detach/${identityID}`, options);
+  }
+}
+
+export type IdentityAttachResponse = unknown;
+
+export type IdentityDetachResponse = unknown;
+
+export interface IdentityAttachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export interface IdentityDetachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export declare namespace Identities {
+  export {
+    type IdentityAttachResponse as IdentityAttachResponse,
+    type IdentityDetachResponse as IdentityDetachResponse,
+    type IdentityAttachParams as IdentityAttachParams,
+    type IdentityDetachParams as IdentityDetachParams,
+  };
+}

package/src/resources/agents/index.ts

@@ -5,53 +5,58 @@ export {
   type AgentEnvironmentVariable,
   type AgentState,
   type AgentType,
+  type AnthropicModelSettings,
+  type AzureModelSettings,
+  type BedrockModelSettings,
   type ChildToolRule,
   type ConditionalToolRule,
   type ContinueToolRule,
+  type DeepseekModelSettings,
+  type GoogleAIModelSettings,
+  type GoogleVertexModelSettings,
+  type GroqModelSettings,
   type InitToolRule,
   type JsonObjectResponseFormat,
   type JsonSchemaResponseFormat,
   type LettaMessageContentUnion,
   type MaxCountPerStepToolRule,
   type MessageCreate,
+  type OpenAIModelSettings,
   type ParentToolRule,
   type RequiredBeforeExitToolRule,
   type RequiresApprovalToolRule,
   type TerminalToolRule,
   type TextResponseFormat,
-  type AgentListResponse,
+  type TogetherModelSettings,
+  type XaiModelSettings,
   type AgentDeleteResponse,
-  type AgentCountResponse,
-  type AgentExportResponse,
-  type AgentImportResponse,
-  type AgentListGroupsResponse,
-  type AgentMigrateResponse,
-  type AgentRetrieveContextResponse,
-  type AgentSearchResponse,
+  type AgentExportFileResponse,
+  type AgentImportFileResponse,
   type AgentCreateParams,
   type AgentRetrieveParams,
   type AgentUpdateParams,
   type AgentListParams,
-  type AgentExportParams,
-  type AgentImportParams,
-  type AgentListGroupsParams,
-  type AgentMigrateParams,
-  type AgentResetMessagesParams,
-  type AgentSearchParams,
-  type AgentSummarizeParams,
+  type AgentExportFileParams,
+  type AgentImportFileParams,
+  type AgentStatesArrayPage,
 } from './agents';
 export {
-  ArchivalMemory,
-  type ArchivalMemoryCreateResponse,
-  type ArchivalMemoryListResponse,
-  type ArchivalMemoryDeleteResponse,
-  type ArchivalMemorySearchResponse,
-  type ArchivalMemoryCreateParams,
-  type ArchivalMemoryListParams,
-  type ArchivalMemoryDeleteParams,
-  type ArchivalMemorySearchParams,
-} from './archival-memory';
-export { CoreMemory, type Memory, type CoreMemoryRetrieveVariablesResponse } from './core-memory/index';
+  Archives,
+  type ArchiveAttachResponse,
+  type ArchiveDetachResponse,
+  type ArchiveAttachParams,
+  type ArchiveDetachParams,
+} from './archives';
+export {
+  Blocks,
+  type Block,
+  type BlockUpdate,
+  type BlockRetrieveParams,
+  type BlockUpdateParams,
+  type BlockListParams,
+  type BlockAttachParams,
+  type BlockDetachParams,
+} from './blocks';
 export {
   Files,
   type FileListResponse,
@@ -61,28 +66,42 @@ export {
   type FileListParams,
   type FileCloseParams,
   type FileOpenParams,
+  type FileListResponsesNextFilesPage,
 } from './files';
 export {
   Folders,
   type FolderListResponse,
+  type FolderListParams,
   type FolderAttachParams,
   type FolderDetachParams,
+  type FolderListResponsesArrayPage,
 } from './folders';
+export { Groups, type GroupListParams } from './groups';
+export {
+  Identities,
+  type IdentityAttachResponse,
+  type IdentityDetachResponse,
+  type IdentityAttachParams,
+  type IdentityDetachParams,
+} from './identities';
 export {
   Messages,
   type ApprovalCreate,
   type ApprovalRequestMessage,
   type ApprovalResponseMessage,
+  type ApprovalReturn,
   type AssistantMessage,
+  type EventMessage,
   type HiddenReasoningMessage,
   type ImageContent,
+  type InternalMessage,
   type JobStatus,
   type JobType,
   type LettaAssistantMessageContentUnion,
-  type LettaMessageUnion,
   type LettaRequest,
   type LettaResponse,
   type LettaStreamingRequest,
+  type LettaStreamingResponse,
   type LettaUserMessageContentUnion,
   type Message,
   type MessageRole,
@@ -92,6 +111,7 @@ export {
   type ReasoningMessage,
   type RedactedReasoningContent,
   type Run,
+  type SummaryMessage,
   type SystemMessage,
   type TextContent,
   type ToolCall,
@@ -105,31 +125,23 @@ export {
   type UpdateSystemMessage,
   type UpdateUserMessage,
   type UserMessage,
-  type MessageUpdateResponse,
-  type MessageListResponse,
   type MessageCancelResponse,
-  type MessagePreviewRawPayloadResponse,
-  type MessageSearchResponse,
-  type MessageSendStreamResponse,
-  type MessageUpdateParams,
+  type MessageCreateParams,
+  type MessageCreateParamsNonStreaming,
+  type MessageCreateParamsStreaming,
   type MessageListParams,
   type MessageCancelParams,
-  type MessagePreviewRawPayloadParams,
-  type MessageSearchParams,
-  type MessageSendParams,
-  type MessageSendAsyncParams,
-  type MessageSendStreamParams,
+  type MessageCreateAsyncParams,
+  type MessageResetParams,
+  type MessageStreamParams,
+  type RunsArrayPage,
+  type MessagesArrayPage,
+  type InternalMessagesObjectPage,
 } from './messages';
-export {
-  Sources,
-  type SourceListResponse,
-  type SourceAttachParams,
-  type SourceDetachParams,
-} from './sources';
 export {
   Tools,
-  type ToolListResponse,
+  type ToolListParams,
   type ToolAttachParams,
   type ToolDetachParams,
-  type ToolModifyApprovalParams,
+  type ToolUpdateApprovalParams,
 } from './tools';