alloy-runtime-cli 0.2.107__tar.gz → 0.2.109__tar.gz

{alloy_runtime_cli-0.2.107 → alloy_runtime_cli-0.2.109}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alloy-runtime-cli
-Version: 0.2.107
+Version: 0.2.109
 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.107
-Requires-Dist: alloy-runtime-types==0.2.107
+Requires-Dist: alloy-runtime-sdk==0.2.109
+Requires-Dist: alloy-runtime-types==0.2.109
 Requires-Dist: trogon==0.6.0
 
 # alloy-runtime-cli
@@ -145,6 +145,18 @@ alloy pipelines executions get <pipeline_id> <execution_id> --watch --timeout 60
 
 `rerun` submits a new hosted attempt asynchronously and returns the queued execution state immediately. Poll `get` when you want the terminal result.
 
+To regenerate exactly one terminal `ctx.generate_text(step_id="...")` child on the
+next rerun while preserving other completed step cache hits, reset that step first:
+
+```bash
+alloy pipelines executions reset-step <pipeline_id> <execution_id> --step-id draft
+alloy pipelines executions rerun <pipeline_id> <execution_id>
+```
+
+`reset-step` is parent-scoped and server-owned. It preserves the child generation
+row, retires only the exact deterministic key for the requested step, and is
+idempotent if the step was already reset.
+
 ## Configuration
 
 The CLI reads configuration in this order:

{alloy_runtime_cli-0.2.107 → alloy_runtime_cli-0.2.109}/README.md

@@ -123,6 +123,18 @@ alloy pipelines executions get <pipeline_id> <execution_id> --watch --timeout 60
 
 `rerun` submits a new hosted attempt asynchronously and returns the queued execution state immediately. Poll `get` when you want the terminal result.
 
+To regenerate exactly one terminal `ctx.generate_text(step_id="...")` child on the
+next rerun while preserving other completed step cache hits, reset that step first:
+
+```bash
+alloy pipelines executions reset-step <pipeline_id> <execution_id> --step-id draft
+alloy pipelines executions rerun <pipeline_id> <execution_id>
+```
+
+`reset-step` is parent-scoped and server-owned. It preserves the child generation
+row, retires only the exact deterministic key for the requested step, and is
+idempotent if the step was already reset.
+
 ## Configuration
 
 The CLI reads configuration in this order:

{alloy_runtime_cli-0.2.107 → alloy_runtime_cli-0.2.109}/alloy_runtime_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alloy-runtime-cli
-Version: 0.2.107
+Version: 0.2.109
 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.107
-Requires-Dist: alloy-runtime-types==0.2.107
+Requires-Dist: alloy-runtime-sdk==0.2.109
+Requires-Dist: alloy-runtime-types==0.2.109
 Requires-Dist: trogon==0.6.0
 
 # alloy-runtime-cli
@@ -145,6 +145,18 @@ alloy pipelines executions get <pipeline_id> <execution_id> --watch --timeout 60
 
 `rerun` submits a new hosted attempt asynchronously and returns the queued execution state immediately. Poll `get` when you want the terminal result.
 
+To regenerate exactly one terminal `ctx.generate_text(step_id="...")` child on the
+next rerun while preserving other completed step cache hits, reset that step first:
+
+```bash
+alloy pipelines executions reset-step <pipeline_id> <execution_id> --step-id draft
+alloy pipelines executions rerun <pipeline_id> <execution_id>
+```
+
+`reset-step` is parent-scoped and server-owned. It preserves the child generation
+row, retires only the exact deterministic key for the requested step, and is
+idempotent if the step was already reset.
+
 ## Configuration
 
 The CLI reads configuration in this order:

{alloy_runtime_cli-0.2.107 → alloy_runtime_cli-0.2.109}/alloy_runtime_cli.egg-info/SOURCES.txt

@@ -237,6 +237,7 @@ cli/commands/pipelines/executions/get_command.py
 cli/commands/pipelines/executions/list_command.py
 cli/commands/pipelines/executions/presenter.py
 cli/commands/pipelines/executions/rerun_command.py
+cli/commands/pipelines/executions/reset_step_command.py
 cli/commands/pipelines/executions/costs/__init__.py
 cli/commands/pipelines/executions/costs/command.py
 cli/commands/pipelines/executions/costs/presenter.py

{alloy_runtime_cli-0.2.107 → alloy_runtime_cli-0.2.109}/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.107
-alloy-runtime-types==0.2.107
+alloy-runtime-sdk==0.2.109
+alloy-runtime-types==0.2.109
 trogon==0.6.0

