alloy-runtime-cli 0.2.45__tar.gz → 0.2.47__tar.gz

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alloy-runtime-cli
-Version: 0.2.45
+Version: 0.2.47
 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.1.1
 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.45
-Requires-Dist: alloy-runtime-types==0.2.45
+Requires-Dist: alloy-runtime-sdk==0.2.47
+Requires-Dist: alloy-runtime-types==0.2.47
 Requires-Dist: trogon==0.6.0
 
 # alloy-runtime-cli
@@ -90,3 +90,5 @@ The CLI reads configuration in this order:
 
 Use `alloy login` to save an API key locally, or set the environment variables when
 running on a VPS.
+
+CLI release trigger: no functional changes.

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/README.md

@@ -68,3 +68,5 @@ The CLI reads configuration in this order:
 
 Use `alloy login` to save an API key locally, or set the environment variables when
 running on a VPS.
+
+CLI release trigger: no functional changes.

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/alloy_runtime_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alloy-runtime-cli
-Version: 0.2.45
+Version: 0.2.47
 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.1.1
 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.45
-Requires-Dist: alloy-runtime-types==0.2.45
+Requires-Dist: alloy-runtime-sdk==0.2.47
+Requires-Dist: alloy-runtime-types==0.2.47
 Requires-Dist: trogon==0.6.0
 
 # alloy-runtime-cli
@@ -90,3 +90,5 @@ The CLI reads configuration in this order:
 
 Use `alloy login` to save an API key locally, or set the environment variables when
 running on a VPS.
+
+CLI release trigger: no functional changes.

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/alloy_runtime_cli.egg-info/requires.txt

@@ -4,6 +4,6 @@ textual==8.1.1
 genson==1.3.0
 pyperclip==1.11.0
 prompt-toolkit==3.0.52
-alloy-runtime-sdk==0.2.45
-alloy-runtime-types==0.2.45
+alloy-runtime-sdk==0.2.47
+alloy-runtime-types==0.2.47
 trogon==0.6.0

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/cli/commands/knowledge/synthesis/create/command.py

@@ -57,7 +57,8 @@ def knowledge_synthesis_create_command(
 
     A synthesis uses an agent with RAG tools to research a topic across
     specified collections and generate a comprehensive response. The
-    synthesis is processed asynchronously - poll the synthesis status
+    synthesis is accepted asynchronously, and identical payloads reuse the
+    existing synthesis. Poll the synthesis status
     to check for completion.
 
     Examples:

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/cli/commands/knowledge/synthesis/create/presenter.py

@@ -20,6 +20,7 @@ def present_synthesis_create_success(response: CreateSynthesisResponse) -> None:
         name=None,
         extra_fields={
             "Message": response.message,
+            "Request Fingerprint": response.queue_metadata.request_fingerprint,
             "Next Step": f"alloy knowledge synthesis get {response.synthesis_id}",
         },
     )

alloy_runtime_cli-0.2.47/cli/commands/knowledge/synthesis/get/command.py

