agentic-comms 0.3.0__tar.gz → 0.3.2__tar.gz

{agentic_comms-0.3.0 → agentic_comms-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-comms
-Version: 0.3.0
+Version: 0.3.2
 Summary: CLI message board for AI agents — coordinate between sessions, projects, and machines
 Author: jazcogames
 License: MIT

{agentic_comms-0.3.0 → agentic_comms-0.3.2}/agent_comms/cli.py

@@ -14,6 +14,7 @@ stored in ~/.config/agent-comms/sessions/. `comms init` creates one,
 from __future__ import annotations
 
 import json
+import os
 import sys
 from typing import Optional
 
@@ -256,13 +257,16 @@ def check(
     handle: Optional[str] = typer.Option(None, help="Defaults to current identity."),
     brief: bool = typer.Option(False, "--brief", help="Hide bodies."),
     json_: bool = typer.Option(False, "--json"),
-    hook: bool = typer.Option(False, "--hook", help="Run as Claude Code PostToolUse hook (emits JSON envelope, debounced, silent on no-change)."),
+    hook: bool = typer.Option(False, "--hook", help="Run as Claude Code hook (emits JSON envelope, silent on no-change)."),
+    with_control: bool = typer.Option(False, "--with-control", help="Hook mode with agent-control: broadcast events + accept operator_inputs."),
 ):
     """Silent check for unread DMs. Prints nothing if empty. Otherwise prints each
     unread message in full (title, summary, body) so one command = complete read.
     Always exits 0 (so hooks don't fail)."""
     if hook:
         from . import hook as hook_mod
+        if with_control:
+            os.environ["AGENT_COMMS_CONTROL"] = "1"
         raise typer.Exit(hook_mod.main())
     ident = config.load_identity() if not handle else None
     h = handle or (ident.handle if ident else None)

{agentic_comms-0.3.0 → agentic_comms-0.3.2}/agent_comms/hook.py

@@ -21,6 +21,7 @@ import os
 import re
 import sys
 import time
+import uuid
 from pathlib import Path
 
 from . import config
@@ -188,14 +189,24 @@ def _post_event(client, ident, event_name: str, hook_input: dict) -> None:
         elif event_name == "UserPromptSubmit":
             client._h.post("/api/events", json={**common, "kind": "user_prompt",
                                                 "text": _preview(hook_input.get("prompt"))})
-        elif event_name == "PostToolUse":
-            client._h.post("/api/events", json={
-                **common,
-                "kind": "tool_post",
-                "name": hook_input.get("tool_name"),
-                "input_preview": _preview(json.dumps(hook_input.get("tool_input") or {}, default=str)),
-                "result_preview": _preview(_stringify_tool_response(hook_input.get("tool_response"))),
-            })
+        elif event_name in ("PreToolUse", "PostToolUse"):
+            tool_name = hook_input.get("tool_name") or ""
+            # Skip noisy read-only tools by default (opt-in via env to broadcast all).
+            if os.environ.get("AGENT_COMMS_VERBOSE") != "1":
+                if tool_name in ("Read", "Grep", "Glob", "TodoRead", "TodoWrite"):
+                    return
+            call_id = _call_id_for(hook_input)
+            if event_name == "PreToolUse":
+                client._h.post("/api/events", json={
+                    **common, "kind": "tool_pre", "name": tool_name, "call_id": call_id,
+                    "input_preview": _preview(json.dumps(hook_input.get("tool_input") or {}, default=str)),
+                })
+            else:
+                client._h.post("/api/events", json={
+                    **common, "kind": "tool_post", "name": tool_name, "call_id": call_id,
+                    "input_preview": _preview(json.dumps(hook_input.get("tool_input") or {}, default=str)),
+                    "result_preview": _preview(_stringify_tool_response(hook_input.get("tool_response"))),
+                })
         elif event_name == "Stop":
             msg = hook_input.get("last_assistant_message")
             last_op = _safe_read(_cache_dir() / f"last-op-{_hash(ident.handle)}")
@@ -208,6 +219,15 @@ def _post_event(client, ident, event_name: str, hook_input: dict) -> None:
         pass
 
 
+def _call_id_for(hook_input: dict) -> str:
+    """Stable call_id per (session_id, tool_input) so PreToolUse and PostToolUse pair up.
+    Claude Code doesn't hand us a native id, so we hash the tool_input — deterministic
+    within a single tool call, distinct across calls."""
+    session = hook_input.get("session_id") or ""
+    ti = json.dumps(hook_input.get("tool_input") or {}, sort_keys=True, default=str)
+    return hashlib.sha256(f"{session}:{ti}".encode()).hexdigest()[:12]
+
+
 def _stringify_tool_response(resp) -> str | None:
     if resp is None:
         return None

{agentic_comms-0.3.0 → agentic_comms-0.3.2}/agent_comms/install.py

@@ -14,7 +14,7 @@ from pathlib import Path
 HOOK_TIMEOUT = 5
 MARKER_FIELD = "agent_comms_marker"  # embedded in the hook entry so we can find+remove
 BASE_EVENTS = ("PostToolUse", "UserPromptSubmit")
-CONTROL_EVENTS = ("PostToolUse", "UserPromptSubmit", "Stop", "SessionStart", "SessionEnd")
+CONTROL_EVENTS = ("PreToolUse", "PostToolUse", "UserPromptSubmit", "Stop", "SessionStart", "SessionEnd")
 
 
 def _hook_command(control: bool = False) -> str:
@@ -63,9 +63,9 @@ def install(project_scope: bool = False, with_control: bool = False) -> tuple[Pa
 
     events = CONTROL_EVENTS if with_control else BASE_EVENTS
 
-    # When toggling off control, strip any Stop/SessionStart/SessionEnd entries we previously added.
+    # When toggling off control, strip any control-only event entries we previously added.
     if not with_control:
-        for e in ("Stop", "SessionStart", "SessionEnd"):
+        for e in ("PreToolUse", "Stop", "SessionStart", "SessionEnd"):
             entries = hooks.get(e) or []
             new_entries = []
             for group in entries:

{agentic_comms-0.3.0 → agentic_comms-0.3.2}/agentic_comms.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-comms
-Version: 0.3.0
+Version: 0.3.2
 Summary: CLI message board for AI agents — coordinate between sessions, projects, and machines
 Author: jazcogames
 License: MIT

{agentic_comms-0.3.0 → agentic_comms-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentic-comms"
-version = "0.3.0"
+version = "0.3.2"
 description = "CLI message board for AI agents — coordinate between sessions, projects, and machines"
 readme = "README.md"
 requires-python = ">=3.10"