morphcloud 0.1.111__tar.gz → 0.1.112__tar.gz

{morphcloud-0.1.111 → morphcloud-0.1.112}/.gitignore

@@ -19,6 +19,7 @@ wheels/
 *.egg-info/
 .installed.cfg
 *.egg
+.ruff_cache/
 
 # Poetry
 poetry.lock
@@ -60,3 +61,10 @@ _build/
 
 # uv
 uv.lock
+
+#clanker
+AGENTS.md
+CLAUDE.md
+PLAN.md
+.codex/
+.agents/

{morphcloud-0.1.111 → morphcloud-0.1.112}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: morphcloud
-Version: 0.1.111
+Version: 0.1.112
 Summary: A Python SDK and CLI tool for creating, managing, and interacting with Morph Cloud VMs.
 Author-email: Morph Labs <jobs@morph.so>
 License: Apache-2.0
@@ -216,6 +216,68 @@ morphcloud instance copy inst_123:/remote/file.log ./local_dir/
 morphcloud instance copy -r ./local_dir inst_123:/remote/dir
 ```
 
+### Plugins
+
+Plugins are Python packages that register extra `morphcloud` commands through
+the `morphcloud.cli_plugins` entry-point group. Catalog and package operations
+use your normal `MORPH_API_KEY`. A catalog entry can install from the private
+simple-index package name or from an explicit `artifact_url`.
+
+```bash
+# Inspect plugin configuration and installed commands
+morphcloud plugin doctor
+
+# List or inspect plugins visible to your organization
+morphcloud plugin list
+morphcloud plugin show intro
+
+# Validate install resolution without changing the environment
+morphcloud plugin install intro --dry-run
+
+# Install or update a plugin into the current Python environment
+morphcloud plugin install intro
+morphcloud plugin upgrade intro
+
+# Run the command exposed by the installed plugin
+morphcloud intro --help
+```
+
+Common commands:
+
+| Command | Purpose |
+| --- | --- |
+| `morphcloud plugin list [query]` | List visible enabled plugins. |
+| `morphcloud plugin search <query>` | Search visible plugins by name, package, artifact, or command. |
+| `morphcloud plugin show <name>` / `info` | Show one catalog entry. |
+| `morphcloud plugin install <name>` | Install into the active Python environment. |
+| `morphcloud plugin upgrade <name>` / `update` | Upgrade an installed plugin. |
+| `morphcloud plugin uninstall <name>` | Remove the plugin package. |
+| `morphcloud plugin register <name>` | Upsert a catalog entry from flags or `--manifest`. |
+| `morphcloud plugin publish <name> --wheel dist/pkg-version-py3-none-any.whl` | Upload a wheel to simple-index, then register the catalog entry. |
+| `morphcloud plugin enable/disable/delete <name>` | Manage catalog lifecycle. |
+| `morphcloud plugin doctor` | Show auth, index, catalog, and installed entry-point status. |
+
+Management commands accept `--visibility global|org` and `--organization-id`.
+Org-scoped entries require `--organization-id`; global entries must omit it.
+
+For local or preview simple-index services, set:
+
+```bash
+export MORPH_SIMPLE_INDEX_BASE_URL="http://127.0.0.1:8912"
+```
+
+The installer uses the authenticated simple-index URL as the primary package
+index for package-backed plugins and keeps PyPI as an extra index for public
+dependencies. Credentials are redacted from CLI output, including direct
+artifact URLs. Direct `artifact_url` installs are allowed only for URLs without
+embedded credentials, query strings, or fragments; use package-backed simple-index
+publishing for private or signed artifacts so secrets are not passed to pip as
+process arguments.
+
+For stricter private-package installs, set `MORPH_PLUGIN_DISABLE_EXTRA_INDEX=1`
+to omit the public extra index. To use a controlled mirror instead of PyPI, set
+`MORPH_PLUGIN_EXTRA_INDEX_URL`.
+
 ### Volumes
 
 Morph Volumes exposes an S3-compatible object store. Bucket lifecycle and object operations use your normal `MORPH_API_KEY`.

{morphcloud-0.1.111 → morphcloud-0.1.112}/README.md

@@ -185,6 +185,68 @@ morphcloud instance copy inst_123:/remote/file.log ./local_dir/
 morphcloud instance copy -r ./local_dir inst_123:/remote/dir
 ```
 
