meshagent-cli 0.50.0__tar.gz → 0.51.0__tar.gz

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshagent-cli
-Version: 0.50.0
+Version: 0.51.0
 Summary: CLI for Meshagent
 License-Expression: Apache-2.0
 Project-URL: Documentation, https://docs.meshagent.com
@@ -22,8 +22,8 @@ Requires-Dist: openpyxl~=3.1
 Requires-Dist: xlsxwriter~=3.2
 Requires-Dist: pathspec<2,>=1.0.3
 Requires-Dist: zstandard~=0.25.0
-Requires-Dist: meshagent-llm-proxy==0.50.0
-Requires-Dist: meshagent-codex==0.50.0
+Requires-Dist: meshagent-llm-proxy==0.51.0
+Requires-Dist: meshagent-codex==0.51.0
 Requires-Dist: rich~=14.3.0
 Requires-Dist: sounddevice~=0.5
 Requires-Dist: textual<9.0,>=8.2.3
@@ -32,23 +32,23 @@ Requires-Dist: prompt-toolkit~=3.0.52
 Requires-Dist: ascii-magic~=2.3
 Requires-Dist: pillow~=11.3.0
 Provides-Extra: all
-Requires-Dist: meshagent-agents[all]==0.50.0; extra == "all"
-Requires-Dist: meshagent-api[all]==0.50.0; extra == "all"
-Requires-Dist: meshagent-commoncrawl==0.50.0; extra == "all"
-Requires-Dist: meshagent-scrapy==0.50.0; extra == "all"
-Requires-Dist: meshagent-computers==0.50.0; extra == "all"
-Requires-Dist: meshagent-openai==0.50.0; extra == "all"
-Requires-Dist: meshagent-anthropic==0.50.0; extra == "all"
-Requires-Dist: meshagent-otel==0.50.0; extra == "all"
-Requires-Dist: meshagent-mcp==0.50.0; extra == "all"
-Requires-Dist: meshagent-tools==0.50.0; extra == "all"
+Requires-Dist: meshagent-agents[all]==0.51.0; extra == "all"
+Requires-Dist: meshagent-api[all]==0.51.0; extra == "all"
+Requires-Dist: meshagent-commoncrawl==0.51.0; extra == "all"
+Requires-Dist: meshagent-scrapy==0.51.0; extra == "all"
+Requires-Dist: meshagent-computers==0.51.0; extra == "all"
+Requires-Dist: meshagent-openai==0.51.0; extra == "all"
+Requires-Dist: meshagent-anthropic==0.51.0; extra == "all"
+Requires-Dist: meshagent-otel==0.51.0; extra == "all"
+Requires-Dist: meshagent-mcp==0.51.0; extra == "all"
+Requires-Dist: meshagent-tools==0.51.0; extra == "all"
 Requires-Dist: supabase-auth~=2.28.0; extra == "all"
 Requires-Dist: prompt-toolkit~=3.0.52; extra == "all"
 Provides-Extra: mcp-service
-Requires-Dist: meshagent-agents[all]==0.50.0; extra == "mcp-service"
-Requires-Dist: meshagent-api==0.50.0; extra == "mcp-service"
-Requires-Dist: meshagent-mcp==0.50.0; extra == "mcp-service"
-Requires-Dist: meshagent-tools==0.50.0; extra == "mcp-service"
+Requires-Dist: meshagent-agents[all]==0.51.0; extra == "mcp-service"
+Requires-Dist: meshagent-api==0.51.0; extra == "mcp-service"
+Requires-Dist: meshagent-mcp==0.51.0; extra == "mcp-service"
+Requires-Dist: meshagent-tools==0.51.0; extra == "mcp-service"
 Requires-Dist: supabase-auth~=2.28.0; extra == "mcp-service"
 Dynamic: license-file
 

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/chatbot.py

