meshagent-cli 0.47.1__tar.gz → 0.49.0__tar.gz

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshagent-cli
-Version: 0.47.1
+Version: 0.49.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.47.1
-Requires-Dist: meshagent-codex==0.47.1
+Requires-Dist: meshagent-llm-proxy==0.49.0
+Requires-Dist: meshagent-codex==0.49.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.47.1; extra == "all"
-Requires-Dist: meshagent-api[all]==0.47.1; extra == "all"
-Requires-Dist: meshagent-commoncrawl==0.47.1; extra == "all"
-Requires-Dist: meshagent-scrapy==0.47.1; extra == "all"
-Requires-Dist: meshagent-computers==0.47.1; extra == "all"
-Requires-Dist: meshagent-openai==0.47.1; extra == "all"
-Requires-Dist: meshagent-anthropic==0.47.1; extra == "all"
-Requires-Dist: meshagent-otel==0.47.1; extra == "all"
-Requires-Dist: meshagent-mcp==0.47.1; extra == "all"
-Requires-Dist: meshagent-tools==0.47.1; extra == "all"
+Requires-Dist: meshagent-agents[all]==0.49.0; extra == "all"
+Requires-Dist: meshagent-api[all]==0.49.0; extra == "all"
+Requires-Dist: meshagent-commoncrawl==0.49.0; extra == "all"
+Requires-Dist: meshagent-scrapy==0.49.0; extra == "all"
+Requires-Dist: meshagent-computers==0.49.0; extra == "all"
+Requires-Dist: meshagent-openai==0.49.0; extra == "all"
+Requires-Dist: meshagent-anthropic==0.49.0; extra == "all"
+Requires-Dist: meshagent-otel==0.49.0; extra == "all"
+Requires-Dist: meshagent-mcp==0.49.0; extra == "all"
+Requires-Dist: meshagent-tools==0.49.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.47.1; extra == "mcp-service"
-Requires-Dist: meshagent-api==0.47.1; extra == "mcp-service"
-Requires-Dist: meshagent-mcp==0.47.1; extra == "mcp-service"
-Requires-Dist: meshagent-tools==0.47.1; extra == "mcp-service"
+Requires-Dist: meshagent-agents[all]==0.49.0; extra == "mcp-service"
+Requires-Dist: meshagent-api==0.49.0; extra == "mcp-service"
+Requires-Dist: meshagent-mcp==0.49.0; extra == "mcp-service"
+Requires-Dist: meshagent-tools==0.49.0; extra == "mcp-service"
 Requires-Dist: supabase-auth~=2.28.0; extra == "mcp-service"
 Dynamic: license-file
 

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/cli.py

@@ -180,6 +180,11 @@ app.add_lazy_command(
     module="meshagent.cli.rooms",
     help="Create, list, and manage rooms in a project",
 )
