@letta-ai/letta-react 0.0.8 → 0.1.0

package/src/types/ContextWindowOverview.ts

@@ -0,0 +1,96 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { FunctionTool } from './FunctionTool.ts'
+import type { Message } from './Message.ts'
+
+/**
+ * @description Overview of the context window, including the number of messages and tokens.
+ */
+export type ContextWindowOverview = {
+  /**
+   * @description The maximum amount of tokens the context window can hold.
+   * @type integer
+   */
+  context_window_size_max: number
+  /**
+   * @description The current number of tokens in the context window.
+   * @type integer
+   */
+  context_window_size_current: number
+  /**
+   * @description The number of messages in the context window.
+   * @type integer
+   */
+  num_messages: number
+  /**
+   * @description The number of messages in the archival memory.
+   * @type integer
+   */
+  num_archival_memory: number
+  /**
+   * @description The number of messages in the recall memory.
+   * @type integer
+   */
+  num_recall_memory: number
+  /**
+   * @description The number of tokens in the external memory summary (archival + recall metadata).
+   * @type integer
+   */
+  num_tokens_external_memory_summary: number
+  /**
+   * @description The metadata summary of the external memory sources (archival + recall metadata).
+   * @type string
+   */
+  external_memory_summary: string
+  /**
+   * @description The number of tokens in the system prompt.
+   * @type integer
+   */
+  num_tokens_system: number
+  /**
+   * @description The content of the system prompt.
+   * @type string
+   */
+  system_prompt: string
+  /**
+   * @description The number of tokens in the core memory.
+   * @type integer
+   */
+  num_tokens_core_memory: number
+  /**
+   * @description The content of the core memory.
+   * @type string
+   */
+  core_memory: string
+  /**
+   * @description The number of tokens in the summary memory.
+   * @type integer
+   */
+  num_tokens_summary_memory: number
+  /**
+   * @description The content of the summary memory.
+   */
+  summary_memory?: string | null
+  /**
+   * @description The number of tokens in the functions definitions.
+   * @type integer
+   */
+  num_tokens_functions_definitions: number
+  /**
+   * @description The content of the functions definitions.
+   */
+  functions_definitions: FunctionTool[] | null
+  /**
+   * @description The number of tokens in the messages list.
+   * @type integer
+   */
+  num_tokens_messages: number
+  /**
+   * @description The messages in the context window.
+   * @type array
+   */
+  messages: Message[]
+}

package/src/types/ContinueToolRule.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+/**
+ * @description Represents a tool rule configuration where if this tool gets called, it must continue the agent loop.
+ */
+export type ContinueToolRule = {
+  /**
+   * @description The name of the tool. Must exist in the database for the user\'s organization.
+   * @type string
+   */
+  tool_name: string
+  /**
+   * @default "continue_loop"
+   * @type string | undefined
+   */
+  type?: 'continue_loop'
+}

package/src/types/CoreMemoryBlockSchema.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+export type CoreMemoryBlockSchema = {
+  /**
+   * @type string
+   */
+  created_at: string
+  description: string | null
+  /**
+   * @type boolean
+   */
+  is_template: boolean
+  /**
+   * @type string
+   */
+  label: string
+  /**
+   * @type integer
+   */
+  limit: number
+  metadata_?: {
+    [key: string]: any
+  } | null
+  template_name: string | null
+  /**
+   * @type string
+   */
+  updated_at: string
+  /**
+   * @type string
+   */
+  value: string
+}

package/src/types/CreateAgent.ts

@@ -0,0 +1,33 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { AgentState } from './AgentState.ts'
+import type { CreateAgentRequest } from './CreateAgentRequest.ts'
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+
+export type CreateAgentHeaderParams = {
+  'X-Project'?: string | null
+}
+
+/**
+ * @description Successful Response
+ */
+export type CreateAgent200 = AgentState
+
+/**
+ * @description Validation Error
+ */
+export type CreateAgent422 = HTTPValidationError
+
+export type CreateAgentMutationRequest = CreateAgentRequest
+
+export type CreateAgentMutationResponse = CreateAgent200
+
+export type CreateAgentMutation = {
+  Response: CreateAgent200
+  Request: CreateAgentMutationRequest
+  HeaderParams: CreateAgentHeaderParams
+  Errors: CreateAgent422
+}

