cometapi-cli 0.2.1__tar.gz → 0.2.2__tar.gz

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/AGENTS.md

@@ -201,13 +201,13 @@ These options apply to **every** command via the root Typer callback.
 
 | Parameter | Alias | Type | Default | Description |
 |-----------|-------|------|---------|-------------|
-| `--source` | `-s` | `str` (`account` or `token`) | `None` (auto-detect) | Force data source: `account` = full account balance via `/api/user/self`; `token` = per-API-key billing via `/v1/dashboard/billing/*` |
+| `--source` | `-s` | `str` (`account` or `key`) | `None` (auto-detect) | Force data source: `account` = full account balance via `/api/user/self`; `key` = per-API-key billing via `/v1/dashboard/billing/*` |
 | `--format` | `-f` | `OutputFormat` | inherits global | Per-command output format override |
 | `--json` | — | flag | `false` | Output raw balance dict as JSON |
 
 **Auto-detection logic** (when `--source` is omitted):
 1. If `COMETAPI_ACCESS_TOKEN` is available → uses `account` source.
-2. Otherwise → falls back to `token` (per-key billing) source.
+2. Otherwise → falls back to `key` (per-key billing) source.
 
 **Display — `account` source:**
 | Field | Description |
@@ -216,7 +216,7 @@ These options apply to **every** command via the root Typer callback.
 | Used | Total amount consumed (USD) |
 | Total Topped Up | Lifetime top-up amount (USD) |
 
-**Display — `token` (billing) source:**
+**Display — `key` (billing) source:**
 | Field | Description |
 |-------|-------------|
 | Limit | Spending cap (`Unlimited` if no cap set) |

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] — 2026-04-14
+
+### Changed
+
+- `balance --source` now uses `key` for the API-key billing view so the CLI terminology matches `api_key` and `access_token`.
+- `balance --source token` is still accepted as a compatibility alias and is normalized to the same API-key billing behavior.
+
 ## [0.2.1] — 2026-04-14
 
 ### Changed

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cometapi-cli
-Version: 0.2.1
+Version: 0.2.2
 Summary: CometAPI CLI — official command-line interface for the CometAPI AI gateway
 Project-URL: Homepage, https://github.com/cometapi-dev/cometapi-cli
 Project-URL: Repository, https://github.com/cometapi-dev/cometapi-cli

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/docs/authentication.md

@@ -9,7 +9,7 @@ Used for **AI relay endpoints** — the core API functionality:
 - `chat` — chat completions
 - `models` — list available models
 - `doctor` — connectivity check
