agentwires 0.2.0__py3-none-any.whl

agentwire/__init__.py

@@ -0,0 +1,7 @@
+"""agentwire — presence and pub/sub for coding-agent sessions.
+
+One package: `core` is the store and the verbs, `adapters` know each agent
+system, `web` is the dashboard and the team server, `extensions` are host
+integrations shipped as data. `cli` is the command on PATH.
+"""
+__version__ = "0.2.0"

agentwire/__main__.py

@@ -0,0 +1,4 @@
+"""`python -m agentwire` behaves exactly like the `agentwire` command."""
+from agentwire.cli import run
+
+run()

agentwire/adapters/__init__.py

@@ -0,0 +1,78 @@
+"""Consumer adapters.
+
+`core/` never imports a consumer. Everything that knows how a particular agent
+system stores its sessions, injects context, or reports a turn lives behind the
+Adapter protocol below. Resolution is by name so a new adapter is a new
+directory, not an edit to this file.
+"""
+import importlib
+import os
+from typing import Protocol, runtime_checkable
+
+
+@runtime_checkable
+class Adapter(Protocol):
+    """What core is allowed to ask a consumer.
+
+    Deliberately says nothing about files, byte offsets or transcripts. A
+    session's progress is an OPAQUE watermark that only the adapter interprets:
+    Claude Code's is a byte offset into a JSONL file, Cursor's is a count of
+    conversation headers in SQLite. Core only ever compares one for equality.
+    """
+    NAME: str
+
+    def present(self) -> bool:
+        """Is this consumer installed on this machine?"""
+
+    def detect_agent_id(self) -> "str | None": ...
+
+    def sessions(self, only=None) -> list:
+        """[{id, project, updated_at: float, trackable: bool, watermark}]."""
+
+    def delta(self, session, since) -> "dict | None":
+        """What changed since `since`.
+
+        -> {"body": str, "units": int, "note": str, "watermark": any} or None.
+        `body` is the consumer-specific "what is new" section of the brief;
+        `units` feeds the --min-rows gate; `note` is one log line.
+        """
+
+    def reading_guide(self) -> str:
+        """How to read this consumer's sessions; core supplies the contract."""
+    def hook_response(self, event, text) -> "dict | None": ...
+    def install(self, exe) -> list: ...
+    def diagnose(self) -> list: ...
+
+
+def active(name=None):
+    """Resolve an adapter by name. With no name, the first tracked consumer —
+    there is no default consumer, only whatever `agentwire add` recorded."""
+    if not name:
+        from agentwire.core import store
+        tracked = store.enabled_consumers()
+        name = tracked[0] if tracked else "claude"
+    try:
+        return importlib.import_module(f"agentwire.adapters.{name}.adapter")
+    except ModuleNotFoundError as e:
+        if getattr(e, "name", "").startswith(f"agentwire.adapters.{name}"):
+            raise SystemExit(f"agentwire: unknown consumer {name!r} "
+                             f"(known: {', '.join(available())})")
+        raise
+
+
+def detected():
+    """Every adapter whose consumer is actually installed here."""
+    out = []
+    for name in available():
+        try:
+            if active(name).present():
+                out.append(name)
+        except Exception:
+            pass
+    return out
+
+
+def available():
+    here = os.path.dirname(__file__)
+    return sorted(d for d in os.listdir(here)
+                  if os.path.isfile(os.path.join(here, d, "adapter.py")))