alloy-runtime-cli 0.2.66__tar.gz → 0.2.68__tar.gz

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alloy-runtime-cli
-Version: 0.2.66
+Version: 0.2.68
 Summary: Alloy Runtime CLI - Command-line interface for Alloy Runtime server
 Keywords: alloy,cli,python,terminal,workflow
 Classifier: Development Status :: 3 - Alpha
@@ -16,8 +16,8 @@ Requires-Dist: textual==8.2.3
 Requires-Dist: genson==1.3.0
 Requires-Dist: pyperclip==1.11.0
 Requires-Dist: prompt-toolkit==3.0.52
-Requires-Dist: alloy-runtime-sdk==0.2.66
-Requires-Dist: alloy-runtime-types==0.2.66
+Requires-Dist: alloy-runtime-sdk==0.2.68
+Requires-Dist: alloy-runtime-types==0.2.68
 Requires-Dist: trogon==0.6.0
 
 # alloy-runtime-cli
@@ -76,7 +76,7 @@ alloy executions get <execution_id>
 alloy executions get <execution_id> --watch
 ```
 
-`alloy executions get` uses a dedicated transcript view for human output: one metadata header followed by full chronological reasoning, tool-call, tool-output, and assistant blocks. `--watch` appends only newly observed activity blocks while the execution is still running.
+`alloy executions get` uses a dedicated transcript view for human output: one metadata header followed by full chronological reasoning, tool-call, tool-output, and assistant blocks. `--watch` appends only newly observed activity blocks while the execution is still running and waits indefinitely unless you pass `--timeout <seconds>`.
 
 `alloy ping` is the authenticated connectivity check. It confirms who you are, which host you reached, and which server build answered the request.
 
@@ -92,6 +92,7 @@ alloy templates validate --content "Hello {{ name }}" --var name=World
 ```
 
 Use `templates validate` for local drafts and CI-style checks. Use `templates create` or `templates update` when you want to persist the template after it passes validation.
+The command prints validation details either way and exits non-zero when the template is not renderable with the supplied variables.
 
 ## Configuration
 

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/README.md

@@ -54,7 +54,7 @@ alloy executions get <execution_id>
 alloy executions get <execution_id> --watch
 ```
 
-`alloy executions get` uses a dedicated transcript view for human output: one metadata header followed by full chronological reasoning, tool-call, tool-output, and assistant blocks. `--watch` appends only newly observed activity blocks while the execution is still running.
+`alloy executions get` uses a dedicated transcript view for human output: one metadata header followed by full chronological reasoning, tool-call, tool-output, and assistant blocks. `--watch` appends only newly observed activity blocks while the execution is still running and waits indefinitely unless you pass `--timeout <seconds>`.
 
 `alloy ping` is the authenticated connectivity check. It confirms who you are, which host you reached, and which server build answered the request.
 
@@ -70,6 +70,7 @@ alloy templates validate --content "Hello {{ name }}" --var name=World
 ```
 
 Use `templates validate` for local drafts and CI-style checks. Use `templates create` or `templates update` when you want to persist the template after it passes validation.
+The command prints validation details either way and exits non-zero when the template is not renderable with the supplied variables.
 
 ## Configuration
 

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/alloy_runtime_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alloy-runtime-cli
-Version: 0.2.66
+Version: 0.2.68
 Summary: Alloy Runtime CLI - Command-line interface for Alloy Runtime server
 Keywords: alloy,cli,python,terminal,workflow
 Classifier: Development Status :: 3 - Alpha
@@ -16,8 +16,8 @@ Requires-Dist: textual==8.2.3
 Requires-Dist: genson==1.3.0
 Requires-Dist: pyperclip==1.11.0
 Requires-Dist: prompt-toolkit==3.0.52
-Requires-Dist: alloy-runtime-sdk==0.2.66
-Requires-Dist: alloy-runtime-types==0.2.66
+Requires-Dist: alloy-runtime-sdk==0.2.68
+Requires-Dist: alloy-runtime-types==0.2.68
 Requires-Dist: trogon==0.6.0
 
 # alloy-runtime-cli
