alloy-runtime-cli 0.1.0__py3-none-any.whl

cli/commands/billing/costs/by_model/presenter.py

@@ -0,0 +1,80 @@
+"""Presenter for billing project costs by model command output."""
+
+from decimal import Decimal
+
+from alloy_runtime_types.dtos.billing import ProjectCostByModel
+
+from cli.infrastructure.output import OutputService
+from cli.infrastructure.renderers.list_renderer import ColumnConfig
+
+
+def _format_cost(cost: Decimal | None) -> str:
+    """Format cost for display."""
+    if cost is None:
+        return "-"
+    return f"${cost:.4f}"
+
+
+def present_billing_costs_by_model(entries: list[ProjectCostByModel]) -> None:
+    """Present billing project cost breakdown by model."""
+    output = OutputService.get()
+
+    if not entries:
+        output.info("No cost data by model found")
+        return
+
+    columns = [
+        ColumnConfig(
+            source_field="provider_key",
+            header_label="Provider",
+            compact_line=1,
+            compact_style="cyan",
+        ),
+        ColumnConfig(
+            source_field="model_name",
+            header_label="Model",
+            compact_line=1,
+            compact_style="green",
+        ),
+        ColumnConfig(
+            source_field="execution_count",
+            header_label="Executions",
+            formatter=str,
+            compact_line=1,
+            compact_style="white",
+        ),
+        ColumnConfig(
+            source_field="total_tokens",
+            header_label="Total Tokens",
+            formatter=lambda x: f"{x:,}",
+            compact_line=2,
+            compact_style="dim",
+        ),
+        ColumnConfig(
+            source_field="llm_cost_usd",
+            header_label="LLM Cost",
+            formatter=_format_cost,
+            compact_line=2,
+            compact_style="dim",
+        ),
+        ColumnConfig(
+            source_field="rag_cost_usd",
+            header_label="RAG Cost",
+            formatter=_format_cost,
+            compact_line=2,
+            compact_style="dim",
+        ),
+        ColumnConfig(
+            source_field="total_cost_usd",
+            header_label="Total Cost",
+            formatter=_format_cost,
+            compact_line=1,
+            compact_style="green bold",
+        ),
+    ]
+
+    output.table(
+        items=entries,  # type: ignore[arg-type]
+        title=f"Costs by Model ({len(entries)} models)",
+        columns=columns,
+    )

cli/commands/billing/costs/daily/__init__.py

@@ -0,0 +1 @@
+# Empty per project convention - import directly from submodules

cli/commands/billing/costs/daily/command.py

@@ -0,0 +1,55 @@
+"""Billing project daily costs command implementation."""
+
+from uuid import UUID
+
+import typer
+
+from cli.commands.billing.costs.daily.presenter import present_billing_daily_costs
+from cli.commands.flag_utils import validate_uuid
+from cli.infrastructure.command import async_command, authenticated_client
+
+
+def billing_costs_daily_command(
+    project_id: str = typer.Argument(
+        ...,
+        help="Billing project UUID",
+    ),
+    start_date: str = typer.Option(
+        ...,
+        "--from",
+        help="Start date (ISO 8601, required)",
+    ),
+    end_date: str = typer.Option(
+        ...,
+        "--to",
+        help="End date (ISO 8601, required)",
+    ),
+) -> None:
+    """Get daily cost breakdown for a billing project.
+
+    Examples:
+        ai billing costs daily 123e4567-89ab... --from 2026-01-01 --to 2026-01-31
+    """
+    project_uuid = validate_uuid(project_id, "billing project")
+    _execute_daily_costs(
+        project_id=project_uuid,
+        start_date=start_date,
+        end_date=end_date,
+    )
+
+
+@async_command
+async def _execute_daily_costs(
+    project_id: UUID,
+    start_date: str,
+    end_date: str,
+) -> None:
+    """Execute get billing project daily costs operation."""
+    async with authenticated_client() as (_config, client):
+        response = await client.get_billing_project_costs_daily(
+            project_id,
+            start_date=start_date,
+            end_date=end_date,
+        )
+
+    present_billing_daily_costs(response)

cli/commands/billing/costs/daily/presenter.py

