delegate-agent-cli 0.21.0__tar.gz → 0.23.0__tar.gz

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project are 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.23.0] - 2026-07-30
+
+### Added
+
+- Added `delegate runs prune` with a 30-day default age threshold, an explicit `--older-than` override, and `--dry-run` preview output. It prunes terminal Run records and their associated Registry artifacts (per-Run directory, logs, Completion Report, retained raw-log archive) without touching genuinely running Runs. Persistent-worktree Runs are skipped unless their worktree is recorded as removed or missing — unknown or unrecorded worktree status is treated as possibly present, mirroring `worktree gc` — so live worktrees never lose their Registry records. The ambient retention pass is bypassed on the prune command path so a dry run never mutates state.
+
+### Fixed
+
+- Focused unittest invocations (`python3 -m unittest tests.<module>`) no longer fail on the src layout import: `tests/__init__.py` now puts `src` on `sys.path` before any test module import runs.
+
+## [0.22.0] - 2026-07-26
+
+### Changed
+
+- Consolidated pure-call validation in `constants.validate_pure_call`, collapsed repeated `attempt`/`call` invocations in `runner.py` into local closures, eliminated `typing.Any` from `src`, and removed defensive `getattr`/`isinstance` hedges where the contract guarantees the type.
+
+### Removed
+
+- Removed the write-only `ReasoningCapability.supported_efforts` field and unused `STATUS_FILTER_ACTIVE`/`STATUS_FILTER_RECENT` constants.
+- Removed dead back-compat re-exports from `delegate_agent.cli`: `build_kimi_argv`, `build_opencode_argv`, `build_pi_argv`, `prefix_droid_safe_prompt`, `redacted_prompt_argv`, `KIMI_PROMPT_REDACTION`, `_grok_harness_bypass_enabled`, `_resolve_default_model`, and `block_external_symlinks`. These had no known consumers; the supported import surface is the CLI and `delegate --json` contracts.
+
 ## [0.21.0] - 2026-07-26
 
 ### Added
@@ -748,6 +769,8 @@ Usage-audit fix wave: 82 sessions and 1,241 delegate invocations from one week o
 
 - Releases before 0.1.3 predate this changelog.
 
+[0.23.0]: https://github.com/treygoff24/delegate-agent/compare/v0.22.0...v0.23.0
+[0.22.0]: https://github.com/treygoff24/delegate-agent/compare/v0.21.0...v0.22.0
 [0.21.0]: https://github.com/treygoff24/delegate-agent/compare/v0.20.0...v0.21.0
 [0.20.0]: https://github.com/treygoff24/delegate-agent/compare/v0.19.0...v0.20.0
 [0.19.0]: https://github.com/treygoff24/delegate-agent/compare/v0.18.0...v0.19.0

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: delegate-agent-cli
-Version: 0.21.0
+Version: 0.23.0
 Summary: A tiny CLI for delegating bounded agent tasks across coding-agent runtimes.
 Author: Trey Goff
 License-Expression: MIT
@@ -332,6 +332,7 @@ delegate runs --recent
 delegate ps                   # active and stale tracked runs
 delegate snapshot <alias-or-runId>
 delegate run-output <alias-or-runId>
+delegate runs prune --dry-run # preview GC of terminal run records older than 30 days
 ```
 
 Aliases are always numbered (`codex-1`, `cursor-2`); a **bare harness name

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/README.md

@@ -299,6 +299,7 @@ delegate runs --recent
 delegate ps                   # active and stale tracked runs
 delegate snapshot <alias-or-runId>
 delegate run-output <alias-or-runId>
+delegate runs prune --dry-run # preview GC of terminal run records older than 30 days
 ```
 
 Aliases are always numbered (`codex-1`, `cursor-2`); a **bare harness name

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/docs/cli-reference.md