@@ -76,7 +76,7 @@ alloy executions get <execution_id>
 alloy executions get <execution_id> --watch
 ```
 
-`alloy executions get` uses a dedicated transcript view for human output: one metadata header followed by full chronological reasoning, tool-call, tool-output, and assistant blocks. `--watch` appends only newly observed activity blocks while the execution is still running.
+`alloy executions get` uses a dedicated transcript view for human output: one metadata header followed by full chronological reasoning, tool-call, tool-output, and assistant blocks. `--watch` appends only newly observed activity blocks while the execution is still running and waits indefinitely unless you pass `--timeout <seconds>`.
 
 `alloy ping` is the authenticated connectivity check. It confirms who you are, which host you reached, and which server build answered the request.
 
@@ -92,6 +92,7 @@ alloy templates validate --content "Hello {{ name }}" --var name=World
 ```
 
 Use `templates validate` for local drafts and CI-style checks. Use `templates create` or `templates update` when you want to persist the template after it passes validation.
+The command prints validation details either way and exits non-zero when the template is not renderable with the supplied variables.
 
 ## Configuration
 

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/alloy_runtime_cli.egg-info/SOURCES.txt

@@ -154,6 +154,11 @@ cli/commands/knowledge/documents/bulk_metadata/command.py
 cli/commands/knowledge/documents/bulk_metadata/presenter.py
 cli/commands/knowledge/documents/bulk_reingest_failed/command.py
 cli/commands/knowledge/documents/bulk_reingest_failed/presenter.py
+cli/commands/knowledge/documents/bulk_reingest_failed_status/command.py
+cli/commands/knowledge/documents/bulk_reingest_failed_status/presenter.py
+cli/commands/knowledge/documents/count/__init__.py
+cli/commands/knowledge/documents/count/command.py
+cli/commands/knowledge/documents/count/presenter.py
 cli/commands/knowledge/documents/delete/__init__.py
 cli/commands/knowledge/documents/delete/command.py
 cli/commands/knowledge/documents/delete/presenter.py

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/alloy_runtime_cli.egg-info/requires.txt

@@ -4,6 +4,6 @@ textual==8.2.3
 genson==1.3.0
 pyperclip==1.11.0
 prompt-toolkit==3.0.52
-alloy-runtime-sdk==0.2.66
-alloy-runtime-types==0.2.66
+alloy-runtime-sdk==0.2.68
+alloy-runtime-types==0.2.68
 trogon==0.6.0

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/cli/commands/admin/credentials/create/command.py

