diff --git a/lib/python/agentic_isolation/agentic_isolation/run_client.py b/lib/python/agentic_isolation/agentic_isolation/run_client.py new file mode 100644 index 00000000..251b2b03 --- /dev/null +++ b/lib/python/agentic_isolation/agentic_isolation/run_client.py @@ -0,0 +1,446 @@ +"""Thin Python client for the Rust ``itmux run`` binary (Plan B, Task 7). + +This module is deliberately *thin*: it owns no orchestration and no business +logic. All of that lives in the Rust ``itmux run`` subcommand. The client's +sole responsibilities are: + +1. Mirror the wire contract (`AgentRunSpec` / `AgentRunResult` / `AgentRunEvent`) + as strict Pydantic v2 models whose field names match the Rust serde names + exactly. See the authoritative source at + ``providers/workspaces/interactive-tmux/driver-rs/src/run/contract.rs`` and + the generated JSON schema under ``.../driver-rs/docs/contract/``. +2. Spawn ``itmux run`` in JSON mode, stream the stdout event JSONL, parse each + line into a typed :data:`AgentRunEvent`, and return the terminal + :class:`AgentRunResult`. +3. Never leak a child process. The child (and any ``docker exec`` grandchildren + it spawns) runs in its own process group; on cancel / crash / timeout the + whole group is signalled ``SIGTERM`` then, after a grace period, ``SIGKILL`` + (R10 process-group cleanup). + +Supersedes the hand-written Python contract proposed in #240 - that contract is +replaced by this Rust-mirrored one and #240 is closed separately. +""" + +from __future__ import annotations + +import os +import signal +import subprocess +import threading +import time +from collections.abc import Callable +from pathlib import Path +from typing import Annotated, Literal + +from pydantic import ( + BaseModel, + ConfigDict, + Field, + JsonValue, + StrictBool, + TypeAdapter, + ValidationError, +) + +__all__ = [ + "AgentRunOutcome", + "ObservabilityBundle", + "AgentRunResult", + "ToolStartEvent", + "ToolEndEvent", + "TokenUsageEvent", + "SessionEndEvent", + "ResultEvent", + "AgentRunEvent", + "ItmuxRunError", + "run_agent", +] + + +# --------------------------------------------------------------------------- +# Contract models (mirror `contract.rs` serde field names exactly). +# --------------------------------------------------------------------------- + +# `frozen=True` mirrors the immutability of the Rust structs; `extra="forbid"` +# mirrors serde's `#[serde(deny_unknown_fields)]` so a typo'd or stale field +# fails loudly instead of being silently ignored. +_CONTRACT_CONFIG = ConfigDict(frozen=True, extra="forbid") + +# Rust `u64` fields (schema `minimum:0`). `strict=True` refuses lax coercion +# (e.g. the string "1" -> 1) so malformed lines are rejected exactly as serde +# would reject them; `ge=0` enforces the unsigned lower bound. `bool` fields use +# `StrictBool` so the string "false" is rejected rather than coerced to a bool. +_U64 = Annotated[int, Field(strict=True, ge=0)] + + +class AgentRunOutcome(BaseModel): + """The success/failure verdict for a run (Rust ``AgentRunOutcome``).""" + + model_config = _CONTRACT_CONFIG + + success: StrictBool + summary: str + + +class ObservabilityBundle(BaseModel): + """Plan 3 placeholder bundle (Rust ``ObservabilityBundle``).""" + + model_config = _CONTRACT_CONFIG + + name: str = "" + # serde: `serde_json::Value` defaulting to null -> arbitrary JSON, default None. + data: JsonValue = None + + +class AgentRunResult(BaseModel): + """Terminal result of ``itmux run`` (Rust ``AgentRunResult``).""" + + model_config = _CONTRACT_CONFIG + + result: AgentRunOutcome + # serde `PathBuf` serializes as a string; default empty list. + output_artifacts: list[str] = Field(default_factory=list) + session_log: str + observability: ObservabilityBundle | None = None + + +class _RunEventEnvelope(BaseModel): + """Common envelope fields flattened onto every ``AgentRunEvent`` line.""" + + model_config = _CONTRACT_CONFIG + + run_id: str + seq: _U64 + ts: str + + +class ToolStartEvent(_RunEventEnvelope): + """``type: "tool_start"`` payload.""" + + type: Literal["tool_start"] = "tool_start" + tool_name: str + tool_input: JsonValue = None + + +class ToolEndEvent(_RunEventEnvelope): + """``type: "tool_end"`` payload.""" + + type: Literal["tool_end"] = "tool_end" + tool_name: str + success: StrictBool = False + output_summary: str | None = None + + +class TokenUsageEvent(_RunEventEnvelope): + """``type: "token_usage"`` payload.""" + + type: Literal["token_usage"] = "token_usage" + input_tokens: _U64 + output_tokens: _U64 + cost_usd: float | None = None + + +class SessionEndEvent(_RunEventEnvelope): + """``type: "session_end"`` terminal lifecycle payload.""" + + type: Literal["session_end"] = "session_end" + outcome: AgentRunOutcome + + +class ResultEvent(_RunEventEnvelope): + """``type: "result"`` final-result delivery envelope.""" + + type: Literal["result"] = "result" + result: AgentRunResult + + +# Internally-tagged discriminated union on the ``type`` field, mirroring the +# Rust ``#[serde(tag = "type")]`` enum. Pydantic uses the ``type`` discriminator +# to pick exactly one variant, and each variant's ``extra="forbid"`` rejects any +# stray key - the same guarantee serde's per-variant `deny_unknown_fields` gives. +AgentRunEvent = Annotated[ + ToolStartEvent | ToolEndEvent | TokenUsageEvent | SessionEndEvent | ResultEvent, + Field(discriminator="type"), +] + +_EVENT_ADAPTER: TypeAdapter[AgentRunEvent] = TypeAdapter(AgentRunEvent) + + +def parse_event(line: str) -> AgentRunEvent: + """Parse one JSONL line of ``itmux run`` stdout into a typed event. + + Raises :class:`ItmuxRunError` if the line is not a valid ``AgentRunEvent``. + """ + try: + return _EVENT_ADAPTER.validate_json(line) + except ValidationError as exc: + raise ItmuxRunError(f"unparseable itmux run event: {line!r}") from exc + + +# --------------------------------------------------------------------------- +# Error type. +# --------------------------------------------------------------------------- + + +class ItmuxRunError(RuntimeError): + """Raised when an ``itmux run`` invocation fails to produce a valid result. + + Covers: non-zero exit with no terminal result, unparseable stdout, a + missing terminal result event, and run timeout. + """ + + def __init__( + self, + message: str, + *, + returncode: int | None = None, + stderr: str | None = None, + ) -> None: + super().__init__(message) + self.returncode = returncode + self.stderr = stderr + + +# --------------------------------------------------------------------------- +# Process-group cleanup (R10). +# --------------------------------------------------------------------------- + +# Grace for crash / timeout / cancel teardown: the Rust leader may be mid-run +# and needs time after SIGTERM to tear its container down before we SIGKILL. +_DEFAULT_KILL_GRACE_S = 5.0 +# Grace once a terminal result has already been delivered: the leader has +# finished its work (the orchestrator tears the container down BEFORE emitting +# the result) and is exiting, so only a short SIGTERM->SIGKILL window is needed. +_RESULT_TEARDOWN_GRACE_S = 0.5 +# Chunk the grace sleep so we do not oversleep a short grace. +_GRACE_SLEEP_CHUNK_S = 0.05 + + +def _killpg_quiet(pgid: int, sig: int) -> bool: + """Signal a process group, swallowing "already gone" errors. + + Returns ``True`` if the signal was delivered (group still existed), + ``False`` if the group was already gone or the call was rejected. + """ + try: + os.killpg(pgid, sig) + return True + except (ProcessLookupError, OSError): + return False + + +def _terminate_process_group( + proc: subprocess.Popen[str], + *, + grace_s: float = _DEFAULT_KILL_GRACE_S, +) -> None: + """Tear the child's whole process group down, kill-before-reap. + + The child is started with ``start_new_session=True`` so it leads its own + process group whose pgid equals the leader pid. Signalling the group reaches + the Rust process AND any ``docker exec`` grandchildren it spawned. + + Ordering (codex must-fix 1+2, refined): + + 1. ``SIGTERM`` the whole group FIRST so the Rust leader can run its own + graceful container teardown; a premature ``SIGKILL`` would orphan the + docker CONTAINER (the orchestrator tears it down on graceful signals, + see #248). + 2. Wait a bounded grace period WITHOUT reaping the leader. + 3. ``SIGKILL`` the whole group to reap any survivor (a docker-exec + grandchild can outlive the leader). + 4. ONLY THEN reap the leader zombie. + + PID-reuse safety - the load-bearing invariant: the leader must stay + UNREAPED (alive or zombie) until AFTER the final group signal. An unreaped + leader keeps its pid (== pgid) reserved by the kernel, so every ``killpg`` + below provably targets OUR group and can never hit a recycled pgid. This is + why the grace phase must NOT call ``proc.poll()`` / ``proc.wait()`` / + ``os.waitpid`` - reaping the zombie frees the pid and the pgid could be + recycled by a concurrent fork before step 3. ``killpg(pgid, 0)`` also cannot + detect "descendants gone" while the unreaped zombie still occupies the + group, so there is no correct non-reaping early exit: we simply sleep the + (short) grace. Teardown latency is an acceptable trade for the guarantee. + The early ``returncode`` guard covers a second teardown pass: if the leader + was already reaped, never signal its possibly-recycled pgid again. + """ + # Guard: if the leader has already been reaped, its pid (== pgid) may have + # been recycled by the kernel - never signal it again. + if proc.returncode is not None: + return + + # start_new_session=True guarantees pgid == leader pid. + pgid = proc.pid + + # 1. Graceful group termination first. + _killpg_quiet(pgid, signal.SIGTERM) + + # 2. Bounded grace, WITHOUT reaping (see the PID-reuse invariant above). + deadline = time.monotonic() + grace_s + while True: + remaining = deadline - time.monotonic() + if remaining <= 0: + break + time.sleep(min(_GRACE_SLEEP_CHUNK_S, remaining)) + + # 3. Force-kill the whole group. Provably safe: the still-unreaped leader + # has kept the pgid reserved to us. Any surviving grandchild dies here. + _killpg_quiet(pgid, signal.SIGKILL) + + # 4. Reap the leader LAST. Grandchildren SIGKILL'd above are orphaned to + # init, which reaps them. + try: + proc.wait(timeout=grace_s) + except subprocess.TimeoutExpired: + pass + + +# --------------------------------------------------------------------------- +# Public entry point. +# --------------------------------------------------------------------------- + + +def run_agent( + recipe: Path, + task: str, + *, + image: str | None = None, + itmux_bin: str = "itmux", + on_event: Callable[[AgentRunEvent], None] | None = None, + timeout: float | None = None, +) -> AgentRunResult: + """Run a recipe via ``itmux run`` and return its terminal result. + + Spawns ``itmux run --recipe --task [--image ] + --json true`` in its own process group, streams the stdout event JSONL, + invokes ``on_event`` once per parsed :data:`AgentRunEvent`, and returns the + :class:`AgentRunResult` carried by the terminal ``result``-payload event. + + Args: + recipe: Path to a recipe directory (Plan A shape). + task: Task text handed to the recipe's default agent. + image: Optional container image override. + itmux_bin: Path or name of the ``itmux`` binary (default ``"itmux"``). + on_event: Optional callback invoked once per streamed event. + timeout: Optional wall-clock timeout (seconds) for the whole run. + + Raises: + ItmuxRunError: on non-zero exit with no result, unparseable output, + a missing terminal result, or timeout. + """ + argv = [itmux_bin, "run", "--recipe", str(recipe), "--task", task] + if image is not None: + argv += ["--image", image] + # `--json` is a clap `ArgAction::Set` bool (default true): it REQUIRES an + # explicit value, so pass `--json true` rather than a bare `--json` flag. + argv += ["--json", "true"] + + # `start_new_session=True` -> os.setsid in the child: it leads a new process + # group so cleanup can signal the whole tree (Rust + docker exec children). + proc = subprocess.Popen( + argv, + stdout=subprocess.PIPE, + stderr=subprocess.PIPE, + text=True, + start_new_session=True, + ) + + stderr_chunks: list[str] = [] + + def _drain_stderr() -> None: + # Drain stderr concurrently so a chatty child (human logs go to stderr) + # can never deadlock against a full pipe while we read stdout. + if proc.stderr is not None: + for line in proc.stderr: + stderr_chunks.append(line) + + stderr_thread = threading.Thread(target=_drain_stderr, daemon=True) + stderr_thread.start() + + # Teardown must run at most once. The watchdog (on timeout) and the finally + # block are two independent teardown paths on different threads; if both ran + # a full SIGTERM->grace->SIGKILL->reap, one could reap the leader while the + # other is still sleeping its grace, freeing the pgid before that thread's + # SIGKILL (the exact PID-reuse race we must avoid). The lock + once-flag + # serialize them: the first caller does the whole teardown holding the lock; + # the second blocks, then sees it is done and returns. + teardown_lock = threading.Lock() + torn_down = False + + def _teardown(grace_s: float) -> None: + nonlocal torn_down + with teardown_lock: + if torn_down: + return + _terminate_process_group(proc, grace_s=grace_s) + torn_down = True + + timed_out = threading.Event() + watchdog: threading.Timer | None = None + if timeout is not None: + + def _on_timeout() -> None: + timed_out.set() + # Timeout/cancel path: the leader may be mid-run - give it the full + # grace to tear its container down after SIGTERM. + _teardown(_DEFAULT_KILL_GRACE_S) + + watchdog = threading.Timer(timeout, _on_timeout) + watchdog.daemon = True + watchdog.start() + + result: AgentRunResult | None = None + try: + assert proc.stdout is not None # PIPE is always set above + for raw_line in proc.stdout: + line = raw_line.strip() + if not line: + continue + event = parse_event(line) + if on_event is not None: + on_event(event) + if isinstance(event, ResultEvent): + result = event.result + # The Rust contract guarantees the process exits after the + # terminal result event. We break rather than draining to EOF so + # a child that emits the result then hangs cannot block us when + # `timeout` is None - liveness must not depend on that guarantee. + break + finally: + if watchdog is not None: + watchdog.cancel() + # Kill-before-reap: tear the whole process group down BEFORE reaping the + # leader (see `_terminate_process_group`). Runs on every exit path - + # normal return, timeout, parse error, KeyboardInterrupt. A delivered + # result means the leader has finished and is exiting, so a short grace + # suffices; otherwise use the full crash/cancel grace. + _teardown(_RESULT_TEARDOWN_GRACE_S if result is not None else _DEFAULT_KILL_GRACE_S) + # Join the stderr drain only AFTER the group is dead - otherwise a + # surviving grandchild holding the stderr pipe could block the join. + stderr_thread.join(timeout=_DEFAULT_KILL_GRACE_S) + + returncode = proc.returncode + stderr_text = "".join(stderr_chunks) + + # Result wins over a simultaneous timeout (Claude nit 1): if a valid terminal + # result was delivered, return it even if the watchdog fired in the same + # instant. Only treat the run as timed out / failed when there is no result. + if result is not None: + return result + if timed_out.is_set(): + raise ItmuxRunError( + f"itmux run timed out after {timeout}s", + returncode=returncode, + stderr=stderr_text, + ) + if returncode is not None and returncode != 0: + raise ItmuxRunError( + f"itmux run exited with code {returncode} and produced no result", + returncode=returncode, + stderr=stderr_text, + ) + raise ItmuxRunError( + "itmux run produced no terminal result event", + returncode=returncode, + stderr=stderr_text, + ) diff --git a/lib/python/agentic_isolation/pyproject.toml b/lib/python/agentic_isolation/pyproject.toml index 3cb6990f..9e16f849 100644 --- a/lib/python/agentic_isolation/pyproject.toml +++ b/lib/python/agentic_isolation/pyproject.toml @@ -20,7 +20,9 @@ classifiers = [ "Topic :: Software Development :: Libraries :: Python Modules", ] -dependencies = [] +dependencies = [ + "pydantic>=2,<3", +] [project.optional-dependencies] docker = [ @@ -60,6 +62,7 @@ python_version = "3.10" strict = true warn_return_any = true warn_unused_ignores = true +plugins = ["pydantic.mypy"] [tool.pytest.ini_options] testpaths = ["tests"] diff --git a/lib/python/agentic_isolation/tests/test_run_client.py b/lib/python/agentic_isolation/tests/test_run_client.py new file mode 100644 index 00000000..3301e94d --- /dev/null +++ b/lib/python/agentic_isolation/tests/test_run_client.py @@ -0,0 +1,508 @@ +"""Tests for the thin ``itmux run`` Python client (Plan B, Task 7). + +No real docker and no real ``itmux`` binary are required: every subprocess test +drives a FAKE ``itmux`` (a tiny Python script on disk) whose path is passed as +``itmux_bin``. +""" + +from __future__ import annotations + +import json +import os +import signal +import subprocess +import sys +import time +from pathlib import Path + +import pytest + +from agentic_isolation import run_client +from agentic_isolation.run_client import ( + _EVENT_ADAPTER, + AgentRunEvent, + AgentRunResult, + ItmuxRunError, + ResultEvent, + SessionEndEvent, + TokenUsageEvent, + ToolEndEvent, + ToolStartEvent, + _terminate_process_group, + parse_event, + run_agent, +) + + +@pytest.fixture(autouse=True) +def _fast_teardown(monkeypatch: pytest.MonkeyPatch) -> None: + """Shrink the teardown grace so no-result / timeout tests stay fast. + + Production defaults (5s crash grace, 0.5s post-result grace) are correct but + slow to sit through in every subprocess test. `run_agent` reads these as + module globals at call time, so patching them here takes effect without + changing behavior under test. + """ + monkeypatch.setattr(run_client, "_DEFAULT_KILL_GRACE_S", 0.3) + monkeypatch.setattr(run_client, "_RESULT_TEARDOWN_GRACE_S", 0.1) + + +# --------------------------------------------------------------------------- +# Canned event stream mirroring the Rust contract wire shape. +# --------------------------------------------------------------------------- + +_RESULT_PAYLOAD = { + "result": {"success": True, "summary": "done"}, + "output_artifacts": ["/work/out.txt"], + "session_log": "pane transcript", + "observability": None, +} + +_EVENT_LINES: list[str] = [ + json.dumps( + { + "run_id": "r1", + "seq": 0, + "ts": "2026-07-07T00:00:00Z", + "type": "tool_start", + "tool_name": "Bash", + "tool_input": {"command": "ls"}, + } + ), + json.dumps( + { + "run_id": "r1", + "seq": 1, + "ts": "2026-07-07T00:00:01Z", + "type": "tool_end", + "tool_name": "Bash", + "success": True, + "output_summary": "ok", + } + ), + json.dumps( + { + "run_id": "r1", + "seq": 2, + "ts": "2026-07-07T00:00:02Z", + "type": "token_usage", + "input_tokens": 100, + "output_tokens": 50, + "cost_usd": 0.01, + } + ), + json.dumps( + { + "run_id": "r1", + "seq": 3, + "ts": "2026-07-07T00:00:03Z", + "type": "session_end", + "outcome": {"success": True, "summary": "done"}, + } + ), + json.dumps( + { + "run_id": "r1", + "seq": 4, + "ts": "2026-07-07T00:00:04Z", + "type": "result", + "result": _RESULT_PAYLOAD, + } + ), +] + + +def _write_fake_itmux(tmp_path: Path, body: str) -> Path: + """Write an executable fake ``itmux`` Python script and return its path.""" + script = tmp_path / "fake_itmux" + script.write_text("#!/usr/bin/env python3\n" + body) + script.chmod(0o755) + return script + + +# --------------------------------------------------------------------------- +# Model / discriminated-union parsing. +# --------------------------------------------------------------------------- + + +def test_parse_event_discriminates_each_variant() -> None: + events = [parse_event(line) for line in _EVENT_LINES] + assert isinstance(events[0], ToolStartEvent) + assert isinstance(events[1], ToolEndEvent) + assert isinstance(events[2], TokenUsageEvent) + assert isinstance(events[3], SessionEndEvent) + assert isinstance(events[4], ResultEvent) + + # Field names mirror the Rust serde names exactly. + assert events[0].tool_name == "Bash" + assert events[0].tool_input == {"command": "ls"} + assert events[2].input_tokens == 100 + assert events[2].output_tokens == 50 + assert events[2].cost_usd == pytest.approx(0.01) + assert events[3].outcome.success is True + + result_event = events[4] + assert isinstance(result_event, ResultEvent) + assert result_event.result.result.summary == "done" + assert result_event.result.output_artifacts == ["/work/out.txt"] + assert result_event.result.session_log == "pane transcript" + + +def test_parse_event_rejects_unknown_field() -> None: + bad = json.dumps( + { + "run_id": "r1", + "seq": 0, + "ts": "t", + "type": "tool_start", + "tool_name": "Bash", + "surprise": 1, + } + ) + with pytest.raises(ItmuxRunError): + parse_event(bad) + + +def test_parse_event_rejects_unknown_discriminator() -> None: + bad = json.dumps({"run_id": "r1", "seq": 0, "ts": "t", "type": "nope"}) + with pytest.raises(ItmuxRunError): + parse_event(bad) + + +def test_result_model_rejects_unknown_field() -> None: + from pydantic import ValidationError + + with pytest.raises(ValidationError): + AgentRunResult.model_validate( + {"result": {"success": True, "summary": "s"}, "session_log": "l", "extra": 1} + ) + + +def test_optional_defaults_match_contract() -> None: + line = json.dumps( + {"run_id": "r1", "seq": 0, "ts": "t", "type": "tool_end", "tool_name": "Read"} + ) + event = _EVENT_ADAPTER.validate_json(line) + assert isinstance(event, ToolEndEvent) + assert event.success is False # serde default + assert event.output_summary is None + + +@pytest.mark.parametrize( + "line", + [ + # seq is u64 (schema minimum:0) - a negative value must be rejected. + json.dumps({"run_id": "r", "seq": -1, "ts": "t", "type": "tool_start", "tool_name": "B"}), + # input_tokens is u64 - a string must NOT be coerced (serde would reject it). + json.dumps( + { + "run_id": "r", + "seq": 0, + "ts": "t", + "type": "token_usage", + "input_tokens": "1", + "output_tokens": 2, + } + ), + # output_tokens is u64 - a negative value must be rejected. + json.dumps( + { + "run_id": "r", + "seq": 0, + "ts": "t", + "type": "token_usage", + "input_tokens": 1, + "output_tokens": -2, + } + ), + # success is bool - a string must NOT be coerced. + json.dumps( + { + "run_id": "r", + "seq": 0, + "ts": "t", + "type": "tool_end", + "tool_name": "B", + "success": "false", + } + ), + ], +) +def test_parse_event_rejects_malformed_scalar(line: str) -> None: + with pytest.raises(ItmuxRunError): + parse_event(line) + + +# --------------------------------------------------------------------------- +# run_agent happy path. +# --------------------------------------------------------------------------- + + +def test_run_agent_returns_result_and_streams_events(tmp_path: Path) -> None: + lines_literal = json.dumps(_EVENT_LINES) + body = ( + "import sys\n" + f"for line in {lines_literal}:\n" + " print(line)\n" + " sys.stdout.flush()\n" + "sys.exit(0)\n" + ) + fake = _write_fake_itmux(tmp_path, body) + + seen: list[object] = [] + result = run_agent( + Path("/recipes/demo"), + "do the thing", + itmux_bin=str(fake), + on_event=seen.append, + ) + + assert isinstance(result, AgentRunResult) + assert result.result.success is True + assert result.result.summary == "done" + assert result.output_artifacts == ["/work/out.txt"] + # on_event fires once per streamed event, including the terminal result. + assert len(seen) == len(_EVENT_LINES) + assert isinstance(seen[-1], ResultEvent) + + +def test_run_agent_passes_expected_argv(tmp_path: Path) -> None: + # Fake echoes its argv (as a session_log) so we can assert the built command. + result_payload = dict(_RESULT_PAYLOAD) + body = ( + "import sys, json\n" + "argv = sys.argv[1:]\n" + "payload = {'result': {'success': True, 'summary': ' '.join(argv)},\n" + " 'session_log': 'x'}\n" + "print(json.dumps({'run_id': 'r', 'seq': 0, 'ts': 't', 'type': 'result',\n" + " 'result': payload}))\n" + ) + del result_payload # not needed; kept for clarity + fake = _write_fake_itmux(tmp_path, body) + + result = run_agent( + Path("/recipes/demo"), + "my task", + image="custom:tag", + itmux_bin=str(fake), + ) + argv_summary = result.result.summary + assert "run --recipe /recipes/demo --task my task" in argv_summary + assert "--image custom:tag" in argv_summary + assert "--json true" in argv_summary + + +# --------------------------------------------------------------------------- +# run_agent failure paths. +# --------------------------------------------------------------------------- + + +def test_run_agent_nonzero_exit_no_result_raises(tmp_path: Path) -> None: + body = "import sys\nprint('boom: recipe failed to load', file=sys.stderr)\nsys.exit(1)\n" + fake = _write_fake_itmux(tmp_path, body) + + with pytest.raises(ItmuxRunError) as exc_info: + run_agent(Path("/recipes/demo"), "task", itmux_bin=str(fake)) + assert exc_info.value.returncode == 1 + assert "boom" in (exc_info.value.stderr or "") + + +def test_run_agent_zero_exit_no_result_raises(tmp_path: Path) -> None: + body = "import sys\nsys.exit(0)\n" # no events at all + fake = _write_fake_itmux(tmp_path, body) + + with pytest.raises(ItmuxRunError, match="no terminal result"): + run_agent(Path("/recipes/demo"), "task", itmux_bin=str(fake)) + + +def test_run_agent_unparseable_output_raises(tmp_path: Path) -> None: + body = "print('not json at all')\n" + fake = _write_fake_itmux(tmp_path, body) + + with pytest.raises(ItmuxRunError, match="unparseable"): + run_agent(Path("/recipes/demo"), "task", itmux_bin=str(fake)) + + +# --------------------------------------------------------------------------- +# Process-group cleanup (R10). +# --------------------------------------------------------------------------- + + +def test_terminate_process_group_signals_pgid(monkeypatch: pytest.MonkeyPatch) -> None: + # Spawn a real child in its own session/group so os.getpgid works, then + # monkeypatch os.killpg to record the signals sent instead of delivering. + proc = subprocess.Popen( + [sys.executable, "-c", "import time; time.sleep(30)"], + start_new_session=True, + text=True, + ) + try: + expected_pgid = os.getpgid(proc.pid) + calls: list[tuple[int, int]] = [] + monkeypatch.setattr(os, "killpg", lambda pgid, sig: calls.append((pgid, sig))) + + # grace 0.1 so the SIGTERM->SIGKILL escalation is fast (killpg is faked, + # so the child never actually dies during the call). + _terminate_process_group(proc, grace_s=0.1) + + assert (expected_pgid, signal.SIGTERM) in calls + assert (expected_pgid, signal.SIGKILL) in calls + finally: + # Undo the killpg patch BEFORE real cleanup so the child actually dies. + monkeypatch.undo() + try: + os.killpg(os.getpgid(proc.pid), signal.SIGKILL) + except (ProcessLookupError, OSError): + pass + proc.wait(timeout=5) + + +def _process_running(pid: int) -> bool: + """True only if ``pid`` is a *live* (non-zombie) process. + + ``os.kill(pid, 0)`` is unusable here: it succeeds for a zombie (killed but + not yet reaped), so it would call a dead-but-unreaped process "alive". We + instead read the process state via ``ps``; a missing process or a zombie + (state ``Z``) counts as not running. + """ + proc = subprocess.run( + ["ps", "-p", str(pid), "-o", "state="], + capture_output=True, + text=True, + check=False, + ) + if proc.returncode != 0: + return False # no such process + state = proc.stdout.strip() + return state != "" and not state.startswith("Z") + + +def _wait_until_dead(pid: int, timeout_s: float = 5.0) -> bool: + deadline = time.time() + timeout_s + while time.time() < deadline: + if not _process_running(pid): + return True + time.sleep(0.05) + return not _process_running(pid) + + +@pytest.mark.skipif(os.name != "posix", reason="process groups are POSIX-only") +def test_run_agent_timeout_reaps_child_tree(tmp_path: Path) -> None: + # Fake emits one event, spawns a long-lived grandchild recording its PID, + # then blocks forever WITHOUT emitting a result. run_agent's timeout must + # kill the whole process group and leave no orphan. + pid_file = tmp_path / "grandchild.pid" + body = ( + "import os, sys, time, subprocess\n" + 'print(\'{"run_id": "r", "seq": 0, "ts": "t", ' + '"type": "tool_start", "tool_name": "Bash"}\')\n' + "sys.stdout.flush()\n" + "child = subprocess.Popen([sys.executable, '-c', 'import time; time.sleep(60)'])\n" + f"open({str(pid_file)!r}, 'w').write(str(child.pid))\n" + "time.sleep(60)\n" + ) + fake = _write_fake_itmux(tmp_path, body) + + with pytest.raises(ItmuxRunError, match="timed out"): + run_agent(Path("/recipes/demo"), "task", itmux_bin=str(fake), timeout=1.0) + + grandchild_pid = int(pid_file.read_text().strip()) + dead = _wait_until_dead(grandchild_pid) + if not dead: + try: + os.kill(grandchild_pid, signal.SIGKILL) + except ProcessLookupError: + pass + assert dead, "grandchild process was orphaned (not reaped by group cleanup)" + + +@pytest.mark.skipif(os.name != "posix", reason="process groups are POSIX-only") +def test_run_agent_reaps_grandchild_when_leader_exits_first(tmp_path: Path) -> None: + # Root cause of codex must-fix 1+2: the leader exits 0 immediately, but a + # grandchild survives it (double-fork'd out of the leader's lifetime). + # Because the leader is gone, a poll()-short-circuit would skip the group + # kill and leak the grandchild. Kill-before-reap must still tear it down. + pid_file = tmp_path / "grandchild.pid" + body = ( + "import os, sys, subprocess\n" + # Spawn a grandchild that outlives the leader, holding stdout open. + "child = subprocess.Popen([sys.executable, '-c', 'import time; time.sleep(60)'])\n" + f"open({str(pid_file)!r}, 'w').write(str(child.pid))\n" + # Emit a valid result so run_agent returns normally, then exit 0 while + # the grandchild keeps sleeping. + 'print(\'{"run_id": "r", "seq": 0, "ts": "t", "type": "result", ' + '"result": {"result": {"success": true, "summary": "ok"}, ' + '"session_log": "x"}}\')\n' + "sys.stdout.flush()\n" + "sys.exit(0)\n" + ) + fake = _write_fake_itmux(tmp_path, body) + + result = run_agent(Path("/recipes/demo"), "task", itmux_bin=str(fake)) + assert result.result.success is True + + grandchild_pid = int(pid_file.read_text().strip()) + dead = _wait_until_dead(grandchild_pid) + if not dead: + try: + os.kill(grandchild_pid, signal.SIGKILL) + except ProcessLookupError: + pass + assert dead, "grandchild survived the leader and was leaked" + + +def test_run_agent_result_wins_over_simultaneous_timeout(tmp_path: Path) -> None: + # A run that delivers a valid result must return it even when the wall-clock + # timeout has fired (Claude nit 1). Deterministic: an on_event callback that + # blocks on the ResultEvent lets the watchdog fire (setting timed_out and + # tearing the group down) WHILE run_agent already holds the parsed result - + # so both `timed_out.is_set()` and a non-None result are true at decision + # time, and the result must win. + body = ( + "import sys\n" + 'print(\'{"run_id": "r", "seq": 0, "ts": "t", "type": "result", ' + '"result": {"result": {"success": true, "summary": "ok"}, ' + '"session_log": "x"}}\')\n' + "sys.stdout.flush()\n" + "sys.exit(0)\n" + ) + fake = _write_fake_itmux(tmp_path, body) + + def block_on_result(event: AgentRunEvent) -> None: + if isinstance(event, ResultEvent): + # Block well past the timeout so the watchdog fires (and tears the + # group down) while run_agent already holds the parsed result. + time.sleep(1.0) + + # timeout comfortably exceeds the fake's process startup so the result line + # is always read first; the long on_event block is what makes the watchdog + # fire afterwards, deterministically. + result = run_agent( + Path("/recipes/demo"), + "task", + itmux_bin=str(fake), + on_event=block_on_result, + timeout=0.5, + ) + assert result.result.summary == "ok" + + +def test_run_agent_breaks_on_result_without_waiting_for_eof(tmp_path: Path) -> None: + # timeout=None (default): a child that emits the result then hangs forever + # must not block run_agent - it breaks on the terminal ResultEvent (Claude + # nit 2). A generous test-level guard proves we do not hang to EOF. + body = ( + "import sys, time\n" + 'print(\'{"run_id": "r", "seq": 0, "ts": "t", "type": "result", ' + '"result": {"result": {"success": true, "summary": "ok"}, ' + '"session_log": "x"}}\')\n' + "sys.stdout.flush()\n" + "time.sleep(60)\n" # hang: EOF never arrives + ) + fake = _write_fake_itmux(tmp_path, body) + + start = time.time() + result = run_agent(Path("/recipes/demo"), "task", itmux_bin=str(fake)) + elapsed = time.time() - start + assert result.result.summary == "ok" + assert elapsed < 30, f"run_agent blocked waiting for EOF ({elapsed:.1f}s)" diff --git a/lib/python/agentic_isolation/uv.lock b/lib/python/agentic_isolation/uv.lock index 1514a38e..4c118dea 100644 --- a/lib/python/agentic_isolation/uv.lock +++ b/lib/python/agentic_isolation/uv.lock @@ -6,6 +6,9 @@ requires-python = ">=3.10" name = "agentic-isolation" version = "0.4.0" source = { editable = "." } +dependencies = [ + { name = "pydantic" }, +] [package.optional-dependencies] dev = [ @@ -22,12 +25,22 @@ docker = [ requires-dist = [ { name = "docker", marker = "extra == 'docker'", specifier = ">=7.0.0" }, { name = "mypy", marker = "extra == 'dev'", specifier = ">=1.8.0" }, + { name = "pydantic", specifier = ">=2,<3" }, { name = "pytest", marker = "extra == 'dev'", specifier = ">=8.0.0" }, { name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.23.0" }, { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.3.0" }, ] provides-extras = ["docker", "dev"] +[[package]] +name = "annotated-types" +version = "0.7.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" }, +] + [[package]] name = "backports-asyncio-runner" version = "1.2.0" @@ -343,6 +356,137 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" }, ] +[[package]] +name = "pydantic" +version = "2.13.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "annotated-types" }, + { name = "pydantic-core" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/18/a5/b60d21ac674192f8ab0ba4e9fd860690f9b4a6e51ca5df118733b487d8d6/pydantic-2.13.4.tar.gz", hash = "sha256:c40756b57adaa8b1efeeced5c196f3f3b7c435f90e84ea7f443901bec8099ef6", size = 844775, upload-time = "2026-05-06T13:43:05.343Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/fd/7b/122376b1fd3c62c1ed9dc80c931ace4844b3c55407b6fb2d199377c9736f/pydantic-2.13.4-py3-none-any.whl", hash = "sha256:45a282cde31d808236fd7ea9d919b128653c8b38b393d1c4ab335c62924d9aba", size = 472262, upload-time = "2026-05-06T13:43:02.641Z" }, +] + +[[package]] +name = "pydantic-core" +version = "2.46.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/9d/56/921726b776ace8d8f5db44c4ef961006580d91dc52b803c489fafd1aa249/pydantic_core-2.46.4.tar.gz", hash = "sha256:62f875393d7f270851f20523dd2e29f082bcc82292d66db2b64ea71f64b6e1c1", size = 471464, upload-time = "2026-05-06T13:37:06.98Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e7/08/f1ba952f1c8ae5581c70fa9c6da89f247b83e3dd8c09c035d5d7931fc23d/pydantic_core-2.46.4-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:a396dcc17e5a0b164dbe026896245a4fa9ff402edca1dff0be3d53a517f74de4", size = 2113146, upload-time = "2026-05-06T13:37:36.537Z" }, + { url = "https://files.pythonhosted.org/packages/56/c6/65f646c7ff09bd257f660434adb45c4dfcbbcebcc030562fecf6f5bf887d/pydantic_core-2.46.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:da4b951fe36dc7c3a1ccb4e3cd1747c3542b8c9ceede8fc86cae054e764485f5", size = 1949769, upload-time = "2026-05-06T13:37:46.365Z" }, + { url = "https://files.pythonhosted.org/packages/64/ba/bfb1d928fd5b49e1258935ff104ae356e9fd89384a55bf9f847e9193ad40/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bb63e0198ca18aad131c089b9204c23079c3afa95487e561f4c522d519e55aba", size = 1974958, upload-time = "2026-05-06T13:37:28.611Z" }, + { url = "https://files.pythonhosted.org/packages/4e/74/76223bfb117b64af743c9b6670d1364516f5c0604f96b48f3272f6af6cc6/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f47286a97f0bc9b8859519809077b91b2cefe4ae47fcbf5e466a009c1c5d742b", size = 2042118, upload-time = "2026-05-06T13:36:55.216Z" }, + { url = "https://files.pythonhosted.org/packages/cb/7b/848732968bc8f48f3187542f08358b9d842db564147b256669426ebb1652/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:905a0ed8ea6f2d61c1738835f99b699348d7857379083e5fc497fa0c967a407c", size = 2222876, upload-time = "2026-05-06T13:38:25.455Z" }, + { url = "https://files.pythonhosted.org/packages/b5/2f/e90b63ee2e14bd8d3db8f705a6d75d64e6ee1b7c2c8833747ce706e1e0ce/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ea793e075b70290d89d8142074262885d3f7da19634845135751bd6344f73b50", size = 2286703, upload-time = "2026-05-06T13:37:53.304Z" }, + { url = "https://files.pythonhosted.org/packages/ba/1e/acc4d70f88a0a277e4a1fa77ebb985ceabaf900430f875bf9338e11c9420/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:395aebd9183f9d112f569aeb5b2214d1a10a33bec8456447f7fbdfa51d38d4cd", size = 2092042, upload-time = "2026-05-06T13:38:46.981Z" }, + { url = "https://files.pythonhosted.org/packages/a9/da/0a422b57bf8504102bf3c4ccea9c41bab5a5cee6a54650acf8faf67f5a24/pydantic_core-2.46.4-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:b078afbc25f3a1436c7a1d2cd3e322497ee99615ba97c563566fdf46aff1ee01", size = 2117231, upload-time = "2026-05-06T13:39:23.146Z" }, + { url = "https://files.pythonhosted.org/packages/bd/2a/2ac13c3af305843e23c5078c53d135656b3f05a2fd78cb7bbbb12e97b473/pydantic_core-2.46.4-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f747929cf940cddb5b3668a390056ddd5ba2e5010615ea2dcf4f9c4f3ab8791d", size = 2168388, upload-time = "2026-05-06T13:40:08.06Z" }, + { url = "https://files.pythonhosted.org/packages/72/04/2beacf7e1607e93eefe4aed1b4709f079b905fb77530179d4f7c71745f22/pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:daa27d92c36f24388fe3ad306b174781c747627f134452e4f128ea00ce1fe8c4", size = 2184769, upload-time = "2026-05-06T13:38:13.901Z" }, + { url = "https://files.pythonhosted.org/packages/9e/29/d2b9fd9f539133548eaf622c06a4ce176cb46ac59f32d0359c4abc0de047/pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:19e51f073cd3df251856a8a4189fbdf1de4012c3ebacfb1884f94f1eb406079f", size = 2319312, upload-time = "2026-05-06T13:39:08.24Z" }, + { url = "https://files.pythonhosted.org/packages/7c/af/0f7a5b85fec6075bea96e3ef9187de38fccced0de92c1e7feda8d5cc7bb9/pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:c1747f85cee84c26985853c6f3d9bd3e75da5212912443fa111c113b9c246f39", size = 2361817, upload-time = "2026-05-06T13:38:43.2Z" }, + { url = "https://files.pythonhosted.org/packages/25/a4/73363fec545fd3ec025490bdda2743c56d0dd5b6266b1a53bbe9e4265375/pydantic_core-2.46.4-cp310-cp310-win32.whl", hash = "sha256:2f84c03c8607173d16b5a854ec68a2f9079ae03237a54fb506d13af47e1d018d", size = 1987085, upload-time = "2026-05-06T13:39:25.497Z" }, + { url = "https://files.pythonhosted.org/packages/01/aa/62f082da2c91fac1c234bc9ee0066257ce83f0604abd72e4c9d5991f2d84/pydantic_core-2.46.4-cp310-cp310-win_amd64.whl", hash = "sha256:8358a950c8909158e3df31538a7e4edc2d7265a7c54b47f0864d9e5bae9dcebf", size = 2074311, upload-time = "2026-05-06T13:39:59.922Z" }, + { url = "https://files.pythonhosted.org/packages/5c/fa/6d7708d2cfc1a832acb6aeb0cd16e801902df8a0f583bb3b4b527fde022e/pydantic_core-2.46.4-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:0e96592440881c74a213e5ad528e2b24d3d4f940de2766bed9010ab1d9e51594", size = 2111872, upload-time = "2026-05-06T13:40:27.596Z" }, + { url = "https://files.pythonhosted.org/packages/ae/6f/aa064a3e74b5745afbdf250594f38e7ead05e2d651bcb35994b9417a0d4d/pydantic_core-2.46.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e0d65b8c354be7fb5f720c3caa8bc940bc2d20ce749c8e06135f07f8ed95dd7c", size = 1948255, upload-time = "2026-05-06T13:39:12.574Z" }, + { url = "https://files.pythonhosted.org/packages/43/3a/41114a9f7569b84b4d84e7a018c57c56347dac30c0d4a872946ec4e36c46/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7bfb192b3f4b9e8a89b6277b6ce787564f62cfd272055f6e685726b111dc7826", size = 1972827, upload-time = "2026-05-06T13:38:19.841Z" }, + { url = "https://files.pythonhosted.org/packages/ef/25/1ab42e8048fe551934d9884e8d64daa7e990ad386f310a15981aeb6a5b08/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9037063db01f09b09e237c282b6792bd4da634b5402c4e7f0c61effed7701a04", size = 2041051, upload-time = "2026-05-06T13:38:10.447Z" }, + { url = "https://files.pythonhosted.org/packages/94/c2/1a934597ddf08da410385b3b7aae91956a5a76c635effef456074fad7e88/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fc010ab034c8c7452522748bf937df58020d256ccae0874463d1f4d01758af8e", size = 2221314, upload-time = "2026-05-06T13:40:13.089Z" }, + { url = "https://files.pythonhosted.org/packages/02/6d/9e8ad178c9c4df27ad3c8f25d1fe2a7ab0d2ba0559fad4aee5d3d1f16771/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c5dac79fa1614d1e06ca695109c6105923bd9c7d1d6c918d4e637b7e6b32fd3", size = 2285146, upload-time = "2026-05-06T13:38:59.224Z" }, + { url = "https://files.pythonhosted.org/packages/80/50/540cd3aeefc041beb111125c4bff779831a2111fc6b15a9138cda277d32c/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f9fa868638bf362d3d138ea55829cefb3d5f4b0d7f142234382a15e2485dbec4", size = 2089685, upload-time = "2026-05-06T13:38:17.762Z" }, + { url = "https://files.pythonhosted.org/packages/6b/a4/b440ad35f05f6a38f89fa0f149accb3f0e02be94ca5e15f3c449a61b4bc9/pydantic_core-2.46.4-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:17299feefe090f2caa5b8e37222bb5f663e4935a8bfa6931d4102e5df1a9f398", size = 2115420, upload-time = "2026-05-06T13:37:58.195Z" }, + { url = "https://files.pythonhosted.org/packages/99/61/de4f55db8dfd57bfdfa9a12ec90fe1b57c4f41062f7ca86f08586b3e0ac0/pydantic_core-2.46.4-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4c63ebc82684aa89d9a3bcbd13d515b3be44250dc68dd3bd81526c1cb31286c3", size = 2165122, upload-time = "2026-05-06T13:37:01.167Z" }, + { url = "https://files.pythonhosted.org/packages/f7/52/7c529d7bdb2d1068bd52f51fe32572c8301f9a4febf1948f10639f1436f5/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:aaa2a54443eff1950ba5ddc6b6ccda0d9c84a364276a62f969bdf2a390650848", size = 2182573, upload-time = "2026-05-06T13:38:45.04Z" }, + { url = "https://files.pythonhosted.org/packages/37/b3/7c40325848ba78247f2812dcf9c7274e38cd801820ca6dd9fe63bcfb0eb4/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:18e5ceec2ab67e6d5f1a9085e5a24c9c4e2ac4545730bfe668680bca05e555f3", size = 2317139, upload-time = "2026-05-06T13:37:15.539Z" }, + { url = "https://files.pythonhosted.org/packages/d9/37/f913f81a657c865b75da6c0dbed79876073c2a43b5bd9edbe8da785e4d49/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:a0f62d0a58f4e7da165457e995725421e0064f2255d8eccebc49f41bbc23b109", size = 2360433, upload-time = "2026-05-06T13:37:30.099Z" }, + { url = "https://files.pythonhosted.org/packages/c4/67/6acaa1be2567f9256b056d8477158cac7240813956ce86e49deae8e173b4/pydantic_core-2.46.4-cp311-cp311-win32.whl", hash = "sha256:041bde0a48fd37cf71cab1c9d56d3e8625a3793fef1f7dd232b3ff37e978ecda", size = 1985513, upload-time = "2026-05-06T13:38:15.669Z" }, + { url = "https://files.pythonhosted.org/packages/aa/e6/c505f83dfeda9a2e5c995cfd872949e4d05e12f7feb3dca72f633daefa94/pydantic_core-2.46.4-cp311-cp311-win_amd64.whl", hash = "sha256:6f2eeda33a839975441c86a4119e1383c50b47faf0cbb5176985565c6bb02c33", size = 2071114, upload-time = "2026-05-06T13:40:35.416Z" }, + { url = "https://files.pythonhosted.org/packages/0f/da/7a263a96d965d9d0df5e8de8a475f33495451117035b09acb110288c381f/pydantic_core-2.46.4-cp311-cp311-win_arm64.whl", hash = "sha256:14f4c5d6db102bd796a627bbb3a17b4cf4574b9ae861d8b7c9a9661c6dd3362d", size = 2044298, upload-time = "2026-05-06T13:38:29.754Z" }, + { url = "https://files.pythonhosted.org/packages/ce/8c/af022f0af448d7747c5154288d46b5f2bc5f17366eaa0e23e9aa04d59f3b/pydantic_core-2.46.4-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3245406455a5d98187ec35530fd772b1d799b26667980872c8d4614991e2c4a2", size = 2106158, upload-time = "2026-05-06T13:38:57.215Z" }, + { url = "https://files.pythonhosted.org/packages/19/95/6195171e385007300f0f5574592e467c568becce2d937a0b6804f218bc49/pydantic_core-2.46.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:962ccbab7b642487b1d8b7df90ef677e03134cf1fd8880bf698649b22a69371f", size = 1951724, upload-time = "2026-05-06T13:37:02.697Z" }, + { url = "https://files.pythonhosted.org/packages/8e/bc/f47d1ff9cbb1620e1b5b697eef06010035735f07820180e74178226b27b3/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8233f2947cf85404441fd7e0085f53b10c93e0ee78611099b5c7237e36aacbf7", size = 1975742, upload-time = "2026-05-06T13:37:09.448Z" }, + { url = "https://files.pythonhosted.org/packages/5b/11/9b9a5b0306345664a2da6410877af6e8082481b5884b3ddd78d47c6013ce/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3a233125ac121aa3ffba9a2b59edfc4a985a76092dc8279586ab4b71390875e7", size = 2052418, upload-time = "2026-05-06T13:37:38.234Z" }, + { url = "https://files.pythonhosted.org/packages/f1/b7/a65fec226f5d78fc39f4a13c4cc0c768c22b113438f60c14adc9d2865038/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5b712b53160b79a5850310b912a5ef8e57e56947c8ad690c227f5c9d7e561712", size = 2232274, upload-time = "2026-05-06T13:38:27.753Z" }, + { url = "https://files.pythonhosted.org/packages/68/f0/92039db98b907ef49269a8271f67db9cb78ae2fc68062ef7e4e77adb5f61/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9401557acd873c3a7f3eb9383edef8ac4968f9510e340f4808d427e75667e7b4", size = 2309940, upload-time = "2026-05-06T13:38:05.353Z" }, + { url = "https://files.pythonhosted.org/packages/5f/97/2aab507d3d00ca626e8e57c1eac6a79e4e5fbcc63eb99733ff55d1717f65/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:926c9541b14b12b1681dca8a0b75feb510b06c6341b70a8e500c2fdcff837cce", size = 2094516, upload-time = "2026-05-06T13:39:10.577Z" }, + { url = "https://files.pythonhosted.org/packages/22/37/a8aca44d40d737dde2bc05b3c6c07dff0de07ce6f82e9f3167aeaf4d5dea/pydantic_core-2.46.4-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:56cb4851bcaf3d117eddcef4fe66afd750a50274b0da8e22be256d10e5611987", size = 2136854, upload-time = "2026-05-06T13:40:22.59Z" }, + { url = "https://files.pythonhosted.org/packages/24/99/fcef1b79238c06a8cbec70819ac722ba76e02bc8ada9b0fd66eba40da01b/pydantic_core-2.46.4-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c68fcd102d71ea85c5b2dfac3f4f8476eff42a9e078fd5faefff6d145063536b", size = 2180306, upload-time = "2026-05-06T13:40:10.666Z" }, + { url = "https://files.pythonhosted.org/packages/ae/6c/fc44000918855b42779d007ae63b0532794739027b2f417321cddbc44f6a/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:b2f69dec1725e79a012d920df1707de5caf7ed5e08f3be4435e25803efc47458", size = 2190044, upload-time = "2026-05-06T13:40:43.231Z" }, + { url = "https://files.pythonhosted.org/packages/6b/65/d9cadc9f1920d7a127ad2edba16c1db7916e59719285cd6c94600b0080ba/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:8d0820e8192167f80d88d64038e609c31452eeca865b4e1d9950a27a4609b00b", size = 2329133, upload-time = "2026-05-06T13:39:57.365Z" }, + { url = "https://files.pythonhosted.org/packages/d0/cf/c873d91679f3a30bcf5e7ac280ce5573483e72295307685120d0d5ad3416/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:fbdb89b3e1c94a30cc5edfce477c6e6a5dc4d8f84665b455c27582f211a1c72c", size = 2374464, upload-time = "2026-05-06T13:38:06.976Z" }, + { url = "https://files.pythonhosted.org/packages/47/bd/6f2fc8188f31bf10590f1e98e7b306336161fac930a8c514cd7bd828c7dc/pydantic_core-2.46.4-cp312-cp312-win32.whl", hash = "sha256:9aa768456404a8bf48a4406685ac2bec8e72b62c69313734fa3b73cf33b3a894", size = 1974823, upload-time = "2026-05-06T13:40:47.985Z" }, + { url = "https://files.pythonhosted.org/packages/40/8c/985c1d41ea1107c2534abd9870e4ed5c8e7669b5c308297835c001e7a1c4/pydantic_core-2.46.4-cp312-cp312-win_amd64.whl", hash = "sha256:e9c26f834c65f5752f3f06cb08cb86a913ceb7274d0db6e267808a708b46bc89", size = 2072919, upload-time = "2026-05-06T13:39:21.153Z" }, + { url = "https://files.pythonhosted.org/packages/c4/ba/f463d006e0c47373ca7ec5e1a261c59dc01ef4d62b2657af925fb0deee3a/pydantic_core-2.46.4-cp312-cp312-win_arm64.whl", hash = "sha256:4fc73cb559bdb54b1134a706a2802a4cddd27a0633f5abb7e53056268751ac6a", size = 2027604, upload-time = "2026-05-06T13:39:03.753Z" }, + { url = "https://files.pythonhosted.org/packages/51/a2/5d30b469c5267a17b39dec53208222f76a8d351dfac4af661888c5aee77d/pydantic_core-2.46.4-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:5d5902252db0d3cedf8d4a1bc68f70eeb430f7e4c7104c8c476753519b423008", size = 2106306, upload-time = "2026-05-06T13:37:48.029Z" }, + { url = "https://files.pythonhosted.org/packages/c1/81/4fa520eaffa8bd7d1525e644cd6d39e7d60b1592bc5b516693c7340b50f1/pydantic_core-2.46.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c94f0688e7b8d0a67abf40e57a7eaaecd17cc9586706a31b76c031f63df052b4", size = 1951906, upload-time = "2026-05-06T13:37:17.012Z" }, + { url = "https://files.pythonhosted.org/packages/03/d5/fd02da45b659668b05923b17ba3a0100a0a3d5541e3bd8fcc4ecb711309e/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f027324c56cd5406ca49c124b0db10e56c69064fec039acc571c29020cc87c76", size = 1976802, upload-time = "2026-05-06T13:37:35.113Z" }, + { url = "https://files.pythonhosted.org/packages/21/f2/95727e1368be3d3ed485eaab7adbd7dda408f33f7a36e8b48e0144002b91/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e739fee756ba1010f8bcccb534252e85a35fe45ae92c295a06059ce58b74ccd3", size = 2052446, upload-time = "2026-05-06T13:37:12.313Z" }, + { url = "https://files.pythonhosted.org/packages/9c/86/5d99feea3f77c7234b8718075b23db11532773c1a0dbd9b9490215dc2eeb/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9d56801be94b86a9da183e5f3766e6310752b99ff647e38b09a9500d88e46e76", size = 2232757, upload-time = "2026-05-06T13:39:01.149Z" }, + { url = "https://files.pythonhosted.org/packages/d2/3a/508ac615935ef7588cf6d9e9b91309fdc2da751af865e02a9098de88258c/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2412e734dcb48da14d4e4006b82b46b74f2518b8a26ee7e58c6844a6cd6d03c4", size = 2309275, upload-time = "2026-05-06T13:37:41.406Z" }, + { url = "https://files.pythonhosted.org/packages/07/f8/41db9de19d7987d6b04715a02b3b40aea467000275d9d758ffaa31af7d50/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9551187363ffc0de2a00b2e47c25aeaeb1020b69b668762966df15fc5659dd5a", size = 2094467, upload-time = "2026-05-06T13:39:18.847Z" }, + { url = "https://files.pythonhosted.org/packages/2c/e2/f35033184cb11d0052daf4416e8e10a502ea2ac006fc4f459aee872727d1/pydantic_core-2.46.4-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:0186750b482eefa11d7f435892b09c5c606193ef3375bcf94aa00ae6bfb66262", size = 2134417, upload-time = "2026-05-06T13:40:17.944Z" }, + { url = "https://files.pythonhosted.org/packages/7e/7b/6ceeb1cc90e193862f444ebe373d8fdf613f0a82572dde03fb10734c6c71/pydantic_core-2.46.4-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5855698a4856556d86e8e6cd8434bc3ac0314ee8e12089ae0e143f64c6256e4e", size = 2179782, upload-time = "2026-05-06T13:40:32.618Z" }, + { url = "https://files.pythonhosted.org/packages/5a/f2/c8d7773ede6af08036423a00ae0ceffce266c3c52a096c435d68c896083f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:cbaf13819775b7f769bf4a1f066cb6df7a28d4480081a589828ef190226881cd", size = 2188782, upload-time = "2026-05-06T13:36:51.018Z" }, + { url = "https://files.pythonhosted.org/packages/59/31/0c864784e31f09f05cdd87606f08923b9c9e7f6e51dd27f20f62f975ce9f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:633147d34cf4550417f12e2b1a0383973bdf5cdfde212cb09e9a581cf10820be", size = 2328334, upload-time = "2026-05-06T13:40:37.764Z" }, + { url = "https://files.pythonhosted.org/packages/c2/eb/4f6c8a41efa30baa755590f4141abf3a8c370fab610915733e74134a7270/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:82cf5301172168103724d49a1444d3378cb20cdee30b116a1bd6031236298a5d", size = 2372986, upload-time = "2026-05-06T13:39:34.152Z" }, + { url = "https://files.pythonhosted.org/packages/5b/24/b375a480d53113860c299764bfe9f349a3dc9108b3adc0d7f0d786492ebf/pydantic_core-2.46.4-cp313-cp313-win32.whl", hash = "sha256:9fa8ae11da9e2b3126c6426f147e0fba88d96d65921799bb30c6abd1cb2c97fb", size = 1973693, upload-time = "2026-05-06T13:37:55.072Z" }, + { url = "https://files.pythonhosted.org/packages/7e/e8/cff247591966f2d22ec8c003cd7587e27b7ba7b81ab2fb888e3ab75dc285/pydantic_core-2.46.4-cp313-cp313-win_amd64.whl", hash = "sha256:6b3ace8194b0e5204818c92802dcdca7fc6d88aabbb799d7c795540d9cd6d292", size = 2071819, upload-time = "2026-05-06T13:38:49.139Z" }, + { url = "https://files.pythonhosted.org/packages/c6/1a/f4aee670d5670e9e148e0c82c7db98d780be566c6e6a97ee8035528ca0b3/pydantic_core-2.46.4-cp313-cp313-win_arm64.whl", hash = "sha256:184c081504d17f1c1066e430e117142b2c77d9448a97f7b65c6ac9fd9aee238d", size = 2027411, upload-time = "2026-05-06T13:40:45.796Z" }, + { url = "https://files.pythonhosted.org/packages/8d/74/228a26ddad29c6672b805d9fd78e8d251cd04004fa7eed0e622096cd0250/pydantic_core-2.46.4-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:428e04521a40150c85216fc8b85e8d39fece235a9cf5e383761238c7fa9b96fb", size = 2102079, upload-time = "2026-05-06T13:38:41.019Z" }, + { url = "https://files.pythonhosted.org/packages/ad/1f/8970b150a4b4365623ae00fc88603491f763c627311ae8031e3111356d6e/pydantic_core-2.46.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:23ace664830ee0bfe014a0c7bc248b1f7f25ed7ad103852c317624a1083af462", size = 1952179, upload-time = "2026-05-06T13:36:59.812Z" }, + { url = "https://files.pythonhosted.org/packages/95/30/5211a831ae054928054b2f79731661087a2bc5c01e825c672b3a4a8f1b3e/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce5c1d2a8b27468f433ca974829c44060b8097eedc39933e3c206a90ee49c4a9", size = 1978926, upload-time = "2026-05-06T13:37:39.933Z" }, + { url = "https://files.pythonhosted.org/packages/57/e9/689668733b1eb67adeef047db3c2e8788fcf65a7fd9c9e2b46b7744fe245/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7283d57845ecf5a163403eb0702dfc220cc4fbdd18919cb5ccea4f95ee1cdab4", size = 2046785, upload-time = "2026-05-06T13:38:01.995Z" }, + { url = "https://files.pythonhosted.org/packages/60/d9/6715260422ff50a2109878fd24d948a6c3446bb2664f34ee78cd972b3acd/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8daafc69c93ee8a0204506a3b6b30f586ef54028f52aeeeb5c4cfc5184fd5914", size = 2228733, upload-time = "2026-05-06T13:40:50.371Z" }, + { url = "https://files.pythonhosted.org/packages/18/ae/fdb2f64316afca925640f8e70bb1a564b0ec2721c1389e25b8eb4bf9a299/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd2213145bcc2ba85884d0ac63d222fece9209678f77b9b4d76f054c561adb28", size = 2307534, upload-time = "2026-05-06T13:37:21.531Z" }, + { url = "https://files.pythonhosted.org/packages/89/1d/8eff589b45bb8190a9d12c49cfad0f176a5cbd1534908a6b5125e2886239/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7a5f930472650a82629163023e630d160863fce524c616f4e5186e5de9d9a49b", size = 2099732, upload-time = "2026-05-06T13:39:31.942Z" }, + { url = "https://files.pythonhosted.org/packages/06/d5/ee5a3366637fee41dee51a1fc91562dcf12ddbc68fda34e6b253da2324bb/pydantic_core-2.46.4-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:c1b3f518abeca3aa13c712fd202306e145abf59a18b094a6bafb2d2bbf59192c", size = 2129627, upload-time = "2026-05-06T13:37:25.033Z" }, + { url = "https://files.pythonhosted.org/packages/94/33/2414be571d2c6a6c4d08be21f9292b6d3fdb08949a97b6dfe985017821db/pydantic_core-2.46.4-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1a7dd0b3ee80d90150e3495a3a13ac34dbcbfd4f012996a6a1d8900e91b5c0fb", size = 2179141, upload-time = "2026-05-06T13:37:14.046Z" }, + { url = "https://files.pythonhosted.org/packages/7b/79/7daa95be995be0eecc4cf75064cb33f9bbbfe3fe0158caf2f0d4a996a5c7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:3fb702cd90b0446a3a1c5e470bfa0dd23c0233b676a9099ddcc964fa6ca13898", size = 2184325, upload-time = "2026-05-06T13:36:53.615Z" }, + { url = "https://files.pythonhosted.org/packages/9f/cb/d0a382f5c0de8a222dc61c65348e0ce831b1f68e0a018450d31c2cace3a5/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:b8458003118a712e66286df6a707db01c52c0f52f7db8e4a38f0da1d3b94fc4e", size = 2323990, upload-time = "2026-05-06T13:40:29.971Z" }, + { url = "https://files.pythonhosted.org/packages/05/db/d9ba624cc4a5aced1598e88c04fdbd8310c8a69b9d38b9a3d39ce3a61ed7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:372429a130e469c9cd698925ce5fc50940b7a1336b0d82038e63d5bbc4edc519", size = 2369978, upload-time = "2026-05-06T13:37:23.027Z" }, + { url = "https://files.pythonhosted.org/packages/f2/20/d15df15ba918c423461905802bfd2981c3af0bfa0e40d05e13edbfa48bc3/pydantic_core-2.46.4-cp314-cp314-win32.whl", hash = "sha256:85bb3611ff1802f3ee7fdd7dbff26b56f343fb432d57a4728fdd49b6ef35e2f4", size = 1966354, upload-time = "2026-05-06T13:38:03.499Z" }, + { url = "https://files.pythonhosted.org/packages/fc/b6/6b8de4c0a7d7ab3004c439c80c5c1e0a3e8d78bbae19379b01960383d9e5/pydantic_core-2.46.4-cp314-cp314-win_amd64.whl", hash = "sha256:811ff8e9c313ab425368bcbb36e5c4ebd7108c2bbf4e4089cfbb0b01eff63fac", size = 2072238, upload-time = "2026-05-06T13:39:40.807Z" }, + { url = "https://files.pythonhosted.org/packages/32/36/51eb763beec1f4cf59b1db243a7dcc39cbb41230f050a09b9d69faaf0a48/pydantic_core-2.46.4-cp314-cp314-win_arm64.whl", hash = "sha256:bfec22eab3c8cc2ceec0248aec886624116dc079afa027ecc8ad4a7e62010f8a", size = 2018251, upload-time = "2026-05-06T13:37:26.72Z" }, + { url = "https://files.pythonhosted.org/packages/e8/91/855af51d625b23aa987116a19e231d2aaef9c4a415273ddc189b79a45fee/pydantic_core-2.46.4-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:af8244b2bef6aaad6d92cda81372de7f8c8d36c9f0c3ea36e827c60e7d9467a0", size = 2099593, upload-time = "2026-05-06T13:39:47.682Z" }, + { url = "https://files.pythonhosted.org/packages/fb/1b/8784a54c65edb5f49f0a14d6977cf1b209bba85a4c77445b255c2de58ab3/pydantic_core-2.46.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5a4330cdbc57162e4b3aa303f588ba752257694c9c9be3e7ebb11b4aca659b5d", size = 1935226, upload-time = "2026-05-06T13:40:40.428Z" }, + { url = "https://files.pythonhosted.org/packages/e8/e7/1955d28d1afc56dd4b3ad7cc0cf39df1b9852964cf16e5d13912756d6d6b/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:29c61fc04a3d840155ff08e475a04809278972fe6aef51e2720554e96367e34b", size = 1974605, upload-time = "2026-05-06T13:37:32.029Z" }, + { url = "https://files.pythonhosted.org/packages/93/e2/3fedbf0ba7a22850e6e9fd78117f1c0f10f950182344d8a6c535d468fdd8/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c50f2528cf200c5eed56faf3f4e22fcd5f38c157a8b78576e6ba3168ec35f000", size = 2030777, upload-time = "2026-05-06T13:38:55.239Z" }, + { url = "https://files.pythonhosted.org/packages/f8/61/46be275fcaaba0b4f5b9669dd852267ce1ff616592dccf7a7845588df091/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0cbe8b01f948de4286c74cdd6c667aceb38f5c1e26f0693b3983d9d74887c65e", size = 2236641, upload-time = "2026-05-06T13:37:08.096Z" }, + { url = "https://files.pythonhosted.org/packages/60/db/12e93e46a8bac9988be3c016860f83293daea8c716c029c9ace279036f2f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:617d7e2ca7dcb8c5cf6bcb8c59b8832c94b36196bbf1cbd1bfb56ed341905edd", size = 2286404, upload-time = "2026-05-06T13:40:20.221Z" }, + { url = "https://files.pythonhosted.org/packages/e2/4a/4d8b19008f38d31c53b8219cfedc2e3d5de5fe99d90076b7e767de29274f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7027560ee92211647d0d34e3f7cd6f50da56399d26a9c8ad0da286d3869a53f3", size = 2109219, upload-time = "2026-05-06T13:38:12.153Z" }, + { url = "https://files.pythonhosted.org/packages/88/70/3cbc40978fefb7bb09c6708d40d4ad1a5d70fd7213c3d17f971de868ec1f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:f99626688942fb746e545232e7726926f3be91b5975f8b55327665fafda991c7", size = 2110594, upload-time = "2026-05-06T13:40:02.971Z" }, + { url = "https://files.pythonhosted.org/packages/9d/20/b8d36736216e29491125531685b2f9e61aa5b4b2599893f8268551da3338/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fc3e9034a63de20e15e8ade85358bc6efc614008cab72898b4b4952bea0509ff", size = 2159542, upload-time = "2026-05-06T13:39:27.506Z" }, + { url = "https://files.pythonhosted.org/packages/1d/a2/367df868eb584dacf6bf82a389272406d7178e301c4ac82545ab98bc2dd9/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:97e7cf2be5c77b7d1a9713a05605d49460d02c6078d38d8bef3cbe323c548424", size = 2168146, upload-time = "2026-05-06T13:38:31.93Z" }, + { url = "https://files.pythonhosted.org/packages/c1/b8/4460f77f7e201893f649a29ab355dddd3beee8a97bcb1a320db414f9a06e/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:3bf92c5d0e00fefaab325a4d27828fe6b6e2a21848686b5b60d2d9eeb09d76c6", size = 2306309, upload-time = "2026-05-06T13:37:44.717Z" }, + { url = "https://files.pythonhosted.org/packages/64/c4/be2639293acd87dc8ddbcec41a73cee9b2ebf996fe6d892a1a74e88ad3f7/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:3ecbc122d18468d06ca279dc26a8c2e2d5acb10943bb35e36ae92096dc3b5565", size = 2369736, upload-time = "2026-05-06T13:37:05.645Z" }, + { url = "https://files.pythonhosted.org/packages/30/a6/9f9f380dbb301f67023bf8f707aaa75daadf84f7152d95c410fd7e81d994/pydantic_core-2.46.4-cp314-cp314t-win32.whl", hash = "sha256:e846ae7835bf0703ae43f534ab79a867146dadd59dc9ca5c8b53d5c8f7c9ef02", size = 1955575, upload-time = "2026-05-06T13:38:51.116Z" }, + { url = "https://files.pythonhosted.org/packages/40/1f/f1eb9eb350e795d1af8586289746f5c5677d16043040d63710e22abc43c9/pydantic_core-2.46.4-cp314-cp314t-win_amd64.whl", hash = "sha256:2108ba5c1c1eca18030634489dc544844144ee36357f2f9f780b93e7ddbb44b5", size = 2051624, upload-time = "2026-05-06T13:38:21.672Z" }, + { url = "https://files.pythonhosted.org/packages/f6/d2/42dd53d0a85c27606f316d3aa5d2869c4e8470a5ed6dec30e4a1abe19192/pydantic_core-2.46.4-cp314-cp314t-win_arm64.whl", hash = "sha256:4fcbe087dbc2068af7eda3aa87634eba216dbda64d1ae73c8684b621d33f6596", size = 2017325, upload-time = "2026-05-06T13:40:52.723Z" }, + { url = "https://files.pythonhosted.org/packages/ee/a4/73995fd4ebbb46ba0ee51e6fa049b8f02c40daebb762208feda8a6b7894d/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:14d4edf427bdcf950a8a02d7cb44a08614388dd6e1bdcbf4f67504fa7887da9c", size = 2111589, upload-time = "2026-05-06T13:37:10.817Z" }, + { url = "https://files.pythonhosted.org/packages/fb/7f/f37d3a5e8bfcc2e403f5c57a730f2d815693fb42119e8ea48b3789335af1/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:0ce40cd7b21210e99342afafbd4d0f76d784eb5b1d60f3bdc566be4983c6c73b", size = 1944552, upload-time = "2026-05-06T13:36:56.717Z" }, + { url = "https://files.pythonhosted.org/packages/15/3c/d7eb777b3ff43e8433a4efb39a17aa8fd98a4ee8561a24a67ef5db07b2d6/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:90884113d8b48f760e9587002789ddd741e76ab9f89518cd1e43b1f1a52ec44b", size = 1982984, upload-time = "2026-05-06T13:39:06.207Z" }, + { url = "https://files.pythonhosted.org/packages/63/87/70b9f40170a81afd55ca26c9b2acb25c20d64bcfbf888fafecb3ba077d4c/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66ce7632c22d837c95301830e111ad0128a32b8207533b60896a96c4915192ea", size = 2138417, upload-time = "2026-05-06T13:39:45.476Z" }, + { url = "https://files.pythonhosted.org/packages/9d/1d/8987ad40f65ae1432753072f214fb5c74fe47ffbd0698bb9cbbb585664f8/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:1d8ba486450b14f3b1d63bc521d410ec7565e52f887b9fb671791886436a42f7", size = 2095527, upload-time = "2026-05-06T13:39:52.283Z" }, + { url = "https://files.pythonhosted.org/packages/64/d3/84c282a7eee1d3ac4c0377546ef5a1ea436ce26840d9ac3b7ed54a377507/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:3009f12e4e90b7f88b4f9adb1b0c4a3d58fe7820f3238c190047209d148026df", size = 1936024, upload-time = "2026-05-06T13:40:15.671Z" }, + { url = "https://files.pythonhosted.org/packages/d7/ca/eac61596cdeb4d7e174d3dc0bd8a6238f14f75f97a24e7b7db4c7e7340a0/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ad785e92e6dc634c21555edc8bd6b64957ab844541bcb96a1366c202951ae526", size = 1990696, upload-time = "2026-05-06T13:38:34.717Z" }, + { url = "https://files.pythonhosted.org/packages/fa/c3/7c8b240552251faf6b3a957db200fcfbbcec36763c050428b601e0c9b83b/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:00c603d540afdd6b80eb39f078f33ebd46211f02f33e34a32d9f053bba711de0", size = 2147590, upload-time = "2026-05-06T13:39:29.883Z" }, + { url = "https://files.pythonhosted.org/packages/11/cb/428de0385b6c8d44b716feba566abfacfbd23ee3c4439faa789a1456242f/pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:0c563b08bca408dc7f65f700633d8442fffb2421fc47b8101377e9fd65051ff0", size = 2112782, upload-time = "2026-05-06T13:37:04.016Z" }, + { url = "https://files.pythonhosted.org/packages/0b/b5/6a17bdadd0fc1f170adfd05a20d37c832f52b117b4d9131da1f41bb097ce/pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:db06ffe51636ffe9ca531fe9023dd64bdd794be8754cb5df57c5498ae5b518a7", size = 1952146, upload-time = "2026-05-06T13:39:43.092Z" }, + { url = "https://files.pythonhosted.org/packages/2a/dc/03734d80e362cd43ef65428e9de77c730ce7f2f11c60d2b1e1b39f0fbf99/pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:133878133d271ade3d41d1bfb2a45ec38dbdbda40bc065921c6b04e4630127e2", size = 2134492, upload-time = "2026-05-06T13:36:58.124Z" }, + { url = "https://files.pythonhosted.org/packages/de/df/5e5ffc085ed07cc22d298134d3d911c63e91f6a0eb91fe646750a3209910/pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:9bc519fbf2b7578398853d815009ae5e4d4603d12f4e3f91da8c06852d3da3e9", size = 2156604, upload-time = "2026-05-06T13:37:49.88Z" }, + { url = "https://files.pythonhosted.org/packages/81/44/6e112a4253e56f5705467cbab7ab5e91ee7398ba3d56d358635958893d3e/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:c7a7bd4e39e8e4c12c39cd480356842b6a8a06e41b23a55a5e3e191718838ddf", size = 2183828, upload-time = "2026-05-06T13:37:43.053Z" }, + { url = "https://files.pythonhosted.org/packages/ac/ad/5565071e937d8e752842ac241463944c9eb14c87e2d269f2658a5bd05e98/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:d396ec2b979760aaf3218e76c24e65bd0aca24983298653b3a9d7a45f9e47b30", size = 2310000, upload-time = "2026-05-06T13:37:56.694Z" }, + { url = "https://files.pythonhosted.org/packages/4f/c3/66883a5cec183e7fba4d024b4cbbe61851a63750ef606b0afecc46d1f2bf/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:86e1a4418c6cd97d60c95c71164158eaf7324fae7b0923264016baa993eba6fc", size = 2361286, upload-time = "2026-05-06T13:40:05.667Z" }, + { url = "https://files.pythonhosted.org/packages/4b/2d/69abac8f838090bbecd5df894befb2c2619e7996a98ddb949db9f3b93225/pydantic_core-2.46.4-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:d51026d73fcfd93610abc7b27789c26b313920fcfb20e27462d74a7f8b06e983", size = 2193071, upload-time = "2026-05-06T13:38:08.682Z" }, +] + [[package]] name = "pygments" version = "2.19.2" @@ -505,6 +649,18 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" }, ] +[[package]] +name = "typing-inspection" +version = "0.4.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" }, +] + [[package]] name = "urllib3" version = "2.6.2"