+### Plugins
+
+Plugins are Python packages that register extra `morphcloud` commands through
+the `morphcloud.cli_plugins` entry-point group. Catalog and package operations
+use your normal `MORPH_API_KEY`. A catalog entry can install from the private
+simple-index package name or from an explicit `artifact_url`.
+
+```bash
+# Inspect plugin configuration and installed commands
+morphcloud plugin doctor
+
+# List or inspect plugins visible to your organization
+morphcloud plugin list
+morphcloud plugin show intro
+
+# Validate install resolution without changing the environment
+morphcloud plugin install intro --dry-run
+
+# Install or update a plugin into the current Python environment
+morphcloud plugin install intro
+morphcloud plugin upgrade intro
+
+# Run the command exposed by the installed plugin
+morphcloud intro --help
+```
+
+Common commands:
+
+| Command | Purpose |
+| --- | --- |
+| `morphcloud plugin list [query]` | List visible enabled plugins. |
+| `morphcloud plugin search <query>` | Search visible plugins by name, package, artifact, or command. |
+| `morphcloud plugin show <name>` / `info` | Show one catalog entry. |
+| `morphcloud plugin install <name>` | Install into the active Python environment. |
+| `morphcloud plugin upgrade <name>` / `update` | Upgrade an installed plugin. |
+| `morphcloud plugin uninstall <name>` | Remove the plugin package. |
+| `morphcloud plugin register <name>` | Upsert a catalog entry from flags or `--manifest`. |
+| `morphcloud plugin publish <name> --wheel dist/pkg-version-py3-none-any.whl` | Upload a wheel to simple-index, then register the catalog entry. |
+| `morphcloud plugin enable/disable/delete <name>` | Manage catalog lifecycle. |
+| `morphcloud plugin doctor` | Show auth, index, catalog, and installed entry-point status. |
+
+Management commands accept `--visibility global|org` and `--organization-id`.
+Org-scoped entries require `--organization-id`; global entries must omit it.
+
+For local or preview simple-index services, set:
+
+```bash
+export MORPH_SIMPLE_INDEX_BASE_URL="http://127.0.0.1:8912"
+```
+
+The installer uses the authenticated simple-index URL as the primary package
+index for package-backed plugins and keeps PyPI as an extra index for public
+dependencies. Credentials are redacted from CLI output, including direct
+artifact URLs. Direct `artifact_url` installs are allowed only for URLs without
+embedded credentials, query strings, or fragments; use package-backed simple-index
+publishing for private or signed artifacts so secrets are not passed to pip as
+process arguments.
+
+For stricter private-package installs, set `MORPH_PLUGIN_DISABLE_EXTRA_INDEX=1`
+to omit the public extra index. To use a controlled mirror instead of PyPI, set
+`MORPH_PLUGIN_EXTRA_INDEX_URL`.
+
 ### Volumes
 
 Morph Volumes exposes an S3-compatible object store. Bucket lifecycle and object operations use your normal `MORPH_API_KEY`.

{morphcloud-0.1.111 → morphcloud-0.1.112}/morphcloud/api.py

@@ -24,6 +24,7 @@ from morphcloud.config import resolve_settings
 
 if typing.TYPE_CHECKING:
     from morphcloud.devbox.client import AsyncDevboxClient, DevboxClient
+    from morphcloud.simple_index.client import SimpleIndexClient
     from morphcloud.volumes.client import VolumesClient
 
 # Global console instance
@@ -167,6 +168,7 @@ class MorphCloudClient:
         volumes_service_api_key: typing.Optional[str] = None,
         admin_base_url: typing.Optional[str] = None,
         db_base_url: typing.Optional[str] = None,
+        simple_index_base_url: typing.Optional[str] = None,
         ssh_hostname: typing.Optional[str] = None,
         ssh_port: typing.Optional[int] = None,
         devbox_base_url: typing.Optional[str] = None,
