Class LocalShellTaskState

src/tasks/local_shell.py:29–87

Runtime state for a background-bash task. Extension fields beyond ``TaskStateBase``: * ``command`` — the literal shell command the model requested. * ``cwd`` — the working directory (string for serializability; the spawner converts back to ``Path`` where needed). * ``pid`` —

@dataclass(kw_only=True)
class LocalShellTaskState(TaskStateBase):
    """Runtime state for a background-bash task.

    Extension fields beyond ``TaskStateBase``:

    * ``command`` — the literal shell command the model requested.
    * ``cwd`` — the working directory (string for serializability; the
      spawner converts back to ``Path`` where needed).
    * ``pid`` — OS process id of the wrapped ``bash -lc`` invocation.
    * ``output_path`` — the on-disk capture file (combined stdout/stderr).
      ``output_file`` on the base carries the same string for chapter-10
      uniformity; ``output_path`` is kept as the bash-specific name to
      avoid breaking existing readers.
    * ``exit_code`` — populated by the reaper thread once the process exits;
      ``None`` while running.
    * ``finished_at`` — populated alongside ``exit_code``.
    * ``proc`` / ``handle`` — runtime-only handles. Underscore-prefixed in
      the legacy dict-of-dicts; here they're regular attributes guarded by
      ``field(repr=False)`` so they don't leak into snapshots / logs.
    """

    type: Literal["local_bash"] = "local_bash"  # type: ignore[assignment]
    command: str = ""
    cwd: str = ""
    pid: int | None = None
    output_path: str = ""
    exit_code: int | None = None
    finished_at: float | None = None
    proc: subprocess.Popen | None = field(default=None, repr=False, compare=False)
    handle: IO[bytes] | None = field(default=None, repr=False, compare=False)

    def derived_status(self) -> Literal["running", "completed", "failed"]:
        """Compute the legacy three-value status string used by the bash
        background reader. Independent of ``self.status`` (which uses the
        canonical 5-value chapter-10 vocabulary)."""
        rc = self.exit_code
        if rc is None:
            return "running"
        return "completed" if rc == 0 else "failed"

    def to_legacy_dict(self) -> dict[str, Any]:
        """Project back to the dict-of-dicts shape that the pre-Chunk-B
        readers used. Kept for back-compat during the migration cycle so
        the deprecated ``ToolContext.background_bash_tasks`` view exposes
        the historical key set unchanged.
        """
        return {
            "task_id": self.id,
            "command": self.command,
            "description": self.description,
            "cwd": self.cwd,
            "started_at": self.start_time,
            "output_path": self.output_path,
            "pid": self.pid,
            "_proc": self.proc,
            "_handle": self.handle,
            "exit_code": self.exit_code,
            "finished_at": self.finished_at,