250 lines
8.7 KiB
Python
250 lines
8.7 KiB
Python
"""Same-cwd creation/resume ordering for post-discovered agents (Issue #63).
|
|
|
|
While a post-discovered agent (agy, codex, hermes, opencode) in a workspace is
|
|
still being created (marker held by a live create/resume process) or is running
|
|
without a recorded conversation id (live pane pid), a second create or resume of
|
|
the same agent type in that workspace waits until the first records its id, up
|
|
to MAM_ID_ORDER_WAIT_S (default 600 s; 0 = do not wait).
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import fcntl
|
|
import hashlib
|
|
import json
|
|
import os
|
|
import sys
|
|
import tempfile
|
|
import time
|
|
from typing import Any, Callable, Dict, List, Mapping, Optional
|
|
|
|
from lib_py import ints
|
|
from lib_py.agents.autopin import claimed_elsewhere
|
|
from lib_py.agents.base import POST_DISCOVERED
|
|
from lib_py.agents.registry import agent_of_row, get_adapter
|
|
from lib_py.agents.session_ids import claiming_rows, own_id
|
|
from lib_py.state import load_state_json
|
|
from lib_py.verify_session import workspace_key
|
|
|
|
DEFAULT_WAIT_S = 600
|
|
|
|
|
|
def wait_s(env: Mapping[str, str] = os.environ) -> int:
|
|
raw = env.get("MAM_ID_ORDER_WAIT_S")
|
|
if raw is None:
|
|
return DEFAULT_WAIT_S
|
|
n = ints.positive_int(raw, 0)
|
|
return DEFAULT_WAIT_S if n is None else n
|
|
|
|
|
|
def pid_alive(pid: int) -> bool:
|
|
if not isinstance(pid, int) or pid <= 0:
|
|
return False
|
|
try:
|
|
os.kill(pid, 0)
|
|
return True
|
|
except ProcessLookupError:
|
|
return False
|
|
except PermissionError:
|
|
return True
|
|
except OSError:
|
|
return False
|
|
|
|
|
|
def order_dir(cwd: str, agent: str, env: Mapping[str, str] = os.environ,
|
|
home: Optional[str] = None) -> str:
|
|
h = home or env.get("HOME") or env.get("HOME_DIR") or os.path.expanduser("~")
|
|
real_cwd = os.path.realpath(cwd or ".")
|
|
digest = hashlib.sha256(real_cwd.encode("utf-8")).hexdigest()[:16]
|
|
return os.path.join(h, ".local", "state", "mam", "id-order", f"{digest}-{agent}")
|
|
|
|
|
|
def _parse_pos_int(val: Any) -> Optional[int]:
|
|
if isinstance(val, bool):
|
|
return None
|
|
if isinstance(val, int):
|
|
return val if val > 0 else None
|
|
s = str(val or "").strip()
|
|
return int(s) if s.isdigit() and int(s) > 0 else None
|
|
|
|
|
|
def blockers(state: Dict[str, Any], cwd: str, agent: str, me: str,
|
|
markers: List[Dict[str, Any]],
|
|
is_alive: Callable[[int], bool] = pid_alive) -> List[str]:
|
|
target_key = workspace_key(cwd)
|
|
found: List[str] = []
|
|
rows_by_name: Dict[str, Dict[str, Any]] = {}
|
|
|
|
for s in state.get("herdr_sessions") or []:
|
|
if not isinstance(s, dict):
|
|
continue
|
|
rname = str(s.get("name") or "")
|
|
if rname:
|
|
rows_by_name[rname] = s
|
|
if not rname or rname == me:
|
|
continue
|
|
s_cwd = (s.get("pane") or {}).get("cwd") or ""
|
|
if not s_cwd or workspace_key(s_cwd) != target_key:
|
|
continue
|
|
if agent_of_row(s) != agent or s.get("status") != "running":
|
|
continue
|
|
if own_id(s, agent):
|
|
continue
|
|
pane_pid = _parse_pos_int((s.get("pane") or {}).get("pid"))
|
|
if pane_pid is None or is_alive(pane_pid):
|
|
if rname not in found:
|
|
found.append(rname)
|
|
|
|
for m in markers or []:
|
|
if not isinstance(m, dict):
|
|
continue
|
|
m_sess = str(m.get("session") or "")
|
|
if not m_sess or m_sess == me or m_sess in found:
|
|
continue
|
|
owner_pid = _parse_pos_int(m.get("owner_pid"))
|
|
if owner_pid is None or not is_alive(owner_pid):
|
|
continue
|
|
row = rows_by_name.get(m_sess)
|
|
if row is None:
|
|
found.append(m_sess)
|
|
elif not own_id(row, agent):
|
|
status = row.get("status")
|
|
end_epoch = int(row.get("stopped_at_epoch") or row.get("terminated_at_epoch") or 0)
|
|
m_at = int(m.get("at") or 0)
|
|
if status == "running" or end_epoch <= m_at:
|
|
found.append(m_sess)
|
|
|
|
return found
|
|
|
|
|
|
def _read_and_prune_markers(dpath: str, me: str,
|
|
is_alive: Callable[[int], bool] = pid_alive) -> List[Dict[str, Any]]:
|
|
out: List[Dict[str, Any]] = []
|
|
try:
|
|
names = sorted(os.listdir(dpath))
|
|
except OSError:
|
|
return out
|
|
for fname in names:
|
|
if not fname.endswith(".json") or fname.startswith("."):
|
|
continue
|
|
fpath = os.path.join(dpath, fname)
|
|
try:
|
|
with open(fpath, encoding="utf-8") as f:
|
|
data = json.load(f)
|
|
except (OSError, ValueError):
|
|
try:
|
|
os.remove(fpath)
|
|
except OSError:
|
|
pass
|
|
continue
|
|
if not isinstance(data, dict):
|
|
continue
|
|
owner_pid = _parse_pos_int(data.get("owner_pid"))
|
|
sess = str(data.get("session") or "")
|
|
if sess == me or owner_pid is None or not is_alive(owner_pid):
|
|
try:
|
|
os.remove(fpath)
|
|
except OSError:
|
|
pass
|
|
continue
|
|
out.append(data)
|
|
return out
|
|
|
|
|
|
def write_marker(dpath: str, session: str, owner_pid: int, cwd: str, agent: str) -> str:
|
|
os.makedirs(dpath, exist_ok=True)
|
|
marker_path = os.path.join(dpath, f"{session}.json")
|
|
fd, tmp = tempfile.mkstemp(dir=dpath, prefix=".marker.", suffix=".tmp")
|
|
with os.fdopen(fd, "w", encoding="utf-8") as f:
|
|
json.dump({
|
|
"session": session,
|
|
"owner_pid": int(owner_pid),
|
|
"cwd": os.path.realpath(cwd),
|
|
"agent": agent,
|
|
"at": int(time.time()),
|
|
}, f)
|
|
os.replace(tmp, marker_path)
|
|
return marker_path
|
|
|
|
|
|
def wait(cwd: str, agent: str, session: str, owner_pid: int,
|
|
uuid: str = "", yaml_path: Optional[str] = None,
|
|
home: Optional[str] = None, wait_s_val: Optional[int] = None,
|
|
poll: float = 0.25,
|
|
is_alive: Callable[[int], bool] = pid_alive) -> int:
|
|
adapter = get_adapter(agent)
|
|
if adapter is None or adapter.id_lifecycle != POST_DISCOVERED:
|
|
return 0
|
|
|
|
cap = wait_s(os.environ) if wait_s_val is None else int(wait_s_val)
|
|
dpath = order_dir(cwd, agent, os.environ, home=home)
|
|
os.makedirs(dpath, exist_ok=True)
|
|
lock_file = os.path.join(dpath, "lock")
|
|
deadline = time.monotonic() + cap
|
|
announced = False
|
|
row_ref = {"name": session}
|
|
|
|
while True:
|
|
with open(lock_file, "a", encoding="utf-8") as lf:
|
|
fcntl.flock(lf, fcntl.LOCK_EX)
|
|
state = load_state_json(yaml_path)
|
|
if uuid:
|
|
claimed = set(claimed_elsewhere(row_ref, state))
|
|
if uuid in claimed:
|
|
others = ", ".join(claiming_rows(row_ref, uuid, state))
|
|
print(
|
|
f"ERROR: {session}'s recorded id {uuid} is also recorded by {others}; "
|
|
f"refusing to resume on a conversation another session claims (Issue #63).",
|
|
file=sys.stderr, flush=True,
|
|
)
|
|
return 1
|
|
markers = _read_and_prune_markers(dpath, session, is_alive=is_alive)
|
|
blks = blockers(state, cwd, agent, session, markers, is_alive=is_alive)
|
|
if not blks:
|
|
if not uuid and owner_pid and owner_pid > 0:
|
|
write_marker(dpath, session, owner_pid, cwd, agent)
|
|
return 0
|
|
|
|
names = ", ".join(blks)
|
|
if time.monotonic() >= deadline:
|
|
print(
|
|
f"ERROR: {names} in {cwd} still has no recorded {agent} id after {cap}s; "
|
|
f"not starting {session} (Issue #63). Wait for its first turn to finish, "
|
|
f"or stop it with multi-agent-mux-stop.",
|
|
file=sys.stderr, flush=True,
|
|
)
|
|
return 1
|
|
if not announced:
|
|
print(
|
|
f"id-order: waiting for {names} ({agent}, no recorded id yet) in {cwd} "
|
|
f"- up to {cap}s (MAM_ID_ORDER_WAIT_S)",
|
|
file=sys.stderr, flush=True,
|
|
)
|
|
announced = True
|
|
remaining = deadline - time.monotonic()
|
|
if remaining > 0:
|
|
time.sleep(min(poll, remaining))
|
|
|
|
|
|
def main(argv: Optional[List[str]] = None) -> int:
|
|
p = argparse.ArgumentParser(prog="python -m lib_py.agents.id_order")
|
|
sub = p.add_subparsers(dest="cmd", required=True)
|
|
s_wait = sub.add_parser("wait")
|
|
s_wait.add_argument("--cwd", required=True)
|
|
s_wait.add_argument("--agent", required=True)
|
|
s_wait.add_argument("--session", required=True)
|
|
s_wait.add_argument("--owner-pid", type=int, default=0)
|
|
s_wait.add_argument("--uuid", default="")
|
|
a = p.parse_args(argv)
|
|
return wait(
|
|
cwd=a.cwd,
|
|
agent=a.agent,
|
|
session=a.session,
|
|
owner_pid=a.owner_pid,
|
|
uuid=a.uuid or "",
|
|
)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|