mirrorneuron-cli 1.1.9__tar.gz → 1.2.6__tar.gz

{mirrorneuron_cli-1.1.9 → mirrorneuron_cli-1.2.6}/.gitignore

@@ -1,6 +1,9 @@
 # Environments
 .env
+.env.*
+!.env.example
 .venv
+.venv/
 env/
 venv/
 ENV/
@@ -30,5 +33,18 @@ __pycache__/
 *.py[cod]
 *$py.class
 .pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.pyre/
+.hypothesis/
+.tox/
+.nox/
 .coverage
-htmlcov/
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Local editor and OS files
+.DS_Store
+.idea/
+.vscode/

mirrorneuron_cli-1.2.6/.python-version

@@ -0,0 +1 @@
+3.11.15

{mirrorneuron_cli-1.1.9 → mirrorneuron_cli-1.2.6}/AGENTS.md

@@ -7,3 +7,4 @@ Guidance for future coding agents working in this repository.
 - Unless the user explicitly asks for a temporary workaround, fix the root cause in the intended layer or contract.
 - Avoid adding fallback paths, compatibility shims, feature flags, or temp solutions that mask a broken primary path.
 - If fallback behavior is already product-specified, keep it narrow, documented, and tested; do not use it to avoid fixing the primary path.
+

{mirrorneuron_cli-1.1.9/mirrorneuron_cli.egg-info → mirrorneuron_cli-1.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mirrorneuron-cli
-Version: 1.1.9
+Version: 1.2.6
 Summary: MirrorNeuron CLI
 License-Expression: MIT
 Classifier: Programming Language :: Python :: 3
@@ -8,6 +8,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: mirrorneuron-python-sdk
+Requires-Dist: jsonschema>=4.25
 Requires-Dist: typer>=0.9.0
 Requires-Dist: rich>=13.0.0
 Dynamic: license-file
@@ -23,10 +24,10 @@ services installed by `mn-deploy`.
 Install locally and run tests:
 
 ```bash
-python3 -m venv .venv
+python3.11 -m venv .venv
 . .venv/bin/activate
-python3 -m pip install -e .
-python3 -m pytest -q
+.venv/bin/python -m pip install -e .
+.venv/bin/python -m pytest -q
 ```
 
 Try the CLI:

{mirrorneuron_cli-1.1.9 → mirrorneuron_cli-1.2.6}/README.md

@@ -9,10 +9,10 @@ services installed by `mn-deploy`.
 Install locally and run tests:
 
 ```bash
-python3 -m venv .venv
+python3.11 -m venv .venv
 . .venv/bin/activate
-python3 -m pip install -e .
-python3 -m pytest -q
+.venv/bin/python -m pip install -e .
+.venv/bin/python -m pytest -q
 ```
 
 Try the CLI:

{mirrorneuron_cli-1.1.9 → mirrorneuron_cli-1.2.6/mirrorneuron_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mirrorneuron-cli
-Version: 1.1.9
+Version: 1.2.6
 Summary: MirrorNeuron CLI
 License-Expression: MIT
 Classifier: Programming Language :: Python :: 3
@@ -8,6 +8,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: mirrorneuron-python-sdk
+Requires-Dist: jsonschema>=4.25
 Requires-Dist: typer>=0.9.0
 Requires-Dist: rich>=13.0.0
 Dynamic: license-file
@@ -23,10 +24,10 @@ services installed by `mn-deploy`.
 Install locally and run tests:
 
 ```bash
-python3 -m venv .venv
+python3.11 -m venv .venv
 . .venv/bin/activate
-python3 -m pip install -e .
-python3 -m pytest -q
+.venv/bin/python -m pip install -e .
+.venv/bin/python -m pytest -q
 ```
 
 Try the CLI:

{mirrorneuron_cli-1.1.9 → mirrorneuron_cli-1.2.6}/mirrorneuron_cli.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 .gitignore
+.python-version
 AGENTS.md
 LICENSE
 README.md
@@ -19,27 +20,39 @@ mn_cli/config.py
 mn_cli/error_handler.py
 mn_cli/logging_config.py
 mn_cli/main.py
+mn_cli/runtime_mode.py
+mn_cli/runtime_state.py
+mn_cli/sdk_path.py
 mn_cli/server_cmds.py
 mn_cli/shared.py
+mn_cli/terminal.py
 mn_cli/update_cmds.py
 mn_cli/libs/__init__.py
+mn_cli/libs/artifacts.py
 mn_cli/libs/backup_cmds.py
 mn_cli/libs/blueprint_cmds.py
+mn_cli/libs/blueprint_models.py
 mn_cli/libs/blueprint_observability.py
 mn_cli/libs/blueprint_repository.py
 mn_cli/libs/blueprint_resources.py
+mn_cli/libs/bundles.py
 mn_cli/libs/deployment_cmds.py
 mn_cli/libs/event_relay.py
 mn_cli/libs/job_cmds.py
+mn_cli/libs/model_cmds.py
 mn_cli/libs/resource_cmds.py
 mn_cli/libs/run_cmds.py
 mn_cli/libs/run_logs.py
 mn_cli/libs/run_manifest.py
+mn_cli/libs/runtime_health.py
 mn_cli/libs/schedule_cmds.py
 mn_cli/libs/service_cmds.py
+mn_cli/libs/skill_runtime.py
 mn_cli/libs/sys_cmds.py
 mn_cli/libs/ui.py
 mn_cli/libs/workflow_progress.py
+mn_cli/libs/workflow_validation.py
+mn_cli/schemas/workflow_manifest.schema.json
 scripts/check-release-artifacts.sh
 scripts/make-release-zip.sh
 scripts/validate-version-tag.sh
@@ -49,13 +62,22 @@ tests/test_blueprint_cmds.py
 tests/test_blueprint_repository.py
 tests/test_blueprint_resources.py
 tests/test_deployment_cmds.py
+tests/test_docker_network_integration.py
 tests/test_job_cmds.py
 tests/test_main.py
+tests/test_model_cmds.py
+tests/test_resource_cmds.py
 tests/test_run_cmds.py
 tests/test_run_helpers.py
+tests/test_runtime_health.py
+tests/test_runtime_mode.py
+tests/test_runtime_state.py
 tests/test_schedule_cmds.py
 tests/test_server_cmds.py
 tests/test_service_cmds.py
 tests/test_shared.py
 tests/test_sys_cmds.py
-tests/test_update_cmds.py
+tests/test_terminal.py
+tests/test_ui.py
+tests/test_update_cmds.py
+tests/test_workflow_validation.py

{mirrorneuron_cli-1.1.9 → mirrorneuron_cli-1.2.6}/mirrorneuron_cli.egg-info/requires.txt

@@ -1,3 +1,4 @@
 mirrorneuron-python-sdk
+jsonschema>=4.25
 typer>=0.9.0
 rich>=13.0.0

mirrorneuron_cli-1.2.6/mn_cli/config.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+from mn_cli.sdk_path import add_local_sdk_path
+
+add_local_sdk_path("runtime_config.py")
+
+from mn_sdk.runtime_config import RuntimeConfig, default_logs_root
+
+
+@dataclass(frozen=True)
+class CliConfig:
+    grpc_target: str = "localhost:55051"
+    grpc_timeout_seconds: float | None = 10.0
+    grpc_auth_token: str = ""
+    grpc_admin_token: str = ""
+    log_path: Path = default_logs_root() / "cli.log"
+    output_mode: str = "rich"
+
+    @classmethod
+    def from_env(cls) -> "CliConfig":
+        runtime_config = RuntimeConfig.from_env()
+        return cls(
+            grpc_target=runtime_config.grpc_target,
+            grpc_timeout_seconds=runtime_config.grpc_timeout_seconds,
+            grpc_auth_token=runtime_config.grpc_auth_token,
+            grpc_admin_token=runtime_config.grpc_admin_token,
+            log_path=Path(
+                os.getenv(
+                    "MN_CLI_LOG_PATH",
+                    str(default_logs_root() / "cli.log"),
+                )
+            ).expanduser(),
+            output_mode=os.getenv("MN_CLI_OUTPUT", "rich"),
+        )

mirrorneuron_cli-1.2.6/mn_cli/libs/artifacts.py

@@ -0,0 +1,139 @@
+from __future__ import annotations
+
+import hashlib
+import mimetypes
+import os
+import socket
+from pathlib import Path
+from typing import Any
+
+from mn_sdk.runtime_config import resolve_mn_home
+
+from mn_cli.runtime_state import read_env_file
+
+DEFAULT_INLINE_PAYLOAD_MAX_BYTES = 1_048_576
+DEFAULT_ARTIFACT_PORT = "55660"
+
+
+def promote_large_payloads_to_blob_refs(
+    manifest: dict[str, Any],
+    payloads: dict[str, bytes],
+    *,
+    runtime_env: dict[str, str] | None = None,
+) -> list[dict[str, Any]]:
+    threshold = _inline_payload_max_bytes()
+    if threshold < 0:
+        return []
+
+    env = _runtime_env_file_values()
+    env.update(os.environ)
+    env.update(runtime_env or {})
+    root = _host_blob_store_root(env)
+    promoted: list[dict[str, Any]] = []
+
+    for rel_path, contents in list(payloads.items()):
+        if len(contents) <= threshold:
+            continue
+
+        blob_ref = _store_payload_blob(root, rel_path, contents, env)
+        promoted.append(blob_ref)
+        del payloads[rel_path]
+
+    if promoted:
+        metadata = manifest.setdefault("metadata", {})
+        artifacts = metadata.setdefault("mn_artifacts", {})
+        artifacts.setdefault("blob_refs", []).extend(promoted)
+
+    return promoted
+
+
+def _store_payload_blob(
+    root: Path,
+    rel_path: str,
+    contents: bytes,
+    env: dict[str, str],
+) -> dict[str, Any]:
+    sha256 = hashlib.sha256(contents).hexdigest()
+    target = root / sha256[:2] / sha256
+    target.parent.mkdir(parents=True, exist_ok=True)
+
+    if not target.exists():
+        tmp = target.with_name(f"{target.name}.tmp-{os.getpid()}")
+        tmp.write_bytes(contents)
+        os.replace(tmp, target)
+
+    media_type, _encoding = mimetypes.guess_type(rel_path)
+    location = _blob_location(sha256, env)
+
+    blob_ref: dict[str, Any] = {
+        "type": "blob_ref",
+        "sha256": sha256,
+        "size_bytes": len(contents),
+        "media_type": media_type or "application/octet-stream",
+        "logical_name": Path(rel_path).name,
+        "scope": "job",
+        "payload_path": rel_path.replace("\\", "/"),
+    }
+
+    if location:
+        blob_ref["locations"] = [location]
+
+    return blob_ref
+
+
+def _blob_location(sha256: str, env: dict[str, str]) -> dict[str, str] | None:
+    base_url = str(env.get("MN_ARTIFACT_ADVERTISE_URL") or os.getenv("MN_ARTIFACT_ADVERTISE_URL") or "").strip()
+    if not base_url:
+        host = (
+            str(env.get("MN_NETWORK_ADVERTISE_HOST") or os.getenv("MN_NETWORK_ADVERTISE_HOST") or "").strip()
+            or _detect_lan_ip()
+        )
+        port = str(env.get("MN_ARTIFACT_PORT") or os.getenv("MN_ARTIFACT_PORT") or DEFAULT_ARTIFACT_PORT).strip()
+        if not host or not port:
+            return None
+        base_url = f"http://{host}:{port}"
+
+    location = {
+        "url": f"{base_url.rstrip('/')}/blobs/{sha256}",
+        "status": "available",
+    }
+    node = str(env.get("MN_NODE_NAME") or os.getenv("MN_NODE_NAME") or "").strip()
+    if node:
+        location["node"] = node
+    return location
+
+
+def _host_blob_store_root(env: dict[str, str]) -> Path:
+    configured = (
+        env.get("MN_HOST_BLOB_STORE_DIR")
+        or os.getenv("MN_HOST_BLOB_STORE_DIR")
+        or env.get("MN_BLOB_STORE_ROOT")
+        or os.getenv("MN_BLOB_STORE_ROOT")
+    )
+    if configured:
+        return Path(configured).expanduser()
+    return resolve_mn_home() / "blobs"
+
+
+def _runtime_env_file_values() -> dict[str, str]:
+    env_file = resolve_mn_home() / "docker-compose.env"
+    return {key.strip(): value.strip() for key, value in read_env_file(env_file).items()}
+
+
+def _inline_payload_max_bytes() -> int:
+    value = os.getenv("MN_INLINE_PAYLOAD_MAX_BYTES", str(DEFAULT_INLINE_PAYLOAD_MAX_BYTES))
+    try:
+        return int(value)
+    except (TypeError, ValueError):
+        return DEFAULT_INLINE_PAYLOAD_MAX_BYTES
+
+
+def _detect_lan_ip() -> str:
+    probe = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    try:
+        probe.connect(("8.8.8.8", 80))
+        return probe.getsockname()[0]
+    except OSError:
+        return "127.0.0.1"
+    finally:
+        probe.close()

{mirrorneuron_cli-1.1.9 → mirrorneuron_cli-1.2.6}/mn_cli/libs/backup_cmds.py

@@ -12,8 +12,11 @@ from typing import Any
 
 import typer
 
+from mn_sdk.runtime_config import default_runs_root
+
 from mn_cli.error_handler import handle_cli_error
 from mn_cli.libs.blueprint_observability import make_blueprint_run_id
+from mn_cli.libs.ui import print_success_confirmation
 from mn_cli.shared import client, console, logger
 
 SCHEMA_VERSION = "mn.backup.v1"
@@ -69,8 +72,12 @@ def backup(
         _merge_cli_source_metadata(backup_payload, target)
 
         archive_path = _write_backup_archive(backup_payload, bundle_files, output, target)
-        console.print(f"[green]Backup written:[/green] {archive_path}")
-        console.print(f"Source job: [bold]{job_id}[/bold]")
+        print_success_confirmation(
+            console,
+            "Job backup",
+            details=[("Backup", archive_path), ("Source job", job_id)],
+            next_steps=f"mn job restore <blueprint-id> --input {archive_path}",
+        )
     except BackupRestoreError as exc:
         console.print(f"[red]{exc}[/red]")
         raise typer.Exit(1)
@@ -119,12 +126,17 @@ def restore(
             knowledge_files,
         )
 
-        console.print(f"[green]Restored backup as paused job:[/green] {new_job_id}")
-        console.print(f"New run: [bold]{new_run_id}[/bold]")
-        console.print(
-            f"Original job: [bold]{result.get('source_job_id', 'unknown')}[/bold]"
+        print_success_confirmation(
+            console,
+            "Job restore",
+            status="paused",
+            details=[
+                ("Job ID", new_job_id),
+                ("Run ID", new_run_id),
+                ("Original job", result.get("source_job_id", "unknown")),
+            ],
+            next_steps=f"mn job resume {new_job_id}",
         )
-        console.print(f"Resume when ready: [bold]mn job resume {new_job_id}[/bold]")
     except BackupRestoreError as exc:
         console.print(f"[red]{exc}[/red]")
         raise typer.Exit(1)
@@ -228,7 +240,7 @@ def _job_from_get_job_payload(payload: Any) -> dict[str, Any]:
 
 
 def _runs_root() -> Path:
-    return Path(os.getenv("MN_RUNS_ROOT") or "~/.mn/runs").expanduser()
+    return default_runs_root()
 
 
 def _load_run_record(run_id: str) -> dict[str, Any] | None: