webbee 0.3.3__tar.gz → 0.3.4__tar.gz

{webbee-0.3.3 → webbee-0.3.4}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.3.4
+
+- `/notify [tg|panel|both|off]` — mirror this coding session to Telegram
+  and/or the panel, and let either surface steer it back (approve/deny
+  prompts, follow-up turns). No argument shows the current routing. Talks to
+  the gateway's per-session remote-control state; a network hiccup notes
+  cleanly instead of crashing the dock.
+
 ## 0.3.3
 
 - Mouse-garbage / dead-keyboard fix (Linux, occasionally macOS): the dock now

{webbee-0.3.3 → webbee-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webbee
-Version: 0.3.3
+Version: 0.3.4
 Summary: Webbee 🐝 — the Imperal Cloud coding agent in your terminal
 Project-URL: Homepage, https://imperal.io
 Project-URL: Documentation, https://docs.imperal.io

{webbee-0.3.3 → webbee-0.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "webbee"
-version = "0.3.3"
+version = "0.3.4"
 description = "Webbee 🐝 — the Imperal Cloud coding agent in your terminal"
 readme = "README.md"
 license = "MIT"

webbee-0.3.4/src/webbee/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.4"

{webbee-0.3.3 → webbee-0.3.4}/src/webbee/commands.py

@@ -16,6 +16,7 @@ _HELP = """Commands:
   /sessions          list active sessions (this + other devices)
   /sessions revoke <#>   revoke a session by its number
   /logout-others     sign out every session except this one
+  /notify [tg|panel|both|off]   mirror this session to Telegram/panel & steer it back
   /exit  (=/quit)    quit"""
 
 
@@ -85,6 +86,8 @@ def dispatch(line: str, ctx: CommandContext) -> SlashResult:
         return SlashResult(handled=True, action="checkpoints")
     if cmd == "/rollback":
         return SlashResult(handled=True, action="rollback", arg=" ".join(args))
+    if cmd == "/notify":
+        return SlashResult(handled=True, action="notify", arg=(args[0].lower() if args else ""))
     if cmd == "/mode":
         if not args:
             return SlashResult(handled=True, action="mode", new_mode=None,

webbee-0.3.4/src/webbee/remote.py

@@ -0,0 +1,41 @@
+"""Remote-control client — read/set this coding session's mirror+steer routing
+(Telegram / panel) via the gateway. Best-effort: network errors never raise."""
+from __future__ import annotations
+
+_ARG_TO_STATE = {
+    "tg": {"enabled": True, "mirror": ["telegram"], "steer": ["telegram"]},
+    "panel": {"enabled": True, "mirror": ["panel"], "steer": []},
+    "both": {"enabled": True, "mirror": ["telegram", "panel"], "steer": ["telegram"]},
+    "off": {"enabled": False, "mirror": [], "steer": []},
+}
+
+
+async def get_remote(cfg, token_provider, session_id: str) -> dict:
+    import httpx
+    token = await token_provider()
+    async with httpx.AsyncClient(base_url=cfg.api_url, timeout=10) as c:
+        r = await c.get(f"/v1/agent/sessions/{session_id}/remote",
+                        headers={"Authorization": f"Bearer {token}"})
+        r.raise_for_status()
+        return (r.json() or {}).get("state", {})
+
+
+async def set_remote(cfg, token_provider, session_id: str, arg: str) -> dict:
+    import httpx
+    body = _ARG_TO_STATE.get(arg)
+    if body is None:
+        raise ValueError(arg)
+    token = await token_provider()
+    async with httpx.AsyncClient(base_url=cfg.api_url, timeout=10) as c:
+        r = await c.put(f"/v1/agent/sessions/{session_id}/remote", json=body,
+                        headers={"Authorization": f"Bearer {token}"})
+        r.raise_for_status()
+        return (r.json() or {}).get("state", {})
+
+
+def describe(state: dict) -> str:
+    if not state.get("enabled"):
+        return "Remote control: OFF."
+    m = ", ".join(state.get("mirror", [])) or "—"
+    s = ", ".join(state.get("steer", [])) or "—"
+    return f"Remote control: ON · mirror → {m} · steer ← {s}"

{webbee-0.3.3 → webbee-0.3.4}/src/webbee/repl.py

@@ -238,6 +238,24 @@ async def run_repl(cfg, mode: str = "default", *, once: bool = False, sink=None,
                     _r = await asyncio.to_thread(shadow.rollback, res.arg)
                     _sink.note(str(_r.get("content", "")))
                 return "continue"
+            if res.action == "notify":
+                from webbee import remote as _remote
+                sid = getattr(agent, "session_id", "")
+                if not sid:
+                    _sink.note("Start a coding turn first, then /notify to route it.")
+                    return "continue"
+                try:
+                    if res.arg in ("tg", "panel", "both", "off"):
+                        st = await _remote.set_remote(cfg, token_provider, sid, res.arg)
+                    elif res.arg:
+                        _sink.note("Usage: /notify [tg|panel|both|off]")
+                        return "continue"
+                    else:
+                        st = await _remote.get_remote(cfg, token_provider, sid)
+                    _sink.note(_remote.describe(st))
+                except Exception as e:
+                    _sink.note(f"Remote control unavailable: {type(e).__name__}")
+                return "continue"
             if res.action == "clear":
                 _sink.clear()
                 _sink.note(res.message)

{webbee-0.3.3 → webbee-0.3.4}/tests/test_commands.py

@@ -140,3 +140,15 @@ def test_help_mentions_the_time_machine():
     from webbee.commands import dispatch
     res = dispatch("/help", _anyctx())
     assert "/checkpoints" in res.message and "/rollback" in res.message
+
+
+def test_notify_command_dispatches():
+    from webbee.commands import dispatch
+    assert dispatch("/notify", _anyctx()).action == "notify"
+    r = dispatch("/notify tg", _anyctx())
+    assert r.action == "notify" and r.arg == "tg"
+
+
+def test_help_mentions_notify():
+    from webbee.commands import dispatch
+    assert "/notify" in dispatch("/help", _anyctx()).message

{webbee-0.3.3 → webbee-0.3.4}/tests/test_repl.py

@@ -404,6 +404,39 @@ def test_boot_skips_intel_when_disabled_in_config(monkeypatch):
     assert _SpyAgent.last_intel is None
 
 
+# ── /notify remote control (Task 8) ───────────────────────────────────────────
+
+def test_notify_sets_remote_and_shows_state(monkeypatch):
+    agent = StepAgent()
+
+    async def fake_set(cfg, tp, sid, arg):
+        assert sid == "sess-1" and arg == "tg"
+        return {"enabled": True, "mirror": ["telegram"], "steer": ["telegram"]}
+    monkeypatch.setattr("webbee.remote.set_remote", fake_set)
+
+    sink, agent = _run(read_line=_lines("/notify tg", "/exit"), agent=agent)
+    assert any("ON" in n for n in sink.notes)
+
+
+def test_notify_without_session_prompts_to_start_a_turn():
+    sink, agent = _run(read_line=_lines("/notify tg", "/exit"), agent=StepAgent(session_id=""))
+    assert any("Start a coding turn first" in n for n in sink.notes)
+
+
+def test_notify_bad_arg_shows_usage():
+    sink, agent = _run(read_line=_lines("/notify bogus", "/exit"), agent=StepAgent())
+    assert any("Usage: /notify" in n for n in sink.notes)
+
+
+def test_notify_network_error_notes_cleanly(monkeypatch):
+    async def fake_set(cfg, tp, sid, arg):
+        raise RuntimeError("connection refused")
+    monkeypatch.setattr("webbee.remote.set_remote", fake_set)
+
+    sink, agent = _run(read_line=_lines("/notify tg", "/exit"), agent=StepAgent())
+    assert any("Remote control unavailable" in n for n in sink.notes)
+
+
 def test_watcher_started_at_intel_root_not_workspace(monkeypatch, tmp_path):
     """F1: IntelService.root is the discovered repo root, which can differ
     from the raw cwd (e.g. the REPL launched from a subdir). The watcher must

webbee-0.3.3/src/webbee/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.3.3"