@@ -0,0 +1,81 @@
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from cli.commands.flag_utils import validate_output_mode, validate_uuid
+from cli.commands.knowledge.synthesis.get.presenter import present_synthesis_details
+from cli.infrastructure.error_display import display_error_record
+from cli.infrastructure.command import async_command, authenticated_client
+from cli.infrastructure.output import OutputService
+
+
+def knowledge_synthesis_get_command(
+    synthesis_id: str = typer.Argument(
+        ...,
+        help="Synthesis UUID",
+    ),
+    output: str = typer.Option("console", "-o", help="Output: console or file"),
+    output_file: Optional[str] = typer.Option(
+        None,
+        "-O",
+        "--output-file",
+        help="Save synthesis content to file",
+    ),
+) -> None:
+    """Get synthesis details.
+
+    Returns the full synthesis details including content (if completed),
+    status, staleness information, and source tracking.
+    """
+    validate_uuid(synthesis_id, "synthesis")
+    validate_output_mode(output, output_file, ("console", "file"))
+    _execute_get(synthesis_id, output, output_file)
+
+
+@async_command
+async def _execute_get(
+    synthesis_id: str,
+    output_mode: str,
+    output_file: Optional[str],
+) -> None:
+    """Execute synthesis get."""
+    async with authenticated_client() as (_config, client):
+        response = await client.get_synthesis(synthesis_id)
+
+    if output_mode == "file":
+        _write_synthesis_file(response.synthesis_content, output_file)
+        return
+
+    present_synthesis_details(response)
+
+
+def _write_synthesis_file(content: str | None, output_file: Optional[str]) -> None:
+    if not content:
+        display_error_record(
+            {
+                "Type": "usage_error",
+                "Message": "Synthesis content is not available yet; wait for the synthesis to complete before saving.",
+                "Hint": "Run `alloy knowledge synthesis get --help`",
+            }
+        )
+        raise typer.Exit(code=1)
+
+    if output_file is None:
+        raise typer.BadParameter("--output-file/-O required with --output file")
+
+    file_path = Path(output_file).expanduser().resolve()
+    file_path.parent.mkdir(parents=True, exist_ok=True)
+    file_path.write_text(content, encoding="utf-8")
+
+    OutputService.get().result(
+        action="write",
+        resource="synthesis",
+        status="success",
+        identifier=None,
+        name=file_path.name,
+        extra_fields={
+            "Destination": str(file_path),
+            "Characters": len(content),
+        },
+    )

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/cli/commands/knowledge/synthesis/get/presenter.py

@@ -1,13 +1,11 @@
-"""Presenter for synthesis get output."""
-
 import json
 from typing import Any, cast
 from uuid import UUID
 
+from alloy_runtime_types.dtos.knowledge import GetSynthesisResponse
 from cli.infrastructure.formatting.fields import format_datetime
 from cli.infrastructure.output import OutputService
 from cli.infrastructure.renderers.entity_renderer import FieldConfig
-from alloy_runtime_types.dtos.knowledge import GetSynthesisResponse
 
 
 def _format_optional_uuid(value: UUID | None) -> Any:
@@ -34,6 +32,22 @@ def _format_optional_datetime(value: Any) -> Any:
     return format_datetime(value)
 
 
+def _queue_metadata_value(response: GetSynthesisResponse, key: str) -> Any:
+    queue_metadata = response.queue_metadata
+    if isinstance(queue_metadata, dict):
+        queue_metadata_dict = cast(dict[str, Any], queue_metadata)
+        return queue_metadata_dict.get(key)
+    return getattr(queue_metadata, key)
+
+
+def _format_request_fingerprint(response: GetSynthesisResponse) -> str:
+    return cast(str, _queue_metadata_value(response, "request_fingerprint"))
+
+
+def _format_worker_task_id(response: GetSynthesisResponse) -> str:
+    return cast(str, _queue_metadata_value(response, "worker_task_id"))
+
+
 def present_synthesis_details(response: GetSynthesisResponse) -> None:
     output = OutputService.get()
 
@@ -59,6 +73,24 @@ def present_synthesis_details(response: GetSynthesisResponse) -> None:
         FieldConfig("updated_at", "Updated At", _format_optional_datetime),
     ]
 