@@ -182,6 +184,7 @@ class MorphCloudClient:
                 "devbox_base_url": devbox_base_url,
                 "admin_base_url": admin_base_url,
                 "db_base_url": db_base_url,
+                "simple_index_base_url": simple_index_base_url,
                 "ssh_hostname": ssh_hostname,
                 "ssh_port": ssh_port,
             },
@@ -200,10 +203,12 @@ class MorphCloudClient:
         self.devbox_base_url = settings.devbox_base_url
         self.admin_base_url = settings.admin_base_url
         self.db_base_url = settings.db_base_url
+        self.simple_index_base_url = settings.simple_index_base_url
         self.profile = settings.profile
         self._devbox_client = None
         self._devbox_async_client = None
         self._volumes_client = None
+        self._simple_index_client = None
         if not self.api_key:
             raise ValueError(
                 "API key must be provided or set in MORPH_API_KEY environment variable"
@@ -254,9 +259,10 @@ class MorphCloudClient:
         )
 
         self._load_sdk_plugins()
-        # Ensure first-party devbox clients win even if an external plugin attempted to attach them.
+        # Ensure first-party clients win even if an external plugin attempted to attach them.
         self._devbox_client = None
         self._devbox_async_client = None
+        self._simple_index_client = None
 
     def _load_sdk_plugins(self):
         """Load SDK plugins from entry points."""
@@ -339,6 +345,18 @@ class MorphCloudClient:
     def volumes(self, value: "VolumesClient") -> None:
         self._volumes_client = value
 
+    @property
+    def simple_index(self) -> "SimpleIndexClient":
+        if self._simple_index_client is None:
+            from morphcloud.simple_index.client import SimpleIndexClient
+
+            self._simple_index_client = SimpleIndexClient(self)
+        return self._simple_index_client
+
+    @simple_index.setter
+    def simple_index(self, value: "SimpleIndexClient") -> None:
+        self._simple_index_client = value
+
 
 class BaseAPI:
     def __init__(self, client: MorphCloudClient):

{morphcloud-0.1.111 → morphcloud-0.1.112}/morphcloud/cli.py

@@ -153,9 +153,8 @@ class VersionCheckGroup(AliasedGroup):
         except click.exceptions.ClickException:
             # Let Click handle its own exceptions, but check version after
             # We need to raise first so Click can display the error
-            exctype, value, tb = sys.exc_info()
             raise
-        except Exception as e:
+        except Exception:
             # For non-Click exceptions, check version before letting the exception propagate
             check_for_package_update(display_mode="error")
             raise
@@ -298,6 +297,11 @@ def profile_show(name):
 )
 @click.option("--admin-base-url", default=None, help="Override the admin API base URL.")
 @click.option("--db-base-url", default=None, help="Override the db API base URL.")