@@ -1471,6 +1471,8 @@ def _build_shell_tool_env(
         env["MESHAGENT_TOKEN"] = room.protocol.token
         env["OPENAI_API_KEY"] = room.protocol.token
         env["ANTHROPIC_API_KEY"] = room.protocol.token
+        env["GROK_API_KEY"] = room.protocol.token
+        env["XAI_API_KEY"] = room.protocol.token
     return env
 
 

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/containers.py

@@ -780,12 +780,14 @@ async def run_container(
             "--template",
             help=(
                 "Allowed values: agent, none. agent: MeshAgent mounts room storage "
-                "at /data, sets MESHAGENT_TOKEN, OPENAI_API_KEY, and "
-                "ANTHROPIC_API_KEY to a container-scoped MeshAgent token. agent "
+                "at /data, sets MESHAGENT_TOKEN, OPENAI_API_KEY, "
+                "ANTHROPIC_API_KEY, GROK_API_KEY, and XAI_API_KEY to a "
+                "container-scoped MeshAgent token. agent "
                 "also sets SMTP_PASSWORD to that token, SMTP_USERNAME to the "
                 "container name, SMTP_PORT to 587, SMTP_HOSTNAME from "
                 "MESHAGENT_MAIL_DOMAIN when available, plus OPENAI_BASE_URL, "
-                "ANTHROPIC_BASE_URL, MESHAGENT_API_URL, MESHAGENT_ROOM_URL, "
+                "ANTHROPIC_BASE_URL, GROK_BASE_URL, XAI_BASE_URL, "
+                "MESHAGENT_API_URL, MESHAGENT_ROOM_URL, "
                 "MESHAGENT_ROOM, MESHAGENT_PROJECT_ID, MESHAGENT_SESSION_ID, "
                 "OTEL_ENDPOINT, OTEL_PYTHON_LOG_LEVEL, and MESHAGENT_MAIL_DOMAIN "
                 "from the room runtime when available. Manual env values win. "

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/create_test.py

@@ -3568,9 +3568,9 @@ def test_init_creates_flutter_webserver_non_interactively(tmp_path) -> None:
     assert (
         "FROM --platform=${FLUTTER_IMAGE_PLATFORM} ubuntu:24.04 AS build" in dockerfile
     )
-    assert "ARG FLUTTER_VERSION=3.44.6" in dockerfile
+    assert "ARG FLUTTER_VERSION=3.47.0" in dockerfile
     assert (
-        "a6320fd72e9a2690c08e2a6a70874a30cb120dee7c78f49d2c628bd7c9e20525" in dockerfile
+        "26cd99d3d94b1367e6b50535a18aeef0282c10a535bbe3ec493534dcdab75296" in dockerfile
     )
     assert 'PUB_CACHE="${PUB_CACHE:-$ROOT/.pub-cache}"' in install_sh
     assert "command -v flutter" in install_sh

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/image.py

@@ -140,6 +140,8 @@ _TOKEN_ENVIRONMENT_NAMES = (
     "MESHAGENT_TOKEN",
     "OPENAI_API_KEY",
     "ANTHROPIC_API_KEY",
+    "GROK_API_KEY",
+    "XAI_API_KEY",
 )
 _DEFAULT_MESHAGENT_IMAGE_PREFIX = PROD_MESHAGENT_IMAGE_PREFIX
 _IMAGE_TAG_RE = re.compile(r"^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$")
@@ -4584,12 +4586,14 @@ async def deploy_image(
             "--template",
             help=(
                 "Allowed values: agent, none. agent: MeshAgent mounts room storage "
-                "at /data, sets MESHAGENT_TOKEN, OPENAI_API_KEY, and "
-                "ANTHROPIC_API_KEY to a container-scoped MeshAgent token. agent "
+                "at /data, sets MESHAGENT_TOKEN, OPENAI_API_KEY, "
+                "ANTHROPIC_API_KEY, GROK_API_KEY, and XAI_API_KEY to a "
+                "container-scoped MeshAgent token. agent "
                 "also sets SMTP_PASSWORD to that token, SMTP_USERNAME to the "
                 "container name, SMTP_PORT to 587, SMTP_HOSTNAME from "
                 "MESHAGENT_MAIL_DOMAIN when available, plus OPENAI_BASE_URL, "
-                "ANTHROPIC_BASE_URL, MESHAGENT_API_URL, MESHAGENT_ROOM_URL, "
+                "ANTHROPIC_BASE_URL, GROK_BASE_URL, XAI_BASE_URL, "
+                "MESHAGENT_API_URL, MESHAGENT_ROOM_URL, "
                 "MESHAGENT_ROOM, MESHAGENT_PROJECT_ID, MESHAGENT_SESSION_ID, "
                 "OTEL_ENDPOINT, OTEL_PYTHON_LOG_LEVEL, and MESHAGENT_MAIL_DOMAIN "
                 "from the room runtime when available. Manual env values win. "

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/image_test.py

@@ -3131,7 +3131,12 @@ async def test_deploy_image_creates_room_service_with_mounts_env_secret_and_toke
     assert env_by_name["MESHAGENT_TOKEN"].token.api.secrets is None
     assert env_by_name["MESHAGENT_TOKEN"].token.api.services is not None
     assert env_by_name["MESHAGENT_TOKEN"].token.role == "agent"
-    for env_name in ("OPENAI_API_KEY", "ANTHROPIC_API_KEY"):
+    for env_name in (
+        "OPENAI_API_KEY",
+        "ANTHROPIC_API_KEY",
+        "GROK_API_KEY",
+        "XAI_API_KEY",
+    ):
         assert env_by_name[env_name].token is not None
         assert env_by_name[env_name].token == env_by_name["MESHAGENT_TOKEN"].token
     assert "restarted_service_id" not in captured
@@ -3208,7 +3213,12 @@ async def test_deploy_image_identity_overrides_env_secret_and_token_identity(
     assert env_by_name["APP_SECRET"].secret == SecretValue(id="secret-1")
     assert env_by_name["MESHAGENT_TOKEN"].token is not None
     assert env_by_name["MESHAGENT_TOKEN"].token.identity == "custom-agent"
-    for env_name in ("OPENAI_API_KEY", "ANTHROPIC_API_KEY"):
+    for env_name in (
+        "OPENAI_API_KEY",
+        "ANTHROPIC_API_KEY",
+        "GROK_API_KEY",
+        "XAI_API_KEY",
+    ):
         assert env_by_name[env_name].token is not None
         assert env_by_name[env_name].token == env_by_name["MESHAGENT_TOKEN"].token
     assert captured["room_client_closed"] is True
@@ -5252,7 +5262,12 @@ async def test_deploy_image_updates_existing_service_route_and_replaces_environm
     assert env_by_name["MESHAGENT_TOKEN"].token.api.admin is not None
     assert env_by_name["MESHAGENT_TOKEN"].token.api.secrets is None
     assert env_by_name["MESHAGENT_TOKEN"].token.api.tunnels is not None
-    for env_name in ("OPENAI_API_KEY", "ANTHROPIC_API_KEY"):
+    for env_name in (
+        "OPENAI_API_KEY",
+        "ANTHROPIC_API_KEY",
+        "GROK_API_KEY",
+        "XAI_API_KEY",
+    ):
         assert env_by_name[env_name].token is not None
         assert env_by_name[env_name].token == env_by_name["MESHAGENT_TOKEN"].token
     assert updated_spec.ports is not None

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/mailbot.py

@@ -395,6 +395,8 @@ def build_mailbot(
                 env["MESHAGENT_TOKEN"] = self.room.protocol.token
                 env["OPENAI_API_KEY"] = self.room.protocol.token
                 env["ANTHROPIC_API_KEY"] = self.room.protocol.token
+                env["GROK_API_KEY"] = self.room.protocol.token
+                env["XAI_API_KEY"] = self.room.protocol.token
 
             if require_shell:
                 if supports_openai_shell:

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/mailboxes.py

@@ -8,7 +8,11 @@ import typer
 from aiohttp import ClientResponseError
 from rich import print
 
-from meshagent.api.client import Mailbox, ValidationErrorResponse
+from meshagent.api.client import (
+    Mailbox,
+    MailboxDeliveryStatus,
+    ValidationErrorResponse,
+)
 from meshagent.cli import async_typer
 from meshagent.cli.common_options import ProjectIdOption, OutputFormatOption
 from meshagent.cli.helper import (
@@ -259,6 +263,120 @@ async def mailbox_get(
         await client.close()
 
 
+@app.async_command("deliveries")
+async def mailbox_deliveries(
+    *,
+    project_id: ProjectIdOption,
+    address: Annotated[str, typer.Argument(help="Mailbox address")],
+    status: Annotated[
+        Optional[MailboxDeliveryStatus],
+        typer.Option("--status", help="Filter by current delivery status"),
+    ] = None,
+    recipient: Annotated[
+        Optional[str], typer.Option("--recipient", help="Recipient contains filter")
+    ] = None,
+    message_id: Annotated[
+        Optional[str], typer.Option("--message-id", help="Exact Message-ID filter")
+    ] = None,
+    count: Annotated[
+        int, typer.Option("--count", help="Maximum rows to return", min=1)
+    ] = 100,
+    offset: Annotated[
+        int, typer.Option("--offset", help="Row offset for pagination", min=0)
+    ] = 0,
+    o: OutputFormatOption = "table",
+):
+    """List outbound deliveries for a mailbox, newest submission first."""
+    client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id)
+        page = await client.list_mailbox_deliveries(
+            project_id=project_id,
+            address=address,
+            status=status,
+            recipient=recipient,
+            message_id=message_id,
+            count=count,
+            offset=offset,
+        )
+        rows = [delivery.model_dump(mode="json") for delivery in page.deliveries]
+        if o == "json":
+            print({"deliveries": rows, "total": page.total})
+        else:
+            print_json_table(
+                rows,
+                "submitted_at",
+                "recipient",
+                "status",
+                "message_id",
+                "id",
+            )
+    finally:
+        await client.close()
+
+
+@app.async_command("delivery")
+async def mailbox_delivery(
+    *,
+    project_id: ProjectIdOption,
+    address: Annotated[str, typer.Argument(help="Mailbox address")],
+    delivery_id: Annotated[str, typer.Argument(help="Delivery ID")],
+):
+    """Get the current status and SMTP details for a delivery."""
+    client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id)
+        delivery = await client.get_mailbox_delivery(
+            project_id=project_id,
+            address=address,
+            delivery_id=delivery_id,
+        )
+        print(delivery.model_dump(mode="json"))
+    finally:
+        await client.close()
+
+
+@app.async_command("delivery-events")
+async def mailbox_delivery_events(
+    *,
+    project_id: ProjectIdOption,
+    address: Annotated[str, typer.Argument(help="Mailbox address")],
+    delivery_id: Annotated[str, typer.Argument(help="Delivery ID")],
+    count: Annotated[
+        int, typer.Option("--count", help="Maximum rows to return", min=1)
+    ] = 100,
+    offset: Annotated[
+        int, typer.Option("--offset", help="Row offset for pagination", min=0)
+    ] = 0,
+    o: OutputFormatOption = "table",
+):
+    """List a delivery's events in chronological order."""
+    client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id)
+        page = await client.list_mailbox_delivery_events(
+            project_id=project_id,
+            address=address,
+            delivery_id=delivery_id,
+            count=count,
+            offset=offset,
+        )
+        rows = [event.model_dump(mode="json") for event in page.events]
+        if o == "json":
+            print({"events": rows, "total": page.total})
+        else:
+            print_json_table(
+                rows,
+                "occurred_at",
+                "event_type",
+                "smtp_code",
+                "description",
+                "attempt_no",
+            )
+    finally:
+        await client.close()
+
+
 @app.async_command("list")
 async def mailbox_list(
     *,

{meshagent_cli-0.50.0 → meshagent_cli-0.51.0}/meshagent/cli/mailboxes_test.py

@@ -1,6 +1,14 @@
 import pytest
+from datetime import datetime, timezone
 
-from meshagent.api.client import Mailbox, MailboxesPage
+from meshagent.api.client import (
+    Mailbox,
+    MailboxDeliveriesPage,
+    MailboxDelivery,
+    MailboxDeliveryEvent,
+    MailboxDeliveryEventsPage,
+    MailboxesPage,
+)
 from meshagent.cli import async_typer, mailboxes
 from meshagent.cli.testing import CliRunner
 
@@ -21,6 +29,8 @@ class _FakeClient:
         self.list_mailboxes_page_calls: list[dict[str, object]] = []
         self.list_room_mailboxes_calls: list[dict[str, object]] = []
         self.room_mailboxes: list[Mailbox] = []
+        self.delivery_calls: list[dict[str, object]] = []
+        self.delivery_event_calls: list[dict[str, object]] = []
         self.closed = False
 
     async def list_mailboxes_page(self, **kwargs) -> MailboxesPage:
@@ -33,6 +43,43 @@ class _FakeClient:
         self.list_room_mailboxes_calls.append(kwargs)
         return self.room_mailboxes
 
+    async def list_mailbox_deliveries(self, **kwargs) -> MailboxDeliveriesPage:
+        self.delivery_calls.append(kwargs)
+        timestamp = datetime(2026, 8, 21, tzinfo=timezone.utc)
+        return MailboxDeliveriesPage(
+            deliveries=[
+                MailboxDelivery(
+                    id="delivery-1",
+                    submission_id="submission-1",
+                    recipient="person@example.net",
+                    message_id="<message@example.test>",
+                    status="delivered",
+                    submitted_at=timestamp,
+                    status_at=timestamp,
+                )
+            ],
+            total=1,
+        )
+
+    async def list_mailbox_delivery_events(self, **kwargs) -> MailboxDeliveryEventsPage:
+        self.delivery_event_calls.append(kwargs)
+        timestamp = datetime(2026, 8, 21, tzinfo=timezone.utc)
+        return MailboxDeliveryEventsPage(
+            events=[
+                MailboxDeliveryEvent(
+                    id="event-1",
+                    delivery_id="delivery-1",
+                    provider="mailgun",
+                    provider_event_id="mailgun-event-1",
+                    event_type="delivered",
+                    status="delivered",
+                    occurred_at=timestamp,
+                    received_at=timestamp,
+                )
+            ],
+            total=1,
+        )
+
     async def close(self) -> None:
         self.closed = True
 
@@ -150,3 +197,69 @@ async def test_mailbox_list_room_preserves_offset_pagination(
     ]
     assert client.list_mailboxes_page_calls == []
     assert client.closed is True
+
+
+@pytest.mark.asyncio
+async def test_mailbox_deliveries_outputs_status_and_passes_filters(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    client = _FakeClient()
+    printed: list[dict[str, object]] = []
+    _patch_mailbox_list(monkeypatch, client=client)
+    monkeypatch.setattr(mailboxes, "print", lambda value: printed.append(value))
+
+    await mailboxes.mailbox_deliveries(
+        project_id="project-1",
+        address="alerts@example.test",
+        status="delivered",
+        recipient="person",
+        message_id="<message@example.test>",
+        count=25,
+        offset=10,
+        o="json",
+    )
+
+    assert client.delivery_calls == [
+        {
+            "project_id": "project-1",
+            "address": "alerts@example.test",
+            "status": "delivered",
+            "recipient": "person",
+            "message_id": "<message@example.test>",
+            "count": 25,
+            "offset": 10,
+        }
+    ]
+    assert printed[0]["deliveries"][0]["status"] == "delivered"
+    assert client.closed is True
+
+
+@pytest.mark.asyncio
+async def test_mailbox_delivery_events_outputs_chronological_events(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    client = _FakeClient()
+    printed: list[dict[str, object]] = []
+    _patch_mailbox_list(monkeypatch, client=client)
+    monkeypatch.setattr(mailboxes, "print", lambda value: printed.append(value))
+
+    await mailboxes.mailbox_delivery_events(
+        project_id="project-1",
+        address="alerts@example.test",
+        delivery_id="delivery-1",
+        count=50,
+        offset=0,
+        o="json",
+    )
+
+    assert client.delivery_event_calls == [
+        {
+            "project_id": "project-1",
+            "address": "alerts@example.test",
+            "delivery_id": "delivery-1",
+            "count": 50,
+            "offset": 0,
+        }
+    ]
+    assert printed[0]["events"][0]["event_type"] == "delivered"
+    assert client.closed is True