@@ -0,0 +1,75 @@
+"""Presenter for billing project daily costs command output."""
+
+from decimal import Decimal
+
+from alloy_runtime_types.dtos.billing import ProjectDailyCostEntry
+
+from cli.infrastructure.output import OutputService
+from cli.infrastructure.renderers.list_renderer import ColumnConfig
+
+
+def _format_cost(cost: Decimal | None) -> str:
+    """Format cost for display."""
+    if cost is None:
+        return "-"
+    return f"${cost:.4f}"
+
+
+def present_billing_daily_costs(entries: list[ProjectDailyCostEntry]) -> None:
+    """Present billing project daily cost breakdown."""
+    output = OutputService.get()
+
+    if not entries:
+        output.info("No daily cost data found for the specified period")
+        return
+
+    columns = [
+        ColumnConfig(
+            source_field="date",
+            header_label="Date",
+            formatter=lambda x: str(x),
+            compact_line=1,
+            compact_style="cyan",
+        ),
+        ColumnConfig(
+            source_field="execution_count",
+            header_label="Executions",
+            formatter=str,
+            compact_line=1,
+            compact_style="white",
+        ),
+        ColumnConfig(
+            source_field="llm_cost_usd",
+            header_label="LLM Cost",
+            formatter=_format_cost,
+            compact_line=2,
+            compact_style="dim",
+        ),
+        ColumnConfig(
+            source_field="rag_cost_usd",
+            header_label="RAG Cost",
+            formatter=_format_cost,
+            compact_line=2,
+            compact_style="dim",
+        ),
+        ColumnConfig(
+            source_field="total_cost_usd",
+            header_label="Total Cost",
+            formatter=_format_cost,
+            compact_line=1,
+            compact_style="green bold",
+        ),
+        ColumnConfig(
+            source_field="avg_cost_usd",
+            header_label="Avg Cost",
+            formatter=_format_cost,
+            compact_line=2,
+            compact_style="dim",
+        ),
+    ]
+
+    output.table(
+        items=entries,  # type: ignore[arg-type]
+        title=f"Daily Costs ({len(entries)} days)",
+        columns=columns,
+    )

cli/commands/billing/costs/summary/__init__.py

@@ -0,0 +1 @@
+# Empty per project convention - import directly from submodules

cli/commands/billing/costs/summary/command.py

@@ -0,0 +1,57 @@
+"""Billing project cost summary command implementation."""
+
+from typing import Optional
+from uuid import UUID
+
+import typer
+
+from cli.commands.billing.costs.summary.presenter import present_billing_cost_summary
+from cli.commands.flag_utils import validate_uuid
+from cli.infrastructure.command import async_command, authenticated_client
+
+
+def billing_costs_summary_command(
+    project_id: str = typer.Argument(
+        ...,
+        help="Billing project UUID",
+    ),
+    start_date: Optional[str] = typer.Option(
+        None,
+        "--from",
+        help="Start date (ISO 8601, defaults to 30 days ago)",
+    ),
+    end_date: Optional[str] = typer.Option(
+        None,
+        "--to",
+        help="End date (ISO 8601, defaults to now)",
+    ),
+) -> None:
+    """Get cost summary for a billing project.
+
+    Examples:
+        ai billing costs summary 123e4567-89ab...
+        ai billing costs summary 123e4567-89ab... --from 2026-01-01 --to 2026-01-31
+    """
+    project_uuid = validate_uuid(project_id, "billing project")
+    _execute_cost_summary(
+        project_id=project_uuid,
+        start_date=start_date,
+        end_date=end_date,
+    )
+
+
+@async_command
+async def _execute_cost_summary(
+    project_id: UUID,
+    start_date: Optional[str],
+    end_date: Optional[str],
+) -> None:
+    """Execute get billing project costs operation."""
+    async with authenticated_client() as (_config, client):
+        response = await client.get_billing_project_costs(
+            project_id,
+            start_date=start_date,
+            end_date=end_date,
+        )
+
+    present_billing_cost_summary(response)

cli/commands/billing/costs/summary/presenter.py

