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

package/src/resources/agents/tools.ts

@@ -1,18 +1,22 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as ToolsAPI from '../tools';
 import * as AgentsAPI from './agents';
-import * as ToolsToolsAPI from '../tools/tools';
 import { APIPromise } from '../../core/api-promise';
 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,
+  ): APIPromise<ToolListResponse> {
+    return this._client.get(path`/v1/agents/${agentID}/tools`, { query, ...options });
   }
 
   /**
@@ -40,48 +44,94 @@ export class Tools extends APIResource {
   }
 
   /**
-   * 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;
+    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 type ToolListResponse = Array<ToolsAPI.Tool>;
+
+export interface ToolListParams {
+  /**
+   * Tool ID cursor for pagination. Returns tools that come after this tool ID in the
+   * specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Tool ID cursor for pagination. Returns tools that come before this tool ID in
+   * the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * Maximum number of tools to return
+   */
+  limit?: number | null;
+
+  /**
+   * Sort order for tools by creation time. 'asc' for oldest first, 'desc' for newest
+   * first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  order_by?: 'created_at';
+}
 
 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,
   };
 }

package/src/resources/archives.ts

@@ -1,27 +1,50 @@
 // 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 { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 export class Archives extends APIResource {
   /**
    * Create a new archive.
    */
-  update(body: ArchiveUpdateParams, options?: RequestOptions): APIPromise<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.
    */
