meshagent-cli 0.7.0__py3-none-any.whl

meshagent/cli/version.py

@@ -0,0 +1 @@
+__version__ = "0.7.0"

meshagent/cli/voicebot.py

@@ -0,0 +1,178 @@
+import typer
+from rich import print
+from typing import Annotated, Optional
+from meshagent.cli.common_options import ProjectIdOption, RoomOption
+from meshagent.api import RoomClient, WebSocketClientProtocol, RoomException
+from meshagent.api.helpers import meshagent_base_url, websocket_room_url
+from meshagent.cli import async_typer
+from meshagent.api import ParticipantToken, ApiScope
+from meshagent.cli.helper import (
+    get_client,
+    resolve_project_id,
+    resolve_room,
+    resolve_key,
+)
+from typing import List
+
+from meshagent.api import RequiredToolkit, RequiredSchema
+from meshagent.api.services import ServiceHost
+from pathlib import Path
+
+
+app = async_typer.AsyncTyper(help="Join a voicebot to a room")
+
+
+@app.async_command("join")
+async def make_call(
+    *,
+    project_id: ProjectIdOption = None,
+    room: RoomOption,
+    agent_name: Annotated[str, typer.Option(..., help="Name of the agent to call")],
+    rule: Annotated[List[str], typer.Option("--rule", "-r", help="a system rule")] = [],
+    rules_file: Optional[str] = None,
+    toolkit: Annotated[
+        List[str],
+        typer.Option("--toolkit", "-t", help="the name or url of a required toolkit"),
+    ] = [],
+    schema: Annotated[
+        List[str],
+        typer.Option("--schema", "-s", help="the name or url of a required schema"),
+    ] = [],
+    auto_greet_message: Annotated[Optional[str], typer.Option()] = None,
+    auto_greet_prompt: Annotated[Optional[str], typer.Option()] = None,
+    key: Annotated[
+        str,
+        typer.Option("--key", help="an api key to sign the token with"),
+    ] = None,
+):
+    try:
+        from meshagent.livekit.agents.voice import VoiceBot
+    except ImportError:
+
+        class VoiceBot:
+            def __init__(self, **kwargs):
+                raise RoomException(
+                    "meshagent.livekit module not found, voicebots are not available"
+                )
+
+    key = await resolve_key(project_id=project_id, key=key)
+
+    account_client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id=project_id)
+        room = resolve_room(room)
+
+        token = ParticipantToken(
+            name=agent_name,
+        )
+
+        token.add_api_grant(ApiScope.agent_default())
+
+        token.add_role_grant(role="agent")
+        token.add_room_grant(room)
+
+        jwt = token.to_jwt(api_key=key)
+        if rules_file is not None:
+            try:
+                with open(Path(rules_file).resolve(), "r") as f:
+                    rule.extend(f.read().splitlines())
+            except FileNotFoundError:
+                print(f"[yellow]rules file not found at {rules_file}[/yellow]")
+
+        print("[bold green]Connecting to room...[/bold green]", flush=True)
+        async with RoomClient(
+            protocol=WebSocketClientProtocol(
+                url=websocket_room_url(room_name=room, base_url=meshagent_base_url()),
+                token=jwt,
+            )
+        ) as client:
+            requirements = []
+
+            for t in toolkit:
+                requirements.append(RequiredToolkit(name=t))
+
+            for t in schema:
+                requirements.append(RequiredSchema(name=t))
+
+            bot = VoiceBot(
+                auto_greet_message=auto_greet_message,
+                auto_greet_prompt=auto_greet_prompt,
+                name=agent_name,
+                requires=requirements,
+                rules=rule if len(rule) > 0 else None,
+            )
+
+            await bot.start(room=client)
+
+            try:
+                print(
+                    f"[bold green]Open the studio to interact with your agent: {meshagent_base_url().replace('api.', 'studio.')}/projects/{project_id}/rooms/{client.room_name}[/bold green]",
+                    flush=True,
+                )
+                await client.protocol.wait_for_close()
+            except KeyboardInterrupt:
+                await bot.stop()
+
+    finally:
+        await account_client.close()
+
+
+@app.async_command("service")
+async def service(
+    *,
+    agent_name: Annotated[str, typer.Option(..., help="Name of the agent to call")],
+    rule: Annotated[List[str], typer.Option("--rule", "-r", help="a system rule")] = [],
+    rules_file: Optional[str] = None,
+    toolkit: Annotated[
+        List[str],
+        typer.Option("--toolkit", "-t", help="the name or url of a required toolkit"),
+    ] = [],
+    schema: Annotated[
+        List[str],
+        typer.Option("--schema", "-s", help="the name or url of a required schema"),
+    ] = [],
+    auto_greet_message: Annotated[Optional[str], typer.Option()] = None,
+    auto_greet_prompt: Annotated[Optional[str], typer.Option()] = None,
+    host: Annotated[Optional[str], typer.Option()] = None,
+    port: Annotated[Optional[int], typer.Option()] = None,
+    path: Annotated[str, typer.Option()] = "/agent",
+):
+    try:
+        from meshagent.livekit.agents.voice import VoiceBot
+    except ImportError:
+
+        class VoiceBot:
+            def __init__(self, **kwargs):
+                raise RoomException(
+                    "meshagent.livekit module not found, voicebots are not available"
+                )
+
+    requirements = []
+
+    for t in toolkit:
+        requirements.append(RequiredToolkit(name=t))
+
+    for t in schema:
+        requirements.append(RequiredSchema(name=t))
+
+    if rules_file is not None:
+        try:
+            with open(Path(rules_file).resolve(), "r") as f:
+                rule.extend(f.read().splitlines())
+        except FileNotFoundError:
+            print(f"[yellow]rules file not found at {rules_file}[/yellow]")
+
+    service = ServiceHost(host=host, port=port)
+
+    @service.path(path=path)
+    class CustomVoiceBot(VoiceBot):
+        def __init__(self):
+            super().__init__(
+                auto_greet_message=auto_greet_message,
+                auto_greet_prompt=auto_greet_prompt,
+                name=agent_name,
+                requires=requirements,
+                rules=rule if len(rule) > 0 else None,
+            )
+
+    await service.run()