package/src/types/CreateAgentMessageAsync.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+import type { LettaRequest } from './LettaRequest.ts'
+import type { Run } from './Run.ts'
+
+export type CreateAgentMessageAsyncPathParams = {
+  /**
+   * @type string
+   */
+  agent_id: string
+}
+
+/**
+ * @description Successful Response
+ */
+export type CreateAgentMessageAsync200 = Run
+
+/**
+ * @description Validation Error
+ */
+export type CreateAgentMessageAsync422 = HTTPValidationError
+
+export type CreateAgentMessageAsyncMutationRequest = LettaRequest
+
+export type CreateAgentMessageAsyncMutationResponse = CreateAgentMessageAsync200
+
+export type CreateAgentMessageAsyncMutation = {
+  Response: CreateAgentMessageAsync200
+  Request: CreateAgentMessageAsyncMutationRequest
+  PathParams: CreateAgentMessageAsyncPathParams
+  Errors: CreateAgentMessageAsync422
+}

package/src/types/CreateAgentMessageStream.ts

@@ -0,0 +1,35 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+import type { LettaStreamingRequest } from './LettaStreamingRequest.ts'
+
+export type CreateAgentMessageStreamPathParams = {
+  /**
+   * @type string
+   */
+  agent_id: string
+}
+
+/**
+ * @description Successful response
+ */
+export type CreateAgentMessageStream200 = any
+
+/**
+ * @description Validation Error
+ */
+export type CreateAgentMessageStream422 = HTTPValidationError
+
+export type CreateAgentMessageStreamMutationRequest = LettaStreamingRequest
+
+export type CreateAgentMessageStreamMutationResponse = CreateAgentMessageStream200
+
+export type CreateAgentMessageStreamMutation = {
+  Response: CreateAgentMessageStream200
+  Request: CreateAgentMessageStreamMutationRequest
+  PathParams: CreateAgentMessageStreamPathParams
+  Errors: CreateAgentMessageStream422
+}

package/src/types/CreateAgentRequest.ts