@@ -931,6 +931,7 @@ Tracked runs return bounded parent-facing output and store local metadata under
 
 ```bash
 delegate runs [--active|--running|--stale|--recent] [--harness HARNESS] [--group NAME] [--limit N]
+delegate runs prune [--older-than DAYS] [--dry-run]
 delegate ps [--harness HARNESS] [--group NAME] [--limit N]
 delegate snapshot [--latest HARNESS] [--no-redact] <handle>
 delegate run-output [--latest HARNESS] <handle> [--completion-report] [--stdout] [--stderr] [--tail N] [--max-chars N] [--raw] [--no-redact]
@@ -942,6 +943,8 @@ delegate cancel <handle>...
 `delegate ps` is the shorter first-class form of `delegate runs --active` and
 accepts the same harness, group, and limit selectors.
 
+`delegate runs prune` removes old terminal Run records from the workspace Registry so they stop accumulating forever. Only runs whose effective status is terminal (`succeeded`, `failed`, `cancelled`, or `stale` from a dead child) and whose last Registry activity is older than the threshold (default 30 days; override with `--older-than DAYS`) are eligible. Effectively running runs are always skipped, and persistent-worktree runs are skipped unless their worktree is recorded as removed or missing — pruning the record of a live worktree would orphan it from `worktree list`/`show`/`remove`. Pruning deletes the per-Run directory (Snapshot, Manifest, logs, events, Completion Report) and the retained raw-log archive; worktree paths on disk are never touched. `--dry-run` reports what would be removed without changing anything. JSON output uses schema `delegate.runs-prune.v1` with `planned`, `removed`, `skipped` (each entry carries a `reason`), and `errors` sections.
+
 Run-scoped handles (`snapshot`, `run-output`, `wait`, and `cancel`)
 resolve exact run IDs and numbered aliases first. A bare harness name such as
 `codex` resolves to that harness's latest run, and `harness:modelAlias` (for

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/docs/delegate-workflows.md

@@ -175,6 +175,7 @@ engines = args.get("engines", ["codex", "claude", "cursor"])
 models = args.get("models", {})
 prompt = args["prompt"]
 
+
 def reviewer(engine):
     return lambda: agent(
         prompt,
@@ -184,6 +185,7 @@ def reviewer(engine):
         phase=f"Review ({engine})",
     )
 
+
 reviews = parallel([reviewer(engine) for engine in engines])
 return {"reviews": dict(zip(engines, reviews))}
 ```

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "delegate-agent-cli"
-version = "0.21.0"
+version = "0.23.0"
 description = "A tiny CLI for delegating bounded agent tasks across coding-agent runtimes."
 readme = "README.md"
 requires-python = ">=3.11"

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/__init__.py

@@ -1,5 +1,5 @@
 """Delegate Agent CLI package."""
 
-VERSION = "0.21.0"
+VERSION = "0.23.0"
 
 __all__ = ["VERSION"]

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/capability_commands.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-from collections.abc import Callable
 from dataclasses import dataclass
 from pathlib import Path
 from typing import TextIO