alloy_runtime_cli-0.2.109/cli/commands/pipelines/executions/reset_step_command.py

@@ -0,0 +1,79 @@
+"""Pipeline execution reset-step command implementation."""
+
+from uuid import UUID
+
+import typer
+
+from alloy_runtime_types.dtos.pipeline import ResetPipelineExecutionStepResponse
+from cli.commands.flag_utils import validate_uuid
+from cli.infrastructure.command import async_command, authenticated_client
+from cli.infrastructure.output import OutputFormat, OutputService
+
+
+def pipelines_executions_reset_step_command(
+    pipeline_id: str = typer.Argument(..., help="Pipeline UUID"),
+    execution_id: str = typer.Argument(
+        ...,
+        help="Parent pipeline execution UUID whose deterministic step key should be reset",
+    ),
+    step_id: str = typer.Option(
+        ...,
+        "--step-id",
+        help="Pipeline ctx.generate_text step_id to regenerate on the next rerun.",
+    ),
+) -> None:
+    """Reset one pipeline generation step before rerunning the parent execution.
+
+    This is a server-owned override for failed, timed-out, cancelled, or
+    approval-paused parent executions. It preserves the generation row and retires
+    only the deterministic idempotency key for the requested step.
+
+    Example:
+        alloy pipelines executions reset-step 123e4567... 456e7890... --step-id draft
+    """
+    p_uuid = validate_uuid(pipeline_id, "pipeline")
+    e_uuid = validate_uuid(execution_id, "execution")
+    _execute_reset_step(pipeline_id=p_uuid, execution_id=e_uuid, step_id=step_id)
+
+
+@async_command
+async def _execute_reset_step(
+    pipeline_id: UUID,
+    execution_id: UUID,
+    step_id: str,
+) -> None:
+    """Execute reset-step pipeline operation."""
+    async with authenticated_client() as (_config, client):
+        response = await client.reset_pipeline_execution_step(
+            pipeline_id,
+            execution_id,
+            step_id=step_id,
+        )
+
+    present_pipeline_execution_reset_step(response)
+
+
+def present_pipeline_execution_reset_step(
+    response: ResetPipelineExecutionStepResponse,
+) -> None:
+    """Present reset-step result."""
+    output = OutputService.get()
+    if output.format == OutputFormat.JSON:
+        output.raw(response)
+        return
+
+    output.result(
+        action="reset-step",
+        resource="pipeline_execution_step",
+        status=response.status,
+        identifier=str(response.generation_execution_id),
+        name=response.step_id,
+        extra_fields={
+            "Pipeline ID": str(response.pipeline_id),
+            "Pipeline Execution ID": str(response.pipeline_execution_id),
+            "Step ID": response.step_id,
+            "Previous External ID": response.previous_external_id,
+            "Already Reset": response.already_reset,
+            "Next Action": response.next_action,
+        },
+    )

{alloy_runtime_cli-0.2.107 → alloy_runtime_cli-0.2.109}/cli/main.py

@@ -214,6 +214,9 @@ from cli.commands.pipelines.approvals.decide_command import (
 from cli.commands.pipelines.executions.rerun_command import (
     pipelines_executions_rerun_command,
 )
+from cli.commands.pipelines.executions.reset_step_command import (
+    pipelines_executions_reset_step_command,
+)
 from cli.commands.pipelines.executions.cancel_command import (
     pipelines_executions_cancel_command,
 )
@@ -860,6 +863,7 @@ pipelines_app.add_typer(pipelines_executions_app, name="executions")
 pipelines_executions_app.command("list")(pipelines_executions_list_command)
 pipelines_executions_app.command("get")(pipelines_executions_get_command)
 pipelines_executions_app.command("rerun")(pipelines_executions_rerun_command)
+pipelines_executions_app.command("reset-step")(pipelines_executions_reset_step_command)
 pipelines_executions_app.command("cancel")(pipelines_executions_cancel_command)
 pipelines_executions_app.command("update")(pipeline_execution_update_command)
 pipelines_executions_app.command("costs")(pipeline_execution_costs_command)

{alloy_runtime_cli-0.2.107 → alloy_runtime_cli-0.2.109}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "alloy-runtime-cli"
-version = "0.2.107"
+version = "0.2.109"
 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.107",
-  "alloy-runtime-types==0.2.107",
+  "alloy-runtime-sdk==0.2.109",
+  "alloy-runtime-types==0.2.109",
   "trogon==0.6.0",
 ]