@@ -0,0 +1,187 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { AgentType } from './AgentType.ts'
+import type { ChildToolRule } from './ChildToolRule.ts'
+import type { ConditionalToolRule } from './ConditionalToolRule.ts'
+import type { ContinueToolRule } from './ContinueToolRule.ts'
+import type { CreateBlock } from './CreateBlock.ts'
+import type { EmbeddingConfig } from './EmbeddingConfig.ts'
+import type { InitToolRule } from './InitToolRule.ts'
+import type { LLMConfig } from './LLMConfig.ts'
+import type { MaxCountPerStepToolRule } from './MaxCountPerStepToolRule.ts'
+import type { MessageCreate } from './MessageCreate.ts'
+import type { ParentToolRule } from './ParentToolRule.ts'
+import type { TerminalToolRule } from './TerminalToolRule.ts'
+
+/**
+ * @description CreateAgent model specifically for POST request body, excluding user_id which comes from headers
+ */
+export type CreateAgentRequest = {
+  /**
+   * @description The name of the agent.
+   * @type string | undefined
+   */
+  name?: string
+  /**
+   * @description The blocks to create in the agent\'s in-context memory.
+   */
+  memory_blocks?: CreateBlock[] | null
+  /**
+   * @description The tools used by the agent.
+   */
+  tools?: string[] | null
+  /**
+   * @description The ids of the tools used by the agent.
+   */
+  tool_ids?: string[] | null
+  /**
+   * @description The ids of the sources used by the agent.
+   */
+  source_ids?: string[] | null
+  /**
+   * @description The ids of the blocks used by the agent.
+   */
+  block_ids?: string[] | null
+  /**
+   * @description The tool rules governing the agent.
+   */
+  tool_rules?: (ChildToolRule | InitToolRule | TerminalToolRule | ConditionalToolRule | ContinueToolRule | MaxCountPerStepToolRule | ParentToolRule)[] | null
+  /**
+   * @description The tags associated with the agent.
+   */
+  tags?: string[] | null
+  /**
+   * @description The system prompt used by the agent.
+   */
+  system?: string | null
+  /**
+   * @type string | undefined
+   */
+  agent_type?: AgentType
+  /**
+   * @description The LLM configuration used by the agent.
+   */
+  llm_config?: LLMConfig | null
+  /**
+   * @description The embedding configuration used by the agent.
+   */
+  embedding_config?: EmbeddingConfig | null
+  /**
+   * @description The initial set of messages to put in the agent\'s in-context memory.
+   */
+  initial_message_sequence?: MessageCreate[] | null
+  /**
+   * @description If true, attaches the Letta core tools (e.g. archival_memory and core_memory related functions).
+   * @default true
+   * @type boolean | undefined
+   */
+  include_base_tools?: boolean
+  /**
+   * @description If true, attaches the Letta multi-agent tools (e.g. sending a message to another agent).
+   * @default false
+   * @type boolean | undefined
+   */
+  include_multi_agent_tools?: boolean
+  /**
+   * @description If true, attaches the Letta base tool rules (e.g. deny all tools not explicitly allowed).
+   * @default true
+   * @type boolean | undefined
+   */
+  include_base_tool_rules?: boolean
+  /**
+   * @description The description of the agent.
+   */
+  description?: string | null
+  /**
+   * @description The metadata of the agent.
+   */
+  metadata?: {
+    [key: string]: any
+  } | null
+  /**
+   * @description The LLM configuration handle used by the agent, specified in the format provider/model-name, as an alternative to specifying llm_config.
+   */
+  model?: string | null
+  /**
+   * @description The embedding configuration handle used by the agent, specified in the format provider/model-name.
+   */
+  embedding?: string | null
+  /**
+   * @description The context window limit used by the agent.
+   */
+  context_window_limit?: number | null
+  /**
+   * @description The embedding chunk size used by the agent.
+   * @default 300
+   */
+  embedding_chunk_size?: number | null
+  /**
+   * @description The maximum number of tokens to generate, including reasoning step. If not set, the model will use its default value.
+   */
+  max_tokens?: number | null
+  /**
+   * @description The maximum number of tokens to generate for reasoning step. If not set, the model will use its default value.
+   */
+  max_reasoning_tokens?: number | null
+  /**
+   * @description Whether to enable internal extended thinking step for a reasoner model.
+   * @default false
+   */
+  enable_reasoner?: boolean | null
+  /**
+   * @description The template id used to configure the agent
+   */
+  from_template?: string | null
+  /**
+   * @description Whether the agent is a template
+   * @default false
+   * @type boolean | undefined
+   */
+  template?: boolean
+  /**
+   * @description 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.
+   * @deprecated
+   */
+  project?: string | null
+  /**
+   * @description The environment variables for tool execution specific to this agent.
+   */
+  tool_exec_environment_variables?: {
+    [key: string]: string
+  } | null
+  /**
+   * @description The variables that should be set for the agent.
+   */
+  memory_variables?: {
+    [key: string]: string
+  } | null
+  /**
+   * @description The id of the project the agent belongs to.
+   */
+  project_id?: string | null
+  /**
+   * @description The id of the template the agent belongs to.
+   */
+  template_id?: string | null
+  /**
+   * @description The base template id of the agent.
+   */
+  base_template_id?: string | null
+  /**
+   * @description The ids of the identities associated with this agent.
+   */
+  identity_ids?: string[] | null
+  /**
+   * @description If set to True, the agent will not remember previous messages (though the agent will still retain state via core memory blocks and archival/recall memory). Not recommended unless you have an advanced use case.
+   * @default false
+   * @type boolean | undefined
+   */
+  message_buffer_autoclear?: boolean
+  /**
+   * @description If set to True, memory management will move to a background agent thread.
+   */
+  enable_sleeptime?: boolean | null
+}

package/src/types/CreateArchivalMemory.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+export type CreateArchivalMemory = {
+  /**
+   * @description Text to write to archival memory.
+   * @type string
+   */
+  text: string
+}

package/src/types/CreateBlock.ts

@@ -0,0 +1,69 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { Block } from './Block.ts'
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+
+/**
+ * @description Create a block
+ */
+export type CreateBlock = {
+  /**
+   * @description Value of the block.
+   * @type string
+   */
+  value: string
+  /**
+   * @description Character limit of the block.
+   * @default 5000
+   * @type integer | undefined
+   */
+  limit?: number
+  /**
+   * @description Name of the block if it is a template.
+   */
+  name?: string | null
+  /**
+   * @default false
+   * @type boolean | undefined
+   */
+  is_template?: boolean
+  /**
+   * @description Label of the block.
+   * @type string
+   */
+  label: string
+  /**
+   * @description Description of the block.
+   */
+  description?: string | null
+  /**
+   * @description Metadata of the block.
+   * @default [object Object]
+   */
+  metadata?: {
+    [key: string]: any
+  } | null
+}
+
+/**
+ * @description Successful Response
+ */
+export type CreateBlock200 = Block
+
+/**
+ * @description Validation Error
+ */
+export type CreateBlock422 = HTTPValidationError
+
+export type CreateBlockMutationRequest = CreateBlock
+
+export type CreateBlockMutationResponse = CreateBlock200
+
+export type CreateBlockMutation = {
+  Response: CreateBlock200
+  Request: CreateBlockMutationRequest
+  Errors: CreateBlock422
+}

