@letta-ai/letta-client 1.2.0 → 1.3.1

package/src/resources/mcp-servers/tools.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as ToolsAPI from '../tools';
-import * as McpServersAPI from './mcp-servers';
+import * as AgentsToolsAPI from '../agents/tools';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -26,14 +26,14 @@ export class Tools extends APIResource {
   /**
    * Execute a specific MCP tool
    *
-   * The request body should contain the tool arguments in the MCPToolExecuteRequest
+   * The request body should contain the tool arguments in the ToolExecuteRequest
    * format.
    */
   run(
     toolID: string,
     params: ToolRunParams,
     options?: RequestOptions,
-  ): APIPromise<McpServersAPI.ToolExecutionResult> {
+  ): APIPromise<AgentsToolsAPI.ToolExecutionResult> {
     const { mcp_server_id, ...body } = params;
     return this._client.post(path`/v1/mcp-servers/${mcp_server_id}/tools/${toolID}/run`, {
       body,
@@ -55,7 +55,7 @@ export interface ToolRunParams {
   mcp_server_id: string;
 
   /**
-   * Body param: Arguments to pass to the MCP tool
+   * Body param: Arguments to pass to the tool
    */
   args?: { [key: string]: unknown };
 }

package/src/resources/messages.ts

@@ -0,0 +1,165 @@
+// 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 AgentsMessagesAPI from './agents/messages';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Messages extends APIResource {
+  /**
+   * List messages across all agents for the current user.
+   */
+  list(
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageListResponse> {
+    return this._client.get('/v1/messages/', { query, ...options });
+  }
+
+  /**
+   * Search messages across the organization with optional agent filtering. Returns
+   * messages with FTS/vector ranks and total RRF score.
+   *
+   * This is a cloud-only feature.
+   */
+  search(body: MessageSearchParams, options?: RequestOptions): APIPromise<MessageSearchResponse> {
+    return this._client.post('/v1/messages/search', { body, ...options });
+  }
+}
+
+export interface MessageSearchRequest {
+  /**
+   * Text query for full-text search
+   */
+  query: string;
+
+  /**
+   * Filter messages created on or before this date
+   */
+  end_date?: string | null;
+
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+
+  /**
+   * Search mode to use
+   */
+  search_mode?: 'vector' | 'fts' | 'hybrid';
+
+  /**
+   * Filter messages created after this date
+   */
+  start_date?: string | null;
+}
+
+/**
+ * Result from a message search operation with scoring details.
+ */
+export interface MessageSearchResult {
+  /**
+   * The embedded content (LLM-friendly)
+   */
+  embedded_text: string;
+
+  /**
+   * The raw message object
+   */
+  message: AgentsMessagesAPI.InternalMessage;
+
+  /**
+   * Reciprocal Rank Fusion combined score
+   */
+  rrf_score: number;
+
+  /**
+   * Full-text search rank position if FTS was used
+   */
+  fts_rank?: number | null;
+
+  /**
+   * Vector search rank position if vector search was used
+   */
+  vector_rank?: number | null;
+}
+
+export type MessageListResponse = Array<AgentsMessagesAPI.Message>;
+
+export type MessageSearchResponse = Array<
+  | AgentsMessagesAPI.SystemMessage
+  | AgentsMessagesAPI.UserMessage
+  | AgentsMessagesAPI.ReasoningMessage
+  | AgentsMessagesAPI.HiddenReasoningMessage
+  | AgentsMessagesAPI.ToolCallMessage
+  | ToolsAPI.ToolReturnMessage
+  | AgentsMessagesAPI.AssistantMessage
+  | AgentsMessagesAPI.ApprovalRequestMessage
+  | AgentsMessagesAPI.ApprovalResponseMessage
+  | AgentsMessagesAPI.SummaryMessage
+  | AgentsMessagesAPI.EventMessage
+>;
+
+export interface MessageListParams {
+  /**
+   * Message ID cursor for pagination. Returns messages that come after this message
+   * ID in the specified sort order
+   */
+  after?: 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';
+}
+
+export interface MessageSearchParams {
+  /**
+   * Text query for full-text search
+   */
+  query: string;
+
+  /**
+   * Filter messages created on or before this date
+   */
+  end_date?: string | null;
+
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+
+  /**
+   * Search mode to use
+   */
+  search_mode?: 'vector' | 'fts' | 'hybrid';
+
+  /**
+   * Filter messages created after this date
+   */
+  start_date?: string | null;
+}
+
+export declare namespace Messages {
+  export {
+    type MessageSearchRequest as MessageSearchRequest,
+    type MessageSearchResult as MessageSearchResult,
+    type MessageListResponse as MessageListResponse,
+    type MessageSearchResponse as MessageSearchResponse,
+    type MessageListParams as MessageListParams,
+    type MessageSearchParams as MessageSearchParams,
+  };
+}

package/src/resources/models/models.ts

@@ -1,6 +1,7 @@
 // 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 * as EmbeddingsAPI from './embeddings';
 import { EmbeddingListResponse, Embeddings } from './embeddings';
 import { APIPromise } from '../../core/api-promise';
@@ -326,6 +327,16 @@ export interface LlmConfig {
    */
   reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | null;
 
+  /**
+   * The response format for the model's output. Supports text, json_object, and
+   * json_schema (structured outputs). Can be set via model_settings.
+   */
+  response_format?:
+    | AgentsAPI.TextResponseFormat
+    | AgentsAPI.JsonSchemaResponseFormat
+    | AgentsAPI.JsonObjectResponseFormat
+    | null;
+
   /**
    * The temperature to use when generating text with the model. A higher temperature
    * will result in more random text.
@@ -481,6 +492,16 @@ export interface Model {
    */
   reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | null;
 
+  /**
+   * The response format for the model's output. Supports text, json_object, and
+   * json_schema (structured outputs). Can be set via model_settings.
+   */
+  response_format?:
+    | AgentsAPI.TextResponseFormat
+    | AgentsAPI.JsonSchemaResponseFormat
+    | AgentsAPI.JsonObjectResponseFormat
+    | null;
+
   /**
    * @deprecated Deprecated: The temperature to use when generating text with the
    * model.

package/src/resources/passages.ts

@@ -0,0 +1,182 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as PassagesAPI from './passages';
+import * as ModelsAPI from './models/models';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Passages extends APIResource {
+  /**
+   * Search passages across the organization with optional agent and archive
+   * filtering. Returns passages with relevance scores.
+   *
+   * This endpoint supports semantic search through passages:
+   *
+   * - If neither agent_id nor archive_id is provided, searches ALL passages in the
+   *   organization
+   * - If agent_id is provided, searches passages across all archives attached to
+   *   that agent
+   * - If archive_id is provided, searches passages within that specific archive
+   * - If both are provided, agent_id takes precedence
+   */
+  search(body: PassageSearchParams, options?: RequestOptions): APIPromise<PassageSearchResponse> {
+    return this._client.post('/v1/passages/search', { body, ...options });
+  }
+}
+
+/**
+ * Representation of a passage, which is stored in archival memory.
+ */
+export interface Passage {
+  /**
+   * 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 type PassageSearchResponse = Array<PassageSearchResponse.PassageSearchResponseItem>;
+
+export namespace PassageSearchResponse {
+  /**
+   * Result from a passage search operation with scoring details.
+   */
+  export interface PassageSearchResponseItem {
+    /**
+     * The passage object
+     */
+    passage: PassagesAPI.Passage;
+
+    /**
+     * Relevance score
+     */
+    score: number;
+
+    /**
+     * Additional metadata about the search result
+     */
+    metadata?: { [key: string]: unknown };
+  }
+}
+
+export interface PassageSearchParams {
+  /**
+   * Text query for semantic search
+   */
+  query: string;
+
+  /**
+   * Filter passages by agent ID
+   */
+  agent_id?: string | null;
+
+  /**
+   * Filter passages by archive ID
+   */
+  archive_id?: string | null;
+
+  /**
+   * Filter results to passages created before this datetime
+   */
+  end_date?: string | null;
+
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+
+  /**
+   * Filter results to passages created after this datetime
+   */
+  start_date?: string | null;
+
+  /**
+   * How to match tags - 'any' to match passages with any of the tags, 'all' to match
+   * only passages with all tags
+   */
+  tag_match_mode?: 'any' | 'all';
+
+  /**
+   * Optional list of tags to filter search results
+   */
+  tags?: Array<string> | null;
+}
+
+export declare namespace Passages {
+  export {
+    type Passage as Passage,
+    type PassageSearchResponse as PassageSearchResponse,
+    type PassageSearchParams as PassageSearchParams,
+  };
+}

package/src/resources/tools.ts

@@ -46,6 +46,18 @@ export class Tools extends APIResource {
     return this._client.delete(path`/v1/tools/${toolID}`, options);
   }
 
+  /**
+   * Search tools using semantic search.
+   *
+   * Requires tool embedding to be enabled (embed_tools=True). Uses vector search,
+   * full-text search, or hybrid mode to find tools matching the query.
+   *
+   * Returns tools ranked by relevance with their search scores.
+   */
+  search(body: ToolSearchParams, options?: RequestOptions): APIPromise<ToolSearchResponse> {
+    return this._client.post('/v1/tools/search', { body, ...options });
+  }
+
   /**
    * Create or update a tool
    */
@@ -304,6 +316,66 @@ export interface ToolReturnMessage {
   tool_returns?: Array<MessagesAPI.ToolReturn> | null;
 }
 
+/**
+ * Request model for searching tools using semantic search.
+ */
+export interface ToolSearchRequest {
+  /**
+   * Maximum number of results to return.
+   */
+  limit?: number;
+
+  /**
+   * Text query for semantic search.
+   */
+  query?: string | null;
+
+  /**
+   * Search mode: vector, fts, or hybrid.
+   */
+  search_mode?: 'vector' | 'fts' | 'hybrid';
+
+  /**
+   * Filter by tags (match any).
+   */
+  tags?: Array<string> | null;
+
+  /**
+   * Filter by tool types (e.g., 'custom', 'letta_core').
+   */
+  tool_types?: Array<string> | null;
+}
+
+/**
+ * Result from a tool search operation.
+ */
+export interface ToolSearchResult {
+  /**
+   * Combined relevance score (RRF for hybrid mode).
+   */
+  combined_score: number;
+
+  /**
+   * The matched tool.
+   */
+  tool: Tool;
+
+  /**
+   * The embedded text content used for matching.
+   */
+  embedded_text?: string | null;
+
+  /**
+   * Full-text search rank position.
+   */
+  fts_rank?: number | null;
+
+  /**
+   * Vector search rank position.
+   */
+  vector_rank?: number | null;
+}
+
 export type ToolType =
   | 'custom'
   | 'letta_core'
@@ -319,6 +391,8 @@ export type ToolType =
 
 export type ToolDeleteResponse = unknown;
 
+export type ToolSearchResponse = Array<ToolSearchResult>;
+
 export type ToolUpsertBaseToolsResponse = Array<Tool>;
 
 export interface ToolCreateParams {
@@ -481,6 +555,33 @@ export interface ToolListParams extends ArrayPageParams {
   tool_types?: Array<string> | null;
 }
 
+export interface ToolSearchParams {
+  /**
+   * Maximum number of results to return.
+   */
+  limit?: number;
+
+  /**
+   * Text query for semantic search.
+   */
+  query?: string | null;
+
+  /**
+   * Search mode: vector, fts, or hybrid.
+   */
+  search_mode?: 'vector' | 'fts' | 'hybrid';
+
+  /**
+   * Filter by tags (match any).
+   */
+  tags?: Array<string> | null;
+
+  /**
+   * Filter by tool types (e.g., 'custom', 'letta_core').
+   */
+  tool_types?: Array<string> | null;
+}
+
 export interface ToolUpsertParams {
   /**
    * The source code of the function.
@@ -547,13 +648,17 @@ export declare namespace Tools {
     type Tool as Tool,
     type ToolCreate as ToolCreate,
     type ToolReturnMessage as ToolReturnMessage,
+    type ToolSearchRequest as ToolSearchRequest,
+    type ToolSearchResult as ToolSearchResult,
     type ToolType as ToolType,
     type ToolDeleteResponse as ToolDeleteResponse,
+    type ToolSearchResponse as ToolSearchResponse,
     type ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse,
     type ToolsArrayPage as ToolsArrayPage,
     type ToolCreateParams as ToolCreateParams,
     type ToolUpdateParams as ToolUpdateParams,
     type ToolListParams as ToolListParams,
+    type ToolSearchParams as ToolSearchParams,
     type ToolUpsertParams as ToolUpsertParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.2.0'; // x-release-please-version
+export const VERSION = '1.3.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.2.0";
+export declare const VERSION = "1.3.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.2.0";
+export declare const VERSION = "1.3.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.2.0'; // x-release-please-version
+exports.VERSION = '1.3.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.2.0'; // x-release-please-version
+export const VERSION = '1.3.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map