letta-client 0.1.0__tar.gz → 0.1.2__tar.gz

letta_client-0.1.2/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.1
+Name: letta-client
+Version: 0.1.2
+Summary: 
+Requires-Python: >=3.8,<4.0
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: httpx (>=0.21.2)
+Requires-Dist: httpx-sse (==0.4.0)
+Requires-Dist: pydantic (>=1.9.2)
+Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
+Requires-Dist: typing_extensions (>=4.0.0)
+Description-Content-Type: text/markdown
+
+# Letta Python Library
+
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fletta-ai%2Fletta-python)
+[![pypi](https://img.shields.io/pypi/v/letta-client)](https://pypi.python.org/pypi/letta-client)
+
+The Letta Python library provides convenient access to the Letta API from Python.
+
+## Installation
+
+```sh
+pip install letta-client
+```
+
+## Reference
+
+A full reference for this library is available [here](./reference.md).
+
+## Usage
+
+Instantiate and use the client with the following:
+
+```python
+from letta import Letta
+
+client = Letta(
+    token="YOUR_TOKEN",
+)
+client.tools.create(
+    source_code="source_code",
+)
+```
+
+## Async Client
+
+The SDK also exports an `async` client so that you can make non-blocking calls to our API.
+
+```python
+import asyncio
+
+from letta import AsyncLetta
+
+client = AsyncLetta(
+    token="YOUR_TOKEN",
+)
+
+
+async def main() -> None:
+    await client.tools.create(
+        source_code="source_code",
+    )
+
+
+asyncio.run(main())
+```
+
+## Exception Handling
+
+When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
+will be thrown.
+
+```python
+from letta.core.api_error import ApiError
+
+try:
+    client.tools.create(...)
+except ApiError as e:
+    print(e.status_code)
+    print(e.body)
+```
+
+## Streaming
+
+The SDK supports streaming responses, as well, the response will be a generator that you can loop over.
+
+```python
+from letta import Letta, MessageCreate
+
+client = Letta(
+    token="YOUR_TOKEN",
+)
+response = client.agents.messages.stream(
+    agent_id="agent_id",
+    messages=[
+        MessageCreate(
+            role="user",
+            text="text",
+        )
+    ],
+)
+for chunk in response:
+    yield chunk
+```
+
+## Advanced
+
+### Retries
+
+The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
+as the request is deemed retriable and the number of retry attempts has not grown larger than the configured
+retry limit (default: 2).
+
+A request is deemed retriable when any of the following HTTP status codes is returned:
+
+- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
+- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
+- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
+
+Use the `max_retries` request option to configure this behavior.
+
+```python
+client.tools.create(..., request_options={
+    "max_retries": 1
+})
+```
+
+### Timeouts
+
+The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
+
+```python
+
+from letta import Letta
+
+client = Letta(
+    ...,
+    timeout=20.0,
+)
+
+
+# Override timeout for a specific method
+client.tools.create(..., request_options={
+    "timeout_in_seconds": 1
+})
+```
+
+### Custom Client
+
+You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
+and transports.
+```python
+import httpx
+from letta import Letta
+
+client = Letta(
+    ...,
+    httpx_client=httpx.Client(
+        proxies="http://my.test.proxy.example.com",
+        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
+    ),
+)
+```
+
+## Contributing
+
+While we value open-source contributions to this SDK, this library is generated programmatically.
+Additions made directly to this library would have to be moved over to our generation code,
+otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
+a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
+an issue first to discuss with us!
+
+On the other hand, contributions to the README are always very welcome!
+

letta_client-0.1.2/README.md

@@ -0,0 +1,161 @@
+# Letta Python Library
+
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fletta-ai%2Fletta-python)
+[![pypi](https://img.shields.io/pypi/v/letta-client)](https://pypi.python.org/pypi/letta-client)
+
+The Letta Python library provides convenient access to the Letta API from Python.
+
+## Installation
+
+```sh
+pip install letta-client
+```
+
+## Reference
+
+A full reference for this library is available [here](./reference.md).
+
+## Usage
+
+Instantiate and use the client with the following:
+
+```python
+from letta import Letta
+
+client = Letta(
+    token="YOUR_TOKEN",
+)
+client.tools.create(
+    source_code="source_code",
+)
+```
+
+## Async Client
+
+The SDK also exports an `async` client so that you can make non-blocking calls to our API.
+
+```python
+import asyncio
+
+from letta import AsyncLetta
+
+client = AsyncLetta(
+    token="YOUR_TOKEN",
+)
+
+
+async def main() -> None:
+    await client.tools.create(
+        source_code="source_code",
+    )
+
+
+asyncio.run(main())
+```
+
+## Exception Handling
+
+When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
+will be thrown.
+
+```python
+from letta.core.api_error import ApiError
+
+try:
+    client.tools.create(...)
+except ApiError as e:
+    print(e.status_code)
+    print(e.body)
+```
+
+## Streaming
+
+The SDK supports streaming responses, as well, the response will be a generator that you can loop over.
+
+```python
+from letta import Letta, MessageCreate
+
+client = Letta(
+    token="YOUR_TOKEN",
+)
+response = client.agents.messages.stream(
+    agent_id="agent_id",
+    messages=[
+        MessageCreate(
+            role="user",
+            text="text",
+        )
+    ],
+)
+for chunk in response:
+    yield chunk
+```
+
+## Advanced
+
+### Retries
+
+The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
+as the request is deemed retriable and the number of retry attempts has not grown larger than the configured
+retry limit (default: 2).
+
+A request is deemed retriable when any of the following HTTP status codes is returned:
+
+- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
+- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
+- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
+
+Use the `max_retries` request option to configure this behavior.
+
+```python
+client.tools.create(..., request_options={
+    "max_retries": 1
+})
+```
+
+### Timeouts
+
+The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
+
+```python
+
+from letta import Letta
+
+client = Letta(
+    ...,
+    timeout=20.0,
+)
+
+
+# Override timeout for a specific method
+client.tools.create(..., request_options={
+    "timeout_in_seconds": 1
+})
+```
+
+### Custom Client
+
+You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
+and transports.
+```python
+import httpx
+from letta import Letta
+
+client = Letta(
+    ...,
+    httpx_client=httpx.Client(
+        proxies="http://my.test.proxy.example.com",
+        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
+    ),
+)
+```
+
+## Contributing
+
+While we value open-source contributions to this SDK, this library is generated programmatically.
+Additions made directly to this library would have to be moved over to our generation code,
+otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
+a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
+an issue first to discuss with us!
+
+On the other hand, contributions to the README are always very welcome!

letta_client-0.1.2/pyproject.toml

@@ -0,0 +1,62 @@
+[tool.poetry]
+name = "letta-client"
+version = "0.1.2"
+description = ""
+readme = "README.md"
+authors = []
+keywords = []
+
+classifiers = [
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Operating System :: POSIX",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed"
+]
+packages = [
+    { include = "letta", from = "src"}
+]
+
+[project.urls]
+Repository = 'https://github.com/letta-ai/letta-python'
+
+[tool.poetry.dependencies]
+python = "^3.8"
+httpx = ">=0.21.2"
+httpx-sse = "0.4.0"
+pydantic = ">= 1.9.2"
+pydantic-core = "^2.18.2"
+typing_extensions = ">= 4.0.0"
+
+[tool.poetry.dev-dependencies]
+mypy = "1.0.1"
+pytest = "^7.4.0"
+pytest-asyncio = "^0.23.5"
+python-dateutil = "^2.9.0"
+types-python-dateutil = "^2.9.0.20240316"
+ruff = "^0.5.6"
+
+[tool.pytest.ini_options]
+testpaths = [ "tests" ]
+asyncio_mode = "auto"
+
+[tool.mypy]
+plugins = ["pydantic.mypy"]
+
+[tool.ruff]
+line-length = 120
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

letta_client-0.1.2/src/letta/__init__.py

@@ -0,0 +1,293 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import (
+    ActionModel,
+    ActionParametersModel,
+    ActionResponseModel,
+    AgentState,
+    AgentStateToolRulesItem,
+    AgentType,
+    AppAuthScheme,
+    AppAuthSchemeAuthMode,
+    AppModel,
+    ArchivalMemorySummary,
+    AssistantFile,
+    AssistantMessageInput,
+    AssistantMessageOutput,
+    AuthRequest,
+    AuthResponse,
+    AuthSchemeField,
+    Block,
+    BlockUpdate,
+    ChatCompletionRequest,
+    ChatCompletionRequestFunctionCall,
+    ChatCompletionRequestMessagesItem,
+    ChatCompletionRequestStop,
+    ChatCompletionRequestToolChoice,
+    ChatCompletionResponse,
+    ChildToolRule,
+    Choice,
+    ConditionalToolRule,
+    ConflictErrorBody,
+    ContextWindowOverview,
+    CreateAssistantFileRequest,
+    CreateAssistantRequest,
+    CreateBlock,
+    DeleteAssistantFileResponse,
+    DeleteAssistantResponse,
+    E2BSandboxConfig,
+    EmbeddingConfig,
+    EmbeddingConfigEmbeddingEndpointType,
+    FileMetadata,
+    FunctionCallInput,
+    FunctionCallOutput,
+    FunctionSchema,
+    Health,
+    HttpValidationError,
+    InitToolRule,
+    InternalServerErrorBody,
+    Job,
+    JobStatus,
+    LettaRequest,
+    LettaResponse,
+    LettaResponseAssistantMessage,
+    LettaResponseLettaUsageStatistics,
+    LettaResponseReasoningMessage,
+    LettaResponseSystemMessage,
+    LettaResponseToolCall,
+    LettaResponseToolCallDelta,
+    LettaResponseToolCallMessage,
+    LettaResponseToolCallMessageToolCall,
+    LettaResponseToolCallMessageToolCallOne,
+    LettaResponseToolCallMessageToolCallZero,
+    LettaResponseToolReturnMessage,
+    LettaResponseToolReturnMessageStatus,
+    LettaResponseUsageMessage,
+    LettaResponseUsageMessageUsage,
+    LettaResponseUserMessage,
+    LettaSchemasLettaMessageToolCall,
+    LettaSchemasMessageMessage,
+    LettaSchemasOpenaiChatCompletionRequestTool,
+    LettaSchemasOpenaiChatCompletionRequestToolCall,
+    LettaSchemasOpenaiChatCompletionRequestToolCallFunction,
+    LettaSchemasOpenaiChatCompletionResponseMessage,
+    LettaSchemasOpenaiChatCompletionResponseToolCall,
+    LettaSchemasOpenaiChatCompletionsToolCallFunction,
+    LettaSchemasOpenaiChatCompletionsToolCallInput,
+    LettaSchemasOpenaiChatCompletionsToolCallOutput,
+    LettaSchemasToolTool,
+    LettaUsageStatistics,
+    LlmConfig,
+    LlmConfigModelEndpointType,
+    LocalSandboxConfig,
+    LogProbToken,
+    Memory,
+    MessageContentLogProb,
+    MessageCreate,
+    MessageCreateRole,
+    MessageRole,
+    NotFoundErrorBody,
+    NotFoundErrorBodyMessage,
+    OpenAiAssistant,
+    Organization,
+    OrganizationCreate,
+    Passage,
+    ReasoningMessage,
+    RecallMemorySummary,
+    ResponseFormat,
+    SandboxConfig,
+    SandboxConfigCreate,
+    SandboxConfigCreateConfig,
+    SandboxConfigUpdate,
+    SandboxConfigUpdateConfig,
+    SandboxEnvironmentVariable,
+    SandboxEnvironmentVariableCreate,
+    SandboxEnvironmentVariableUpdate,
+    SandboxType,
+    Source,
+    SystemMessageInput,
+    SystemMessageOutput,
+    TerminalToolRule,
+    ToolCallDelta,
+    ToolCallFunctionOutput,
+    ToolCallMessage,
+    ToolCallMessageToolCall,
+    ToolCreate,
+    ToolFunctionChoice,
+    ToolInput,
+    ToolMessage,
+    ToolReturnMessage,
+    ToolReturnMessageStatus,
+    ToolRuleType,
+    UsageMessage,
+    UsageStatistics,
+    User,
+    UserCreate,
+    UserMessageInput,
+    UserMessageInputContent,
+    UserMessageOutput,
+    UserUpdate,
+    ValidationError,
+    ValidationErrorLocItem,
+)
+from .errors import ConflictError, InternalServerError, NotFoundError, UnprocessableEntityError
+from . import agents, blocks, health, jobs, models, sources, tools
+from .agents import (
+    AgentsCreateVersionResponse,
+    AgentsMigrateResponse,
+    CreateAgentRequestToolRulesItem,
+    UpdateAgentToolRulesItem,
+)
+from .client import AsyncLetta, Letta
+from .environment import LettaEnvironment
+from .version import __version__
+
+__all__ = [
+    "ActionModel",
+    "ActionParametersModel",
+    "ActionResponseModel",
+    "AgentState",
+    "AgentStateToolRulesItem",
+    "AgentType",
+    "AgentsCreateVersionResponse",
+    "AgentsMigrateResponse",
+    "AppAuthScheme",
+    "AppAuthSchemeAuthMode",
+    "AppModel",
+    "ArchivalMemorySummary",
+    "AssistantFile",
+    "AssistantMessageInput",
+    "AssistantMessageOutput",
+    "AsyncLetta",
+    "AuthRequest",
+    "AuthResponse",
+    "AuthSchemeField",
+    "Block",
+    "BlockUpdate",
+    "ChatCompletionRequest",
+    "ChatCompletionRequestFunctionCall",
+    "ChatCompletionRequestMessagesItem",
+    "ChatCompletionRequestStop",
+    "ChatCompletionRequestToolChoice",
+    "ChatCompletionResponse",
+    "ChildToolRule",
+    "Choice",
+    "ConditionalToolRule",
+    "ConflictError",
+    "ConflictErrorBody",
+    "ContextWindowOverview",
+    "CreateAgentRequestToolRulesItem",
+    "CreateAssistantFileRequest",
+    "CreateAssistantRequest",
+    "CreateBlock",
+    "DeleteAssistantFileResponse",
+    "DeleteAssistantResponse",
+    "E2BSandboxConfig",
+    "EmbeddingConfig",
+    "EmbeddingConfigEmbeddingEndpointType",
+    "FileMetadata",
+    "FunctionCallInput",
+    "FunctionCallOutput",
+    "FunctionSchema",
+    "Health",
+    "HttpValidationError",
+    "InitToolRule",
+    "InternalServerError",
+    "InternalServerErrorBody",
+    "Job",
+    "JobStatus",
+    "Letta",
+    "LettaEnvironment",
+    "LettaRequest",
+    "LettaResponse",
+    "LettaResponseAssistantMessage",
+    "LettaResponseLettaUsageStatistics",
+    "LettaResponseReasoningMessage",
+    "LettaResponseSystemMessage",
+    "LettaResponseToolCall",
+    "LettaResponseToolCallDelta",
+    "LettaResponseToolCallMessage",
+    "LettaResponseToolCallMessageToolCall",
+    "LettaResponseToolCallMessageToolCallOne",
+    "LettaResponseToolCallMessageToolCallZero",
+    "LettaResponseToolReturnMessage",
+    "LettaResponseToolReturnMessageStatus",
+    "LettaResponseUsageMessage",
+    "LettaResponseUsageMessageUsage",
+    "LettaResponseUserMessage",
+    "LettaSchemasLettaMessageToolCall",
+    "LettaSchemasMessageMessage",
+    "LettaSchemasOpenaiChatCompletionRequestTool",
+    "LettaSchemasOpenaiChatCompletionRequestToolCall",
+    "LettaSchemasOpenaiChatCompletionRequestToolCallFunction",
+    "LettaSchemasOpenaiChatCompletionResponseMessage",
+    "LettaSchemasOpenaiChatCompletionResponseToolCall",
+    "LettaSchemasOpenaiChatCompletionsToolCallFunction",
+    "LettaSchemasOpenaiChatCompletionsToolCallInput",
+    "LettaSchemasOpenaiChatCompletionsToolCallOutput",
+    "LettaSchemasToolTool",
+    "LettaUsageStatistics",
+    "LlmConfig",
+    "LlmConfigModelEndpointType",
+    "LocalSandboxConfig",
+    "LogProbToken",
+    "Memory",
+    "MessageContentLogProb",
+    "MessageCreate",
+    "MessageCreateRole",
+    "MessageRole",
+    "NotFoundError",
+    "NotFoundErrorBody",
+    "NotFoundErrorBodyMessage",
+    "OpenAiAssistant",
+    "Organization",
+    "OrganizationCreate",
+    "Passage",
+    "ReasoningMessage",
+    "RecallMemorySummary",
+    "ResponseFormat",
+    "SandboxConfig",
+    "SandboxConfigCreate",
+    "SandboxConfigCreateConfig",
+    "SandboxConfigUpdate",
+    "SandboxConfigUpdateConfig",
+    "SandboxEnvironmentVariable",
+    "SandboxEnvironmentVariableCreate",
+    "SandboxEnvironmentVariableUpdate",
+    "SandboxType",
+    "Source",
+    "SystemMessageInput",
+    "SystemMessageOutput",
+    "TerminalToolRule",
+    "ToolCallDelta",
+    "ToolCallFunctionOutput",
+    "ToolCallMessage",
+    "ToolCallMessageToolCall",
+    "ToolCreate",
+    "ToolFunctionChoice",
+    "ToolInput",
+    "ToolMessage",
+    "ToolReturnMessage",
+    "ToolReturnMessageStatus",
+    "ToolRuleType",
+    "UnprocessableEntityError",
+    "UpdateAgentToolRulesItem",
+    "UsageMessage",
+    "UsageStatistics",
+    "User",
+    "UserCreate",
+    "UserMessageInput",
+    "UserMessageInputContent",
+    "UserMessageOutput",
+    "UserUpdate",
+    "ValidationError",
+    "ValidationErrorLocItem",
+    "__version__",
+    "agents",
+    "blocks",
+    "health",
+    "jobs",
+    "models",
+    "sources",
+    "tools",
+]