package/src/types/CreateGroup.ts

@@ -0,0 +1,33 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { Group } from './Group.ts'
+import type { GroupCreate } from './GroupCreate.ts'
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+
+export type CreateGroupHeaderParams = {
+  'X-Project'?: string | null
+}
+
+/**
+ * @description Successful Response
+ */
+export type CreateGroup200 = Group
+
+/**
+ * @description Validation Error
+ */
+export type CreateGroup422 = HTTPValidationError
+
+export type CreateGroupMutationRequest = GroupCreate
+
+export type CreateGroupMutationResponse = CreateGroup200
+
+export type CreateGroupMutation = {
+  Response: CreateGroup200
+  Request: CreateGroupMutationRequest
+  HeaderParams: CreateGroupHeaderParams
+  Errors: CreateGroup422
+}

package/src/types/CreateIdentity.ts

@@ -0,0 +1,33 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+import type { Identity } from './Identity.ts'
+import type { IdentityCreate } from './IdentityCreate.ts'
+
+export type CreateIdentityHeaderParams = {
+  'X-Project'?: string | null
+}
+
+/**
+ * @description Successful Response
+ */
+export type CreateIdentity200 = Identity
+
+/**
+ * @description Validation Error
+ */
+export type CreateIdentity422 = HTTPValidationError
+
+export type CreateIdentityMutationRequest = IdentityCreate
+
+export type CreateIdentityMutationResponse = CreateIdentity200
+
+export type CreateIdentityMutation = {
+  Response: CreateIdentity200
+  Request: CreateIdentityMutationRequest
+  HeaderParams: CreateIdentityHeaderParams
+  Errors: CreateIdentity422
+}

package/src/types/CreatePassage.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { CreateArchivalMemory } from './CreateArchivalMemory.ts'
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+import type { Passage } from './Passage.ts'
+
+export type CreatePassagePathParams = {
+  /**
+   * @type string
+   */
+  agent_id: string
+}
+
+/**
+ * @description Successful Response
+ */
+export type CreatePassage200 = Passage[]
+
+/**
+ * @description Validation Error
+ */
+export type CreatePassage422 = HTTPValidationError
+
+export type CreatePassageMutationRequest = CreateArchivalMemory
+
+export type CreatePassageMutationResponse = CreatePassage200
+
+export type CreatePassageMutation = {
+  Response: CreatePassage200
+  Request: CreatePassageMutationRequest
+  PathParams: CreatePassagePathParams
+  Errors: CreatePassage422
+}

package/src/types/CreateProvider.ts

@@ -0,0 +1,28 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+import type { Provider } from './Provider.ts'
+import type { ProviderCreate } from './ProviderCreate.ts'
+
+/**
+ * @description Successful Response
+ */
+export type CreateProvider200 = Provider
+
+/**
+ * @description Validation Error
+ */
+export type CreateProvider422 = HTTPValidationError
+
+export type CreateProviderMutationRequest = ProviderCreate
+
+export type CreateProviderMutationResponse = CreateProvider200
+
+export type CreateProviderMutation = {
+  Response: CreateProvider200
+  Request: CreateProviderMutationRequest
+  Errors: CreateProvider422
+}

package/src/types/CreateSource.ts

@@ -0,0 +1,28 @@
+/**
+ * Generated by Kubb (https://kubb.dev/).
+ * Do not edit manually.
+ */
+
+import type { HTTPValidationError } from './HTTPValidationError.ts'
+import type { Source } from './Source.ts'
+import type { SourceCreate } from './SourceCreate.ts'
+
+/**
+ * @description Successful Response
+ */
+export type CreateSource200 = Source
+
+/**
+ * @description Validation Error
+ */
+export type CreateSource422 = HTTPValidationError
+
+export type CreateSourceMutationRequest = SourceCreate
+
+export type CreateSourceMutationResponse = CreateSource200
+
+export type CreateSourceMutation = {
+  Response: CreateSource200
+  Request: CreateSourceMutationRequest
+  Errors: CreateSource422
+}