urun-cli 0.5.0__tar.gz → 0.5.2__tar.gz

{urun_cli-0.5.0 → urun_cli-0.5.2}/.gitignore

@@ -16,3 +16,4 @@ build/
 # Local development environment
 .devcontainer.env
 .cache/
+.claude/

{urun_cli-0.5.0 → urun_cli-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: urun-cli
-Version: 0.5.0
+Version: 0.5.2
 Summary: End-user CLI for deploying apps to urun
 Project-URL: Homepage, https://urun.sh
 Project-URL: Repository, https://github.com/urun-sh/urun-cli
@@ -93,6 +93,40 @@ In this release, `urun run` uses the same deploy pipeline as `urun deploy`.
 `deploy` remains available as the lower-level command while the full
 deploy/run/monitor workflow is being built.
 
+## Serve a model from the catalog
+
+`urun serve` deploys a model straight from the urun model catalog — no app code
+required. It is `urun deploy` with a serve app templated from the resolved
+catalog row (engine, HF repo, GPU, engine args).
+
+List the enumerable model matrix (models, variants, the GPU each fits, engine
+shape, and whether the placement is dev-testable or prod-only):
+
+```bash
+urun serve catalog
+urun serve catalog --json
+```
+
+Serve a model. With no variant the model's default (first) variant is used; with
+no `--gpu` the variant's first placement is used:
+
+```bash
+urun serve qwen-coder                    # default variant + first placement
+urun serve glm-5.2:UD-IQ2_M              # explicit <id>:<variant>
+urun serve qwen-coder-480b:fp8 --gpu b200:8
+```
+
+The catalog is anon-readable reference data published by a urun-infra migration.
+Reads go over PostgREST on the same control-plane host as the API URL; supply the
+public Supabase anon key via `--anon-key` or `URUN_CATALOG_ANON_KEY`
+(`URUN_SUPABASE_ANON_KEY` is also honored). Override the PostgREST base with
+`--catalog-url` / `URUN_CATALOG_URL` if needed.
+
+By default `urun serve <id>` renders a templated serve app and deploys it. If you
+maintain your own `_serve` app, point `--entrypoint` at it; the CLI deploys that
+app with `URUN_SERVE_CONFIG` and `URUN_SERVE_CATALOG_ROW` set to the resolved
+row instead of rendering one.
+
 ## Inspect apps
 
 List every app deployed in your org and its current status:

{urun_cli-0.5.0 → urun_cli-0.5.2}/README.md

@@ -71,6 +71,40 @@ In this release, `urun run` uses the same deploy pipeline as `urun deploy`.
 `deploy` remains available as the lower-level command while the full
 deploy/run/monitor workflow is being built.
 
+## Serve a model from the catalog
+
+`urun serve` deploys a model straight from the urun model catalog — no app code
+required. It is `urun deploy` with a serve app templated from the resolved
+catalog row (engine, HF repo, GPU, engine args).
+
+List the enumerable model matrix (models, variants, the GPU each fits, engine
+shape, and whether the placement is dev-testable or prod-only):
+
+```bash
+urun serve catalog
+urun serve catalog --json
+```
+
+Serve a model. With no variant the model's default (first) variant is used; with
+no `--gpu` the variant's first placement is used:
+
+```bash
+urun serve qwen-coder                    # default variant + first placement
+urun serve glm-5.2:UD-IQ2_M              # explicit <id>:<variant>
+urun serve qwen-coder-480b:fp8 --gpu b200:8
+```
+
+The catalog is anon-readable reference data published by a urun-infra migration.
+Reads go over PostgREST on the same control-plane host as the API URL; supply the
+public Supabase anon key via `--anon-key` or `URUN_CATALOG_ANON_KEY`
+(`URUN_SUPABASE_ANON_KEY` is also honored). Override the PostgREST base with
+`--catalog-url` / `URUN_CATALOG_URL` if needed.
+
+By default `urun serve <id>` renders a templated serve app and deploys it. If you
+maintain your own `_serve` app, point `--entrypoint` at it; the CLI deploys that
+app with `URUN_SERVE_CONFIG` and `URUN_SERVE_CATALOG_ROW` set to the resolved
+row instead of rendering one.
+
 ## Inspect apps
 
 List every app deployed in your org and its current status:

{urun_cli-0.5.0 → urun_cli-0.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "urun-cli"
-version = "0.5.0"
+version = "0.5.2"
 description = "End-user CLI for deploying apps to urun"
 readme = "README.md"
 requires-python = ">=3.11"

{urun_cli-0.5.0 → urun_cli-0.5.2}/src/urun/api.py

@@ -43,6 +43,21 @@ class ApiClient:
     def deployment_status(self, manifest_hash: str) -> dict[str, Any]:
         return self._json("GET", f"/deployment-status/{manifest_hash}", None)
 
+    def _get(self, path: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._json("GET", self._path(path, params), None)
+
+    def _post(self, path: str, body: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._json("POST", path, body or {})
+
+    def _delete(self, path: str, body: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._json("DELETE", path, body)
+
+    def _path(self, path: str, params: dict[str, Any] | None = None) -> str:
+        clean = {k: v for k, v in (params or {}).items() if v is not None and v is not False}
+        if not clean:
+            return path
+        return path + "?" + urllib.parse.urlencode(clean, doseq=True)
+
     def list_apps(self) -> dict[str, Any]:
         """List all deployed apps for the authenticated org.
 
@@ -58,6 +73,15 @@ class ApiClient:
         """
         return self._json("GET", "/apps", None)
 
+    def get_app(self, app: str, environment: str | None = None) -> dict[str, Any]:
+        return self.app_status(app, environment=environment)
+
+    def diagnose_app(self, app: str, environment: str | None = None) -> dict[str, Any]:
+        return self._get(
+            f"/cli/apps/{urllib.parse.quote(app, safe='')}/diagnose",
+            {"environment": environment},
+        )
+
     def list_sessions(self, limit: int | None = None, state: str | None = None) -> dict[str, Any]:
         """List sessions for the authenticated org.
 
@@ -84,6 +108,15 @@ class ApiClient:
             path += "?" + urllib.parse.urlencode(params)
         return self._json("GET", path, None)
 
+    def get_session(self, session_id: str) -> dict[str, Any]:
+        return self._get(f"/cli/sessions/{urllib.parse.quote(session_id, safe='')}")
+
+    def cancel_session(self, session_id: str, reason: str | None = None) -> dict[str, Any]:
+        return self._post(
+            f"/cli/sessions/{urllib.parse.quote(session_id, safe='')}/cancel",
+            {"reason": reason} if reason else {},
+        )
+
     def list_compute(self, limit: int | None = None) -> dict[str, Any]:
         """List currently-provisioned compute slices for the authenticated org.
 
@@ -110,6 +143,210 @@ class ApiClient:
             path += "?" + urllib.parse.urlencode({"limit": str(limit)})
         return self._json("GET", path, None)
 
+    def list_capacity(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/capacity", params)
+
+    def get_capacity(self, app: str, environment: str | None = None) -> dict[str, Any]:
+        return self._get(
+            f"/cli/capacity/{urllib.parse.quote(app, safe='')}", {"environment": environment}
+        )
+
+    def list_shapes(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/shapes", params)
+
+    def get_shape(self, shape: str) -> dict[str, Any]:
+        return self._get(f"/cli/shapes/{urllib.parse.quote(shape, safe='')}")
+
+    def list_capacity_leases(self, status: str | None = None) -> dict[str, Any]:
+        return self._get("/cli/capacity-leases", {"status": status})
+
+    def get_capacity_lease(self, lease_id: str) -> dict[str, Any]:
+        return self._get(f"/cli/capacity-leases/{urllib.parse.quote(lease_id, safe='')}")
+
+    def create_capacity_lease(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self._post("/cli/capacity-leases", payload)
+
+    def cancel_capacity_lease(self, lease_id: str) -> dict[str, Any]:
+        return self._post(f"/cli/capacity-leases/{urllib.parse.quote(lease_id, safe='')}/cancel")
+
+    def list_builds(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/builds", params)
+
+    def get_build(self, build_id: str) -> dict[str, Any]:
+        return self._get(f"/cli/builds/{urllib.parse.quote(build_id, safe='')}")
+
+    def logs_build(self, build_id: str, tail: int | None = None) -> dict[str, Any]:
+        return self._get(
+            f"/cli/builds/{urllib.parse.quote(build_id, safe='')}/logs", {"tail": tail}
+        )
+
+    def list_releases(self, app: str, environment: str | None = None) -> dict[str, Any]:
+        return self._get("/cli/releases", {"app": app, "environment": environment})
+
+    def get_release(self, release_id: str) -> dict[str, Any]:
+        return self._get(f"/cli/releases/{urllib.parse.quote(release_id, safe='')}")
+
+    def query_logs(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/logs", params)
+
+    def list_events(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/events", params)
+
+    def list_environments(self) -> dict[str, Any]:
+        return self._get("/cli/environments")
+
+    def get_environment(self, environment: str) -> dict[str, Any]:
+        return self._get(f"/cli/environments/{urllib.parse.quote(environment, safe='')}")
+
+    def create_environment(
+        self, environment: str, display_name: str | None = None
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {"environment": environment}
+        if display_name:
+            body["display_name"] = display_name
+        return self._post("/cli/environments", body)
+
+    def get_usage(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/usage", params)
+
+    def get_credits(self) -> dict[str, Any]:
+        return self._get("/cli/credits")
+
+    def list_credit_ledger(self, limit: int | None = None) -> dict[str, Any]:
+        return self._get("/cli/credit-ledger", {"limit": limit})
+
+    def get_quota(self, shape: str | None = None) -> dict[str, Any]:
+        return self._get("/cli/quota", {"shape": shape})
+
+    def get_billing(self) -> dict[str, Any]:
+        return self._get("/cli/billing")
+
+    def list_invoices(self) -> dict[str, Any]:
+        return self._get("/cli/invoices")
+
+    def list_secrets(self, app: str | None = None) -> dict[str, Any]:
+        return self._get("/cli/secrets", {"app": app})
+
+    def set_secret(self, name: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self._post(f"/cli/secrets/{urllib.parse.quote(name, safe='')}", payload)
+
+    def delete_secret(self, name: str, app: str | None = None) -> dict[str, Any]:
+        return self._delete(
+            f"/cli/secrets/{urllib.parse.quote(name, safe='')}", {"app": app} if app else None
+        )
+
+    def list_api_keys(self) -> dict[str, Any]:
+        return self._get("/cli/api-keys")
+
+    def create_api_key(self, label: str, service_account: str | None = None) -> dict[str, Any]:
+        return self._post("/cli/api-keys", {"label": label, "service_account": service_account})
+
+    def revoke_api_key(self, key_id: str) -> dict[str, Any]:
+        return self._post(f"/cli/api-keys/{urllib.parse.quote(key_id, safe='')}/revoke")
+
+    def list_service_accounts(self) -> dict[str, Any]:
+        return self._get("/cli/service-accounts")
+
+    def create_service_account(self, name: str) -> dict[str, Any]:
+        return self._post("/cli/service-accounts", {"name": name})
+
+    def delete_service_account(self, account_id: str) -> dict[str, Any]:
+        return self._delete(f"/cli/service-accounts/{urllib.parse.quote(account_id, safe='')}")
+
+    def list_members(self) -> dict[str, Any]:
+        return self._get("/cli/members")
+
+    def get_member(self, actor_id: str) -> dict[str, Any]:
+        return self._get(f"/cli/members/{urllib.parse.quote(actor_id, safe='')}")
+
+    def invite_member(self, email: str, role: str) -> dict[str, Any]:
+        return self._post("/cli/members/invite", {"email": email, "role": role})
+
+    def set_member_role(self, actor_id: str, role: str) -> dict[str, Any]:
+        return self._post(
+            f"/cli/members/{urllib.parse.quote(actor_id, safe='')}/role", {"role": role}
+        )
+
+    def list_activity(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/activity", params)
+
+    def list_failure_groups(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/failure-groups", params)
+
+    def list_issues(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/issues", params)
+
+    def get_issue(self, issue: str) -> dict[str, Any]:
+        return self._get(f"/cli/issues/{urllib.parse.quote(issue, safe='')}")
+
+    def set_issue_status(self, issue: str, status: str, note: str | None = None) -> dict[str, Any]:
+        return self._post(
+            f"/cli/issues/{urllib.parse.quote(issue, safe='')}/status",
+            {"status": status, "note": note},
+        )
+
+    def list_alert_rules(self) -> dict[str, Any]:
+        return self._get("/cli/alert-rules")
+
+    def get_alert_rule(self, rule_id: str) -> dict[str, Any]:
+        return self._get(f"/cli/alert-rules/{urllib.parse.quote(rule_id, safe='')}")
+
+    def create_alert_rule(self, payload: dict[str, Any]) -> dict[str, Any]:
+        return self._post("/cli/alert-rules", payload)
+
+    def update_alert_rule(self, rule_id: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self._post(f"/cli/alert-rules/{urllib.parse.quote(rule_id, safe='')}", payload)
+
+    def delete_alert_rule(self, rule_id: str) -> dict[str, Any]:
+        return self._delete(f"/cli/alert-rules/{urllib.parse.quote(rule_id, safe='')}")
+
+    def list_alert_channels(self) -> dict[str, Any]:
+        return self._get("/cli/alert-channels")
+
+    def create_alert_channel(self, kind: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self._post(f"/cli/alert-channels/{urllib.parse.quote(kind, safe='')}", payload)
+
+    def set_alert_channel_enabled(self, channel_id: str, enabled: bool) -> dict[str, Any]:
+        return self._post(
+            f"/cli/alert-channels/{urllib.parse.quote(channel_id, safe='')}/enabled",
+            {"enabled": enabled},
+        )
+
+    def delete_alert_channel(self, channel_id: str) -> dict[str, Any]:
+        return self._delete(f"/cli/alert-channels/{urllib.parse.quote(channel_id, safe='')}")
+
+    def list_git_installations(self) -> dict[str, Any]:
+        return self._get("/cli/git-installations")
+
+    def list_git_repos(self) -> dict[str, Any]:
+        return self._get("/cli/git-repos")
+
+    def link_app(self, app: str, payload: dict[str, Any]) -> dict[str, Any]:
+        return self._post(f"/cli/apps/{urllib.parse.quote(app, safe='')}/git", payload)
+
+    def unlink_app(self, app: str) -> dict[str, Any]:
+        return self._delete(f"/cli/apps/{urllib.parse.quote(app, safe='')}/git")
+
+    def deploy_app_from_git(self, app: str, branch: str | None = None) -> dict[str, Any]:
+        body: dict[str, Any] = {}
+        if branch is not None:
+            body["branch"] = branch
+        return self._post(f"/cli/apps/{urllib.parse.quote(app, safe='')}/deploy", body)
+
+    def list_marketplace_apps(self, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._get("/cli/marketplace-apps", params)
+
+    def get_marketplace_app(self, slug: str) -> dict[str, Any]:
+        return self._get(f"/cli/marketplace-apps/{urllib.parse.quote(slug, safe='')}")
+
+    def install_app(self, slug: str, environment: str | None = None) -> dict[str, Any]:
+        body: dict[str, Any] = {}
+        if environment is not None:
+            body["environment"] = environment
+        return self._post(
+            f"/cli/marketplace-apps/{urllib.parse.quote(slug, safe='')}/install", body
+        )
+
     def app_status(self, app: str, environment: str | None = None) -> dict[str, Any]:
         """Fetch the detailed lifecycle status for a single app.