+    if response.queue_metadata is not None:
+        queue_fields = [
+            FieldConfig(
+                "queue_metadata",
+                "Request Fingerprint",
+                lambda _value: _format_request_fingerprint(response),
+            ),
+        ]
+        if _queue_metadata_value(response, "worker_task_id") is not None:
+            queue_fields.append(
+                FieldConfig(
+                    "queue_metadata",
+                    "Worker Task ID",
+                    lambda _value: _format_worker_task_id(response),
+                )
+            )
+        fields[10:10] = queue_fields
+
     output.entity(
         response,
         f"Synthesis: {response.title}",

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/cli/commands/knowledge/synthesis/list/command.py

@@ -20,7 +20,7 @@ def knowledge_synthesis_list_command(
         None,
         "-s",
         "--status",
-        help="Filter by status: pending, processing, completed, failed",
+        help="Filter by status: accepted, queued, worker_assigned, processing, completed, failed",
     ),
     include_stale: bool = typer.Option(
         True,
@@ -77,7 +77,14 @@ def _execute_list_from_flags(
 
     # Validate status if provided
     if status:
-        valid_statuses = ["pending", "processing", "completed", "failed"]
+        valid_statuses = [
+            "accepted",
+            "queued",
+            "worker_assigned",
+            "processing",
+            "completed",
+            "failed",
+        ]
         if status.lower() not in valid_statuses:
             raise typer.BadParameter(
                 f"Invalid status '{status}'. Valid: {', '.join(valid_statuses)}"

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/cli/infrastructure/output.py

@@ -88,6 +88,10 @@ class OutputService:
     def _write_json_message_to_stderr(self, message: str) -> None:
         print(message, file=sys.stderr)
 
+    def _write_raw_stdout(self, content: str) -> None:
+        self._console.file.write(f"{content}\n")
+        self._console.file.flush()
+
     def _to_jsonable(self, payload: Any) -> Any:
         if isinstance(payload, BaseModel):
             return payload.model_dump(mode="json")
@@ -107,11 +111,7 @@ class OutputService:
 
     def raw(self, payload: BaseModel | dict[str, Any] | list[Any]) -> None:
         jsonable = self._to_jsonable(payload)
-        self._console.print(
-            json.dumps(jsonable, indent=2, default=str),
-            markup=False,
-            highlight=False,
-        )
+        self._write_raw_stdout(json.dumps(jsonable, indent=2, default=str))
 
     # Message methods
     def success(self, message: str) -> None:

{alloy_runtime_cli-0.2.45 → alloy_runtime_cli-0.2.47}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "alloy-runtime-cli"
-version = "0.2.45"
+version = "0.2.47"
 description = "Alloy Runtime CLI - Command-line interface for Alloy Runtime server"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -23,8 +23,8 @@ dependencies = [
   "genson==1.3.0",
   "pyperclip==1.11.0",
   "prompt-toolkit==3.0.52",
-  "alloy-runtime-sdk==0.2.45",
-  "alloy-runtime-types==0.2.45",
+  "alloy-runtime-sdk==0.2.47",
+  "alloy-runtime-types==0.2.47",
   "trogon==0.6.0",
 ]
 

alloy_runtime_cli-0.2.45/cli/commands/knowledge/synthesis/get/command.py

@@ -1,41 +0,0 @@
-"""Knowledge synthesis get command implementation."""
-
-import typer
-
-from cli.commands.flag_utils import validate_uuid
-from cli.commands.knowledge.synthesis.get.presenter import present_synthesis_details
-from cli.infrastructure.command import async_command, authenticated_client
-
-
-def knowledge_synthesis_get_command(
-    synthesis_id: str = typer.Argument(
-        ...,
-        help="Synthesis UUID",
-    ),
-) -> None:
-    """Get synthesis details.
-
-    Returns the full synthesis details including content (if completed),
-    status, staleness information, and source tracking.
-
-    Examples:
-        alloy knowledge synthesis get <synthesis-uuid>
-    """
-    _execute_get_from_flags(synthesis_id=synthesis_id)
-
-
-def _execute_get_from_flags(synthesis_id: str) -> None:
-    """Validate flags and execute get."""
-    # Validate synthesis UUID
-    validate_uuid(synthesis_id, "synthesis")
-
-    _execute_get(synthesis_id)
-
-
-@async_command
-async def _execute_get(synthesis_id: str) -> None:
-    """Execute synthesis get."""
-    async with authenticated_client() as (_config, client):
-        response = await client.get_synthesis(synthesis_id)
-
-    present_synthesis_details(response)