cli-agent-runner 0.2.19__tar.gz → 0.2.20__tar.gz

{cli_agent_runner-0.2.19 → cli_agent_runner-0.2.20}/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be 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.2.20] - 2026-09-09
+
+### Fixed
+- A supervised CLI's `setsid()`-detached descendant — outside the round leader's process group — is now killed at the hard-kill fallthrough instead of being left running, orphaned, after the round is torn down.
+- A configured `docker run`/`podman run` command (including `sudo`/`env`-wrapped and global-flag forms) escapes killpg-based termination and could previously outlive the round silently. It's now detected, agent-runner warns loudly and emits a `round_container_orphan_risk` event that the hard-wall can't guarantee stopping it, and best-effort-stops the container via an injected `--cidfile` for the plain (unwrapped, unflagged) form. Full container lifecycle management remains a later-release item.
+
+### Notes
+- Not breaking: no `agent-runner migrate` step, no systemd unit change.
+- `peek --json` gains the new `round_container_orphan_risk` event kind; existing kinds unchanged.
+
 ## [0.2.19] - 2026-09-09
 
 ### Changed

{cli_agent_runner-0.2.19 → cli_agent_runner-0.2.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cli-agent-runner
-Version: 0.2.19
+Version: 0.2.20
 Summary: Restart-on-exit supervisor for autonomous CLI agents
 Project-URL: Homepage, https://github.com/wan9yu/cli-agent-runner
 Project-URL: Documentation, https://github.com/wan9yu/cli-agent-runner#readme

{cli_agent_runner-0.2.19 → cli_agent_runner-0.2.20}/agent_runner/_emit/__init__.py

@@ -40,6 +40,7 @@ from agent_runner._emit.memory import (  # noqa: F401 — public re-export
 )
 from agent_runner._emit.rounds import (  # noqa: F401 — public re-export
     emit_fresh_eyes_round_triggered,
+    emit_round_container_orphan_risk,
     emit_round_grace_extended,
     emit_round_grace_kill,
     emit_round_logs_prune_deferred,
@@ -79,6 +80,7 @@ __all__ = [
     "emit_mem_pressure_deferred_to_cgroup",
     "emit_rate_limit_stop",
     "emit_round_cgroup_memory",
+    "emit_round_container_orphan_risk",
     "emit_round_deferred",
     "emit_round_grace_extended",
     "emit_round_grace_kill",

{cli_agent_runner-0.2.19 → cli_agent_runner-0.2.20}/agent_runner/_emit/rounds.py

@@ -47,6 +47,42 @@ def emit_round_substrate_after(
     )
 
 
+def emit_round_container_orphan_risk(
+    log_dir: Path,
+    *,
+    round_num: int,
+    runtime: str,
+    container_id: str | None,
+    stop_ok: bool | None,
+) -> None:
+    """Emit when a round's configured command launches a container (`docker run`
+    / `podman run`) and the round had to be terminated: killpg-based
+    termination reaches the launcher process, not conmon/containerd's
+    double-fork-detached container itself, so the R1128 hard-wall cannot
+    guarantee the container stops. This event is the actual floor -- it must
+    never fire silently, regardless of whether the best-effort stop below
+    lands.
+
+    `container_id`/`stop_ok` describe the best-effort `<runtime> stop`
+    attempt made when an id was recoverable (an injected or pre-existing
+    `--cidfile`): `container_id` is None when no id could be recovered (no
+    stop was attempted, so `stop_ok` is also None); otherwise `stop_ok` is
+    whether that `stop` call exited zero. Full container lifecycle
+    management (cgroup delegation, a containment ladder) is out of scope
+    here -- left for a future release.
+    """
+    from agent_runner.events import ROUND_CONTAINER_ORPHAN_RISK, emit
+
+    emit(
+        log_dir,
+        ROUND_CONTAINER_ORPHAN_RISK,
+        round_num=round_num,
+        runtime=runtime,
+        container_id=container_id,
+        stop_ok=stop_ok,
+    )
+
+
 def emit_round_supervisor_wedged(
     log_dir: Path, *, pid: int, timeout_s: int, log_path: Path
 ) -> None:

{cli_agent_runner-0.2.19 → cli_agent_runner-0.2.20}/agent_runner/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.19'
-__version_tuple__ = version_tuple = (0, 2, 19)
+__version__ = version = '0.2.20'
+__version_tuple__ = version_tuple = (0, 2, 20)
 
 __commit_id__ = commit_id = None