feat: clear_table — empty the roster on a table change

"Clear the table" had no tool behind it, so she claimed she did it and nothing
changed. Add clear_table (empties the roster, keeps the session/stack/reads) and
a `replace` flag on seat_players for a one-shot table swap. Cash card: on a table
change / "clear the table", call clear_table then seat the new table — never claim
it without calling the tool.

2 tests. Full suite green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

lyra/tools.py

@@ -317,6 +317,8 @@ def _seat_players(args: dict, ctx: dict) -> str:
     if isinstance(players, str):
         players = [p.strip() for p in re.split(r"[,\n]", players) if p.strip()]
     try:
+        if args.get("replace"):     # a whole new table — wipe the roster first
+            poker.clear_roster()
         n = poker.seat_players(players)
     except ValueError:
         return "No live session — start one first, then I'll seat the table."
@@ -325,6 +327,11 @@ def _seat_players(args: dict, ctx: dict) -> str:
     return f"Seated {n}. Table now: {names}"
 
 
+def _clear_table(args: dict, ctx: dict) -> str:
+    n = poker.clear_roster()
+    return f"Table cleared — roster's empty ({n} removed). Tell me who's at the new one."
+
+
 def _unseat_player(args: dict, ctx: dict) -> str:
     ok = poker.unseat_player(name=args.get("name"), descriptor=args.get("descriptor"))
     who = args.get("name") or args.get("descriptor") or "player"
@@ -685,7 +692,9 @@ TOOLS.update({
                          "name": {**_S, "description": "Handle as it appears on Bravo, e.g. 'TAG'"},
                          "descriptor": {**_S, "description": "Physical description if no name"},
                          "seat": {**_S, "description": "Seat number/label if known"},
-                         "category": {**_S, "description": "feeder | risky | reg | unknown"}}}}},
+                         "category": {**_S, "description": "feeder | risky | reg | unknown"}}}},
+         "replace": {"type": "boolean", "description": "true = a brand-new table: clear the "
+                     "current roster first, then seat these (use when he changes tables)"}},
         ["players"])},
     "unseat_player": {"handler": _unseat_player, "spec": _f(
         "unseat_player",
@@ -693,6 +702,12 @@ TOOLS.update({
         {"name": {**_S, "description": "Their handle"},
          "descriptor": {**_S, "description": "Or a description if unnamed"}},
         [])},
+    "clear_table": {"handler": _clear_table, "spec": _f(
+        "clear_table",
+        "Empty the whole table roster at once — call this when Brian changes tables or says "
+        "to clear the table. The session, stack, and logged reads stay; only who's currently "
+        "seated resets. Then he'll tell you the new table.",
+        {}, [])},
     "name_villain": {"handler": _name_villain, "spec": _f(
         "name_villain",
         "Attach a real name to a player you'd only known by description (e.g. you caught it "