-  retrieve(
-    query: ArchiveRetrieveParams | null | undefined = {},
+  list(
+    query: ArchiveListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ArchiveRetrieveResponse> {
+  ): APIPromise<ArchiveListResponse> {
     return this._client.get('/v1/archives/', { query, ...options });
   }
+
+  /**
+   * Delete an archive by its ID.
+   */
+  delete(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
+    return this._client.delete(path`/v1/archives/${archiveID}`, options);
+  }
 }
 
 /**
@@ -40,6 +63,11 @@ export interface Archive {
    */
   created_at: string;
 
+  /**
+   * Embedding configuration for passages in this archive
+   */
+  embedding_config: ModelsAPI.EmbeddingConfig;
+
   /**
    * The name of the archive
    */
@@ -86,15 +114,26 @@ export interface Archive {
  */
 export type VectorDBProvider = 'native' | 'tpuf' | 'pinecone';
 
-export type ArchiveRetrieveResponse = Array<Archive>;
+export type ArchiveListResponse = Array<Archive>;
+
+export interface ArchiveCreateParams {
+  /**
+   * Embedding configuration for the archive
+   */
+  embedding_config: ModelsAPI.EmbeddingConfig;
 
-export interface ArchiveUpdateParams {
   name: string;
 
   description?: string | null;
 }
 
-export interface ArchiveRetrieveParams {
+export interface ArchiveUpdateParams {
+  description?: string | null;
+
+  name?: string | null;
+}
+
+export interface ArchiveListParams {
   /**
    * Archive ID cursor for pagination. Returns archives that come after this archive
    * ID in the specified sort order
@@ -133,8 +172,9 @@ export declare namespace Archives {
   export {
     type Archive as Archive,
     type VectorDBProvider as VectorDBProvider,
-    type ArchiveRetrieveResponse as ArchiveRetrieveResponse,
+    type ArchiveListResponse as ArchiveListResponse,
+    type ArchiveCreateParams as ArchiveCreateParams,
     type ArchiveUpdateParams as ArchiveUpdateParams,
-    type ArchiveRetrieveParams as ArchiveRetrieveParams,
+    type ArchiveListParams as ArchiveListParams,
   };
 }

package/src/resources/{messages → batches}/batches.ts

@@ -1,14 +1,18 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as RunsAPI from '../runs';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
+import * as BatchesMessagesAPI from './messages';
+import { MessageListParams, MessageListResponse, Messages } from './messages';
+import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Batches extends APIResource {
+  messages: BatchesMessagesAPI.Messages = new BatchesMessagesAPI.Messages(this._client);
+
   /**
    * Submit a batch of agent runs for asynchronous processing.
    *
@@ -42,17 +46,6 @@ export class Batches extends APIResource {
   cancel(batchID: string, options?: RequestOptions): APIPromise<unknown> {
     return this._client.patch(path`/v1/messages/batches/${batchID}/cancel`, options);
   }
-
-  /**
-   * Get response messages for a specific batch job.
-   */
-  listMessages(
-    batchID: string,
-    query: BatchListMessagesParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<BatchListMessagesResponse> {
-    return this._client.get(path`/v1/messages/batches/${batchID}/messages`, { query, ...options });
-  }
 }
 
 export interface BatchJob {
@@ -61,6 +54,16 @@ export interface BatchJob {
    */
   id?: string;
 
+  /**
+   * The agent associated with this job/run.
+   */
+  agent_id?: string | null;
+
+  /**
+   * Whether the job was created in background mode.
+   */
+  background?: boolean | null;
+
   /**
    * Optional error message from attempting to POST the callback endpoint.
    */
@@ -138,10 +141,6 @@ export type BatchListResponse = Array<BatchJob>;
 
 export type BatchCancelResponse = unknown;
 
-export interface BatchListMessagesResponse {
-  messages: Array<MessagesAPI.Message>;
-}
-
 export interface BatchCreateParams {
   /**
    * List of requests to be processed in batch.
@@ -172,17 +171,21 @@ export namespace BatchCreateParams {
     messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
 
     /**
-     * The name of the message argument in the designated message tool.
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
      */
     assistant_message_tool_kwarg?: string;
 
     /**
-     * The name of the designated message tool.
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
      */
     assistant_message_tool_name?: string;
 
     /**
-     * If set to True, enables reasoning before responses or tool calls from the agent.
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
      */
     enable_thinking?: string;
 
@@ -198,8 +201,9 @@ export namespace BatchCreateParams {
     max_steps?: number;
 
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * @deprecated Whether the server should parse specific tool call arguments
+     * (default `send_message`) as `AssistantMessage` objects. Still supported for
+     * legacy agent types, but deprecated for letta_v1_agent onward.
      */
     use_assistant_message?: boolean;
   }
@@ -235,49 +239,20 @@ export interface BatchListParams {
   order_by?: 'created_at';
 }
 
-export interface BatchListMessagesParams {
-  /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Filter messages by agent ID
-   */
-  agent_id?: string | null;
-
-  /**
-   * Message ID cursor for pagination. Returns messages that come before this message
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-}
+Batches.Messages = Messages;
 
 export declare namespace Batches {
   export {
     type BatchJob as BatchJob,
     type BatchListResponse as BatchListResponse,
     type BatchCancelResponse as BatchCancelResponse,
-    type BatchListMessagesResponse as BatchListMessagesResponse,
     type BatchCreateParams as BatchCreateParams,
     type BatchListParams as BatchListParams,
-    type BatchListMessagesParams as BatchListMessagesParams,
+  };
+
+  export {
+    Messages as Messages,
+    type MessageListResponse as MessageListResponse,
+    type MessageListParams as MessageListParams,
   };
 }

package/src/resources/{messages → batches}/index.ts

@@ -5,9 +5,7 @@ export {
   type BatchJob,
   type BatchListResponse,
   type BatchCancelResponse,
-  type BatchListMessagesResponse,
   type BatchCreateParams,
   type BatchListParams,
-  type BatchListMessagesParams,
 } from './batches';
-export { Messages } from './messages';
+export { Messages, type MessageListResponse, type MessageListParams } from './messages';

package/src/resources/batches/messages.ts

@@ -0,0 +1,63 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as MessagesAPI from '../agents/messages';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Messages extends APIResource {
+  /**
+   * Get response messages for a specific batch job.
+   */
+  list(
+    batchID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageListResponse> {
+    return this._client.get(path`/v1/messages/batches/${batchID}/messages`, { query, ...options });
+  }
+}
+
+export interface MessageListResponse {
+  messages: Array<MessagesAPI.Message>;
+}
+
+export interface MessageListParams {
+  /**
+   * Message ID cursor for pagination. Returns messages that come after this message
+   * ID in the specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Filter messages by agent ID
+   */
+  agent_id?: string | null;
+
+  /**
+   * Message ID cursor for pagination. Returns messages that come before this message
+   * ID in the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * Maximum number of messages to return
+   */
+  limit?: number | null;
+
+  /**
+   * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
+   * newest first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  order_by?: 'created_at';
+}
+
+export declare namespace Messages {
+  export { type MessageListResponse as MessageListResponse, type MessageListParams as MessageListParams };
+}

package/src/resources/{tools/mcp.ts → batches.ts}

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './mcp/index';
+export * from './batches/index';

package/src/resources/blocks/agents.ts

@@ -0,0 +1,79 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from '../agents/agents';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Agents extends APIResource {
+  /**
+   * Retrieves all agents associated with the specified block. Raises a 404 if the
+   * block does not exist.
+   */
+  list(
+    blockID: string,
+    query: AgentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AgentListResponse> {
+    return this._client.get(path`/v1/blocks/${blockID}/agents`, { query, ...options });
+  }
+}
+
+export type AgentListResponse = Array<AgentsAPI.AgentState>;
+
+export interface AgentListParams {
+  /**
+   * Agent ID cursor for pagination. Returns agents that come after this agent ID in
+   * the specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Agent ID cursor for pagination. Returns agents that come before this agent ID in
+   * the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * Specify which relational fields to include in the response. No relationships are
+   * included by default.
+   */
+  include?: Array<
+    | 'agent.blocks'
+    | 'agent.identities'
+    | 'agent.managed_group'
+    | 'agent.secrets'
+    | 'agent.sources'
+    | 'agent.tags'
+    | 'agent.tools'
+  >;
+
+  /**
+   * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
+   * in the response. If not provided, all relationships are loaded by default. Using
+   * this can optimize performance by reducing unnecessary joins.This is a legacy
+   * parameter, and no longer supported after 1.0.0 SDK versions.
+   */
+  include_relationships?: Array<string> | null;
+
+  /**
+   * Maximum number of agents to return
+   */
+  limit?: number | null;
+
+  /**
+   * Sort order for agents by creation time. 'asc' for oldest first, 'desc' for
+   * newest first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  order_by?: 'created_at';
+}
+
+export declare namespace Agents {
+  export { type AgentListResponse as AgentListResponse, type AgentListParams as AgentListParams };
+}