@letta-ai/letta-client 1.0.0-alpha.1 → 1.0.0-alpha.2

package/api/types/ApprovalReturn.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface ApprovalReturn {
+    type: "approval";
+    /** The ID of the tool call that corresponds to this approval */
+    toolCallId: string;
+    /** Whether the tool has been approved */
+    approve: boolean;
+    /** An optional explanation for the provided approval status */
+    reason?: string;
+}

package/api/types/InternalTemplateAgentCreate.d.ts

@@ -60,9 +60,9 @@ export interface InternalTemplateAgentCreate {
     enableReasoner?: boolean;
     /** Whether to enable reasoning for this agent. */
     reasoning?: boolean;
-    /** The template id used to configure the agent */
+    /** Deprecated: please use the 'create agents from a template' endpoint instead. */
     fromTemplate?: string;
-    /** Whether the agent is a template */
+    /** Deprecated: No longer used */
     template?: boolean;
     /** Deprecated: Project should now be passed via the X-Project header instead of in the request body. If using the sdk, this can be done via the new x_project field below. */
     project?: string;

package/api/types/LettaSchemasAgentFileAgentSchema.d.ts

@@ -60,9 +60,9 @@ export interface LettaSchemasAgentFileAgentSchema {
     enableReasoner?: boolean;
     /** Whether to enable reasoning for this agent. */
     reasoning?: boolean;
-    /** The template id used to configure the agent */
+    /** Deprecated: please use the 'create agents from a template' endpoint instead. */
     fromTemplate?: string;
-    /** Whether the agent is a template */
+    /** Deprecated: No longer used */
     template?: boolean;
     /** Deprecated: Project should now be passed via the X-Project header instead of in the request body. If using the sdk, this can be done via the new x_project field below. */
     project?: string;

package/api/types/LettaSchemasAgentFileMessageSchema.d.ts

@@ -33,7 +33,13 @@ export interface LettaSchemasAgentFileMessageSchema {
     /** The ID of the tool call. Only applicable for role tool. */
     toolCallId?: string;
     /** Tool execution return information for prior tool calls */
-    toolReturns?: Letta.ToolReturn[];
+    toolReturns?: Letta.LettaSchemasMessageToolReturn[];
     /** The timestamp when the object was created. */
     createdAt?: Date;
+    /** Whether the tool has been approved */
+    approve?: boolean;
+    /** The message ID of the approval request */
+    approvalRequestId?: string;
+    /** An optional explanation for the provided approval status */
+    denialReason?: string;
 }

package/api/types/LettaSchemasLettaMessageToolReturn.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Letta from "../index";
+export interface LettaSchemasLettaMessageToolReturn {
+    type: "tool";
+    toolReturn: string;
+    status: Letta.LettaSchemasLettaMessageToolReturnStatus;
+    toolCallId: string;
+    stdout?: string[];
+    stderr?: string[];
+}

package/api/types/LettaSchemasLettaMessageToolReturnStatus.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type LettaSchemasLettaMessageToolReturnStatus = "success" | "error";
+export declare const LettaSchemasLettaMessageToolReturnStatus: {
+    readonly Success: "success";
+    readonly Error: "error";
+};

package/api/types/LettaSchemasLettaMessageToolReturnStatus.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LettaSchemasLettaMessageToolReturnStatus = void 0;
+exports.LettaSchemasLettaMessageToolReturnStatus = {
+    Success: "success",
+    Error: "error",
+};

package/{dist/api/types/ToolReturn.d.ts → api/types/LettaSchemasMessageToolReturn.d.ts}

@@ -2,11 +2,14 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Letta from "../index";
-export interface ToolReturn {
+export interface LettaSchemasMessageToolReturn {
+    toolCallId?: unknown;
     /** The status of the tool call */
-    status: Letta.ToolReturnStatus;
+    status: Letta.LettaSchemasMessageToolReturnStatus;
     /** Captured stdout (e.g. prints, logs) from the tool invocation */
     stdout?: string[];
     /** Captured stderr from the tool invocation */
     stderr?: string[];
+    /** The function response string */
+    funcResponse?: string;
 }

package/api/types/{ToolReturnStatus.d.ts → LettaSchemasMessageToolReturnStatus.d.ts}

@@ -4,8 +4,8 @@
 /**
  * The status of the tool call
  */
-export type ToolReturnStatus = "success" | "error";
-export declare const ToolReturnStatus: {
+export type LettaSchemasMessageToolReturnStatus = "success" | "error";
+export declare const LettaSchemasMessageToolReturnStatus: {
     readonly Success: "success";
     readonly Error: "error";
 };

package/api/types/{ToolReturnStatus.js → LettaSchemasMessageToolReturnStatus.js}

@@ -3,8 +3,8 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolReturnStatus = void 0;
-exports.ToolReturnStatus = {
+exports.LettaSchemasMessageToolReturnStatus = void 0;
+exports.LettaSchemasMessageToolReturnStatus = {
     Success: "success",
     Error: "error",
 };

package/api/types/Message.d.ts

@@ -55,7 +55,7 @@ export interface Message {
     /** The offline threading id associated with this message */
     otid?: string;
     /** Tool execution return information for prior tool calls */
-    toolReturns?: Letta.ToolReturn[];
+    toolReturns?: Letta.LettaSchemasMessageToolReturn[];
     /** The multi-agent group that the message was sent in */
     groupId?: string;
     /** The id of the sender of the message, can be an identity id or agent id */
@@ -70,4 +70,6 @@ export interface Message {
     approve?: boolean;
     /** The reason the tool call request was denied. */
     denialReason?: string;
+    /** The list of approvals for this message. */
+    approvals?: Letta.MessageApprovalsItem[];
 }

package/api/types/MessageApprovalsItem.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Letta from "../index";
+export type MessageApprovalsItem = Letta.ApprovalReturn | Letta.LettaSchemasMessageToolReturn;

package/api/types/OmittedReasoningContent.d.ts

@@ -6,4 +6,6 @@
  */
 export interface OmittedReasoningContent {
     type: "omitted_reasoning";
+    /** A unique identifier for this reasoning step. */
+    signature?: string;
 }

package/api/types/Provider.d.ts

@@ -23,4 +23,8 @@ export interface Provider {
     apiVersion?: string;
     /** The last update timestamp of the provider. */
     updatedAt?: Date;
+    /** Encrypted API key as Secret object */
+    apiKeyEnc?: string;
+    /** Encrypted access key as Secret object */
+    accessKeyEnc?: string;
 }

package/api/types/RunMetrics.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface RunMetrics {
+    /** The id of the run this metric belongs to (matches runs.id). */
+    id: string;
+    /** The unique identifier of the agent. */
+    agentId?: string;
+    /** The project that the run belongs to (cloud only). */
+    projectId?: string;
+    /** The timestamp of the start of the run in nanoseconds. */
+    runStartNs?: number;
+    /** Total time for the run in nanoseconds. */
+    runNs?: number;
+    /** The number of steps in the run. */
+    numSteps?: number;
+    /** The template ID that the run belongs to (cloud only). */
+    templateId?: string;
+    /** The base template ID that the run belongs to (cloud only). */
+    baseTemplateId?: string;
+}

package/api/types/RunMetrics.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/types/SandboxEnvironmentVariable.d.ts

@@ -18,6 +18,8 @@ export interface SandboxEnvironmentVariable {
     value: string;
     /** An optional description of the environment variable. */
     description?: string;
+    /** Encrypted value as Secret object */
+    valueEnc?: string;
     /** The ID of the sandbox config this environment variable belongs to. */
     sandboxConfigId: string;
 }

package/api/types/TextContent.d.ts

@@ -5,4 +5,6 @@ export interface TextContent {
     type: "text";
     /** The text content of the message. */
     text: string;
+    /** Stores a unique identifier for any reasoning associated with this text content. */
+    signature?: string;
 }

package/api/types/ToolCallContent.d.ts

@@ -9,4 +9,6 @@ export interface ToolCallContent {
     name: string;
     /** The parameters being passed to the tool, structured as a dictionary of parameter names to values. */
     input: Record<string, unknown>;
+    /** Stores a unique identifier for any reasoning associated with this tool call. */
+    signature?: string;
 }

package/api/types/ToolCallMessage.d.ts

@@ -23,4 +23,5 @@ export interface ToolCallMessage {
     seqId?: number;
     runId?: string;
     toolCall: Letta.ToolCallMessageToolCall;
+    toolCalls?: Letta.ToolCallMessageToolCalls;
 }

package/api/types/ToolCallMessageToolCalls.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Letta from "../index";
+export type ToolCallMessageToolCalls = Letta.ToolCall[] | Letta.ToolCallDelta;

package/api/types/ToolCallMessageToolCalls.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/types/ToolReturnMessage.d.ts

@@ -9,11 +9,12 @@ import * as Letta from "../index";
  *     id (str): The ID of the message
  *     date (datetime): The date the message was created in ISO format
  *     name (Optional[str]): The name of the sender of the message
- *     tool_return (str): The return value of the tool
- *     status (Literal["success", "error"]): The status of the tool call
- *     tool_call_id (str): A unique identifier for the tool call that generated this message
- *     stdout (Optional[List(str)]): Captured stdout (e.g. prints, logs) from the tool invocation
- *     stderr (Optional[List(str)]): Captured stderr from the tool invocation
+ *     tool_return (str): The return value of the tool (deprecated, use tool_returns)
+ *     status (Literal["success", "error"]): The status of the tool call (deprecated, use tool_returns)
+ *     tool_call_id (str): A unique identifier for the tool call that generated this message (deprecated, use tool_returns)
+ *     stdout (Optional[List(str)]): Captured stdout (e.g. prints, logs) from the tool invocation (deprecated, use tool_returns)
+ *     stderr (Optional[List(str)]): Captured stderr from the tool invocation (deprecated, use tool_returns)
+ *     tool_returns (Optional[List[ToolReturn]]): List of tool returns for multi-tool support
  */
 export interface ToolReturnMessage {
     id: string;
@@ -31,4 +32,5 @@ export interface ToolReturnMessage {
     toolCallId: string;
     stdout?: string[];
     stderr?: string[];
+    toolReturns?: Letta.LettaSchemasLettaMessageToolReturn[];
 }

package/api/types/ToolType.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type ToolType = "custom" | "letta_core" | "letta_memory_core" | "letta_multi_agent_core" | "letta_sleeptime_core" | "letta_voice_sleeptime_core" | "letta_builtin" | "letta_files_core" | "external_composio" | "external_langchain" | "external_mcp";
+export type ToolType = "custom" | "letta_core" | "letta_memory_core" | "letta_multi_agent_core" | "letta_sleeptime_core" | "letta_voice_sleeptime_core" | "letta_builtin" | "letta_files_core" | "external_langchain" | "external_composio" | "external_mcp";
 export declare const ToolType: {
     readonly Custom: "custom";
     readonly LettaCore: "letta_core";
@@ -11,7 +11,7 @@ export declare const ToolType: {
     readonly LettaVoiceSleeptimeCore: "letta_voice_sleeptime_core";
     readonly LettaBuiltin: "letta_builtin";
     readonly LettaFilesCore: "letta_files_core";
-    readonly ExternalComposio: "external_composio";
     readonly ExternalLangchain: "external_langchain";
+    readonly ExternalComposio: "external_composio";
     readonly ExternalMcp: "external_mcp";
 };

package/api/types/ToolType.js

@@ -13,7 +13,7 @@ exports.ToolType = {
     LettaVoiceSleeptimeCore: "letta_voice_sleeptime_core",
     LettaBuiltin: "letta_builtin",
     LettaFilesCore: "letta_files_core",
-    ExternalComposio: "external_composio",
     ExternalLangchain: "external_langchain",
+    ExternalComposio: "external_composio",
     ExternalMcp: "external_mcp",
 };

package/api/types/index.d.ts

@@ -3,9 +3,6 @@ export * from "./PaymentRequiredErrorBody";
 export * from "./BadRequestErrorBody";
 export * from "./InternalServerErrorBody";
 export * from "./ConflictErrorBody";
-export * from "./ActionModel";
-export * from "./ActionParametersModel";
-export * from "./ActionResponseModel";
 export * from "./AgentEnvironmentVariable";
 export * from "./AgentFileAttachment";
 export * from "./AgentFileSchema";
@@ -13,13 +10,13 @@ export * from "./AgentStateToolRulesItem";
 export * from "./AgentStateResponseFormat";
 export * from "./AgentState";
 export * from "./AgentType";
-export * from "./AppAuthSchemeAuthMode";
-export * from "./AppAuthScheme";
-export * from "./AppModel";
+export * from "./ApprovalCreateApprovalsItem";
 export * from "./ApprovalCreate";
 export * from "./ApprovalRequestMessageToolCall";
 export * from "./ApprovalRequestMessage";
+export * from "./ApprovalResponseMessageApprovalsItem";
 export * from "./ApprovalResponseMessage";
+export * from "./ApprovalReturn";
 export * from "./ArchivalMemorySearchResponse";
 export * from "./ArchivalMemorySearchResult";
 export * from "./Archive";
@@ -27,7 +24,6 @@ export * from "./AssistantMessageContent";
 export * from "./AssistantMessage";
 export * from "./AuthRequest";
 export * from "./AuthResponse";
-export * from "./AuthSchemeField";
 export * from "./Base64Image";
 export * from "./BaseToolRuleSchema";
 export * from "./BatchJob";
@@ -123,6 +119,7 @@ export * from "./MaxCountPerStepToolRuleSchema";
 export * from "./MemoryAgentType";
 export * from "./Memory";
 export * from "./MessageContentItem";
+export * from "./MessageApprovalsItem";
 export * from "./Message";
 export * from "./MessageCreateRole";
 export * from "./MessageCreateContent";
@@ -157,6 +154,7 @@ export * from "./RequiresApprovalToolRule";
 export * from "./RoundRobinManager";
 export * from "./RoundRobinManagerUpdate";
 export * from "./Run";
+export * from "./RunMetrics";
 export * from "./RunStatus";
 export * from "./SseServerConfig";
 export * from "./SandboxConfig";
@@ -197,13 +195,12 @@ export * from "./ToolCall";
 export * from "./ToolCallContent";
 export * from "./ToolCallDelta";
 export * from "./ToolCallMessageToolCall";
+export * from "./ToolCallMessageToolCalls";
 export * from "./ToolCallMessage";
 export * from "./ToolCallNode";
 export * from "./ToolCreate";
 export * from "./ToolEnvVarSchema";
 export * from "./ToolJsonSchema";
-export * from "./ToolReturnStatus";
-export * from "./ToolReturn";
 export * from "./ToolReturnContent";
 export * from "./ToolReturnMessageStatus";
 export * from "./ToolReturnMessage";
@@ -237,6 +234,10 @@ export * from "./LettaSchemasAgentFileAgentSchema";
 export * from "./LettaSchemasAgentFileMessageSchemaContent";
 export * from "./LettaSchemasAgentFileMessageSchema";
 export * from "./LettaSchemasAgentFileToolSchema";
+export * from "./LettaSchemasLettaMessageToolReturnStatus";
+export * from "./LettaSchemasLettaMessageToolReturn";
+export * from "./LettaSchemasMessageToolReturnStatus";
+export * from "./LettaSchemasMessageToolReturn";
 export * from "./LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem";
 export * from "./LettaSerializeSchemasPydanticAgentSchemaAgentSchema";
 export * from "./LettaSerializeSchemasPydanticAgentSchemaMessageSchema";

package/api/types/index.js

@@ -19,9 +19,6 @@ __exportStar(require("./PaymentRequiredErrorBody"), exports);
 __exportStar(require("./BadRequestErrorBody"), exports);
 __exportStar(require("./InternalServerErrorBody"), exports);
 __exportStar(require("./ConflictErrorBody"), exports);
-__exportStar(require("./ActionModel"), exports);
-__exportStar(require("./ActionParametersModel"), exports);
-__exportStar(require("./ActionResponseModel"), exports);
 __exportStar(require("./AgentEnvironmentVariable"), exports);
 __exportStar(require("./AgentFileAttachment"), exports);
 __exportStar(require("./AgentFileSchema"), exports);
@@ -29,13 +26,13 @@ __exportStar(require("./AgentStateToolRulesItem"), exports);
 __exportStar(require("./AgentStateResponseFormat"), exports);
 __exportStar(require("./AgentState"), exports);
 __exportStar(require("./AgentType"), exports);
-__exportStar(require("./AppAuthSchemeAuthMode"), exports);
-__exportStar(require("./AppAuthScheme"), exports);
-__exportStar(require("./AppModel"), exports);
+__exportStar(require("./ApprovalCreateApprovalsItem"), exports);
 __exportStar(require("./ApprovalCreate"), exports);
 __exportStar(require("./ApprovalRequestMessageToolCall"), exports);
 __exportStar(require("./ApprovalRequestMessage"), exports);
+__exportStar(require("./ApprovalResponseMessageApprovalsItem"), exports);
 __exportStar(require("./ApprovalResponseMessage"), exports);
+__exportStar(require("./ApprovalReturn"), exports);
 __exportStar(require("./ArchivalMemorySearchResponse"), exports);
 __exportStar(require("./ArchivalMemorySearchResult"), exports);
 __exportStar(require("./Archive"), exports);
@@ -43,7 +40,6 @@ __exportStar(require("./AssistantMessageContent"), exports);
 __exportStar(require("./AssistantMessage"), exports);
 __exportStar(require("./AuthRequest"), exports);
 __exportStar(require("./AuthResponse"), exports);
-__exportStar(require("./AuthSchemeField"), exports);
 __exportStar(require("./Base64Image"), exports);
 __exportStar(require("./BaseToolRuleSchema"), exports);
 __exportStar(require("./BatchJob"), exports);
@@ -139,6 +135,7 @@ __exportStar(require("./MaxCountPerStepToolRuleSchema"), exports);
 __exportStar(require("./MemoryAgentType"), exports);
 __exportStar(require("./Memory"), exports);
 __exportStar(require("./MessageContentItem"), exports);
+__exportStar(require("./MessageApprovalsItem"), exports);
 __exportStar(require("./Message"), exports);
 __exportStar(require("./MessageCreateRole"), exports);
 __exportStar(require("./MessageCreateContent"), exports);
@@ -173,6 +170,7 @@ __exportStar(require("./RequiresApprovalToolRule"), exports);
 __exportStar(require("./RoundRobinManager"), exports);
 __exportStar(require("./RoundRobinManagerUpdate"), exports);
 __exportStar(require("./Run"), exports);
+__exportStar(require("./RunMetrics"), exports);
 __exportStar(require("./RunStatus"), exports);
 __exportStar(require("./SseServerConfig"), exports);
 __exportStar(require("./SandboxConfig"), exports);
@@ -213,13 +211,12 @@ __exportStar(require("./ToolCall"), exports);
 __exportStar(require("./ToolCallContent"), exports);
 __exportStar(require("./ToolCallDelta"), exports);
 __exportStar(require("./ToolCallMessageToolCall"), exports);
+__exportStar(require("./ToolCallMessageToolCalls"), exports);
 __exportStar(require("./ToolCallMessage"), exports);
 __exportStar(require("./ToolCallNode"), exports);
 __exportStar(require("./ToolCreate"), exports);
 __exportStar(require("./ToolEnvVarSchema"), exports);
 __exportStar(require("./ToolJsonSchema"), exports);
-__exportStar(require("./ToolReturnStatus"), exports);
-__exportStar(require("./ToolReturn"), exports);
 __exportStar(require("./ToolReturnContent"), exports);
 __exportStar(require("./ToolReturnMessageStatus"), exports);
 __exportStar(require("./ToolReturnMessage"), exports);
@@ -253,6 +250,10 @@ __exportStar(require("./LettaSchemasAgentFileAgentSchema"), exports);
 __exportStar(require("./LettaSchemasAgentFileMessageSchemaContent"), exports);
 __exportStar(require("./LettaSchemasAgentFileMessageSchema"), exports);
 __exportStar(require("./LettaSchemasAgentFileToolSchema"), exports);
+__exportStar(require("./LettaSchemasLettaMessageToolReturnStatus"), exports);
+__exportStar(require("./LettaSchemasLettaMessageToolReturn"), exports);
+__exportStar(require("./LettaSchemasMessageToolReturnStatus"), exports);
+__exportStar(require("./LettaSchemasMessageToolReturn"), exports);
 __exportStar(require("./LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem"), exports);
 __exportStar(require("./LettaSerializeSchemasPydanticAgentSchemaAgentSchema"), exports);
 __exportStar(require("./LettaSerializeSchemasPydanticAgentSchemaMessageSchema"), exports);

package/dist/api/resources/agents/client/Client.d.ts

@@ -77,7 +77,22 @@ export declare class Agents {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.list()
+     *     await client.agents.list({
+     *         name: "name",
+     *         matchAllTags: true,
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         queryText: "query_text",
+     *         projectId: "project_id",
+     *         templateId: "template_id",
+     *         baseTemplateId: "base_template_id",
+     *         identityId: "identity_id",
+     *         order: "asc",
+     *         orderBy: "created_at",
+     *         ascending: true,
+     *         sortBy: "sort_by"
+     *     })
      */
     list(request?: Letta.AgentsListRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Letta.AgentState[]>;
     private __list;
@@ -120,7 +135,10 @@ export declare class Agents {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.exportFile("agent_id")
+     *     await client.agents.exportFile("agent_id", {
+     *         maxSteps: 1,
+     *         useLegacyFormat: true
+     *     })
      */
     exportFile(agentId: string, request?: Letta.AgentsExportFileRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<string>;
     private __exportFile;
@@ -135,7 +153,9 @@ export declare class Agents {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.importFile(fs.createReadStream("/path/to/your/file"), {})
+     *     await client.agents.importFile(fs.createReadStream("/path/to/your/file"), {
+     *         overrideEmbeddingModel: "x-override-embedding-model"
+     *     })
      */
     importFile(file: File | fs.ReadStream | Blob, request: Letta.BodyImportAgent, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Letta.ImportedAgentsResponse>;
     private __importFile;