feat(core,frontends,agents): agent kinds, frontend routing, anthropic on conversations, vault mirror

src/beaver_gateway/core/transcript.py

@@ -15,7 +15,9 @@ anything that needs Anthropic-shape history out of a mirrored transcript.
 
 from __future__ import annotations
 
+import hashlib
 import uuid as _uuid
+from collections.abc import Mapping
 from datetime import UTC, datetime
 from typing import TYPE_CHECKING, Any
 
@@ -25,17 +27,19 @@ except ImportError:  # pragma: no cover
     _cli_version = "2.1.248"
 
 if TYPE_CHECKING:
-    from collections.abc import Iterable, Mapping
+    from collections.abc import Iterable
 
 __all__ = [
     "CLI_VERSION",
     "build_entries",
     "close_open_tool_uses",
+    "fingerprint",
     "messages_from_entries",
     "open_tool_uses",
     "prompt_count",
     "render_messages",
     "strip_tool_entries",
+    "text_of",
     "window_entries",
 ]
 
@@ -503,3 +507,37 @@ def _text_of_content(content: Any) -> str:
             if isinstance(b, dict) and b.get("type") == "text" and b.get("text")
         )
     return ""
+
+
+def fingerprint(messages: Iterable[Mapping[str, Any]]) -> str:
+    """Text-only hash of a history; stateless callers are keyed by it."""
+    turns: list[tuple[str, str]] = []
+    for message in messages:
+        text = text_of(message.get("content"))
+        if not text:
+            continue
+        role = str(message.get("role", ""))
+        if turns and turns[-1][0] == role:
+            turns[-1] = (role, turns[-1][1] + "\n" + text)
+        else:
+            turns.append((role, text))
+    digest = hashlib.sha1(usedforsecurity=False)
+    for role, text in turns:
+        digest.update(role.encode("utf-8"))
+        digest.update(b"\x00")
+        digest.update(text.strip().encode("utf-8"))
+        digest.update(b"\x01")
+    return digest.hexdigest()
+
+
+def text_of(content: Any) -> str:
+    if isinstance(content, str):
+        return content
+    if isinstance(content, list):
+        parts = [
+            str(b.get("text", ""))
+            for b in content
+            if isinstance(b, Mapping) and b.get("type") == "text"
+        ]
+        return "\n".join(p for p in parts if p)
+    return ""