mistralai-workflows-cli 1.2.0a2__tar.gz → 1.2.1__tar.gz

{mistralai_workflows_cli-1.2.0a2 → mistralai_workflows_cli-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mistralai-workflows-cli
-Version: 1.2.0a2
+Version: 1.2.1
 Summary: CLI to bootstrap Mistral Workflows projects
 Requires-Python: >=3.10
 Requires-Dist: click>=8.0

{mistralai_workflows_cli-1.2.0a2 → mistralai_workflows_cli-1.2.1}/README.md

@@ -11,13 +11,13 @@ both live here, so template and CLI changes ship in a single PR.
 ## Usage
 
 ```bash
-uvx mistralai-workflows-cli setup
+uvx mistralai-workflows-cli@latest setup
 ```
 
 Or with options:
 
 ```bash
-uvx mistralai-workflows-cli setup --api-key sk-... --project-name my-project
+uvx mistralai-workflows-cli@latest setup --api-key sk-... --project-name my-project
 ```
 
 The `setup` command will:
@@ -55,7 +55,7 @@ Workflows are auto-discovered at worker startup. Any class decorated with `@work
 | ----------------- | ------------------------------------------------------------ |
 | `project_name`    | Name of the project (used in pyproject.toml, workflow names) |
 | `mistral_api_key` | Mistral API key (written to `.env`, excluded from git)       |
-| `deployment_name` | Deployment name used to identify the deployment in AI Studio |
+| `deployment_name` | Name identifying the deployment in AI Studio. The CLI sets it to `{hostname}-{project_name}-{adjective}-{noun}` so multiple projects on the same machine don't collide |
 
 ## CLI Development
 

{mistralai_workflows_cli-1.2.0a2 → mistralai_workflows_cli-1.2.1}/src/mistral_workflows_cli/_template/template/.agents/skills/workflows/references/getting-started/installation.mdx

@@ -30,7 +30,7 @@ This will create a virtual environment (if one doesn't exist) and install Workfl
 If you want to start from a ready-to-run Python project instead of wiring the SDK manually, use `mistralai-workflows-cli`:
 
 ```bash
-uvx mistralai-workflows-cli setup
+uvx mistralai-workflows-cli@latest setup
 ```
 
 This scaffolds a ready-to-run Python project with the Workflows SDK already configured, a minimal example workflow, and helper commands to register and execute workflows.

{mistralai_workflows_cli-1.2.0a2 → mistralai_workflows_cli-1.2.1}/src/mistral_workflows_cli/_template/template/README.md.jinja

@@ -12,7 +12,7 @@ uv sync
 
 ### Register workflows in AI Studio
 
-Auto-discovers all workflow classes in `src/workflows/`, registers them with AI Studio, and starts polling for executions. The [deployment name](https://docs.mistral.ai/workflows/managing-workflows-in-production/deployments) is set to your hostname:
+Auto-discovers all workflow classes in `src/workflows/`, registers them with AI Studio, and starts polling for executions. The [deployment name](https://docs.mistral.ai/workflows/managing-workflows-in-production/deployments) is set to `{hostname}-{project}-{adjective}-{noun}` so multiple projects on the same machine stay isolated:
 
 ```bash
 make start-worker

{mistralai_workflows_cli-1.2.0a2 → mistralai_workflows_cli-1.2.1}/src/mistral_workflows_cli/setup.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import os
+import secrets
 import socket
 from pathlib import Path
 
@@ -10,6 +11,84 @@ from rich.prompt import Prompt
 API_KEYS_URL = "https://console.mistral.ai/api-keys"
 TEMPLATE_DIR = Path(__file__).parent / "_template"
 
+_ADJECTIVES = [
+    "bold",
+    "brave",
+    "bright",
+    "calm",
+    "clever",
+    "cool",
+    "eager",
+    "fair",
+    "fast",
+    "fierce",
+    "gentle",
+    "glad",
+    "grand",
+    "happy",
+    "keen",
+    "kind",
+    "lively",
+    "lucky",
+    "merry",
+    "neat",
+    "noble",
+    "proud",
+    "quick",
+    "sharp",
+    "silent",
+    "smart",
+    "steady",
+    "swift",
+    "vivid",
+    "warm",
+    "wise",
+    "witty",
+]
+
+_NOUNS = [
+    "badger",
+    "bear",
+    "crane",
+    "eagle",
+    "falcon",
+    "fox",
+    "hawk",
+    "heron",
+    "horse",
+    "jaguar",
+    "lark",
+    "lion",
+    "lynx",
+    "otter",
+    "owl",
+    "panda",
+    "raven",
+    "robin",
+    "salmon",
+    "shark",
+    "sparrow",
+    "stork",
+    "tiger",
+    "viper",
+    "whale",
+    "wolf",
+    "wren",
+    "zebra",
+]
+
+
+def build_deployment_name(project_name: str, hostname: str | None = None) -> str:
+    """Build a deployment name unique to this project on this machine.
+
+    Multiple projects scaffolded on the same machine would otherwise share the
+    hostname-based deployment name and register conflicting workers. Combining
+    the hostname, project name, and a random word pair keeps them isolated.
+    """
+    hostname = hostname or socket.gethostname()
+    suffix = f"{secrets.choice(_ADJECTIVES)}-{secrets.choice(_NOUNS)}"
+    return f"{hostname}-{project_name}-{suffix}"
+
 
 def run_setup(
     api_key: str | None,
@@ -60,7 +139,7 @@ def run_setup(
         data={
             "project_name": project_name,
             "mistral_api_key": api_key,
-            "deployment_name": socket.gethostname(),
+            "deployment_name": build_deployment_name(project_name),
         },
         unsafe=True,
     )

{mistralai_workflows_cli-1.2.0a2 → mistralai_workflows_cli-1.2.1}/tests/test_setup.py

@@ -1,12 +1,13 @@
 from __future__ import annotations
 
+import re
 from unittest.mock import patch
 
 import pytest
 from click.testing import CliRunner
 
 from mistral_workflows_cli.main import cli
-from mistral_workflows_cli.setup import run_setup
+from mistral_workflows_cli.setup import build_deployment_name, run_setup
 
 
 @pytest.fixture
@@ -66,3 +67,22 @@ def test_setup_fails_if_dir_exists(tmp_path: object) -> None:
     with pytest.raises(SystemExit) as exc_info:
         run_setup(api_key="sk-test", output_dir=str(tmp_path), project_name="existing")
     assert exc_info.value.code == 1
+
+
+def test_build_deployment_name_format() -> None:
+    name = build_deployment_name("my-proj", hostname="my-host")
+    assert re.fullmatch(r"my-host-my-proj-[a-z]+-[a-z]+", name)
+
+
+def test_build_deployment_name_suffix_is_random() -> None:
+    names = {build_deployment_name("my-proj", hostname="my-host") for _ in range(20)}
+    assert len(names) > 1
+
+
+def test_setup_deployment_name_includes_project(tmp_path: object, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr("mistral_workflows_cli.setup.socket.gethostname", lambda: "my-host")
+    with patch("copier.run_copy") as run_copy:
+        run_setup(api_key="sk-test", output_dir=str(tmp_path), project_name="test-proj")
+
+    deployment_name = run_copy.call_args.kwargs["data"]["deployment_name"]
+    assert re.fullmatch(r"my-host-test-proj-[a-z]+-[a-z]+", deployment_name)