@@ -0,0 +1,42 @@
+"""Presenter for billing project cost summary command output."""
+
+from decimal import Decimal
+
+from alloy_runtime_types.dtos.billing import ProjectCostSummary
+
+from cli.infrastructure.output import OutputService
+from cli.infrastructure.renderers.entity_renderer import FieldConfig
+
+
+def _format_cost(cost: Decimal | None) -> str:
+    """Format cost for display."""
+    if cost is None:
+        return "-"
+    return f"${cost:.4f}"
+
+
+def _format_period(response: ProjectCostSummary) -> str:
+    """Format period dates for display."""
+    return f"{response.period_start.strftime('%Y-%m-%d')} to {response.period_end.strftime('%Y-%m-%d')}"
+
+
+def present_billing_cost_summary(response: ProjectCostSummary) -> None:
+    """Present billing project cost summary."""
+    output = OutputService.get()
+
+    fields = [
+        FieldConfig("project_id", "Project ID", str),
+        FieldConfig("project_name", "Project Name"),
+        FieldConfig("period", "Period", lambda _: _format_period(response)),
+        FieldConfig("execution_count", "Total Executions", str),
+        FieldConfig("completed_count", "Completed", str),
+        FieldConfig("failed_count", "Failed", str),
+        FieldConfig("llm_cost_usd", "LLM Cost", _format_cost),
+        FieldConfig("rag_cost_usd", "RAG Cost", _format_cost),
+        FieldConfig("total_cost_usd", "Total Cost", _format_cost),
+        FieldConfig("avg_cost_usd", "Avg Cost", _format_cost),
+        FieldConfig("min_cost_usd", "Min Cost", _format_cost),
+        FieldConfig("max_cost_usd", "Max Cost", _format_cost),
+    ]
+
+    output.entity(response, "Billing Project Cost Summary", fields)

cli/commands/billing/projects/__init__.py

@@ -0,0 +1 @@
+# Empty per project convention - import directly from submodules

cli/commands/billing/projects/create/__init__.py

@@ -0,0 +1 @@
+# Empty per project convention - import directly from submodules

cli/commands/billing/projects/create/command.py

@@ -0,0 +1,60 @@
+"""Billing project create command implementation."""
+
+from typing import Optional
+
+import typer
+
+from cli.commands.billing.projects.create.presenter import (
+    present_billing_project_created,
+)
+from cli.infrastructure.command import async_command, authenticated_client
+
+from alloy_runtime_types.dtos.billing import CreateProjectRequest
+
+
+def billing_projects_create_command(
+    name: str = typer.Option(
+        ...,
+        "--name",
+        help="Project name (unique per organization)",
+    ),
+    description: Optional[str] = typer.Option(
+        None,
+        "--description",
+        help="Optional project description",
+    ),
+    external_reference: Optional[str] = typer.Option(
+        None,
+        "--external-reference",
+        help="External billing system identifier",
+    ),
+) -> None:
+    """Create a new billing project.
+
+    Examples:
+        ai billing projects create --name "Q1 Campaign"
+        ai billing projects create --name "Q1 Campaign" --description "Marketing costs"
+    """
+    _execute_create(
+        name=name,
+        description=description,
+        external_reference=external_reference,
+    )
+
+
+@async_command
+async def _execute_create(
+    name: str,
+    description: Optional[str],
+    external_reference: Optional[str],
+) -> None:
+    """Execute create billing project operation."""
+    async with authenticated_client() as (_config, client):
+        request = CreateProjectRequest(
+            name=name,
+            description=description,
+            external_reference=external_reference,
+        )
+        response = await client.create_billing_project(request)
+
+    present_billing_project_created(response)

cli/commands/billing/projects/create/presenter.py

