@letta-ai/letta-client 1.0.0-alpha.10 → 1.0.0-alpha.11

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

@@ -0,0 +1,43 @@
+// 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 Refresh extends APIResource {
+  /**
+   * Refresh tools for an MCP server by:
+   *
+   * 1. Fetching current tools from the MCP server
+   * 2. Deleting tools that no longer exist on the server
+   * 3. Updating schemas for existing tools
+   * 4. Adding new tools from the server
+   *
+   * Returns a summary of changes made.
+   */
+  trigger(
+    mcpServerID: string,
+    params: RefreshTriggerParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<unknown> {
+    const { agent_id } = params ?? {};
+    return this._client.patch(path`/v1/mcp-servers/${mcpServerID}/refresh`, {
+      query: { agent_id },
+      ...options,
+    });
+  }
+}
+
+export type RefreshTriggerResponse = unknown;
+
+export interface RefreshTriggerParams {
+  agent_id?: string | null;
+}
+
+export declare namespace Refresh {
+  export {
+    type RefreshTriggerResponse as RefreshTriggerResponse,
+    type RefreshTriggerParams as RefreshTriggerParams,
+  };
+}

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

@@ -0,0 +1,110 @@
+// 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/agents';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Tools extends APIResource {
+  /**
+   * Get a specific MCP tool by its ID
+   */
+  retrieve(toolID: string, params: ToolRetrieveParams, options?: RequestOptions): APIPromise<ToolsAPI.Tool> {
+    const { mcp_server_id } = params;
+    return this._client.get(path`/v1/mcp-servers/${mcp_server_id}/tools/${toolID}`, options);
+  }
+
+  /**
+   * Get a list of all tools for a specific MCP server
+   */
+  list(mcpServerID: string, options?: RequestOptions): APIPromise<ToolListResponse> {
+    return this._client.get(path`/v1/mcp-servers/${mcpServerID}/tools`, options);
+  }
+
+  /**
+   * Execute a specific MCP tool
+   *
+   * The request body should contain the tool arguments in the MCPToolExecuteRequest
+   * format.
+   */
+  run(toolID: string, params: ToolRunParams, options?: RequestOptions): APIPromise<ToolRunResponse> {
+    const { mcp_server_id, ...body } = params;
+    return this._client.post(path`/v1/mcp-servers/${mcp_server_id}/tools/${toolID}/run`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export type ToolListResponse = Array<ToolsAPI.Tool>;
+
+export interface ToolRunResponse {
+  /**
+   * The status of the tool execution and return object
+   */
+  status: 'success' | 'error';
+
+  /**
+   * Representation of an agent's state. This is the state of the agent at a given
+   * time, and is persisted in the DB backend. The state has all the information
+   * needed to recreate a persisted agent.
+   *
+   * Parameters: id (str): The unique identifier of the agent. name (str): The name
+   * of the agent (must be unique to the user). created_at (datetime): The datetime
+   * the agent was created. message_ids (List[str]): The ids of the messages in the
+   * agent's in-context memory. memory (Memory): The in-context memory of the agent.
+   * tools (List[str]): The tools used by the agent. This includes any memory editing
+   * functions specified in `memory`. system (str): The system prompt used by the
+   * agent. llm_config (LLMConfig): The LLM configuration used by the agent.
+   * embedding_config (EmbeddingConfig): The embedding configuration used by the
+   * agent.
+   */
+  agent_state?: AgentsAPI.AgentState | null;
+
+  /**
+   * The function return object
+   */
+  func_return?: unknown;
+
+  /**
+   * The fingerprint of the config for the sandbox
+   */
+  sandbox_config_fingerprint?: string | null;
+
+  /**
+   * Captured stderr from the function invocation
+   */
+  stderr?: Array<string> | null;
+
+  /**
+   * Captured stdout (prints, logs) from function invocation
+   */
+  stdout?: Array<string> | null;
+}
+
+export interface ToolRetrieveParams {
+  mcp_server_id: string;
+}
+
+export interface ToolRunParams {
+  /**
+   * Path param:
+   */
+  mcp_server_id: string;
+
+  /**
+   * Body param: Arguments to pass to the MCP tool
+   */
+  args?: { [key: string]: unknown };
+}
+
+export declare namespace Tools {
+  export {
+    type ToolListResponse as ToolListResponse,
+    type ToolRunResponse as ToolRunResponse,
+    type ToolRetrieveParams as ToolRetrieveParams,
+    type ToolRunParams as ToolRunParams,
+  };
+}

package/src/resources/mcp-servers.ts

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

package/src/resources/steps/steps.ts

@@ -13,7 +13,6 @@ import * as TraceAPI from './trace';
 import { Trace } from './trace';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
-import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -34,18 +33,10 @@ export class Steps extends APIResource {
    * List steps with optional pagination and date filters.
    */
   list(
-    params: StepListParams | null | undefined = {},
+    query: StepListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<StepsArrayPage, Step> {
-    const { 'X-Project': xProject, ...query } = params ?? {};
-    return this._client.getAPIList('/v1/steps/', ArrayPage<Step>, {
-      query,
-      ...options,
-      headers: buildHeaders([
-        { ...(xProject != null ? { 'X-Project': xProject } : undefined) },
-        options?.headers,
-      ]),
-    });
+    return this._client.getAPIList('/v1/steps/', ArrayPage<Step>, { query, ...options });
   }
 }
 
@@ -229,57 +220,49 @@ export interface Step {
 
 export interface StepListParams extends ArrayPageParams {
   /**
-   * Query param: Filter by the ID of the agent that performed the step
+   * Filter by the ID of the agent that performed the step
    */
   agent_id?: string | null;
 
   /**
-   * Query param: Return steps before this ISO datetime (e.g.
-   * "2025-01-29T15:01:19-08:00")
+   * Return steps before this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
    */
   end_date?: string | null;
 
   /**
-   * Query param: Filter by feedback
+   * Filter by feedback
    */
   feedback?: 'positive' | 'negative' | null;
 
   /**
-   * Query param: Filter by whether steps have feedback (true) or not (false)
+   * Filter by whether steps have feedback (true) or not (false)
    */
   has_feedback?: boolean | null;
 
   /**
-   * Query param: Filter by the name of the model used for the step
+   * Filter by the name of the model used for the step
    */
   model?: string | null;
 
   /**
-   * Query param: Filter by the project ID that is associated with the step (cloud
-   * only).
+   * Filter by the project ID that is associated with the step (cloud only).
    */
   project_id?: string | null;
 
   /**
-   * Query param: Return steps after this ISO datetime (e.g.
-   * "2025-01-29T15:01:19-08:00")
+   * Return steps after this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
    */
   start_date?: string | null;
 
   /**
-   * Query param: Filter by tags
+   * Filter by tags
    */
   tags?: Array<string> | null;
 
   /**
-   * Query param: Filter by trace ids returned by the server
+   * Filter by trace ids returned by the server
    */
   trace_ids?: Array<string> | null;
-
-  /**
-   * Header param: Filter by project slug to associate with the group (cloud only).
-   */
-  'X-Project'?: string;
 }
 
 Steps.Metrics = Metrics;

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.0.0-alpha.10'; // x-release-please-version
+export const VERSION = '1.0.0-alpha.11'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.0-alpha.10";
+export declare const VERSION = "1.0.0-alpha.11";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.0-alpha.10";
+export declare const VERSION = "1.0.0-alpha.11";
 //# 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.0.0-alpha.10'; // x-release-please-version
+exports.VERSION = '1.0.0-alpha.11'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.0.0-alpha.10'; // x-release-please-version
+export const VERSION = '1.0.0-alpha.11'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map