sessiontools 0.0.1__tar.gz → 0.0.3__tar.gz

{sessiontools-0.0.1 → sessiontools-0.0.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: sessiontools
-Version: 0.0.1
+Version: 0.0.3
 Summary: The harness layer: sessions, status and idle, one driver per harness - a library first
 Author: Cora 7
 Author-email: Cora 7 <ai-cora@failmode.com>
-Requires-Python: >=3.13
+Requires-Python: >=3.11

{sessiontools-0.0.1 → sessiontools-0.0.3}/pyproject.toml

@@ -1,11 +1,16 @@
 [project]
 name = "sessiontools"
-version = "0.0.1"
+version = "0.0.3"
 description = "The harness layer: sessions, status and idle, one driver per harness - a library first"
 authors = [
     { name = "Cora 7", email = "ai-cora@failmode.com" }
 ]
-requires-python = ">=3.13"
+# >=3.11, not the recipe's >=3.13: sessionmail (the first consumer) declares
+# >=3.11, and uv resolves for EVERY version a project allows, so a stricter
+# floor here made sessionmail's `uv sync` unsatisfiable (Pip, 13:02 Thu
+# 2026-09-17). Measured: the suite passes on 3.11, 3.12 and 3.13; nothing in
+# the tree needs 3.13.
+requires-python = ">=3.11"
 # ZERO runtime dependencies, on purpose: sessionmail (click + mcp) will
 # depend on this, and a stranger installing sessionmail must be happy to
 # pull it. A library first.

{sessiontools-0.0.1 → sessiontools-0.0.3}/src/sessiontools/__init__.py

@@ -6,6 +6,7 @@ cutover (Mike, voice 12:18 Thu 2026-09-17), and the one that arrives then
 is `session`, whose verbs the fleet's callers are already written to.
 
     from sessiontools import sessions, find, idle_seconds
+    from sessiontools import session_id, current, SESSION_ID_VARS
 
 Every function speaks OUR words - busy, not busy, unknown - never a
 harness's. The first driver is `claude_code`; the day a harness changes a
@@ -17,10 +18,13 @@ from __future__ import annotations
 from importlib.metadata import PackageNotFoundError, version
 
 from sessiontools.claude_code import (
+    SESSION_ID_VARS,
     SIDECAR_DIR_ENV,
     Session,
+    current,
     find,
     idle_seconds,
+    session_id,
     sessions,
     sidecar_dir,
 )
@@ -31,11 +35,14 @@ except PackageNotFoundError:   # a checkout that is not installed
     __version__ = "0+unknown"
 
 __all__ = [
+    "SESSION_ID_VARS",
     "SIDECAR_DIR_ENV",
     "Session",
     "__version__",
+    "current",
     "find",
     "idle_seconds",
+    "session_id",
     "sessions",
     "sidecar_dir",
 ]

{sessiontools-0.0.1 → sessiontools-0.0.3}/src/sessiontools/claude_code.py

@@ -109,6 +109,42 @@ def find(session_id: str, env: dict[str, str] | None = None) -> Session | None:
     return None
 
 
+#: Where Claude Code puts THIS session's id, first non-blank wins, in this
+#: order (Mike, voice 20:36-20:41 Wed 2026-09-23). The chain was written
+#: three times and never shared; this is the one copy. Public, so a caller
+#: that needs the names (to scrub a child's environment, say) reads them
+#: here instead of spelling them again.
+SESSION_ID_VARS = ("CLAUDE_CODE_SESSION_ID", "CLAUDE_SESSION_ID")
+
+
+def session_id(env: dict[str, str] | None = None) -> str | None:
+    """This session's id, from the environment ONLY; None when there is none.
+
+    Never the disk: the pager needs the id before Claude Code has written
+    its sidecar. The first NON-BLANK variable in SESSION_ID_VARS wins, and
+    its value is stripped - the rule sessionmail's `_seat.session_id`
+    already keeps (sessionmail 0c010ed, src/sessionmail/_seat.py:59
+    SESSION_VARS, :930 session_id), except that no id is None here, not
+    that module's `-` marks-line placeholder.
+    """
+    env = os.environ if env is None else env
+    for var in SESSION_ID_VARS:
+        value = (env.get(var) or "").strip()
+        if value:
+            return value
+    return None
+
+
+def current(env: dict[str, str] | None = None) -> Session | None:
+    """This session, read from its sidecar: `find(session_id(env))`.
+
+    None when the environment names no session, or when no sidecar names
+    the one it does. Read-only, like everything in this driver.
+    """
+    sid = session_id(env)
+    return None if sid is None else find(sid, env)
+
+
 def idle_seconds(session_id: str, now: float | None = None,
                  env: dict[str, str] | None = None) -> float | None:
     """The one number the pager wants: 0 while busy, else seconds since