@@ -130,7 +130,7 @@ async def _execute_create(
     request = CreateSystemCredentialRequest(
         credential_type_id=credential_type_id,
         name=name,
-        plaintext_value=plaintext_value,
+        secret=plaintext_value,
         provider_key=provider_enum,
         description=description,
         priority=priority,

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/cli/commands/credentials/create/command.py

@@ -1,5 +1,6 @@
 """Credentials create command implementation."""
 
+import json
 from datetime import datetime
 from typing import Any, Optional
 
@@ -150,8 +151,6 @@ async def _execute_create(
     # Parse configuration JSON if provided
     configuration_dict: Optional[dict[str, Any]] = None
     if configuration:
-        import json
-
         try:
             configuration_dict = json.loads(configuration)
             if not isinstance(configuration_dict, dict):
@@ -165,13 +164,13 @@ async def _execute_create(
     request = CreateOrganizationCredentialRequest(
         credential_type_id=credential_type_id,
         name=name,
-        plaintext_value=plaintext_value,
+        secret=plaintext_value,
         provider_key=provider_enum,
         service_key=service_enum,
         tool_id=tool_id,
         description=description,
         expires_at=expires_datetime,
-        configuration=configuration_dict,
+        provider_config=configuration_dict,
     )
 
     # Execute API call with authenticated client

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/cli/commands/credentials/update/command.py

@@ -44,7 +44,7 @@ async def _execute_update(
     request = UpdateCredentialRequest(
         name=name,
         description=description,
-        plain_text_api_key=value,
+        secret=value,
     )
 
     async with authenticated_client() as (_config, client):

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/cli/commands/executions/get/command.py

@@ -18,10 +18,10 @@ def executions_get_command(
     watch: bool = typer.Option(
         False, "--watch", help="Poll until execution reaches a terminal state"
     ),
-    timeout: float = typer.Option(
-        300.0,
+    timeout: float | None = typer.Option(
+        None,
         "--timeout",
-        help="Maximum seconds to wait when using --watch (default: 300)",
+        help="Maximum seconds to wait when using --watch (default: wait indefinitely)",
     ),
 ) -> None:
     _execute_get(
@@ -35,7 +35,7 @@ def executions_get_command(
 async def _execute_get(
     execution_id: UUID,
     watch: bool,
-    timeout: float,
+    timeout: float | None,
 ) -> None:
     async with authenticated_client() as (_config, client):
         if not watch:
@@ -44,16 +44,16 @@ async def _execute_get(
             return
 
         output = OutputService.get()
-        start_time = time.monotonic()
+        start_time = time.monotonic() if timeout is not None else None
         metadata_rendered = False
         rendered_count = 0
         output.progress(f"Watching execution {execution_id}...")
 
         if output.format == OutputFormat.JSON:
             last_response = await client.get_execution(execution_id)
-            while (
-                not last_response.is_terminal
-                and time.monotonic() - start_time < timeout
+            while not last_response.is_terminal and not _watch_timed_out(
+                start_time=start_time,
+                timeout=timeout,
             ):
                 await asyncio.sleep(_POLL_INTERVAL_SECONDS)
                 last_response = await client.get_execution(execution_id)
@@ -73,7 +73,15 @@ async def _execute_get(
             metadata_rendered = True
             if response.is_terminal:
                 return
-            if time.monotonic() - start_time >= timeout:
+            if _watch_timed_out(start_time=start_time, timeout=timeout):
                 output.progress(f"Watch timed out after {timeout:.0f}s.")
                 return
             await asyncio.sleep(_POLL_INTERVAL_SECONDS)
+
+
+def _watch_timed_out(start_time: float | None, timeout: float | None) -> bool:
+    if timeout is None:
+        return False
+    if start_time is None:
+        raise RuntimeError("watch timeout requires a start time")
+    return time.monotonic() - start_time >= timeout

alloy_runtime_cli-0.2.68/cli/commands/knowledge/documents/bulk_reingest_failed/presenter.py

@@ -0,0 +1,44 @@
+from cli.infrastructure.output import OutputService
+from alloy_runtime_types.dtos.knowledge import BulkReingestFailedDocumentsResponse
+
+
+def _follow_up_message(response: BulkReingestFailedDocumentsResponse) -> str | None:
+    if response.dry_run:
+        return None
+    if response.status == "accepted":
+        return f"Bulk reingest accepted. Poll status with: alloy knowledge documents reingest-failed-status {response.operation_id}"
+    if response.queued_count and response.queued_count > 0:
+        return "Bulk reingest queued. Watch worker queue depth until processing stabilizes."
+    if response.skipped_count and response.skipped_count > 0:
+        return "No documents were queued. Review skipped documents before retrying."
+    return "No failed documents matched the provided scope."
+
+
+def present_bulk_reingest_failed_result(
+    response: BulkReingestFailedDocumentsResponse,
+) -> None:
+    output = OutputService.get()
+    next_step = _follow_up_message(response)
+
+    extra_fields: dict[str, bool | str | int | None] = {
+        "Dry Run": response.dry_run,
+        "Message": response.message,
+        "Next Step": next_step,
+    }
+
+    if response.status == "accepted":
+        extra_fields["Status"] = response.status
+        extra_fields["Operation ID"] = str(response.operation_id)
+    else:
+        extra_fields["Matched"] = response.matched_count
+        extra_fields["Queued"] = response.queued_count
+        extra_fields["Skipped"] = response.skipped_count
+
+    output.result(
+        action="reingest",
+        resource="knowledge_documents",
+        status="dry_run" if response.dry_run else "success",
+        identifier=str(response.operation_id) if response.operation_id else None,
+        name=None,
+        extra_fields=extra_fields,
+    )

alloy_runtime_cli-0.2.68/cli/commands/knowledge/documents/bulk_reingest_failed_status/command.py

@@ -0,0 +1,33 @@
+import typer
+from uuid import UUID
+
+from cli.commands.knowledge.documents.bulk_reingest_failed_status.presenter import (
+    present_bulk_reingest_failed_status,
+)
+from cli.infrastructure.command import async_command, authenticated_client
+
+
+def _parse_operation_id(value: str) -> UUID:
+    try:
+        return UUID(value)
+    except ValueError as exc:
+        raise typer.BadParameter(f"Invalid operation UUID: {value}") from exc
+
+
+def knowledge_documents_bulk_reingest_failed_status_command(
+    operation_id: str = typer.Argument(
+        ...,
+        help="Operation UUID returned by reingest-failed submit",
+    ),
+) -> None:
+    _execute_bulk_reingest_failed_status(operation_id=operation_id)
+
+
+@async_command
+async def _execute_bulk_reingest_failed_status(operation_id: str) -> None:
+    async with authenticated_client() as (_config, client):
+        response = await client.get_bulk_reingest_failed_operation(
+            _parse_operation_id(operation_id)
+        )
+
+    present_bulk_reingest_failed_status(response)

alloy_runtime_cli-0.2.68/cli/commands/knowledge/documents/bulk_reingest_failed_status/presenter.py

@@ -0,0 +1,71 @@
+from typing import Iterable
+from uuid import UUID
+
+from cli.infrastructure.formatting.fields import (
+    format_datetime,
+    format_optional,
+    format_uuid,
+)
+from cli.infrastructure.output import OutputService
+from cli.infrastructure.renderers.entity_renderer import FieldConfig
+from alloy_runtime_types.dtos.knowledge import (
+    GetBulkReingestFailedDocumentsOperationResponse,
+)
+
+
+def _format_uuid_list(value: Iterable[UUID] | None) -> str:
+    if not value:
+        return "—"
+    return ", ".join(str(item) for item in value)
+
+
+def present_bulk_reingest_failed_status(
+    response: GetBulkReingestFailedDocumentsOperationResponse,
+) -> None:
+    output = OutputService.get()
+    output.entity(
+        response,
+        "Bulk Reingest Failed Status",
+        [
+            FieldConfig(
+                "operation_id",
+                "Operation ID",
+                lambda value: format_uuid(value, short=False),
+            ),
+            FieldConfig(
+                "collection_id",
+                "Collection ID",
+                lambda value: format_uuid(value, short=False),
+            ),
+            FieldConfig(
+                "requested_document_ids", "Requested Document IDs", _format_uuid_list
+            ),
+            FieldConfig("status", "Status"),
+            FieldConfig("matched_count", "Matched Count", str),
+            FieldConfig("queued_count", "Queued Count", str),
+            FieldConfig("skipped_count", "Skipped Count", str),
+            FieldConfig("dispatch_failed_count", "Dispatch Failed Count", str),
+            FieldConfig(
+                "matched_document_ids", "Matched Document IDs", _format_uuid_list
+            ),
+            FieldConfig(
+                "queued_document_ids", "Queued Document IDs", _format_uuid_list
+            ),
+            FieldConfig(
+                "skipped_document_ids", "Skipped Document IDs", _format_uuid_list
+            ),
+            FieldConfig(
+                "dispatch_failed_document_ids",
+                "Dispatch Failed Document IDs",
+                _format_uuid_list,
+            ),
+            FieldConfig("queued_at", "Queued At", format_datetime),
+            FieldConfig(
+                "processing_started_at", "Processing Started At", format_datetime
+            ),
+            FieldConfig("last_heartbeat_at", "Last Heartbeat At", format_datetime),
+            FieldConfig("completed_at", "Completed At", format_datetime),
+            FieldConfig("error_message", "Error", format_optional),
+        ],
+        raw_payload=response,
+    )

alloy_runtime_cli-0.2.68/cli/commands/knowledge/documents/count/command.py

@@ -0,0 +1,84 @@
+"""Knowledge documents count command implementation."""
+
+import json
+from typing import Annotated, cast
+
+import typer
+from alloy_runtime_types.dtos.knowledge import CountDocumentsRequest, ProcessingStatus
+from alloy_runtime_types.dtos.structured_filter import ConditionSpec, LogicalSpec
+from pydantic import TypeAdapter, ValidationError
+
+from cli.commands.knowledge.documents.count.presenter import present_documents_count
+from cli.infrastructure.command import async_command, authenticated_client
+from cli.infrastructure.file_content import resolve_content_or_raise
+
+
+def _parse_metadata_filter(value: str | None) -> ConditionSpec | LogicalSpec | None:
+    if value is None:
+        return None
+    resolved = (
+        typer.get_text_stream("stdin").read()
+        if value == "-"
+        else resolve_content_or_raise(value)
+    )
+    if resolved is None:
+        return None
+    try:
+        data = json.loads(resolved)
+    except json.JSONDecodeError as error:
+        typer.echo(f"Invalid JSON in --metadata-filter: {error}", err=True)
+        raise typer.Exit(code=2) from error
+    try:
+        return cast(
+            ConditionSpec | LogicalSpec,
+            TypeAdapter(ConditionSpec | LogicalSpec).validate_python(data),
+        )
+    except ValidationError as error:
+        typer.echo(f"Invalid metadata filter: {error}", err=True)
+        raise typer.Exit(code=2) from error
+
+
+def knowledge_documents_count_command(
+    collection: Annotated[
+        str | None,
+        typer.Option("-C", "--collection", help="Filter by collection ID or name"),
+    ] = None,
+    status_: Annotated[
+        str | None,
+        typer.Option(
+            "-s",
+            "--status",
+            help="Filter by status: queued|processing|completed|failed|duplicate|filtered",
+        ),
+    ] = None,
+    external_id: Annotated[
+        str | None, typer.Option("--external-id", help="Filter by external_id")
+    ] = None,
+    tag: Annotated[
+        str | None, typer.Option("--tag", help="Filter by ltree tag pattern")
+    ] = None,
+    metadata_filter: Annotated[
+        str | None,
+        typer.Option(
+            "--metadata-filter",
+            help="Structured metadata filter JSON. Inline JSON, @file.json, @- or - for stdin.",
+        ),
+    ] = None,
+    output_json: Annotated[bool, typer.Option("--json", help="Emit JSON")] = False,
+) -> None:
+    """Count documents matching combined filters."""
+    request = CountDocumentsRequest(
+        collection_id=collection,
+        processing_status=cast(ProcessingStatus | None, status_),
+        external_id=external_id,
+        tag_filter=tag,
+        metadata_filter=_parse_metadata_filter(metadata_filter),
+    )
+    _execute(request=request, output_json=output_json)
+
+
+@async_command
+async def _execute(*, request: CountDocumentsRequest, output_json: bool) -> None:
+    async with authenticated_client() as (_config, client):
+        response = await client.count_documents(request)
+    present_documents_count(response, output_json=output_json)

alloy_runtime_cli-0.2.68/cli/commands/knowledge/documents/count/presenter.py

@@ -0,0 +1,25 @@
+"""Presenter for knowledge document count output."""
+
+import json
+
+from alloy_runtime_types.dtos.knowledge import (
+    CountDocumentsResponse,
+    DOCUMENT_STATUS_ORDER,
+)
+
+from cli.infrastructure.output import OutputService
+
+
+def present_documents_count(
+    response: CountDocumentsResponse, *, output_json: bool = False
+) -> None:
+    output = OutputService.get()
+    if output_json:
+        output.text(json.dumps(response.model_dump(mode="json"), indent=2))
+        return
+
+    output.text(f"Total documents: {response.count}")
+    breakdown = response.breakdown_by_status.model_dump()
+    output.text("By status:")
+    for status in DOCUMENT_STATUS_ORDER:
+        output.text(f"  {status}: {breakdown[status]}")

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/cli/commands/knowledge/documents/list/command.py

@@ -1,6 +1,9 @@
 """Knowledge documents list command implementation."""
 
 import typer
+from typing import cast
+
+from alloy_runtime_types.dtos.knowledge import ListDocumentsRequest, ProcessingStatus
 
 from cli.commands.knowledge.documents.list.presenter import present_documents_list
 from cli.infrastructure.command import async_command, authenticated_client
@@ -68,13 +71,14 @@ async def _execute_list(
     offset: int,
 ) -> None:
     """Execute list documents operation."""
+    request = ListDocumentsRequest(
+        collection_id=collection_id,
+        processing_status=cast(ProcessingStatus | None, processing_status),
+        external_id=external_id,
+        limit=limit,
+        offset=offset,
+    )
     async with authenticated_client() as (_config, client):
-        response = await client.list_documents(
-            limit=limit,
-            offset=offset,
-            collection_id=collection_id,
-            processing_status=processing_status,
-            external_id=external_id,
-        )
+        response = await client.list_documents(request)
 
     present_documents_list(response)

{alloy_runtime_cli-0.2.66 → alloy_runtime_cli-0.2.68}/cli/commands/knowledge/documents/list/presenter.py

@@ -1,6 +1,9 @@
 """Presenter for knowledge documents list command output."""
 
-from alloy_runtime_types.dtos.knowledge import ListDocumentsResponse
+from alloy_runtime_types.dtos.knowledge import (
+    DOCUMENT_STATUS_ORDER,
+    ListDocumentsResponse,
+)
 
 from cli.infrastructure.output import OutputService
 from cli.infrastructure.renderers.list_renderer import ColumnConfig
@@ -82,3 +85,8 @@ def present_documents_list(response: ListDocumentsResponse) -> None:
         raw_payload=response,
         total_count=response.total,
     )
+    breakdown = response.breakdown_by_status.model_dump()
+    output.text(
+        "By status: "
+        + ", ".join(f"{status}={breakdown[status]}" for status in DOCUMENT_STATUS_ORDER)
+    )