albus-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{albus_cli-0.3.0 → albus_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: albus-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: Command-line client for the Albus REST API
 Project-URL: Homepage, https://github.com/albusgroup/albus-cli
 Project-URL: Repository, https://github.com/albusgroup/albus-cli
@@ -9,7 +9,7 @@ Author: Albus
 License-Expression: MIT
 License-File: LICENSE
 Requires-Python: >=3.11
-Requires-Dist: albus-sdk==0.8.0
+Requires-Dist: albus-sdk==0.9.0
 Requires-Dist: typer<0.28,>=0.26.8
 Description-Content-Type: text/markdown
 
@@ -130,8 +130,14 @@ albus tokens get "$id"
 albus tokens delete "$id"
 
 albus invites create teammate@example.com
+
+albus models list
 ```
 
+`models list` gives the model names `sessions run --model` takes, each with
+the provider it runs on — which is the provider the `--credential` secret has
+to be for.
+
 `tokens create` prints the only copy of the key value the API ever returns;
 `list` and `get` return metadata alone.
 

{albus_cli-0.3.0 → albus_cli-0.4.0}/README.md

@@ -115,8 +115,14 @@ albus tokens get "$id"
 albus tokens delete "$id"
 
 albus invites create teammate@example.com
+
+albus models list
 ```
 
+`models list` gives the model names `sessions run --model` takes, each with
+the provider it runs on — which is the provider the `--credential` secret has
+to be for.
+
 `tokens create` prints the only copy of the key value the API ever returns;
 `list` and `get` return metadata alone.
 

{albus_cli-0.3.0 → albus_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "albus-cli"
-version = "0.3.0"
+version = "0.4.0"
 description = "Command-line client for the Albus REST API"
 readme = "README.md"
 license = "MIT"
@@ -13,7 +13,7 @@ authors = [{ name = "Albus" }]
 dependencies = [
     # Pinned, not floated: the published CLI states the one SDK version it was
     # tested against, and bumping it is a reviewed edit made when releasing.
-    "albus-sdk==0.8.0",
+    "albus-sdk==0.9.0",
     "typer>=0.26.8,<0.28",
 ]
 

albus_cli-0.4.0/src/albus_cli/commands/models.py

@@ -0,0 +1,19 @@
+"""`albus models` — the models a session can run on.
+
+The name a `sessions run` passes to `--model` has to be one of these, and
+the pair names the provider it runs on, which is the credential
+`--credential` has to carry.
+"""
+
+import typer
+
+from albus_cli.context import sdk
+from albus_cli.output import emit
+
+app = typer.Typer(no_args_is_help=True, help="List supported models.")
+
+
+@app.command("list")
+def list_models(ctx: typer.Context) -> None:
+    """List the supported models and the provider each runs on."""
+    emit(sdk(ctx).models.list_models())

{albus_cli-0.3.0 → albus_cli-0.4.0}/src/albus_cli/commands/sessions.py

@@ -176,7 +176,8 @@ def run(
         int | None,
         typer.Option(
             "--wait-timeout",
-            help="Seconds to block while waiting. Omit to wait indefinitely.",
+            help="Seconds to block while waiting. Omit to use the "
+            "server default.",
         ),
     ] = None,
 ) -> None:
@@ -199,9 +200,9 @@ def run(
         agent_name=agent_name,
         agent=agent,
         idempotency_key=idempotency_key,
-        # The server waits whenever the parameter is present, and 0 is
-        # its unbounded wait.
-        wait_timeout_seconds=(wait_timeout or 0) if wait else None,
+        # Omit the parameter to use the server's default wait; 0 returns
+        # immediately after the run is accepted.
+        wait_timeout_seconds=wait_timeout if wait else 0,
     )
     result = response.result.model_dump(mode="json", exclude_none=True)
     # The server names the invocation's effective key in a header, and the

{albus_cli-0.3.0 → albus_cli-0.4.0}/src/albus_cli/main.py

@@ -15,6 +15,7 @@ from albus_cli.commands import (
     agents,
     auth,
     invites,
+    models,
     secrets,
     sessions,
     status,
@@ -39,6 +40,7 @@ app.add_typer(secrets.app, name="secrets")
 app.add_typer(agents.app, name="agents")
 app.add_typer(tokens.app, name="tokens")
 app.add_typer(invites.app, name="invites")
+app.add_typer(models.app, name="models")
 app.command("login")(auth.login)
 app.command("logout")(auth.logout)
 app.command("whoami")(auth.whoami)

{albus_cli-0.3.0 → albus_cli-0.4.0}/tests/conftest.py

@@ -124,6 +124,19 @@ class FakeAuth:
         )
 
 
+@dataclass
+class FakeModels:
+    calls: list[Call]
+
+    def list_models(self, **kwargs: Any) -> models.ListModelsResponse:
+        self.calls.append(Call("list_models", kwargs))
+        return models.ListModelsResponse(
+            models=[
+                models.ModelMeta(name="claude-opus-4-8", provider="anthropic")
+            ]
+        )
+
+
 @dataclass
 class FakeAlbus:
     init_kwargs: list[dict[str, Any]] = field(default_factory=list)
@@ -136,6 +149,7 @@ class FakeAlbus:
         self.tokens = FakeTokens(self.calls)
         self.health = FakeHealth(self.calls)
         self.invites = FakeInvites(self.calls)
+        self.models = FakeModels(self.calls)
 
     def __call__(self, **kwargs: Any) -> "FakeAlbus":
         self.init_kwargs.append(kwargs)

{albus_cli-0.3.0 → albus_cli-0.4.0}/tests/test_cli.py

@@ -41,7 +41,7 @@ def test_run_builds_agent_config_from_flags(albus: FakeAlbus) -> None:
     assert call.name == "run_session"
     assert call.kwargs["id"] == "s1"
     assert call.kwargs["user_prompt"] == "hello"
-    assert call.kwargs["wait_timeout_seconds"] == 0
+    assert call.kwargs["wait_timeout_seconds"] is None
     agent = call.kwargs["agent"]
     assert agent.model.name == "gemini-3.6-flash"
     assert agent.model.provider is not None
@@ -89,7 +89,7 @@ def test_wait_flags_map_to_the_wait_timeout(albus: FakeAlbus) -> None:
     ]
 
     assert runner.invoke(app, [*args, "--no-wait"]).exit_code == 0