@@ -0,0 +1,26 @@
+"""Presenter for billing project create command output."""
+
+from alloy_runtime_types.dtos.billing import CreateProjectResponse
+
+from cli.infrastructure.output import OutputService
+from cli.infrastructure.renderers.entity_renderer import FieldConfig
+
+
+def present_billing_project_created(response: CreateProjectResponse) -> None:
+    """Present created billing project details."""
+    output = OutputService.get()
+
+    fields = [
+        FieldConfig("id", "ID", str),
+        FieldConfig("name", "Name"),
+        FieldConfig("description", "Description", lambda x: x or "-"),
+        FieldConfig("external_reference", "External Reference", lambda x: x or "-"),
+        FieldConfig("is_active", "Active", lambda x: "Yes" if x else "No"),
+        FieldConfig(
+            "created_at",
+            "Created At",
+            lambda x: x.strftime("%Y-%m-%d %H:%M:%S") if x else "-",
+        ),
+    ]
+
+    output.entity(response, "Billing Project Created", fields)

cli/commands/billing/projects/get/__init__.py

@@ -0,0 +1 @@
+# Empty per project convention - import directly from submodules

cli/commands/billing/projects/get/command.py

@@ -0,0 +1,33 @@
+"""Billing project get command implementation."""
+
+from uuid import UUID
+
+import typer
+
+from cli.commands.billing.projects.get.presenter import present_billing_project
+from cli.commands.flag_utils import validate_uuid
+from cli.infrastructure.command import async_command, authenticated_client
+
+
+def billing_projects_get_command(
+    project_id: str = typer.Argument(
+        ...,
+        help="Billing project UUID",
+    ),
+) -> None:
+    """Get details of a billing project.
+
+    Examples:
+        ai billing projects get 123e4567-89ab-cdef-0123-456789abcdef
+    """
+    project_uuid = validate_uuid(project_id, "billing project")
+    _execute_get(project_id=project_uuid)
+
+
+@async_command
+async def _execute_get(project_id: UUID) -> None:
+    """Execute get billing project operation."""
+    async with authenticated_client() as (_config, client):
+        response = await client.get_billing_project(project_id)
+
+    present_billing_project(response)

cli/commands/billing/projects/get/presenter.py

@@ -0,0 +1,32 @@
+"""Presenter for billing project get command output."""
+
+from alloy_runtime_types.dtos.billing import ProjectResponse
+
+from cli.infrastructure.output import OutputService
+from cli.infrastructure.renderers.entity_renderer import FieldConfig
+
+
+def present_billing_project(response: ProjectResponse) -> None:
+    """Present billing project details."""
+    output = OutputService.get()
+
+    fields = [
+        FieldConfig("id", "ID", str),
+        FieldConfig("organization_id", "Organization ID", str),
+        FieldConfig("name", "Name"),
+        FieldConfig("description", "Description", lambda x: x or "-"),
+        FieldConfig("external_reference", "External Reference", lambda x: x or "-"),
+        FieldConfig("is_active", "Active", lambda x: "Yes" if x else "No"),
+        FieldConfig(
+            "created_at",
+            "Created At",
+            lambda x: x.strftime("%Y-%m-%d %H:%M:%S") if x else "-",
+        ),
+        FieldConfig(
+            "updated_at",
+            "Updated At",
+            lambda x: x.strftime("%Y-%m-%d %H:%M:%S") if x else "-",
+        ),
+    ]
+
+    output.entity(response, "Billing Project", fields)

cli/commands/billing/projects/list/__init__.py

@@ -0,0 +1 @@
+# Empty per project convention - import directly from submodules

cli/commands/billing/projects/list/command.py

@@ -0,0 +1,40 @@
+"""Billing projects list command implementation."""
+
+import typer
+
+from cli.commands.billing.projects.list.presenter import present_billing_projects_list
+from cli.infrastructure.command import async_command, authenticated_client
+
+
+def billing_projects_list_command(
+    limit: int = typer.Option(
+        50,
+        "-l",
+        "--limit",
+        min=1,
+        max=100,
+        help="Max results",
+    ),
+    offset: int = typer.Option(
+        0,
+        "--offset",
+        min=0,
+        help="Skip N results",
+    ),
+) -> None:
+    """List billing projects in your organization.
+
+    Examples:
+        ai billing projects list
+        ai billing projects list -l 10
+    """
+    _execute_list(limit=limit, offset=offset)
+
+
+@async_command
+async def _execute_list(limit: int, offset: int) -> None:
+    """Execute list billing projects operation."""
+    async with authenticated_client() as (_config, client):
+        response = await client.list_billing_projects()
+
+    present_billing_projects_list(response)

