@letta-ai/letta-client 1.2.0 → 1.3.2

package/src/resources/templates/templates.ts

@@ -3,14 +3,157 @@
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from './agents';
 import { AgentCreateParams, AgentCreateResponse, Agents } from './agents';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
 
 export class Templates extends APIResource {
   agents: AgentsAPI.Agents = new AgentsAPI.Agents(this._client);
+
+  /**
+   * Creates a new template from an existing agent or agent file
+   */
+  create(body: TemplateCreateParams, options?: RequestOptions): APIPromise<TemplateCreateResponse> {
+    return this._client.post('/v1/templates', { body, ...options });
+  }
+
+  /**
+   * Updates the current working version of a template from an agent file
+   */
+  update(
+    templateName: string,
+    body: TemplateUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<TemplateUpdateResponse> {
+    return this._client.patch(path`/v1/templates/${templateName}`, { body, ...options });
+  }
+
+  /**
+   * Deletes all versions of a template with the specified name
+   */
+  delete(
+    templateName: string,
+    body?: TemplateDeleteParams | null | undefined,
+    options?: RequestOptions,
+  ): APIPromise<TemplateDeleteResponse> {
+    return this._client.delete(path`/v1/templates/${templateName}`, { body, ...options });
+  }
+}
+
+export interface TemplateCreateResponse {
+  id: string;
+
+  /**
+   * The latest version of the template
+   */
+  latest_version: string;
+
+  /**
+   * The exact name of the template
+   */
+  name: string;
+
+  project_id: string;
+
+  project_slug: string;
+
+  /**
+   * The full name of the template, including version and project slug
+   */
+  template_deployment_slug: string;
+
+  /**
+   * When the template was last updated
+   */
+  updated_at: string;
+
+  description?: string;
+}
+
+export interface TemplateUpdateResponse {
+  success: boolean;
+
+  message?: string;
+}
+
+export interface TemplateDeleteResponse {
+  success: boolean;
 }
 
+export type TemplateCreateParams = TemplateCreateParams.Variant0 | TemplateCreateParams.Variant1;
+
+export declare namespace TemplateCreateParams {
+  export interface Variant0 {
+    /**
+     * The ID of the agent to use as a template, can be from any project
+     */
+    agent_id: string;
+
+    type: 'agent';
+
+    /**
+     * Optional custom name for the template. If not provided, a random name will be
+     * generated.
+     */
+    name?: string;
+  }
+
+  export interface Variant1 {
+    /**
+     * The agent file to use as a template, this should be a JSON file exported from
+     * the platform
+     */
+    agent_file: { [key: string]: unknown };
+
+    type: 'agent_file';
+
+    /**
+     * Optional custom name for the template. If not provided, a random name will be
+     * generated.
+     */
+    name?: string;
+
+    /**
+     * If true, update existing custom tools source_code and json_schema (source_type
+     * cannot be changed)
+     */
+    update_existing_tools?: boolean;
+  }
+}
+
+export interface TemplateUpdateParams {
+  /**
+   * The agent file to update the current template version from
+   */
+  agent_file_json: { [key: string]: unknown };
+
+  /**
+   * If true, Letta will automatically save any changes as a version before updating
+   * the template
+   */
+  save_existing_changes?: boolean;
+
+  /**
+   * If true, update existing custom tools source_code and json_schema (source_type
+   * cannot be changed)
+   */
+  update_existing_tools?: boolean;
+}
+
+export interface TemplateDeleteParams {}
+
 Templates.Agents = Agents;
 
 export declare namespace Templates {
+  export {
+    type TemplateCreateResponse as TemplateCreateResponse,
+    type TemplateUpdateResponse as TemplateUpdateResponse,
+    type TemplateDeleteResponse as TemplateDeleteResponse,
+    type TemplateCreateParams as TemplateCreateParams,
+    type TemplateUpdateParams as TemplateUpdateParams,
+    type TemplateDeleteParams as TemplateDeleteParams,
+  };
+
   export {
     Agents as Agents,
     type AgentCreateResponse as AgentCreateResponse,

package/src/resources/tools.ts

@@ -47,17 +47,22 @@ export class Tools extends APIResource {
   }
 
   /**
-   * Create or update a tool
-   */
-  upsert(body: ToolUpsertParams, options?: RequestOptions): APIPromise<Tool> {
-    return this._client.put('/v1/tools/', { body, ...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 });
   }
 
   /**
-   * Upsert base tools
+   * Create or update a tool
    */
-  upsertBaseTools(options?: RequestOptions): APIPromise<ToolUpsertBaseToolsResponse> {
-    return this._client.post('/v1/tools/add-base-tools', options);
+  upsert(body: ToolUpsertParams, options?: RequestOptions): APIPromise<Tool> {
+    return this._client.put('/v1/tools/', { body, ...options });
   }
 }
 
@@ -304,6 +309,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,7 +384,7 @@ export type ToolType =
 
 export type ToolDeleteResponse = unknown;
 
-export type ToolUpsertBaseToolsResponse = Array<Tool>;
+export type ToolSearchResponse = Array<ToolSearchResult>;
 
 export interface ToolCreateParams {
   /**
@@ -481,6 +546,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 +639,16 @@ 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 ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse,
+    type ToolSearchResponse as ToolSearchResponse,
     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.2'; // 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.2";
 //# 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.2";
 //# 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.2'; // 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.2'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map