meshagent/cli/webhook.py

@@ -0,0 +1,100 @@
+import typer
+from rich import print
+import json
+from typing import Annotated, List, Optional
+from meshagent.cli.common_options import ProjectIdOption
+
+from meshagent.cli import async_typer
+from meshagent.cli.helper import get_client, print_json_table, resolve_project_id
+
+app = async_typer.AsyncTyper()
+
+# ---------------------------------------------------------------------------
+# Webhook commands
+# ---------------------------------------------------------------------------
+
+
+@app.async_command("create")
+async def webhook_create(
+    *,
+    project_id: ProjectIdOption = None,
+    name: Annotated[str, typer.Option(help="Friendly name for the webhook")],
+    url: Annotated[str, typer.Option(help="Target URL that will receive POSTs")],
+    event: Annotated[
+        List[str],
+        typer.Option(
+            "-e", "--event", help="Event to subscribe to (repeat for multiple)."
+        ),
+    ],
+    description: Annotated[
+        str, typer.Option(default="", help="Optional description")
+    ] = "",
+    action: Annotated[
+        Optional[str],
+        typer.Option("--action", help="Optional action name delivered with each call"),
+    ] = None,
+    payload: Annotated[
+        Optional[str],
+        typer.Option(
+            "--payload",
+            help="Optional JSON string sent as the body (merged with event payload).",
+        ),
+    ] = None,
+):
+    """Create a new project webhook."""
+    client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id=project_id)
+
+        payload_obj = json.loads(payload) if payload else None
+        webhook = await client.create_webhook(
+            project_id=project_id,
+            name=name,
+            url=url,
+            events=event,
+            description=description,
+            action=action,
+            payload=payload_obj,
+        )
+        print_json_table([webhook])
+    finally:
+        await client.close()
+
+
+@app.async_command("list")
+async def webhook_list(
+    *,
+    project_id: ProjectIdOption = None,
+):
+    """List all webhooks for the project."""
+    client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id=project_id)
+        hooks = await client.list_webhooks(project_id)
+        print_json_table(
+            hooks.get("webhooks"),
+            "id",
+            "name",
+            "description",
+            "url",
+            "events",
+            "action",
+        )
+    finally:
+        await client.close()
+
+
+@app.async_command("delete")
+async def webhook_delete(
+    *,
+    project_id: ProjectIdOption = None,
+    webhook_id: Annotated[str, typer.Argument(help="ID of the webhook to delete")],
+):
+    """Delete a project webhook."""
+    client = await get_client()
+    try:
+        project_id = await resolve_project_id(project_id=project_id)
+        await client.delete_webhook(project_id, webhook_id)
+        print(f"[green]Webhook {webhook_id} deleted.[/]")
+    finally:
+        await client.close()