@@ -139,7 +138,7 @@ def _refresh_payload(
     *,
     profile: profiles.ProfileResolution,
     engines: tuple[str, ...] | None = None,
-    progress: Callable[[str], None] | None = None,
+    progress: harness_discovery.ProgressCallback | None = None,
 ) -> JsonObject:
     try:
         result = harness_discovery.refresh_discovery(

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/cli.py

@@ -40,20 +40,14 @@ from delegate_agent import runner as delegate_runner
 from delegate_agent.argv_builders import (  # noqa: F401  # re-exported for tests / back-compat
     SAFE_REVIEW_PREFIX_BY_ENGINE,
     _claude_harness_bypass_enabled,
-    _grok_harness_bypass_enabled,
     build_claude_argv,
     build_codex_argv,
     build_cursor_argv,
     build_devin_argv,
     build_droid_argv,
     build_grok_argv,
-    build_kimi_argv,
     build_omp_argv,
-    build_opencode_argv,
-    build_pi_argv,
     prefix_cursor_safe_prompt,
-    prefix_droid_safe_prompt,
-    redacted_prompt_argv,
 )
 from delegate_agent.argv_utils import public_argv
 from delegate_agent.cli_parser import (  # noqa: F401  # re-exported for tests / back-compat
@@ -98,7 +92,6 @@ from delegate_agent.prompt_transport import (  # noqa: F401  # CURSOR_PROMPT_RED
     DEVIN_AGENT_CONFIG_DISPLAY,
     DROID_PROMPT_FILE_ARG_PLACEHOLDER,
     DROID_PROMPT_FILE_DISPLAY,
-    KIMI_PROMPT_REDACTION,
     PROMPT_FILE_ARG_PLACEHOLDER,
     PROMPT_FILE_DISPLAY,
     PROMPT_TRANSPORT_ARGV,
@@ -109,7 +102,6 @@ from delegate_agent.request_build import (  # noqa: F401  # re-exported for test
     CALL_TEMP_CWD_PLACEHOLDER,
     RUN_INPUT_KEYS,
     _load_input_json_object,
-    _resolve_default_model,
     build_request,
     effective_prompt,
     load_config,
@@ -136,7 +128,6 @@ from delegate_agent.safe_workspace import (  # noqa: F401  # re-exported for tes
     SAFE_BLOCKED_SYMLINK_PLACEHOLDER,
     SAFE_EXTERNAL_SYMLINK_WARNING_PREFIX,
     SAFE_UNBORN_GIT_WARNING,
-    block_external_symlinks,
     cleanup_safe_isolated_workspace,
     create_directory_safe_workspace,
     create_git_safe_workspace,
@@ -332,7 +323,6 @@ def dry_run_payload(request: Request) -> JsonObject:
     if request.profile_resolution.name is not None:
         payload["profileEnv"] = redaction.redact_env_map(request.profile_resolution.env)
 
-    # Structured isolation fields from the isolation context.
     if request.isolation_context is not None:
         ctx = request.isolation_context
 
@@ -515,7 +505,6 @@ def make_run_context(
         if request.isolation_context is not None
         else False
     )
-    # Extract isolation metadata from the isolation context.
     iso_ctx = request.isolation_context
     if iso_ctx is not None:
         isolation_mode = iso_ctx.isolation_mode
@@ -860,7 +849,7 @@ def execute_request(
         profiles.preflight_codex_request(request, config.get("codex", {}))
     ctx = request.isolation_context
 
-    # --- Persistent worktree path (work + worktree) ---
+    # Persistent worktree runs (work + worktree) hand off to worktree_execution.
     if ctx is not None and ctx.isolation_lifecycle == "persistent":
         try:
             return worktree_execution.execute_persistent_worktree(
@@ -1022,7 +1011,6 @@ def pre_read_run_json_for_config(
     if json_cwd is not None and not isinstance(json_cwd, str):
         raise DelegateError("invalid_cwd", "cwd must be a string.")
 
-    # Reject explicit null isolation in the JSON pre-read.
     if "isolation" in raw and raw["isolation"] is None:
         raise DelegateError(
             "invalid_isolation",
@@ -1192,7 +1180,12 @@ def main(
             "workflow",
         }:
             existing_registry = run_registry.registry_root_if_exists(Path(workspace.path))
-            if existing_registry is not None:
+            pruning_runs = (
+                parsed.subcommand == "runs"
+                and parsed.runs is not None
+                and parsed.runs.action == "prune"
+            )
+            if existing_registry is not None and not pruning_runs:
                 maybe_run_retention_pass(existing_registry, config)
         if parsed.subcommand == "snapshot":
             return emit_snapshot(parsed, workspace, stdout)
@@ -1280,8 +1273,8 @@ def main(
             DelegateError(
                 exc.error,
                 exc.message,
-                diagnostics=getattr(exc, "diagnostics", None),
-                next_actions=getattr(exc, "next_actions", None),
+                diagnostics=exc.diagnostics,
+                next_actions=exc.next_actions,
             ),
             json_mode,
             stdout,

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/cli_parser.py

@@ -32,10 +32,9 @@ from delegate_agent.constants import (
     ENGINES_PROSE,
     KNOWN_ENGINES,
     MODELESS_ENGINES,
-    PURE_CALL_ENGINES,
     VALID_MODES,
-    pure_call_supported,
     validate_mode,
+    validate_pure_call,
 )
 from delegate_agent.errors import DelegateError
 from delegate_agent.request_models import (
@@ -647,10 +646,6 @@ def corrected_global_argv(argv: list[str]) -> list[str]:
     return [*globals_out, *rest]
 
 
-def corrected_global_command(argv: list[str]) -> str:
-    return _shell_command(corrected_global_argv(argv))
-
-
 def raise_misplaced_global_option(message: str, argv: list[str] | None = None) -> NoReturn:
     guidance = (
         "Move global options before the subcommand "
@@ -1320,22 +1315,7 @@ def _validate_pure_options(
         return
     if mode != "call":
         raise DelegateError("unsupported_pure_call", "--pure only applies to call mode.")
-    if group is not None:
-        raise DelegateError(
-            "pure_conflicts_group",
-            "--pure cannot be combined with --group; pure call is a stateless one-hop completion.",
-        )
-    if read_only:
-        raise DelegateError(
-            "pure_conflicts_read_only", "--pure cannot be combined with --read-only."
-        )
-    if not pure_call_supported(engine):
-        supported = ", ".join(PURE_CALL_ENGINES)
-        raise DelegateError(
-            "unsupported_pure_call",
-            f"{engine} does not support pure call mode.",
-            next_actions=[f"Use --pure with one of: {supported}."],
-        )
+    validate_pure_call(engine, pure=pure, read_only=read_only, group=group)
 
 
 def parse_snapshot(rest: list[str], json_mode: bool, cwd: str | None) -> ParsedCommand:
@@ -1400,7 +1380,10 @@ def parse_runs(
     # front-ends (ps) do not report errors against flags nobody entered.
     rest, json_mode = consume_json_option(rest, json_mode)
     if any(command_help.is_help_token(token) for token in rest):
-        return help_command(json_mode, "runs")
+        topic = "runs prune" if rest and rest[0] == "prune" else "runs"
+        return help_command(json_mode, topic)
+    if rest and rest[0] == "prune":
+        return parse_runs_prune(rest[1:], json_mode, cwd)
     active = False
     recent = False
     running = False
@@ -1488,6 +1471,37 @@ def parse_runs(
     )
 
 
+def parse_runs_prune(rest: list[str], json_mode: bool, cwd: str | None) -> ParsedCommand:
+    rest, json_mode = consume_json_option(rest, json_mode)
+    if any(command_help.is_help_token(token) for token in rest):
+        return help_command(json_mode, "runs prune")
+    older_than_days = None
+    dry_run = False
+    i = 0
+    while i < len(rest):
+        token = rest[i]
+        if token == "--older-than":
+            value = _require_option_value(rest, i, token)
+            older_than_days = parse_non_negative_int(value, option="runs prune --older-than")
+            i += 2
+            continue
+        if token == "--dry-run":
+            dry_run = True
+            i += 1
+            continue
+        raise DelegateError("unknown_option", f"runs prune does not support option: {token}")
+    return ParsedCommand(
+        "runs",
+        global_options=GlobalOptions(json_mode=json_mode, cwd=cwd),
+        runs=inspection_commands.RunsCommand(
+            action="prune",
+            older_than_days=older_than_days,
+            dry_run=dry_run,
+            json_mode=json_mode,
+        ),
+    )
+
+
 def parse_ps(rest: list[str], json_mode: bool, cwd: str | None) -> ParsedCommand:
     rest, json_mode = consume_json_option(rest, json_mode)
     if any(command_help.is_help_token(token) for token in rest):
@@ -1982,6 +1996,10 @@ def _require_option_value(rest: list[str], index: int, option: str) -> str:
 
 WorktreeOptionSpec = tuple[str, str]
 
+# Parsed worktree option values: flags store True, "str"/"group"/"status" kinds
+# store the validated string, and the int kinds store a parsed int.
+WorktreeOptionValue = str | int | bool
+
 WORKTREE_OPTION_SPECS: dict[str, dict[str, WorktreeOptionSpec]] = {
     "list": {
         "--harness": ("str", "harness"),
@@ -2020,7 +2038,7 @@ WORKTREE_OPTION_SPECS: dict[str, dict[str, WorktreeOptionSpec]] = {
 
 
 def _apply_worktree_option(
-    options: dict[str, object],
+    options: dict[str, WorktreeOptionValue],
     args: list[str],
     index: int,
     option: str,
@@ -2069,7 +2087,7 @@ def parse_worktree(rest: list[str], json_mode: bool, cwd: str | None) -> ParsedC
         return help_command(json_mode, topic)
     if action not in WORKTREE_OPTION_SPECS:
         raise DelegateError("unknown_worktree_action", f"Unknown worktree action: {action}")
-    options: dict[str, object] = {}
+    options: dict[str, WorktreeOptionValue] = {}
     positional: list[str] = []
     i = 0
     action_specs = WORKTREE_OPTION_SPECS[action]

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/command_errors.py

@@ -10,6 +10,8 @@ class CommandError(Exception):
         super().__init__(message)
         self.error = error
         self.message = message
+        self.diagnostics: dict | None = None
+        self.next_actions: list[str] | None = None
 
 
 def resolve_run_target(

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/command_help.py

@@ -16,6 +16,7 @@ from dataclasses import dataclass, field
 from delegate_agent import VERSION
 from delegate_agent.constants import ENGINES_PROSE
 from delegate_agent.json_types import JsonObject
+from delegate_agent.run_registry import DEFAULT_RUN_PRUNE_DAYS
 
 
 @dataclass(frozen=True)
@@ -818,7 +819,34 @@ COMMAND_SPECS: dict[str, CommandSpec] = {
             "delegate runs --group wave4",
         ),
         notes=("--active, --running, --stale, and --recent are mutually exclusive.",),
-        see_also=("ps", "snapshot", "run-output"),
+        see_also=("ps", "runs prune", "snapshot", "run-output"),
+        unsupported_global_options=("--auth-profile",),
+    ),
+    "runs prune": CommandSpec(
+        name="runs prune",
+        summary="Prune old terminal Run records from the workspace Registry.",
+        usage=("delegate [--cwd PATH] [--json] runs prune [--older-than DAYS] [--dry-run]",),
+        options=(
+            OptionSpec(
+                "--older-than",
+                "DAYS",
+                f"Prune Runs older than DAYS by Registry activity time (defaults to {DEFAULT_RUN_PRUNE_DAYS}; non-negative integer).",
+            ),
+            OptionSpec(
+                "--dry-run",
+                None,
+                "Report planned removals without changing the Registry, logs, or artifacts.",
+            ),
+        ),
+        examples=(
+            "delegate runs prune --dry-run",
+            "delegate runs prune --older-than 14",
+        ),
+        notes=(
+            "Only terminal effective statuses are eligible: succeeded, failed, cancelled, and stale from a dead child; effective running Runs are always skipped.",
+            "Runs with a registered present persistent worktree are skipped, so their worktree remains manageable. Pruning removes the per-Run directory, including its Snapshot, Manifest, logs, events, and Completion Report, plus the retained raw-log archive.",
+        ),
+        see_also=("runs", "snapshot", "run-output"),
         unsupported_global_options=("--auth-profile",),
     ),
     "ps": CommandSpec(
@@ -1745,6 +1773,7 @@ def render_overview_text() -> str:
         "delegate [--cwd PATH] [--json] snapshot [--latest HARNESS] [--no-redact] <handle>",
         "delegate [--cwd PATH] [--json] runs "
         "[--active|--running|--stale|--recent] [--harness HARNESS] [--limit N]",
+        "delegate [--cwd PATH] [--json] runs prune [--older-than DAYS] [--dry-run]",
         "delegate [--cwd PATH] [--json] ps [--harness HARNESS] [--group NAME] [--limit N]",
         "delegate [--cwd PATH] [--json] run-output <handle> "
         "[--completion-report] [--stdout] [--stderr] [--tail N] [--max-chars N] "

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/config.py

@@ -821,11 +821,9 @@ def _reject_opencode_flag_like_value(
 def _reject_pi_family_flag_like_value(value: JsonValue, *, path: str, error: str) -> None:
     if value is None:
         return
-    if not isinstance(value, str) or not value.strip() or value.startswith("-"):
-        raise ConfigError(
-            error,
-            f"{path} must be a non-empty string that does not start with '-'.",
-        )
+    _reject_opencode_flag_like_value(value, path=path, error=error)
+    if not isinstance(value, str):
+        return
     if ":" in value:
         raise ConfigError(
             error,

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/config_commands.py

@@ -23,10 +23,14 @@ class ConfigCommand:
 PROFILE_CONFIG_NAMES = delegate_config.PROFILE_CONFIG_NAMES
 
 
-def _target_path() -> Path:
+def target_config_path() -> Path:
+    """Resolve the config path, rejecting Windows-style paths under WSL."""
     raw = delegate_config.config_path()
     if wsl.should_reject_windows_path(str(raw)):
-        raise DelegateError("windows_path", wsl.windows_path_message("DELEGATE_CONFIG", str(raw)))
+        raise DelegateError(
+            "windows_path",
+            wsl.windows_path_message(delegate_config.CONFIG_ENV, str(raw)),
+        )
     return raw
 
 
@@ -94,7 +98,7 @@ def _validated_effective_config(config: JsonObject) -> JsonObject:
 def emit(command: ConfigCommand, stdout: TextIO) -> int:
     if command.action not in {"init", "sync-profiles"}:
         raise DelegateError("invalid_config_command", f"Unknown config action: {command.action}")
-    path = _target_path()
+    path = target_config_path()
     if command.action == "sync-profiles":
         if not path.exists():
             raise DelegateError(

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/constants.py

@@ -53,6 +53,30 @@ def pure_call_supported(engine: str) -> bool:
     return engine == "claude"
 
 
+def validate_pure_call(
+    engine: str, *, pure: bool, read_only: bool, group: str | None = None
+) -> None:
+    """Reject --pure combinations that conflict with its stateless one-hop contract."""
+    if not pure:
+        return
+    if group is not None:
+        raise DelegateError(
+            "pure_conflicts_group",
+            "--pure cannot be combined with --group; pure call is a stateless one-hop completion.",
+        )
+    if read_only:
+        raise DelegateError(
+            "pure_conflicts_read_only", "--pure cannot be combined with --read-only."
+        )
+    if not pure_call_supported(engine):
+        supported = ", ".join(PURE_CALL_ENGINES)
+        raise DelegateError(
+            "unsupported_pure_call",
+            f"{engine} does not support pure call mode.",
+            next_actions=[f"Use --pure with one of: {supported}."],
+        )
+
+
 # Public harness capability contract. Request validation and describe output both
 # derive from this map so enabling a capability cannot drift between the two.
 ENGINE_CAPABILITIES = {

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/describe_payload.py

@@ -48,14 +48,12 @@ from delegate_agent.constants import (
 from delegate_agent.errors import EXIT_OK, DelegateError
 from delegate_agent.json_types import JsonObject
 from delegate_agent.prompt_transport import (
-    DEVIN_AGENT_CONFIG_ARG_PLACEHOLDER,
-    DEVIN_AGENT_CONFIG_DISPLAY,
     DROID_PROMPT_FILE_DISPLAY,
-    PROMPT_FILE_ARG_PLACEHOLDER,
-    PROMPT_FILE_DISPLAY,
     PROMPT_TRANSPORT_ARGV,
     PROMPT_TRANSPORT_FILE,
     PROMPT_TRANSPORT_STDIN,
+    devin_display_argv,
+    prompt_file_display_argv,
 )
 from delegate_agent.request_build import OPENCODE_SAFE_AGENT, _resolve_default_model
 
@@ -718,7 +716,7 @@ def _grok_describe_argv(
         policy,
         allow_bypass_permissions=_grok_harness_bypass_enabled(config, mode),
     )
-    return [PROMPT_FILE_DISPLAY if item == PROMPT_FILE_ARG_PLACEHOLDER else item for item in argv]
+    return prompt_file_display_argv(argv)
 
 
 def _devin_describe_argv(
@@ -730,14 +728,7 @@ def _devin_describe_argv(
         _resolve_default_model(devin),
         call_read_only=call_read_only,
     )
-    return [
-        DEVIN_AGENT_CONFIG_DISPLAY
-        if item == DEVIN_AGENT_CONFIG_ARG_PLACEHOLDER
-        else PROMPT_FILE_DISPLAY
-        if item == PROMPT_FILE_ARG_PLACEHOLDER
-        else item
-        for item in argv
-    ]
+    return devin_display_argv(argv)
 
 
 def _kimi_describe_argv(kimi: JsonObject, *, mode: str) -> list[str]:
@@ -774,7 +765,7 @@ def _opencode_describe_argv(
         if isinstance(opencode.get("defaultReasoningEffort"), str)
         else None,
     )
-    return [PROMPT_FILE_DISPLAY if item == PROMPT_FILE_ARG_PLACEHOLDER else item for item in argv]
+    return prompt_file_display_argv(argv)
 
 
 def _pi_family_describe_argv(section: JsonObject, engine: str, *, mode: str) -> list[str]:

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/harness_discovery.py

@@ -19,13 +19,17 @@ from collections.abc import Callable, Collection, Mapping
 from dataclasses import dataclass
 from datetime import UTC, datetime
 from pathlib import Path
-from typing import BinaryIO, TextIO
+from typing import BinaryIO, TextIO, TypeAlias
 
 from delegate_agent import config as delegate_config
 from delegate_agent import private_io, profiles, redaction
 from delegate_agent.constants import KNOWN_ENGINES
 from delegate_agent.json_types import JsonObject
 
+# A refresh-progress callback: called with each harness name before its probe
+# spawns. Shared by every caller that threads a progress hook into discovery.
+ProgressCallback: TypeAlias = Callable[[str], None]
+
 DISCOVERY_SCHEMA = 1
 PROBE_STATUSES = frozenset({"ok", "partial", "missing", "error"})
 MODEL_SCOPES = frozenset({"account", "configured", "catalog", "unknown"})
@@ -1364,7 +1368,7 @@ def probe_harness(
         )
 
 
-def stderr_probe_progress(stream: TextIO | None = None) -> Callable[[str], None]:
+def stderr_probe_progress(stream: TextIO | None = None) -> ProgressCallback:
     """Return a progress callback that names each harness as probing starts.
 
     Every probe is bounded by ``METADATA_PROBE_TIMEOUT_SEC``, so a wedged
@@ -1384,7 +1388,7 @@ def probe_all_harnesses(
     *,
     env: Mapping[str, str],
     factory_settings_path: Path | None = None,
-    progress: Callable[[str], None] | None = None,
+    progress: ProgressCallback | None = None,
 ) -> JsonObject:
     records: JsonObject = {}
     for harness in KNOWN_ENGINES:
@@ -1603,7 +1607,7 @@ def refresh_discovery(
     home: Path | None = None,
     factory_settings_path: Path | None = None,
     persist: bool = True,
-    progress: Callable[[str], None] | None = None,
+    progress: ProgressCallback | None = None,
 ) -> JsonObject:
     """Probe harnesses, optionally persisting successful last-known-good records."""
     if isinstance(engines, str):

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/inspection_commands.py

@@ -19,12 +19,15 @@ class SnapshotCommand:
 
 @dataclass(frozen=True)
 class RunsCommand:
+    action: str | None = None
     active: bool = False
     running: bool = False
     stale: bool = False
     harness: str | None = None
     group: str | None = None
     limit: int | None = None
+    older_than_days: int | None = None
+    dry_run: bool = False
     json_mode: bool = False
 
 
@@ -64,6 +67,34 @@ def emit_snapshot(command: SnapshotCommand, *, workspace_path: str, stdout: Text
 
 def emit_runs(command: RunsCommand, *, workspace_path: str, stdout: TextIO) -> int:
     registry_root = run_registry.registry_root_if_exists(Path(workspace_path))
+    if command.action == "prune":
+        older_than_days = (
+            command.older_than_days
+            if command.older_than_days is not None
+            else run_registry.DEFAULT_RUN_PRUNE_DAYS
+        )
+        payload = (
+            run_registry.prune_runs(
+                registry_root,
+                older_than_days=older_than_days,
+                dry_run=command.dry_run,
+            )
+            if registry_root is not None
+            else run_registry.empty_run_prune_payload(
+                older_than_days=older_than_days,
+                dry_run=command.dry_run,
+            )
+        )
+        if command.json_mode:
+            delegate_rendering.print_json(payload, stdout)
+        else:
+            delegate_rendering.render_runs_prune_text(payload, stdout)
+        if payload.get("ok") is False:
+            exit_code = payload.get("exitCode")
+            return exit_code if isinstance(exit_code, int) else 1
+        return 0
+    if command.action is not None:
+        raise InspectionError("unknown_runs_action", f"Unknown runs action: {command.action}")
     limit = command.limit or run_registry.DEFAULT_RUNS_LIMIT
     if command.running:
         mode = "running"

{delegate_agent_cli-0.21.0 → delegate_agent_cli-0.23.0}/src/delegate_agent/profiles.py

@@ -275,13 +275,8 @@ def preflight_codex_home(codex_home: str, *, codex: JsonObject) -> None:
             )
 
 
-def _request_resolution(request: object) -> ProfileResolution:
-    resolution = getattr(request, "profile_resolution", None)
-    return resolution if resolution is not None else empty_profile_resolution()
-
-
 def preflight_codex_request(request: object, codex_config: JsonObject) -> None:
-    resolution = _request_resolution(request)
+    resolution: ProfileResolution = request.profile_resolution  # type: ignore[attr-defined]
     if resolution.name is not None and resolution.codex_home is None:
         raise DelegateError(
             "profile_missing_codex_home",