langchain-sendmux 0.2.0__tar.gz

langchain_sendmux-0.2.0/.gitignore

@@ -0,0 +1,22 @@
+node_modules/
+.venv/
+.pytest_cache/
+dist/
+.tmp/
+coverage/
+.DS_Store
+*.log
+*.snap
+snapcraft-*.txt
+*.codegen.json
+.codegen/
+.codegraph/
+*.tsbuildinfo
+packages/ts/cli/oclif.manifest.json
+packages/ts/cli/tmp/
+.phpunit.result.cache
+__pycache__/
+*.py[cod]
+vendor/
+.bundle/
+target/

langchain_sendmux-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sendmux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

langchain_sendmux-0.2.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: langchain-sendmux
+Version: 0.2.0
+Summary: LangChain toolkit for the Sendmux email API for AI agents.
+Project-URL: Repository, https://github.com/Sendmux/sendmux-sdk
+License-Expression: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: langchain-core<2,>=1.0.0
+Requires-Dist: sendmux-mailbox<2.0.0,>=1.2.0
+Requires-Dist: sendmux-sending<2.0.0,>=1.3.0
+Description-Content-Type: text/markdown
+
+# langchain-sendmux
+
+[LangChain](https://docs.langchain.com) toolkit for [Sendmux](https://sendmux.ai), the email API for AI agents. Give a LangChain agent tools to send email and read its own inbox.
+
+## Installation
+
+```sh
+pip install langchain-sendmux
+```
+
+## Usage
+
+```python
+import os
+
+from langchain.agents import create_agent
+from langchain_sendmux import SendmuxToolkit
+
+smx = SendmuxToolkit(api_key=os.environ["SENDMUX_API_KEY"])
+
+agent = create_agent(
+    model="gpt-4o",
+    tools=smx.get_tools(),
+    system_prompt="You triage the support inbox.",
+)
+
+agent.invoke({"messages": [{"role": "user", "content": "Reply to Sarah."}]})
+```
+
+## Tools
+
+`SendmuxToolkit(api_key=...).get_tools()` returns three tools:
+
+- `send_email` - send an email to any recipient through Sendmux.
+- `list_messages` - list recent messages in the agent's mailbox.
+- `reply` - send a message from the agent's own mailbox.
+
+## Configuration
+
+- `api_key` (required) - a send + receive capable mailbox API key (`smx_mbx_*`) or a scoped agent token.
+- `default_from` (optional) - default From address for `send_email` when a call omits `var_from`.
+
+## Licence
+
+MIT. See the [licence file](https://github.com/Sendmux/sendmux-sdk/blob/main/LICENSE).

langchain_sendmux-0.2.0/README.md

@@ -0,0 +1,45 @@
+# langchain-sendmux
+
+[LangChain](https://docs.langchain.com) toolkit for [Sendmux](https://sendmux.ai), the email API for AI agents. Give a LangChain agent tools to send email and read its own inbox.
+
+## Installation
+
+```sh
+pip install langchain-sendmux
+```
+
+## Usage
+
+```python
+import os
+
+from langchain.agents import create_agent
+from langchain_sendmux import SendmuxToolkit
+
+smx = SendmuxToolkit(api_key=os.environ["SENDMUX_API_KEY"])
+
+agent = create_agent(
+    model="gpt-4o",
+    tools=smx.get_tools(),
+    system_prompt="You triage the support inbox.",
+)
+
+agent.invoke({"messages": [{"role": "user", "content": "Reply to Sarah."}]})
+```
+
+## Tools
+
+`SendmuxToolkit(api_key=...).get_tools()` returns three tools:
+
+- `send_email` - send an email to any recipient through Sendmux.
+- `list_messages` - list recent messages in the agent's mailbox.
+- `reply` - send a message from the agent's own mailbox.
+
+## Configuration
+
+- `api_key` (required) - a send + receive capable mailbox API key (`smx_mbx_*`) or a scoped agent token.
+- `default_from` (optional) - default From address for `send_email` when a call omits `var_from`.
+
+## Licence
+
+MIT. See the [licence file](https://github.com/Sendmux/sendmux-sdk/blob/main/LICENSE).

langchain_sendmux-0.2.0/langchain_sendmux/__init__.py

@@ -0,0 +1,7 @@
+"""LangChain toolkit for the Sendmux email API for AI agents."""
+
+from __future__ import annotations
+
+from langchain_sendmux.toolkit import SendmuxToolkit
+
+__all__ = ["SendmuxToolkit"]

langchain_sendmux-0.2.0/langchain_sendmux/toolkit.py

@@ -0,0 +1,146 @@
+"""LangChain toolkit for the Sendmux email API for AI agents."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from langchain_core.tools import BaseTool, BaseToolkit, tool
+from pydantic import Field
+
+from sendmux_mailbox import MailboxAPIApi, create_mailbox_client
+from sendmux_mailbox.models.send_mailbox_message_body import SendMailboxMessageBody
+from sendmux_sending import EmailSendRequest, EmailsApi, create_sending_client
+
+
+def _html_from_text(text: str) -> str:
+    escaped = (
+        text.replace("&", "&")
+        .replace("<", "&lt;")
+        .replace(">", "&gt;")
+        .replace("\n", "<br>")
+    )
+    return f"<p>{escaped}</p>"
+
+
+class SendmuxToolkit(BaseToolkit):
+    """LangChain toolkit exposing Sendmux tools to an agent.
+
+    ``get_tools()`` returns three tools: ``send_email``, ``list_messages`` and
+    ``reply``.
+
+    Example:
+        >>> from langchain.agents import create_agent
+        >>> from langchain_sendmux import SendmuxToolkit
+        >>> smx = SendmuxToolkit(api_key="smx_mbx_...")
+        >>> agent = create_agent(model="gpt-4o", tools=smx.get_tools())
+    """
+
+    api_key: str = Field(
+        description=(
+            "A send + receive capable mailbox API key (smx_mbx_*) or a scoped "
+            "agent token. Read it from your environment; never hard-code it."
+        ),
+    )
+    default_from: Optional[str] = Field(
+        default=None,
+        description=(
+            "Default From address for send_email when a call omits `from`. "
+            "If unset, the model must supply a sender per call."
+        ),
+    )
+
+    def get_tools(self) -> list[BaseTool]:
+        sending_client = create_sending_client(api_key=self.api_key)
+        mailbox_client = create_mailbox_client(api_key=self.api_key)
+        emails = EmailsApi(sending_client)
+        mailbox = MailboxAPIApi(mailbox_client)
+        default_from = self.default_from
+
+        @tool
+        def send_email(
+            to: str,
+            subject: str,
+            text: str,
+            html: Optional[str] = None,
+            var_from: Optional[str] = None,
+            idempotency_key: Optional[str] = None,
+        ) -> Any:
+            """Send an email through Sendmux to any recipient.
+
+            Args:
+                to: Recipient email address.
+                subject: Email subject line.
+                text: Plain-text body of the email.
+                html: Optional HTML body.
+                var_from: Sender email address; defaults to the configured sender.
+                idempotency_key: Optional key that makes a retried send idempotent
+                    for 24 hours.
+            """
+            sender = var_from if var_from is not None else default_from
+            if sender is None:
+                raise ValueError(
+                    "No sender address: pass `var_from` in the tool call, or set "
+                    "default_from on SendmuxToolkit."
+                )
+            # EmailSendRequest.var_from carries alias "from" (a Python keyword),
+            # so build from a dict via model_validate rather than keyword args.
+            response = emails.sending_send_email(
+                EmailSendRequest.model_validate(
+                    {
+                        "from": {"email": sender},
+                        "to": {"email": to},
+                        "subject": subject,
+                        "text_body": text,
+                        "html_body": (
+                            html if html is not None else _html_from_text(text)
+                        ),
+                    }
+                ),
+                idempotency_key=idempotency_key,
+            )
+            return response.data
+
+        @tool
+        def list_messages(limit: int = 25) -> Any:
+            """List recent messages in the agent's mailbox, newest first.
+
+            Args:
+                limit: Maximum number of messages to return (1-100).
+            """
+            response = mailbox.mailbox_list_messages(limit=limit)
+            return response.data
+
+        @tool
+        def reply(
+            to: str,
+            subject: str,
+            text: str,
+            html: Optional[str] = None,
+            idempotency_key: Optional[str] = None,
+        ) -> Any:
+            """Send a message from the agent's own mailbox, e.g. to reply to a sender.
+
+            Args:
+                to: Recipient email address.
+                subject: Subject line.
+                text: Plain-text body.
+                html: Optional HTML body.
+                idempotency_key: Optional key that makes a retried send idempotent
+                    for 24 hours.
+            """
+            response = mailbox.mailbox_send_message(
+                idempotency_key=idempotency_key,
+                send_mailbox_message_body=SendMailboxMessageBody.model_validate(
+                    {
+                        "to": [{"email": to, "name": None}],
+                        "subject": subject,
+                        "text_body": text,
+                        "html_body": (
+                            html if html is not None else _html_from_text(text)
+                        ),
+                    }
+                ),
+            )
+            return response.data
+
+        return [send_email, list_messages, reply]

langchain_sendmux-0.2.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "langchain-sendmux"
+version = "0.2.0"
+description = "LangChain toolkit for the Sendmux email API for AI agents."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+  "langchain-core>=1.0.0,<2",
+  "sendmux-sending>=1.3.0,<2.0.0",
+  "sendmux-mailbox>=1.2.0,<2.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/Sendmux/sendmux-sdk"
+
+[tool.hatch.build.targets.sdist]
+core-metadata-version = "2.4"
+include = [
+  "LICENSE",
+  "README.md",
+  "langchain_sendmux",
+]
+
+[tool.hatch.build.targets.wheel]
+core-metadata-version = "2.4"
+packages = ["langchain_sendmux"]
+artifacts = ["langchain_sendmux/py.typed"]