meshagent_cli-0.7.0.dist-info/METADATA

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: meshagent-cli
+Version: 0.7.0
+Summary: CLI for Meshagent
+License-Expression: Apache-2.0
+Project-URL: Documentation, https://docs.meshagent.com
+Project-URL: Website, https://www.meshagent.com
+Project-URL: Source, https://www.meshagent.com
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: typer~=0.15
+Requires-Dist: fastmcp~=2.8
+Requires-Dist: opentelemetry-distro~=0.54b1
+Requires-Dist: opentelemetry-exporter-otlp-proto-http~=1.33
+Requires-Dist: art~=6.5
+Requires-Dist: pydantic-yaml~=1.5
+Requires-Dist: pathspec~=0.12.1
+Provides-Extra: all
+Requires-Dist: meshagent-agents[all]~=0.7.0; extra == "all"
+Requires-Dist: meshagent-api[all]~=0.7.0; extra == "all"
+Requires-Dist: meshagent-computers~=0.7.0; extra == "all"
+Requires-Dist: meshagent-openai~=0.7.0; extra == "all"
+Requires-Dist: meshagent-mcp~=0.7.0; extra == "all"
+Requires-Dist: meshagent-tools~=0.7.0; extra == "all"
+Requires-Dist: supabase-auth~=2.12.3; extra == "all"
+Provides-Extra: mcp-service
+Requires-Dist: meshagent-agents[all]~=0.7.0; extra == "mcp-service"
+Requires-Dist: meshagent-api~=0.7.0; extra == "mcp-service"
+Requires-Dist: meshagent-mcp~=0.7.0; extra == "mcp-service"
+Requires-Dist: meshagent-tools~=0.7.0; extra == "mcp-service"
+Requires-Dist: supabase-auth~=2.12.3; extra == "mcp-service"
+
+# [Meshagent](https://www.meshagent.com)
+
+## MeshAgent CLI
+
+The ``meshagent.cli`` package installs everything you need to streamline room and agent management from your terminal. The CLI assembles submodules for authentication, projects, API keys, participant tokens, messaging, storage, agents, webhooks, and more. 
+Check out the [CLI Quickstart](https://docs.meshagent.com/cli/getting_started) for more details.
+
+---
+### Learn more about MeshAgent on our website or check out the docs for additional examples!
+
+**Website**: [www.meshagent.com](https://www.meshagent.com/)
+
+**Documentation**: [docs.meshagent.com](https://docs.meshagent.com/)
+
+---

meshagent_cli-0.7.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+meshagent/cli/__init__.py,sha256=X78Z4yEg5XfkNKH0HiIdG4k1q5ktB-ampTuXHLNFrAw,58
+meshagent/cli/agent.py,sha256=CKH8XkRJ4oeu2hbG-FL8tWXtDn2tYDvTSCxSvQ0sCIY,8976
+meshagent/cli/api_keys.py,sha256=2_-TB0a1vca4uG-RG4zc0_c9QTJ8EHt3qomy2wfKlXE,3192
+meshagent/cli/async_typer.py,sha256=GCeSefBDbpd-V4V8LrvHGUTBMth3HspVMfFa-HUZ0cg,898
+meshagent/cli/auth.py,sha256=wpGTomrFH0uvbwv262sTqK0DgB4ltAuurEmI9tYedIs,815
+meshagent/cli/auth_async.py,sha256=Ce0h_V3tNlZBvplQuhy2uRP9PJvhi6k_vUGh3GMNL-E,9277
+meshagent/cli/call.py,sha256=ydxEnX7uPZ9B2-ND1LvBt4Leb2K8whhmdogRIsCydnw,7315
+meshagent/cli/chatbot.py,sha256=sui_h2XtBhjOUglQkyM9e2il8v5YGiN-jVFOuoQEq7w,20437
+meshagent/cli/cli.py,sha256=XGfLfCp0vQatVY2tavrh9uZfoXJIdINXRSTd2rhN3EE,5581
+meshagent/cli/cli_mcp.py,sha256=d3N37rZ-CMFouk9jxJRe8CIUprv_nExiata8Ni8OKsQ,11259
+meshagent/cli/cli_secrets.py,sha256=_hxEe93YJaJczWZXbMxS-qiedMpwGLC3ez-YUnjqudM,13713
+meshagent/cli/common_options.py,sha256=79OnCgiBLhExf-_l18R3dkLidoND5BPJD2NY7gAtl00,573
+meshagent/cli/containers.py,sha256=s9xuxjT_jLLmML3cuxBeLi8HE2w0lI3wRgVk8COOM3w,17573
+meshagent/cli/developer.py,sha256=2nWCX9lqtTd__i6qDJOOJtI0kB4X185s_3Ktfx5MaRQ,2251
+meshagent/cli/exec.py,sha256=fZpRvvTJC5bUBpaUCOFFJuaZDuyIPz5r42-bxtwDWhM,15647
+meshagent/cli/helper.py,sha256=RLUJxNJ1aDx4fij61ps_s0NGXwYVcp_Ek6n1ChHM3HM,3961
+meshagent/cli/helpers.py,sha256=9JSZiWOnVkh0qfM3DKcvz4u83EJ34DBdukx2Ple9V94,4783
+meshagent/cli/mailbot.py,sha256=CSkRY6fX2t6Izbz5uJN6GQhMPDGcPJxtGkX4VQwn4MI,8529
+meshagent/cli/meeting_transcriber.py,sha256=Eo4itFxwQvMoz-IBN4hMA7PMVsU81uUsYSnmCyZK9QA,3834
+meshagent/cli/messaging.py,sha256=guzaFxtmApLJ0p6RCqiHstk-md2NGW3FLTu-Pzwdo5Q,5278
+meshagent/cli/oauth2.py,sha256=-ArxgO7KAjowanp8KcHlSEnVpemzm49fSov6wrKOe0o,6193
+meshagent/cli/participant_token.py,sha256=zdNDviXfChhvbVyWukJt4CNvi7nVIl5nJChST_qCjaI,1778
+meshagent/cli/projects.py,sha256=-s5xIfd2pCW8HsuqRsNoKZr5hsF6xYxfEjyYI6Nm4YI,3511
+meshagent/cli/queue.py,sha256=DauqjVul7v6dLHQ_t3C-Pqmrgvjg093FHCRsD5Yf3bg,2937
+meshagent/cli/room.py,sha256=TddjQn_cg0JSDou-x-dmbavHfUO28m48XFtbh3w3VGM,6472
+meshagent/cli/services.py,sha256=GZA40INO9bOZMoKAw0u_qTtD2inGEJAX4aqXqUuSt3Y,14908
+meshagent/cli/sessions.py,sha256=bUwrPkzeEWE8gTqD4E-tfr2ChBns3Fvv9MsSV4RRNTQ,881
+meshagent/cli/storage.py,sha256=0pSrviBM53-2xFlD1ZW4rDthJ-CwUD5tQC43FcaU5sU,32541
+meshagent/cli/version.py,sha256=RaANGbRu5e-vehwXI1-Qe2ggPPfs1TQaZj072JdbLk4,22
+meshagent/cli/voicebot.py,sha256=t8sqygbXPbasfCf6cDDTGxZWHD3KeuBZhYDkV0k-wQI,6003
+meshagent/cli/webhook.py,sha256=g2vqt3fKQ5HQ2miXZbekjyZ_NODsyRTYIgWEni5bDP0,2971
+meshagent_cli-0.7.0.dist-info/METADATA,sha256=b6iXHJhspTKa5uX26-8j3YRRiNIxnVBvKUYl3Cb_8Mc,1976
+meshagent_cli-0.7.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+meshagent_cli-0.7.0.dist-info/entry_points.txt,sha256=WRcGGN4vMtvC5Pgl3uRFqsJiQXNoHuLLa-TCSY3gAhQ,52
+meshagent_cli-0.7.0.dist-info/top_level.txt,sha256=GlcXnHtRP6m7zlG3Df04M35OsHtNXy_DY09oFwWrH74,10
+meshagent_cli-0.7.0.dist-info/RECORD,,

meshagent_cli-0.7.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

meshagent_cli-0.7.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+meshagent = meshagent.cli.cli:app

meshagent_cli-0.7.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+meshagent