cli/commands/billing/projects/list/presenter.py

@@ -0,0 +1,57 @@
+"""Presenter for billing projects list command output."""
+
+from alloy_runtime_types.dtos.billing import ProjectListResponse
+
+from cli.infrastructure.output import OutputService
+from cli.infrastructure.renderers.list_renderer import ColumnConfig
+
+
+def present_billing_projects_list(response: ProjectListResponse) -> None:
+    """Present list of billing projects."""
+    output = OutputService.get()
+
+    if not response.projects:
+        output.info("No billing projects found")
+        return
+
+    columns = [
+        ColumnConfig(
+            source_field="id",
+            header_label="ID",
+            compact_line=1,
+            compact_style="cyan",
+        ),
+        ColumnConfig(
+            source_field="name",
+            header_label="Name",
+            compact_line=1,
+            compact_style="green",
+        ),
+        ColumnConfig(
+            source_field="description",
+            header_label="Description",
+            formatter=lambda x: x[:60] + "..." if x and len(x) > 60 else (x or "-"),
+            compact_line=2,
+            compact_style="dim",
+        ),
+        ColumnConfig(
+            source_field="external_reference",
+            header_label="External Ref",
+            formatter=lambda x: x or "-",
+            compact_line=2,
+            compact_style="dim",
+        ),
+        ColumnConfig(
+            source_field="is_active",
+            header_label="Active",
+            formatter=lambda x: "Yes" if x else "No",
+            compact_line=1,
+            compact_style="white bold",
+        ),
+    ]
+
+    output.table(
+        items=response.projects,  # type: ignore[arg-type]
+        title=f"Billing Projects ({response.total})",
+        columns=columns,
+    )

cli/commands/content/__init__.py

@@ -0,0 +1 @@
+

cli/commands/content/delete/command.py

@@ -0,0 +1,49 @@
+"""Content delete command implementation."""
+
+from uuid import UUID
+
+import typer
+
+from cli.commands.flag_utils import validate_uuid
+from cli.commands.content.delete.presenter import present_delete_result
+from cli.infrastructure.command import async_command, authenticated_client
+from cli.infrastructure.console import Confirm
+
+
+def content_delete_command(
+    content_part_id: str = typer.Argument(
+        ...,
+        help="Content part UUID",
+    ),
+    yes: bool = typer.Option(
+        False,
+        "-y",
+        "--yes",
+        help="Skip confirmation",
+    ),
+) -> None:
+    """Delete a content part.
+
+    Examples:
+        ai content delete 019405e0-e000-7000-f100-000000000001
+        ai content delete <id> -y
+    """
+    content_uuid = validate_uuid(content_part_id, "content")
+    _execute_delete(content_part_id=content_uuid, skip_confirm=yes)
+
+
+@async_command
+async def _execute_delete(content_part_id: UUID, skip_confirm: bool) -> None:
+    """Execute delete content part operation."""
+    if not skip_confirm:
+        short_id = str(content_part_id)[:8]
+        confirmed = Confirm.ask(
+            f"[yellow]Delete content part '{short_id}...'?[/yellow] This cannot be undone"
+        )
+        if not confirmed:
+            raise typer.Abort()
+
+    async with authenticated_client() as (_config, client):
+        response = await client.delete_content_part(content_part_id)
+
+    present_delete_result(response)

cli/commands/content/delete/presenter.py

@@ -0,0 +1,18 @@
+"""Presenter for content delete command output."""
+
+from cli.infrastructure.output import OutputService
+from alloy_runtime_types.dtos.content import DeleteContentPartResponse
+
+
+def present_delete_result(response: DeleteContentPartResponse) -> None:
+    """Present content part deletion result.
+
+    Args:
+        response: DeleteContentPartResponse from server
+    """
+    output = OutputService.get()
+    deleted = response.deleted_content_part
+
+    # Use short UUID for display (first 8 chars)
+    short_id = str(deleted.id)[:8]
+    output.success(f"Content part '{short_id}...' deleted successfully")

cli/commands/content/edit/__init__.py

@@ -0,0 +1 @@
+