+app.add_lazy_command(
+    name="volumes",
+    module="meshagent.cli.volumes",
+    help="Manage durable storage volumes for a room",
+)
 app.add_lazy_command(
     name="agent",
     module="meshagent.cli.agents",

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/cli_test.py

@@ -58,6 +58,7 @@ def test_root_help_lists_create_and_doctor_but_hides_legacy_command_namespaces()
     assert "│ api-key" not in result.output
     assert "│ launch" in result.output
     assert "│ room" in result.output
+    assert "│ volumes" in result.output
     assert "│ call" not in result.output
     assert "│ package" not in result.output
     assert "│ multi" not in result.output
@@ -151,6 +152,36 @@ def test_room_help_lists_agents_command() -> None:
     assert "│ agents" in result.output
 
 
+def test_volumes_help_lists_durable_lifecycle_commands() -> None:
+    result = CliRunner().invoke(cli.app, ["volumes", "--help"])
+
+    assert result.exit_code == 0
+    assert "│ list" in result.output
+    assert "│ create" in result.output
+    assert "│ expand" in result.output
+    assert "│ delete" in result.output
+    assert "lease" not in result.output.lower()
+
+    create_result = CliRunner().invoke(cli.app, ["volumes", "create", "--help"])
+    assert create_result.exit_code == 0
+    assert "--type" in create_result.output
+    assert "--max-size" in create_result.output
+
+    expand_result = CliRunner().invoke(cli.app, ["volumes", "expand", "--help"])
+    assert expand_result.exit_code == 0
+    assert "--max-size" in expand_result.output
+
+
+def test_room_mounts_help_is_list_only() -> None:
+    result = CliRunner().invoke(cli.app, ["room", "mounts", "--help"])
+
+    assert result.exit_code == 0
+    assert "│ list" in result.output
+    assert "│ mount" not in result.output
+    assert "│ unmount" not in result.output
+    assert "lease" not in result.output.lower()
+
+
 def test_room_agents_help_lists_call_command() -> None:
     result = CliRunner().invoke(cli.app, ["room", "agents", "--help"])
 

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/create_project_templates/python/contact-form/server.py

@@ -25,7 +25,8 @@ logging.basicConfig(
 )
 LOGGER = logging.getLogger("contact_form")
 
-DEFAULT_FROM_ADDRESS = "contact@mail.meshagent.com"
+DEFAULT_MAIL_DOMAIN = "mail.meshagent.com"
+DEFAULT_FROM_ADDRESS = f"contact@{DEFAULT_MAIL_DOMAIN}"
 DEFAULT_TO_ADDRESS = ""
 PRIVATE_MAILBOX_PERMISSION_ERROR = "5.7.1 Permission denied"
 TRUE_ENV_VALUES = {"1", "true", "yes", "on"}
@@ -181,10 +182,19 @@ def room_slug_from_name(room_name: str) -> str:
     return room_slug or "room"
 
 
+def mail_domain() -> str:
+    return (
+        os.getenv("MESHAGENT_MAIL_DOMAIN", DEFAULT_MAIL_DOMAIN)
+        .strip()
+        .removeprefix("@")
+        or DEFAULT_MAIL_DOMAIN
+    )
+
+
 def default_from_address() -> str:
     room_name = os.getenv("MESHAGENT_ROOM", "").strip()
     if room_name:
-        return f"contact-{room_slug_from_name(room_name)}@mail.meshagent.com"
+        return f"contact-{room_slug_from_name(room_name)}@{mail_domain()}"
     return DEFAULT_FROM_ADDRESS
 
 

meshagent_cli-0.49.0/meshagent/cli/mounts.py

@@ -0,0 +1,64 @@
+import json
+
+from rich import print
+
+from meshagent.api import RoomClient, RoomException, WebSocketClientProtocol
+from meshagent.api.helpers import websocket_room_url
+from meshagent.cli import async_typer
+from meshagent.cli.common_options import OutputFormatOption, ProjectIdOption, RoomOption
+from meshagent.cli.helper import (
+    get_client,
+    print_json_table,
+    resolve_project_id,
+    resolve_room,
+)
+
+
+app = async_typer.AsyncTyper(help="List storage mounts currently ready in a room")
+
+
+@app.callback()
+def _mounts_callback() -> None:
+    pass
+
+
+@app.async_command("list")
+async def list_mounts_command(
+    *,
+    project_id: ProjectIdOption,
+    room: RoomOption,
+    output: OutputFormatOption = "table",
+) -> None:
+    account_client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id=project_id)
+        room_name = resolve_room(room)
+        if room_name is None:
+            raise RoomException("--room is required")
+        connection = await account_client.connect_room(
+            project_id=project_id,
+            room=room_name,
+        )
+        async with RoomClient(
+            protocol_factory=WebSocketClientProtocol(
+                url=websocket_room_url(room_name=room_name),
+                token=connection.jwt,
+            ).create_factory()
+        ) as room_client:
+            mounts = await room_client.mounts.list()
+        records = [mount.model_dump(mode="json") for mount in mounts]
+        if output == "json":
+            print(json.dumps(records, indent=2))
+        elif records:
+            print_json_table(
+                records,
+                "id",
+                "name",
+                "required",
+                "description",
+                "consumers",
+            )
+        else:
+            print("No storage mounts are ready.")
+    finally:
+        await account_client.close()

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/process_live_test.py

@@ -299,14 +299,13 @@ class _RestoringThreadStorage:
     def agent_messages(self) -> list[AgentMessage]:
         return [*self.messages]
 