-    assert albus.calls[0].kwargs["wait_timeout_seconds"] is None
+    assert albus.calls[0].kwargs["wait_timeout_seconds"] == 0
 
     assert runner.invoke(app, [*args, "--wait-timeout", "5"]).exit_code == 0
     assert albus.calls[1].kwargs["wait_timeout_seconds"] == 5

albus_cli-0.4.0/tests/test_models.py

@@ -0,0 +1,26 @@
+"""`albus models list` is where a reader finds the name `sessions run
+--model` takes, so it has to answer with the API key that a run uses
+rather than the browser session `/tokens` needs."""
+
+import json
+
+from typer.testing import CliRunner
+
+from albus_cli.main import app
+from tests.conftest import FakeAlbus
+
+runner = CliRunner()
+
+
+def test_list_prints_the_models_and_providers(albus: FakeAlbus) -> None:
+    result = runner.invoke(app, ["models", "list"])
+
+    assert result.exit_code == 0, result.output
+    assert albus.calls[0].name == "list_models"
+    listed = json.loads(result.stdout)["models"][0]
+    assert listed == {"name": "claude-opus-4-8", "provider": "anthropic"}
+
+
+def test_list_uses_the_api_key(albus: FakeAlbus) -> None:
+    assert runner.invoke(app, ["models", "list"]).exit_code == 0
+    assert albus.init_kwargs[0]["api_key"] == "test-key"

{albus_cli-0.3.0 → albus_cli-0.4.0}/uv.lock

@@ -8,7 +8,7 @@ resolution-markers = [
 
 [[package]]
 name = "albus-cli"
-version = "0.3.0"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "albus-sdk" },
@@ -24,7 +24,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "albus-sdk", specifier = "==0.8.0" },
+    { name = "albus-sdk", specifier = "==0.9.0" },
     { name = "typer", specifier = ">=0.26.8,<0.28" },
 ]
 
@@ -37,16 +37,16 @@ dev = [
 
 [[package]]
 name = "albus-sdk"
-version = "0.8.0"
+version = "0.9.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpcore" },
     { name = "httpx" },
     { name = "pydantic" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/ca/86/c891c6fdd1ad4c34e4f49af973af09c23058288ae36e4ed89f58542cd3d3/albus_sdk-0.8.0.tar.gz", hash = "sha256:18609e42cbdbbd80fa27bd78e951cfff6da208f61b31b54a3c3efc8ae8a37856", size = 66873, upload-time = "2026-08-12T22:08:58.186Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/35/52/3dfdcc881a2d0a99adc6f9c9cb4c64b9616aa9cb0dd10f812aa5f3471661/albus_sdk-0.9.0.tar.gz", hash = "sha256:0edfe7fd732d04e87d440e38a8f296ddc3eb5e6f8ef77335c409b1873313ba74", size = 67010, upload-time = "2026-08-14T15:24:58.288Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/43/5a/4392771345d808c5f44a78cffef7532d486fa976bc00072df6b6b3b69365/albus_sdk-0.8.0-py3-none-any.whl", hash = "sha256:1226da9d23f3530e060a0081ce5e1d7de1f023e2b9e2056b66784757996a028c", size = 95910, upload-time = "2026-08-12T22:08:57.18Z" },
+    { url = "https://files.pythonhosted.org/packages/da/20/13f398123fd17d653b84b1160409378302a9fa8f0c6600719d7cc782ef6d/albus_sdk-0.9.0-py3-none-any.whl", hash = "sha256:cc7736e37b03562263e620293e67286c2c58ee470067440c274437e1104e0581", size = 98238, upload-time = "2026-08-14T15:24:57.15Z" },
 ]
 
 [[package]]