+@click.option(
+    "--simple-index-base-url",
+    default=None,
+    help="Override the simple-index base URL.",
+)
 def profile_set(
     name,
     api_key,
@@ -309,6 +313,7 @@ def profile_set(
     volumes_base_url,
     admin_base_url,
     db_base_url,
+    simple_index_base_url,
 ):
     updates = {
         "api_key": api_key,
@@ -320,6 +325,7 @@ def profile_set(
         "volumes_base_url": volumes_base_url,
         "admin_base_url": admin_base_url,
         "db_base_url": db_base_url,
+        "simple_index_base_url": simple_index_base_url,
     }
     updates = {k: v for k, v in updates.items() if v is not None}
     if not updates:
@@ -510,7 +516,7 @@ def _interactive_pagination(
             content_height = max(5, height - 12)
 
             if not current_items:
-                spinner = _start_spinner("Fetching data")
+                _start_spinner("Fetching data")
                 try:
                     result = get_data_func(page=page, limit=limit, **kwargs)
                     current_items = getattr(result, items_attr, [])
@@ -617,7 +623,7 @@ def _interactive_pagination(
                 # Temporarily exit alt screen for input
                 click.echo("\033[?1049l", nl=False)
                 try:
-                    changed = on_search()
+                    on_search()
                 finally:
                     # Re-enter alt screen
                     click.echo("\033[?1049h", nl=False)
@@ -2709,6 +2715,10 @@ def _register_builtin_cli_extensions() -> None:
 
     register_volumes_cli_plugin(cli)
 
+    from morphcloud.plugins.cli import register_cli_plugin as register_plugin_cli_plugin
+
+    register_plugin_cli_plugin(cli)
+
     # Register built-in devbox commands last (so they win over any external
     # plugin).
     from morphcloud.devbox.cli import devbox as devbox_group

{morphcloud-0.1.111 → morphcloud-0.1.112}/morphcloud/config.py

@@ -17,6 +17,7 @@ DEFAULT_VOLUMES_BASE_URL = "https://volumes.svc.cloud.morph.so"
 DEFAULT_DEVBOX_BASE_URL = "https://devbox.svc.cloud.morph.so"
 DEFAULT_ADMIN_BASE_URL = "https://admin.svc.cloud.morph.so"
 DEFAULT_DB_BASE_URL = "https://db.svc.cloud.morph.so"
+DEFAULT_SIMPLE_INDEX_BASE_URL = "https://simple-index.svc.cloud.morph.so"
 
 
 @dataclass(frozen=True)
@@ -32,6 +33,7 @@ class ResolvedSettings:
     devbox_base_url: str
     admin_base_url: str
     db_base_url: str
+    simple_index_base_url: str
 
     def as_env(self, *, include_api_key: bool = True) -> Dict[str, str]:
         env: Dict[str, str] = {
@@ -44,6 +46,7 @@ class ResolvedSettings:
             "MORPH_DEVBOX_BASE_URL": self.devbox_base_url,
             "MORPH_ADMIN_BASE_URL": self.admin_base_url,
             "MORPH_DB_BASE_URL": self.db_base_url,
+            "MORPH_SIMPLE_INDEX_BASE_URL": self.simple_index_base_url,
         }
         if include_api_key and self.api_key:
             env["MORPH_API_KEY"] = self.api_key
@@ -255,6 +258,11 @@ def resolve_settings(
         env.get("MORPH_DB_BASE_URL"),
         profile_data.get("db_base_url"),
     )
+    simple_index_base_url = _coalesce(
+        overrides.get("simple_index_base_url"),
+        env.get("MORPH_SIMPLE_INDEX_BASE_URL"),
+        profile_data.get("simple_index_base_url"),
+    )
 
     if not api_host:
         api_host = _api_host_from_base_url(base_url)
@@ -277,6 +285,8 @@ def resolve_settings(
             admin_base_url = f"https://admin.svc.{api_host}"
         if not db_base_url:
             db_base_url = f"https://db.svc.{api_host}"
+        if not simple_index_base_url:
+            simple_index_base_url = f"https://simple-index.svc.{api_host}"
 
     base_url = base_url or DEFAULT_BASE_URL
     ssh_hostname = ssh_hostname or DEFAULT_SSH_HOSTNAME
@@ -286,6 +296,7 @@ def resolve_settings(
     devbox_base_url = devbox_base_url or DEFAULT_DEVBOX_BASE_URL
     admin_base_url = admin_base_url or DEFAULT_ADMIN_BASE_URL
     db_base_url = db_base_url or DEFAULT_DB_BASE_URL
+    simple_index_base_url = simple_index_base_url or DEFAULT_SIMPLE_INDEX_BASE_URL
 
     if not api_host:
         api_host = _api_host_from_base_url(base_url) or DEFAULT_API_HOST
@@ -302,6 +313,7 @@ def resolve_settings(
         devbox_base_url=devbox_base_url,
         admin_base_url=admin_base_url,
         db_base_url=db_base_url,
+        simple_index_base_url=simple_index_base_url,
     )
 
 

morphcloud-0.1.112/morphcloud/plugins/__init__.py

@@ -0,0 +1 @@
+"""Built-in plugin management commands for the Morph Cloud CLI."""