-    async def restore_session_context_async(self, *, context, llm_adapter) -> None:
-        restored_messages: list[dict[str, Any]] = []
-        reader = llm_adapter.make_agent_event_reader(
-            emit_message=restored_messages.append
+    async def restore_session_context(
+        self, *, context, llm_adapter, file_reader=None
+    ) -> None:
+        restored_messages = await llm_adapter.project_agent_messages(
+            messages=self.messages,
+            file_reader=file_reader,
         )
-        for message in self.messages:
-            reader.consume(message)
-        reader.finalize()
         llm_adapter.restore_context_messages(
             context=context,
             messages=restored_messages,

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/process_test.py

@@ -5442,12 +5442,12 @@ class _FakeProcessThreadAdapter:
     def agent_messages(self):
         return []
 
-    def restore_session_context(self, *, context, llm_adapter=None) -> None:
+    async def restore_session_context(
+        self, *, context, llm_adapter=None, file_reader=None
+    ) -> None:
         del context
         del llm_adapter
-
-    async def restore_session_context_async(self, *, context, llm_adapter=None) -> None:
-        self.restore_session_context(context=context, llm_adapter=llm_adapter)
+        del file_reader
 
     def make_toolkit(self):
         return Toolkit(name="thread", tools=[])
@@ -5547,6 +5547,28 @@ class _SteeringRecordingAdapter:
         del custom_event_callback
         return lambda message: None
 
+    async def project_agent_messages(
+        self,
+        *,
+        messages: list[AgentMessage],
+        file_reader=None,
+        callbacks=None,
+    ) -> list[dict[str, object]]:
+        del file_reader
+        del callbacks
+        projected: list[dict[str, object]] = []
+        for message in messages:
+            if not isinstance(message, (TurnStart, TurnSteer)):
+                continue
+            text = "\n".join(
+                item.text
+                for item in message.content
+                if isinstance(item, AgentTextContent) and item.text != ""
+            )
+            if text != "":
+                projected.append({"role": "user", "content": text})
+        return projected
+
     async def create_response(
         self,
         *,

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/projects.py

@@ -1,19 +1,24 @@
 import sys
 from dataclasses import dataclass
-from typing import Annotated
+from pathlib import Path
+from typing import Annotated, Literal
 
 import typer
+from pydantic import BaseModel, ConfigDict
+from pydantic_yaml import parse_yaml_raw_as
 from rich import print
 
+from meshagent.api import ApiScope
 from meshagent.api.client import Meshagent, NotFoundError, ProjectInfo, ProjectsPage
 from meshagent.cli import async_typer
+from meshagent.cli.common_options import OutputFormatOption, ProjectIdOption
 from meshagent.cli.helper import (
     get_client,
     get_active_project,
     print_json_table,
+    resolve_project_id,
     set_active_project,
 )
-from meshagent.cli.common_options import OutputFormatOption
 
 app = async_typer.AsyncTyper(help="Manage or activate your meshagent projects")
 
@@ -25,6 +30,30 @@ class ListedProject:
     is_active: bool
 
 
+RoomAccessRole = Literal["guest", "viewer", "operator", "developer", "admin"]
+
+
+class ParticipantTokenRoleDefinition(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    api: ApiScope
+
+
+class RoomRoleDefinition(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    participant: ParticipantTokenRoleDefinition | None = None
+    site_user: bool = False
+
+
+class RoomRolesSpec(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    version: Literal["v1"]
+    kind: Literal["RoomRoles"]
+    roles: dict[RoomAccessRole, RoomRoleDefinition]
+
+
 def _parse_listed_projects(
     response: ProjectsPage,
     *,
@@ -209,6 +238,50 @@ async def get(
         await client.close()
 
 
+@app.async_command(
+    "set-room-roles",
+    help="Set authoritative project room-role mappings from a YAML spec.",
+)
+async def set_room_roles(
+    file: Annotated[Path, typer.Argument(help="RoomRoles YAML spec")],
+    project_id: ProjectIdOption,
+):
+    try:
+        spec = parse_yaml_raw_as(RoomRolesSpec, file.read_text())
+    except (OSError, ValueError) as error:
+        print(f"[red]Invalid room role spec: {error}[/red]")
+        raise typer.Exit(code=1) from error
+
+    client = await get_client()
+    try:
+        resolved_project_id = await resolve_project_id(project_id)
+        await client.set_project_settings_document(
+            resolved_project_id,
+            "room_roles",
+            {"roles": spec.model_dump(mode="json", exclude_none=True)["roles"]},
+        )
+        print(f"[green]Room role override updated:[/] {resolved_project_id}")
+    finally:
+        await client.close()
+
+
+@app.async_command(
+    "reset-room-roles",
+    help="Remove the project room-role override and restore built-in defaults.",
+)
+async def reset_room_roles(project_id: ProjectIdOption):
+    client = await get_client()
+    try:
+        resolved_project_id = await resolve_project_id(project_id)
+        await client.delete_project_settings_document(
+            resolved_project_id,
+            "room_roles",
+        )
+        print(f"[green]Room role defaults restored:[/] {resolved_project_id}")
+    finally:
+        await client.close()
+
+
 @app.async_command(
     "activate", help="Set the active project for subsequent CLI commands."
 )

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/projects_test.py

@@ -17,6 +17,8 @@ class _FakeClient:
         self._project_rows = list(project_rows)
         self._created_project_id = created_project_id
         self.created_project_names: list[str] = []
+        self.settings_documents: dict[str, dict] = {}
+        self.deleted_settings_documents: list[str] = []
         self.closed = False
 
     async def list_projects(self) -> ProjectsPage:
@@ -48,6 +50,16 @@ class _FakeClient:
         self._project_rows.append(created_row)
         return ProjectInfo.model_validate(created_row)
 
+    async def set_project_settings_document(
+        self, project_id: str, name: str, document: dict
+    ):
+        self.settings_documents[name] = document
+        return {}
+
+    async def delete_project_settings_document(self, project_id: str, name: str):
+        self.deleted_settings_documents.append(name)
+        return {}
+
     async def close(self) -> None:
         self.closed = True
 
@@ -375,3 +387,87 @@ async def test_activate_prints_cancel_message_when_tui_is_canceled(monkeypatch)
     assert active_project_calls == []
     assert output == ["Project activation canceled."]
     assert client.closed is True
+
+
+@pytest.mark.asyncio
+async def test_set_room_roles_writes_dedicated_document(monkeypatch, tmp_path) -> None:
+    client = _FakeClient(
+        [
+            {
+                "id": "project-1",
+                "name": "Alpha",
+            }
+        ]
+    )
+    spec = tmp_path / "room-roles.yaml"
+    spec.write_text(
+        """version: v1
+kind: RoomRoles
+roles:
+  guest:
+    participant:
+      api:
+        messaging:
+          broadcast: false
+          list: true
+          send: false
+    site_user: false
+"""
+    )
+
+    async def _fake_get_client():
+        return client
+
+    async def _fake_resolve_project_id(project_id=None):
+        return project_id or "project-1"
+
+    monkeypatch.setattr(projects, "get_client", _fake_get_client)
+    monkeypatch.setattr(projects, "resolve_project_id", _fake_resolve_project_id)
+
+    await projects.set_room_roles(file=spec, project_id="project-1")
+
+    assert client.settings_documents == {
+        "room_roles": {
+            "roles": {
+                "guest": {
+                    "participant": {
+                        "api": {
+                            "messaging": {
+                                "broadcast": False,
+                                "list": True,
+                                "send": False,
+                            }
+                        }
+                    },
+                    "site_user": False,
+                }
+            }
+        },
+    }
+    assert client.closed is True
+
+
+@pytest.mark.asyncio
+async def test_reset_room_roles_deletes_dedicated_document(monkeypatch) -> None:
+    client = _FakeClient(
+        [
+            {
+                "id": "project-1",
+                "name": "Alpha",
+            }
+        ]
+    )
+
+    async def _fake_get_client():
+        return client
+
+    async def _fake_resolve_project_id(project_id=None):
+        return project_id or "project-1"
+
+    monkeypatch.setattr(projects, "get_client", _fake_get_client)
+    monkeypatch.setattr(projects, "resolve_project_id", _fake_resolve_project_id)
+
+    await projects.reset_room_roles(project_id="project-1")
+
+    assert client.deleted_settings_documents == ["room_roles"]
+    assert client.closed is True

{meshagent_cli-0.47.1 → meshagent_cli-0.49.0}/meshagent/cli/room.py

@@ -29,6 +29,11 @@ app.add_lazy_command(
     module="meshagent.cli.storage",
     help="Manage storage for a room",
 )
+app.add_lazy_command(
+    name="mounts",
+    module="meshagent.cli.mounts",
+    help="List storage mounts currently ready in a room",
+)
 app.add_lazy_command(
     name="service",
     module="meshagent.cli.room_services",