meshagent-cli 0.44.10__tar.gz → 0.44.12__tar.gz

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/PKG-INFO

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

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/agent.py

@@ -157,6 +157,7 @@ async def list_toolkits_command(
                         "name": tk.name,
                         "title": tk.title,
                         "description": tk.description,
+                        "annotations": tk.annotations,
                         "tools": [
                             {
                                 "name": tool.name,

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/agent_cli_options_test.py

@@ -1,4 +1,4 @@
-from typer._click.testing import CliRunner
+from meshagent.cli.testing import CliRunner
 import pytest
 
 from meshagent.cli import async_typer

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/ask_test.py

@@ -6,7 +6,7 @@ from pathlib import Path
 
 import pytest
 import typer
-from typer._click.testing import CliRunner
+from meshagent.cli.testing import CliRunner
 from PIL import Image
 
 from meshagent.agents import AgentSessionContext

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/async_typer_test.py

@@ -2,7 +2,7 @@ import importlib
 import types
 
 import typer
-from typer._click.testing import CliRunner
+from meshagent.cli.testing import CliRunner
 
 from meshagent.cli import async_typer
 

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/chatbot.py

@@ -2019,7 +2019,7 @@ def build_process_agent(
     from meshagent.agents.messages import TurnStart, TurnSteer
     from meshagent.agents.process import AgentSupervisor, LLMAgentProcess
     from meshagent.tools import RoomToolContext, Toolkit
-    from meshagent.tools.hosting import _RemoteToolkitWrapper, _start_hosted_toolkit
+    from meshagent.tools.hosting import _RemoteToolkitWrapper, start_hosted_toolkit
 
     requirements = []
     toolkits = []
@@ -2284,7 +2284,7 @@ def build_process_agent(
 
                 self._exposed_toolkits = await self.get_exposed_toolkits()
                 for toolkit in self._exposed_toolkits:
-                    hosted_toolkit = await _start_hosted_toolkit(
+                    hosted_toolkit = await start_hosted_toolkit(
                         room=room,
                         toolkit=toolkit,
                     )

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/cli_mcp.py

@@ -13,7 +13,7 @@ from meshagent.cli import async_typer
 from meshagent.cli.helper import resolve_project_id, resolve_room, resolve_key
 
 from meshagent.tools import Toolkit
-from meshagent.tools.hosting import _start_hosted_toolkit
+from meshagent.tools.hosting import start_hosted_toolkit
 
 
 from meshagent.api.services import ServiceHost
@@ -203,7 +203,7 @@ async def sse(
                         description=toolkit.description,
                     )
 
-                    hosted_toolkit = await _start_hosted_toolkit(
+                    hosted_toolkit = await start_hosted_toolkit(
                         room=client,
                         toolkit=toolkit,
                     )
@@ -320,7 +320,7 @@ async def streamable_http(
                         description=toolkit.description,
                     )
 
-                    hosted_toolkit = await _start_hosted_toolkit(
+                    hosted_toolkit = await start_hosted_toolkit(
                         room=client,
                         toolkit=toolkit,
                     )
@@ -422,7 +422,7 @@ async def stdio(
                         description=toolkit.description,
                     )
 
-                    hosted_toolkit = await _start_hosted_toolkit(
+                    hosted_toolkit = await start_hosted_toolkit(
                         room=client,
                         toolkit=toolkit,
                     )

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/cli_test.py

@@ -3,7 +3,7 @@ import sys
 import types
 
 import pytest
-from typer._click.testing import CliRunner
+from meshagent.cli.testing import CliRunner
 
 from meshagent.api import RoomException
 from meshagent.cli import async_typer

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/create.py

@@ -65,6 +65,7 @@ CHATBOT_UI_FOCUS = "chatbot-ui"
 ROOM_CHAT_FOCUS = "room-chat"
 ROOM_WORKSPACE_FOCUS = "room-workspace"
 CONTACT_FORM_FOCUS = "contact-form"
+TASK_QUEUE_DASHBOARD_FOCUS = "task-queue-dashboard"
 DEFAULT_LANGUAGE = "python"
 DEFAULT_FOCUS = AGENT_FOCUS
 CREATE_TEMPLATE_PACKAGE = "meshagent.cli.create_project_templates"
@@ -116,29 +117,35 @@ AGENT_NEXT_STEPS = (
     "./scripts/dev.sh",
     "./scripts/deploy.sh",
 )
+PYTHON_WEBSERVER_NEXT_STEPS = (
+    "./scripts/dev.sh",
+    "./scripts/deploy.sh",
+)
+PYTHON_AGENT_NEXT_STEPS = (
+    "./scripts/dev.sh",
+    "./scripts/deploy.sh",
+)
 NPM_WEBSERVER_NEXT_STEPS = (
-    "npm install",
     "npm run dev",
     "npm run deploy",
 )
 NPM_STATIC_WEBSERVER_NEXT_STEPS = (
-    "npm install",
     "npm run dev",
     "npm run deploy",
 )
 NPM_CHATBOT_UI_NEXT_STEPS = (
-    "npm install",
     "npm run dev",
     "npm run deploy",
 )
 CONTACT_FORM_NEXT_STEPS = (
-    "./scripts/install.sh",
-    "meshagent rooms create <room> --if-not-exists",
-    "./scripts/dev.sh --room <room>",
-    "CONTACT_FORM_TO=you@example.com ./scripts/deploy.sh --room <room>",
+    "./scripts/dev.sh",
+    "CONTACT_FORM_TO=you@example.com ./scripts/deploy.sh",
+)
+TASK_QUEUE_DASHBOARD_NEXT_STEPS = (
+    "./scripts/dev.sh",
+    "./scripts/deploy.sh",
 )
 NPM_AGENT_NEXT_STEPS = (
-    "npm install",
     "npm run dev",
     "npm run deploy",
 )
@@ -256,6 +263,11 @@ FOCUSES: Mapping[str, CreateFocus] = {
         label="Contact Form",
         description="Public HTML contact form that sends email through a room mailbox.",
     ),
+    TASK_QUEUE_DASHBOARD_FOCUS: CreateFocus(
+        id=TASK_QUEUE_DASHBOARD_FOCUS,
+        label="Task Queue Dashboard",
+        description="Public dashboard backed by a scheduled queue worker.",
+    ),
 }
 
 
@@ -270,7 +282,7 @@ TEMPLATES: Mapping[tuple[str, str], CreateTemplate] = {
         label="Python Web App",
         description="Async Python public HTTP service with a health route.",
         template_dir=_template_dir("python", WEB_FOCUS),
-        next_steps=WEBSERVER_NEXT_STEPS,
+        next_steps=PYTHON_WEBSERVER_NEXT_STEPS,
     ),
     ("python", AGENT_FOCUS): CreateTemplate(
         language_id="python",
@@ -278,7 +290,7 @@ TEMPLATES: Mapping[tuple[str, str], CreateTemplate] = {
         label="Python Agent Toolkit",
         description="Headless Python service that exposes custom tools to agents.",
         template_dir=_template_dir("python", AGENT_FOCUS),
-        next_steps=AGENT_NEXT_STEPS,
+        next_steps=PYTHON_AGENT_NEXT_STEPS,
     ),
     ("python", CONTACT_FORM_FOCUS): CreateTemplate(
         language_id="python",
@@ -288,6 +300,14 @@ TEMPLATES: Mapping[tuple[str, str], CreateTemplate] = {
         template_dir=_template_dir("python", CONTACT_FORM_FOCUS),
         next_steps=CONTACT_FORM_NEXT_STEPS,
     ),
+    ("python", TASK_QUEUE_DASHBOARD_FOCUS): CreateTemplate(
+        language_id="python",
+        focus_id=TASK_QUEUE_DASHBOARD_FOCUS,
+        label="Python Task Queue Dashboard",
+        description="Python dashboard that schedules text work onto a room queue.",
+        template_dir=_template_dir("python", TASK_QUEUE_DASHBOARD_FOCUS),
+        next_steps=TASK_QUEUE_DASHBOARD_NEXT_STEPS,
+    ),
     ("javascript", WEB_FOCUS): CreateTemplate(
         language_id="javascript",
         focus_id=WEB_FOCUS,
@@ -469,6 +489,19 @@ FOCUS_ALIASES = {
     "email": CONTACT_FORM_FOCUS,
     "email-form": CONTACT_FORM_FOCUS,
     "email_form": CONTACT_FORM_FOCUS,
+    "queue": TASK_QUEUE_DASHBOARD_FOCUS,
+    "queue-dashboard": TASK_QUEUE_DASHBOARD_FOCUS,
+    "queue_dashboard": TASK_QUEUE_DASHBOARD_FOCUS,
+    "scheduled-queue": TASK_QUEUE_DASHBOARD_FOCUS,
+    "scheduled_queue": TASK_QUEUE_DASHBOARD_FOCUS,
+    "scheduled-task": TASK_QUEUE_DASHBOARD_FOCUS,
+    "scheduled_task": TASK_QUEUE_DASHBOARD_FOCUS,
+    "scheduled-task-queue": TASK_QUEUE_DASHBOARD_FOCUS,
+    "scheduled_task_queue": TASK_QUEUE_DASHBOARD_FOCUS,
+    "task-queue": TASK_QUEUE_DASHBOARD_FOCUS,
+    "task_queue": TASK_QUEUE_DASHBOARD_FOCUS,
+    "task-queue-dashboard": TASK_QUEUE_DASHBOARD_FOCUS,
+    "task_queue_dashboard": TASK_QUEUE_DASHBOARD_FOCUS,
     "roomclient": AGENT_FOCUS,
     "room-client": AGENT_FOCUS,
     "web": WEB_FOCUS,
@@ -658,16 +691,64 @@ def _language_choices() -> Sequence[tuple[str, str, str, tuple[str, ...]]]:
     )
 
 
-def _focus_choices() -> Sequence[tuple[str, str, str]]:
+def _first_explanatory_readme_paragraph(markdown: str) -> str | None:
+    paragraph_lines: list[str] = []
+    in_fenced_block = False
+
+    for raw_line in markdown.splitlines():
+        line = raw_line.strip()
+        if line.startswith("```") or line.startswith("~~~"):
+            in_fenced_block = not in_fenced_block
+            continue
+        if in_fenced_block:
+            continue
+        if line == "":
+            if paragraph_lines:
+                break
+            continue
+        if line.startswith("#"):
+            if paragraph_lines:
+                break
+            continue
+
+        paragraph_lines.append(line)
+
+    if not paragraph_lines:
+        return None
+    return " ".join(" ".join(paragraph_lines).split())
+
+
+def _template_choice_description(template: CreateTemplate) -> str:
+    try:
+        readme = _read_create_template(f"{template.template_dir}/README.md")
+    except FileNotFoundError:
+        return template.description
+
+    return _first_explanatory_readme_paragraph(readme) or template.description
+
+
+def _focus_choices() -> Sequence[tuple[str, str, str, tuple[tuple[str, str], ...]]]:
     return tuple(
-        (focus.id, focus.label, focus.description) for focus in FOCUSES.values()
+        (
+            focus.id,
+            focus.label,
+            focus.description,
+            tuple(
+                (template.language_id, _template_choice_description(template))
+                for template in TEMPLATES.values()
+                if template.focus_id == focus.id
+            ),
+        )
+        for focus in FOCUSES.values()
     )
 
 
 def _run_create_tui(
     *,
     language_choices: Sequence[tuple[str, str, str, tuple[str, ...]]],
-    focus_choices: Sequence[tuple[str, str, str]],
+    focus_choices: Sequence[
+        tuple[str, str, str, Sequence[tuple[str, str]]] | tuple[str, str, str]
+    ],
 ) -> tuple[str, str] | None:
     from meshagent.cli.tui.create import (
         CreateFocusChoice,
@@ -685,8 +766,15 @@ def _run_create_tui(
         for language_id, label, description, focus_ids in language_choices
     ]
     focuses = [
-        CreateFocusChoice(id=focus_id, label=label, description=description)
-        for focus_id, label, description in focus_choices
+        CreateFocusChoice(
+            id=focus_id,
+            label=label,
+            description=description,
+            descriptions_by_language=tuple(descriptions_by_language),
+        )
+        for focus_id, label, description, descriptions_by_language in (
+            (*choice, ()) if len(choice) == 3 else choice for choice in focus_choices
+        )
     ]
     result = asyncio.run(run_create_wizard_tui(languages=languages, focuses=focuses))
     if result.status != "completed":
@@ -812,30 +900,31 @@ def _print_agent_toolkit_guidance(template: CreateTemplate) -> None:
     typer.secho(f"  {command}", fg="green")
 
 
-def _print_contact_form_mailbox_guidance(template: CreateTemplate) -> None:
+def _print_contact_form_email_guidance(template: CreateTemplate) -> None:
     if template.focus_id != CONTACT_FORM_FOCUS:
         return
     typer.echo("")
     typer.secho(
-        "Before testing a submission, set up the sender mailbox for that room:",
+        "Email setup is handled by the deploy template:",
         fg="cyan",
         bold=True,
     )
-    typer.echo("  New mailbox:")
-    typer.secho(
-        "    meshagent mailbox create --address contact-<room-slug>@mail.meshagent.com --room <room> --queue contact-<room-slug>@mail.meshagent.com --public",
-        fg="green",
+    typer.echo(
+        "  .meshagent/deploy.yaml injects CONTACT_FORM_FROM and CONTACT_FORM_TO into the service."
     )
-    typer.echo("  Existing mailbox for that room:")
-    typer.secho(
-        "    meshagent mailbox update contact-<room-slug>@mail.meshagent.com --room <room> --queue contact-<room-slug>@mail.meshagent.com --public",
-        fg="green",
+    typer.echo(
+        "  meshagent deploy creates or updates the public sender mailbox from CONTACT_FORM_FROM."
+    )
+    typer.echo(
+        "  meshagent deploy prompts for the sender mailbox when CONTACT_FORM_FROM is not set."
     )
     typer.echo(
-        "Use that mailbox as CONTACT_FORM_FROM. If create returns 409, choose another room-specific local part; do not reuse a mailbox unless it is listed for this room. Set CONTACT_FORM_TO to the address that should receive submissions."
+        "Set CONTACT_FORM_TO to the address that should receive submissions. "
+        "Set CONTACT_FORM_FROM only when you want a specific sender mailbox on "
+        "the MeshAgent mail domain."
     )
     typer.echo(
-        "If CONTACT_FORM_TO is also a private MeshAgent mailbox, use a public destination mailbox or an external delivery alias."
+        "If deploy reports that the sender mailbox already routes to a different room, choose another room-specific local part."
     )
 
 
@@ -851,7 +940,7 @@ def _print_created_report(
     typer.echo("")
     _print_next_steps(template.next_steps, enter_project_root=enter_project_root)
     _print_agent_toolkit_guidance(template)
-    _print_contact_form_mailbox_guidance(template)
+    _print_contact_form_email_guidance(template)
 
 
 app = async_typer.AsyncTyper(add_completion=False)
@@ -885,7 +974,7 @@ def _create_command(
                 "Project focus for non-interactive use. Use stable IDs: webserver "
                 "(Web App), backend-agent (Agent Toolkit), chatbot (OpenAI Chatbot), "
                 "chatbot-anthropic (Anthropic Chatbot), chatbot-ui (Agent UI), "
-                "room-chat (Room Chat), meeting-app (Meeting App), or "
+                "room-chat (Room Chat), room-workspace (Room Workspace), or "
                 "contact-form (Contact Form)."
             ),
         ),

{meshagent_cli-0.44.10 → meshagent_cli-0.44.12}/meshagent/cli/create_project_templates/python/backend-agent/server.py

@@ -9,7 +9,7 @@ import aiofiles
 import aiofiles.os
 from meshagent.api import RoomClient, WebSocketClientProtocol, websocket_room_url
 from meshagent.tools import FunctionTool, Toolkit, ToolContext
-from meshagent.tools.hosting import _start_hosted_toolkit
+from meshagent.tools.hosting import start_hosted_toolkit
 
 
 PROOF_PATH = Path(__file__).with_name("agent-proof.json")
@@ -108,7 +108,7 @@ async def main() -> None:
 
 async def run_agent_toolkit_proof(room: RoomClient) -> None:
     probe = os.environ.get("MESHAGENT_CREATE_DEV_PROBE")
-    hosted_toolkit = await _start_hosted_toolkit(
+    hosted_toolkit = await start_hosted_toolkit(
         room=room,
         toolkit=PythonAgentToolkit(),
     )