-- `balance` — per-token billing stats (fallback mode)
+- `balance` — per-key billing stats (fallback mode)
 
 **How to get one**: [https://www.cometapi.com/console/token](https://www.cometapi.com/console/token)
 

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/docs/commands/balance.md

@@ -10,7 +10,7 @@ cometapi balance [OPTIONS]
 
 | Option | Alias | Type | Default | Description |
 |--------|-------|------|---------|-------------|
-| `--source` | `-s` | string | — | Data source: `account` (full account) or `token` (current API key) |
+| `--source` | `-s` | string | — | Data source: `account` (full account) or `key` (current API key) |
 | `--format` | `-f` | choice | `table` | Output format: `table`, `json`, `yaml`, `csv`, `markdown` |
 | `--json` | — | flag | `false` | Output as JSON |
 | `--help` | `-h` | flag | — | Show help |
@@ -21,7 +21,7 @@ Requires `COMETAPI_KEY`. Access token is optional but provides richer data.
 
 ## Behavior
 
-By default, the command shows account-level balance if an access token is available, falling back to per-token billing stats from the API key. Use `--source` to force a specific view.
+By default, the command shows account-level balance if an access token is available, falling back to per-key billing stats from the API key. Use `--source` to force a specific view.
 
 ### Source: `account` (access token required)
 
@@ -33,9 +33,9 @@ Shows full account balance:
 | `used` | Total amount consumed in USD |
 | `total_topped_up` | Total amount added to the account in USD |
 
-### Source: `token` (API key only)
+### Source: `key` (API key only)
 
-Shows per-token billing stats:
+Shows per-key billing stats:
 
 | Field | Description |
 |-------|-------------|
@@ -59,8 +59,8 @@ cometapi balance
 # Force account-level balance
 cometapi balance --source account
 
-# Force per-token billing stats
-cometapi balance --source token
+# Force per-key billing stats
+cometapi balance --source key
 
 # JSON output for scripting
 cometapi balance --json

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cometapi-cli"
-version = "0.2.1"
+version = "0.2.2"
 description = "CometAPI CLI — official command-line interface for the CometAPI AI gateway"
 readme = "README.md"
 license = { text = "MIT" }

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/skills/live-test/SKILL.md

@@ -134,14 +134,14 @@ uv run cometapi models --format yaml --limit 3
 
 ```bash
 uv run cometapi balance
-uv run cometapi balance --source token
+uv run cometapi balance --source key
 uv run cometapi balance --source account
 uv run cometapi balance --json
 ```
 
 **Verify:**
 - Default: shows "Available Balance", "Used", "Total Topped Up" (account source, if access token available).
-- `--source token`: shows "Limit" (may be "Unlimited") and "Used".
+- `--source key`: shows "Limit" (may be "Unlimited") and "Used".
 - `--source account`: same as default account view.
 - `--json`: outputs valid JSON with `balance`, `used`, `total_topped_up`, `source` fields.
 
@@ -330,7 +330,7 @@ uv run cometapi --version
 uv run cometapi -h
 uv run cometapi models --limit 3 --json
 uv run cometapi balance
-uv run cometapi balance --source token
+uv run cometapi balance --source key
 uv run cometapi chat "ping" --json
 uv run cometapi account --json
 uv run cometapi tokens --limit 3 --json

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/src/cometapi_cli/__init__.py

@@ -1,3 +1,3 @@
 """CometAPI CLI — professional terminal interface for CometAPI."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/src/cometapi_cli/commands/balance.py

@@ -7,28 +7,50 @@ from typing import Annotated
 import typer
 
 from ..config import get_client
+from ..console import err_console
 from ..errors import handle_errors
 from ..formatters import OutputFormat, output, resolve_format
 
+BALANCE_SOURCE_ALIASES = {
+    "account": "account",
+    "key": "key",
+    "token": "key",
+}
+
+
+def _normalize_balance_source(source: str | None) -> str | None:
+    if source is None:
+        return None
+
+    normalized = BALANCE_SOURCE_ALIASES.get(source.lower())
+    if normalized is not None:
+        return normalized
+
+    err_console.print(f"[red]Invalid source:[/] {source}. Valid sources: account, key")
+    raise typer.Exit(code=2)
+
 
 @handle_errors
 def balance(
     ctx: typer.Context,
     source: Annotated[
         str | None,
-        typer.Option("--source", "-s", help="Data source: 'account' (full account) or 'token' (current API key)."),
+        typer.Option("--source", "-s", help="Data source: 'account' (full account) or 'key' (current API key)."),
+    ] = None,
+    output_format: Annotated[
+        OutputFormat | None,
+        typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown)."),
     ] = None,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Show your CometAPI account balance.
 
     By default shows account-level balance (requires access token), falling back
-    to per-token billing stats. Use --source to force a specific view.
+    to per-key billing stats. Use --source to force a specific view.
     """
     fmt = resolve_format(ctx, json_output, output_format)
     client = get_client()
-    raw = client.get_balance(source=source)
+    raw = client.get_balance(source=_normalize_balance_source(source))
 
     # For JSON output, pass raw data for maximum information
     if fmt == OutputFormat.JSON:

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/tests/test_balance.py

@@ -22,8 +22,8 @@ def test_balance_table(cli_runner, patched_client):
     assert "$3,305.90" in result.output
 
 
-def test_balance_source_token(cli_runner, patched_client):
-    """Test --source token shows billing view."""
+def test_balance_source_key(cli_runner, patched_client):
+    """Test --source key shows billing view."""
     patched_client.get_balance.return_value = {
         "balance": -1,
         "used": 280.05,
@@ -31,11 +31,18 @@ def test_balance_source_token(cli_runner, patched_client):
         "currency": "USD",
         "source": "billing",
     }
-    result = cli_runner("balance", "--source", "token")
+    result = cli_runner("balance", "--source", "key")
     assert result.exit_code == 0
     assert "Unlimited" in result.output
     assert "$280.05" in result.output
-    patched_client.get_balance.assert_called_with(source="token")
+    patched_client.get_balance.assert_called_with(source="key")
+
+
+def test_balance_source_token_alias(cli_runner, patched_client):
+    """Test deprecated --source token still maps to API-key billing view."""
+    result = cli_runner("balance", "--source", "token")
+    assert result.exit_code == 0
+    patched_client.get_balance.assert_called_with(source="key")
 
 
 def test_balance_source_account(cli_runner, patched_client):
@@ -50,4 +57,14 @@ def test_balance_help(cli_runner):
     result = cli_runner("balance", "-h")
     assert result.exit_code == 0
     assert "--source" in result.output
+    assert "Data source:" in result.output
+    assert "'key'" in result.output
+    assert "API key" in result.output
+    assert "'token'" not in result.output
     assert "--json" in result.output
+
+
+def test_balance_source_invalid(cli_runner):
+    result = cli_runner("balance", "--source", "billing")
+    assert result.exit_code == 2
+    assert "Valid sources: account, key" in result.output

{cometapi_cli-0.2.1 → cometapi_cli-0.2.2}/uv.lock

@@ -66,7 +66,7 @@ wheels = [
 
 [[package]]
 name = "cometapi-cli"
-version = "0.2.1"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "openai" },