sessionkit 0.2.1__tar.gz → 0.3.0__tar.gz

{sessionkit-0.2.1 → sessionkit-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionkit
-Version: 0.2.1
+Version: 0.3.0
 Summary: Session Kit gives your Claude Code sessions voice, mail, a phone line and a tmux sidebar, in one install.
 Author: Mike Bailey
 Author-email: Mike Bailey <mike@sessionkit.ai>
@@ -8,11 +8,11 @@ License-Expression: AGPL-3.0-or-later
 License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
 Requires-Dist: click>=8.1
-Requires-Dist: sessionmail>=0.2.1
-Requires-Dist: sessiontools>=0.2.0
-Requires-Dist: sessionphone[media]>=0.2.1
-Requires-Dist: sessionview>=0.2.0
-Requires-Dist: sessionvoice[capture]>=0.2.1
+Requires-Dist: sessionmail>=0.3.0
+Requires-Dist: sessiontools>=0.3.0
+Requires-Dist: sessionphone[media]>=0.3.0
+Requires-Dist: sessionview>=0.3.0
+Requires-Dist: sessionvoice[capture]>=0.3.0
 Requires-Python: >=3.11, <3.15
 Project-URL: Homepage, https://github.com/sessionkit/sessionkit
 Project-URL: Repository, https://github.com/sessionkit/sessionkit
@@ -26,9 +26,14 @@ Code plugins.
 
 ## Installation
 
-You need macOS and [Claude Code][claude-code]. If you do not have uv yet,
-install it with `curl -LsSf https://astral.sh/uv/install.sh | sh`, then open
-a new terminal (or run `source ~/.local/bin/env`).
+You need macOS, [Claude Code][claude-code], and [Homebrew][brew] or at
+least Apple's Command Line Tools. Homebrew installs the Command Line Tools
+for you ([prerequisites][prereqs]), and the kit needs two of their tools:
+the plugin lines clone with git, and the ears build a Swift helper with
+`swiftc`. Without Homebrew, run `xcode-select --install` to get the Command
+Line Tools alone. If you do not have uv yet, install it with
+`curl -LsSf https://astral.sh/uv/install.sh | sh`, then open a new terminal
+(or run `source ~/.local/bin/env`).
 
 ```bash
 uv tool install --python 3.14 sessionkit
@@ -37,18 +42,42 @@ claude plugin install sessionkit@sessionkit
 ```
 
 The first line puts the commands on your PATH. The other two install the
-kit's plugin and the five family plugins it depends on. Start Claude Code
-(or restart it) to load them.
+kit's plugin and the five family plugins it depends on.
 
 - **Keep `--python 3.14`.** Without it, uv takes the Python it finds: 3.15,
   where a voice library has no build yet and the install fails, or the
   Command Line Tools' 3.11. The kit is tested on 3.14.
+- **Upgrade with `uv tool upgrade sessionkit`.** It keeps the Python the
+  install chose. To reinstall, give the pin again:
+  `uv tool install --python 3.14 --reinstall sessionkit`. Without it, uv
+  drops the pin from its record, or, with `--force`, builds the kit again on
+  the Python it finds.
 - **A dialog may ask to install the Command Line Tools.** On a Mac without
   them, the first `uv tool install` opens it. Click Install and let it
   finish: the plugin lines need the git it brings.
-- **Phone calls are installed, not yet walked.** Whether the phone bot
-  signs its mail to your Claude follows your mail carrier: [bot mail
-  signing][phone-signing].
+- **Phone calls are installed, and walked for a session started with
+  `session start <name>`.** A fresh Mac took a real call and passed. A plain
+  `claude` session does not hear calls you make to it yet. Whether the phone
+  bot signs its mail to your Claude follows your mail carrier:
+  [bot mail signing][phone-signing].
+
+**Then quit Claude Code and start it again**, every window of it, before you
+run anything else. A plugin installed from the shell loads only when Claude
+Code starts, so a session that was already open has no plugin commands on
+its PATH, and no plugin hooks.
+
+The three lines leave the ears without the model they listen with. Fetch it
+once:
+
+```bash
+ears install
+```
+
+It downloads the 2.3 MB voice-activity model to
+`~/.cache/ears/silero_vad.onnx` (network, no sudo) and prints `done`. Without
+it the ears cannot hear you, and `ears services install`, the step that
+starts them ([hearing and speaking][hearing]), refuses with
+`silero MISSING`. The Swift helper is built later, when those services start.
 
 - **The mail hooks start off.** They tell an agent about new mail between
   its tool calls. To turn them on, set `"hooks": true` in
@@ -79,12 +108,12 @@ sessionkit --version
 It lists the kit and each family package, with its version:
 
 ```text
-sessionkit, version 0.2.1
-  sessionmail   0.2.1
-  sessiontools  0.2.0
-  sessionphone  0.2.1
-  sessionview   0.2.0
-  sessionvoice  0.2.1
+sessionkit, version 0.3.0
+  sessionmail   0.3.0
+  sessiontools  0.3.0
+  sessionphone  0.3.0
+  sessionview   0.3.0
+  sessionvoice  0.3.0
 ```
 
 Start Claude with `session start claude`, never a bare `claude`: mail to
@@ -109,6 +138,14 @@ mouth say --device default "the build is green"  # speak one line
   output; `mouth devices` lists the others.
 - **To hear you**, the ears need a speech-to-text server: [hearing and
   speaking][hearing].
+- **Your agent talks with the kit's mouth and ears.** sessionvoice's ears
+  skill sets the default:
+
+  > **With the kit, an agent talks through the kit's own mouth and ears: it
+  > speaks with `mouth say` and listens by arming the ears with `ears-arm`. That
+  > is the default whenever the user asks it to talk, speak, listen or use voice,
+  > even on a host that also has VoiceMode's `converse` tool. It uses `converse`
+  > only when the user asks for converse by name.**
 
 ## Uninstall
 
@@ -117,8 +154,9 @@ claude plugin marketplace remove sessionkit
 uv tool uninstall sessionkit
 ```
 
-Removing the marketplace removes its six plugins too. The services and your
-data have their own steps: [uninstall][uninstall].
+Removing the marketplace removes its six plugins too, but not the copies they
+ran from. Those copies, the services and your data have their own steps:
+[uninstall][uninstall].
 
 ## Usage
 
@@ -133,7 +171,9 @@ Session Kit installs these together:
 - [sessiontools][pkg-tools]: sessions, status and idle. `session`.
 - [sessionvoice][pkg-voice]: ambient voice. `ears` hears; `mouth` speaks.
 - [sessionphone][pkg-phone]: phone calls to a session over Delta Chat.
-  Installed, not yet walked.
+  Installed, and walked on a fresh Mac for a session started with
+  `session start <name>`. A plain `claude` session does not hear calls you
+  make to it yet.
 - [sessionview][pkg-view]: a tmux sidebar of your projects and your agents.
 
 ## Components
@@ -164,13 +204,15 @@ The rules for changing the kit: [AGENTS.md][agents].
 
 ## Status
 
-Alpha, 0.2.1. Tested on macOS 27 on Apple silicon; Linux and Windows are
+Alpha, 0.3.0. Tested on macOS 27 on Apple silicon; Linux and Windows are
 untested. What you may still hit: [known gaps][gaps].
 
 Licence: [AGPL-3.0][licence].
 
 [claude-code]: https://claude.ai/code
+[brew]: https://brew.sh
 [install]: INSTALL.md
+[prereqs]: INSTALL.md#1-prerequisites-human
 [checks]: INSTALL.md#4-first-checks
 [hearing]: INSTALL.md#5-hearing-and-speaking-it-hears-me-and-speaks
 [mail]: INSTALL.md#mail-between-agents

{sessionkit-0.2.1 → sessionkit-0.3.0}/README.md

@@ -6,9 +6,14 @@ Code plugins.
 
 ## Installation
 
-You need macOS and [Claude Code][claude-code]. If you do not have uv yet,
-install it with `curl -LsSf https://astral.sh/uv/install.sh | sh`, then open
-a new terminal (or run `source ~/.local/bin/env`).
+You need macOS, [Claude Code][claude-code], and [Homebrew][brew] or at
+least Apple's Command Line Tools. Homebrew installs the Command Line Tools
+for you ([prerequisites][prereqs]), and the kit needs two of their tools:
+the plugin lines clone with git, and the ears build a Swift helper with
+`swiftc`. Without Homebrew, run `xcode-select --install` to get the Command
+Line Tools alone. If you do not have uv yet, install it with
+`curl -LsSf https://astral.sh/uv/install.sh | sh`, then open a new terminal
+(or run `source ~/.local/bin/env`).
 
 ```bash
 uv tool install --python 3.14 sessionkit
@@ -17,18 +22,42 @@ claude plugin install sessionkit@sessionkit
 ```
 
 The first line puts the commands on your PATH. The other two install the
-kit's plugin and the five family plugins it depends on. Start Claude Code
-(or restart it) to load them.
+kit's plugin and the five family plugins it depends on.
 
 - **Keep `--python 3.14`.** Without it, uv takes the Python it finds: 3.15,
   where a voice library has no build yet and the install fails, or the
   Command Line Tools' 3.11. The kit is tested on 3.14.
+- **Upgrade with `uv tool upgrade sessionkit`.** It keeps the Python the
+  install chose. To reinstall, give the pin again:
+  `uv tool install --python 3.14 --reinstall sessionkit`. Without it, uv
+  drops the pin from its record, or, with `--force`, builds the kit again on
+  the Python it finds.
 - **A dialog may ask to install the Command Line Tools.** On a Mac without
   them, the first `uv tool install` opens it. Click Install and let it
   finish: the plugin lines need the git it brings.
-- **Phone calls are installed, not yet walked.** Whether the phone bot
-  signs its mail to your Claude follows your mail carrier: [bot mail
-  signing][phone-signing].
+- **Phone calls are installed, and walked for a session started with
+  `session start <name>`.** A fresh Mac took a real call and passed. A plain
+  `claude` session does not hear calls you make to it yet. Whether the phone
+  bot signs its mail to your Claude follows your mail carrier:
+  [bot mail signing][phone-signing].
+
+**Then quit Claude Code and start it again**, every window of it, before you
+run anything else. A plugin installed from the shell loads only when Claude
+Code starts, so a session that was already open has no plugin commands on
+its PATH, and no plugin hooks.
+
+The three lines leave the ears without the model they listen with. Fetch it
+once:
+
+```bash
+ears install
+```
+
+It downloads the 2.3 MB voice-activity model to
+`~/.cache/ears/silero_vad.onnx` (network, no sudo) and prints `done`. Without
+it the ears cannot hear you, and `ears services install`, the step that
+starts them ([hearing and speaking][hearing]), refuses with
+`silero MISSING`. The Swift helper is built later, when those services start.
 
 - **The mail hooks start off.** They tell an agent about new mail between
   its tool calls. To turn them on, set `"hooks": true` in
@@ -59,12 +88,12 @@ sessionkit --version
 It lists the kit and each family package, with its version:
 
 ```text
-sessionkit, version 0.2.1
-  sessionmail   0.2.1
-  sessiontools  0.2.0
-  sessionphone  0.2.1
-  sessionview   0.2.0
-  sessionvoice  0.2.1
+sessionkit, version 0.3.0
+  sessionmail   0.3.0
+  sessiontools  0.3.0
+  sessionphone  0.3.0
+  sessionview   0.3.0
+  sessionvoice  0.3.0
 ```
 
 Start Claude with `session start claude`, never a bare `claude`: mail to
@@ -89,6 +118,14 @@ mouth say --device default "the build is green"  # speak one line
   output; `mouth devices` lists the others.
 - **To hear you**, the ears need a speech-to-text server: [hearing and
   speaking][hearing].
+- **Your agent talks with the kit's mouth and ears.** sessionvoice's ears
+  skill sets the default:
+
+  > **With the kit, an agent talks through the kit's own mouth and ears: it
+  > speaks with `mouth say` and listens by arming the ears with `ears-arm`. That
+  > is the default whenever the user asks it to talk, speak, listen or use voice,
+  > even on a host that also has VoiceMode's `converse` tool. It uses `converse`
+  > only when the user asks for converse by name.**
 
 ## Uninstall
 
@@ -97,8 +134,9 @@ claude plugin marketplace remove sessionkit
 uv tool uninstall sessionkit
 ```
 
-Removing the marketplace removes its six plugins too. The services and your
-data have their own steps: [uninstall][uninstall].
+Removing the marketplace removes its six plugins too, but not the copies they
+ran from. Those copies, the services and your data have their own steps:
+[uninstall][uninstall].
 
 ## Usage
 
@@ -113,7 +151,9 @@ Session Kit installs these together:
 - [sessiontools][pkg-tools]: sessions, status and idle. `session`.
 - [sessionvoice][pkg-voice]: ambient voice. `ears` hears; `mouth` speaks.
 - [sessionphone][pkg-phone]: phone calls to a session over Delta Chat.
-  Installed, not yet walked.
+  Installed, and walked on a fresh Mac for a session started with
+  `session start <name>`. A plain `claude` session does not hear calls you
+  make to it yet.
 - [sessionview][pkg-view]: a tmux sidebar of your projects and your agents.
 
 ## Components
@@ -144,13 +184,15 @@ The rules for changing the kit: [AGENTS.md][agents].
 
 ## Status
 
-Alpha, 0.2.1. Tested on macOS 27 on Apple silicon; Linux and Windows are
+Alpha, 0.3.0. Tested on macOS 27 on Apple silicon; Linux and Windows are
 untested. What you may still hit: [known gaps][gaps].
 
 Licence: [AGPL-3.0][licence].
 
 [claude-code]: https://claude.ai/code
+[brew]: https://brew.sh
 [install]: INSTALL.md
+[prereqs]: INSTALL.md#1-prerequisites-human
 [checks]: INSTALL.md#4-first-checks
 [hearing]: INSTALL.md#5-hearing-and-speaking-it-hears-me-and-speaks
 [mail]: INSTALL.md#mail-between-agents

sessionkit-0.2.1/pyproject.toml.orig → sessionkit-0.3.0/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sessionkit"
-version = "0.2.1"
+version = "0.3.0"
 description = "Session Kit gives your Claude Code sessions voice, mail, a phone line and a tmux sidebar, in one install."
 readme = "README.md"
 license = "AGPL-3.0-or-later"
@@ -10,12 +10,10 @@ authors = [
     { name = "Mike Bailey", email = "mike@sessionkit.ai" }
 ]
 requires-python = ">=3.11,<3.15"
-# The family, one install. Floored at 0.2.0: the kit needs every family
-# package at 0.2.0 or later, and PyPI's 0.0.1 name placeholders and the
-# 0.1.0 alphas must never satisfy these. sessionmail, sessionphone and
-# sessionvoice are floored at 0.2.1: mail's 0.2.1 judges the doorbell by the
-# drop, phone's 0.2.1 sends unsigned under the drop carrier, and voice's 0.2.1
-# installer sets the drop carrier.
+# The family, one install. Floored at 0.3.0: the kit is released and tested
+# with the family's 0.3.0, so it needs every family package at 0.3.0 or
+# later, and PyPI's 0.0.1 name placeholders and the 0.1.0 alphas must never
+# satisfy these.
 # sessionphone with its media extra: the bot, calls and `sessionphone web` need it.
 # sessionvoice with its capture extra, so the ears can hear the room.
 # This is the RULED list, kept in tests/_ruled_deps.py with the ruling;
@@ -23,11 +21,11 @@ requires-python = ">=3.11,<3.15"
 # uv.lock drift from it.
 dependencies = [
     "click>=8.1",
-    "sessionmail>=0.2.1",
-    "sessiontools>=0.2.0",
-    "sessionphone[media]>=0.2.1",
-    "sessionview>=0.2.0",
-    "sessionvoice[capture]>=0.2.1",
+    "sessionmail>=0.3.0",
+    "sessiontools>=0.3.0",
+    "sessionphone[media]>=0.3.0",
+    "sessionview>=0.3.0",
+    "sessionvoice[capture]>=0.3.0",
 ]
 
 [project.urls]
@@ -40,8 +38,8 @@ Repository = "https://github.com/sessionkit/sessionkit"
 # `uv tool install sessionkit` would put `sessionkit` alone on the PATH.
 # Each entry point is the child's own target, copied verbatim; re-measure them
 # at each child's HEAD whenever a child adds, renames or drops a command.
-# Measured from each child's built wheel (entry_points.txt) at mail 471a6f7,
-# tools ab62717, phone 02d8cf7, view 3fada19, voice eda3f94.
+# Measured from each child's 0.3.0 wheel (entry_points.txt), by wheel sha256:
+# mail 8e4d9476, tools 8d089699, phone ac402a39, view 3942f119, voice ebc1b65c.
 # sessionview's four commands share one target: `sessionview:main` reads the
 # name it was run as and runs that command.
 # The kit itself still ships no `session` of its own: `session` below is

{sessionkit-0.2.1 → sessionkit-0.3.0}/src/sessionkit/cli.py

@@ -127,6 +127,10 @@ def setup(mailbox: str | None, address: str | None, agent: str, dry_run: bool) -
     layout, is left as it is. It ends with the one launch step:
     `session start NAME`.
 
+    Before that step it asks `ears backends`, read only. If the ears'
+    voice-activity model is missing, it says one line naming `ears install`.
+    It never runs `ears install`, and the line never changes the exit.
+
     Exit 0 all done, 1 refused or failed, 2 usage, 4 done what it could,
     mail steps left for you. See INSTALL.md, "Operator and administrators"
     and "Mail between agents".

{sessionkit-0.2.1 → sessionkit-0.3.0}/src/sessionkit/setup.py

@@ -1,6 +1,8 @@
 """`sessionkit setup`: make this host's mail ready, write the operator, then
 define the assistant (`run_agent`: the file `session start NAME` resolves, and
-the box it hears, so a seat started that way hears mail to NAME).
+the box it hears, so a seat started that way hears mail to NAME). Last, it
+asks `ears backends` whether the ears' model is there, and says so when it is
+not (`ears_model_missing`): read only, never `ears install`, never the exit.
 
 Mail first. sessionmail's mail setup verb (argv in `MAIL_SETUP_ARGV`) makes
 the mail root and the first boxes, the operator's box among them, and the
@@ -636,6 +638,34 @@ def run_agent(
     return Outcome(EXIT_OK, lines)
 
 
+# --- the ears' model: read, never fetched -------------------------------------
+
+# sessionvoice's read-only probe. Its last line is `silero    ok: PATH` or
+# `silero    no model: ears install` (sessionvoice 0.2.1, `ears backends`).
+EARS_BACKENDS_ARGV = ("ears", "backends")
+# The probe answers in well under a second; a slow one is never waited on.
+EARS_PROBE_TIMEOUT = 5.0
+EARS_MODEL_LINE = (
+    "The ears have no voice-activity model, so they cannot hear you: "
+    "run `ears install` to fetch it."
+)
+
+
+def ears_model_missing(environ: Mapping[str, str]) -> bool:
+    """True only when `ears backends` answers, exit 0, with a `silero` line
+    saying `no model`. `ears` not on the PATH (no voice here), a timeout, a
+    failure or output we do not know all read as False: say nothing. Setup
+    never runs `ears install`; the user does."""
+    done = _run(EARS_BACKENDS_ARGV, environ, timeout=EARS_PROBE_TIMEOUT)
+    if done is None or done.returncode != 0:
+        return False
+    for line in (done.stdout or "").splitlines():
+        name, _, state = line.strip().partition(" ")
+        if name == "silero":
+            return state.strip().startswith("no model")
+    return False
+
+
 # --- the run ------------------------------------------------------------------
 
 
@@ -700,9 +730,11 @@ def run_setup(
     because the operator is written only for a box that exists, and the
     mail setup verb is what makes the operator's box and the agent's. The
     exit is the worst of the three: 1 if any refused or failed, else 4 if
-    mail left steps for you, else 0. With the agent defined, the run ends on
-    the one launch step (LAUNCH_SENTENCE). MAILBOX / ADDRESS / AGENT are
-    already shape-checked by the caller.
+    mail left steps for you, else 0. Then `ears backends` is asked, read
+    only: when the ears' model is missing, one line (EARS_MODEL_LINE) names
+    `ears install`; it never changes the exit. With the agent defined, the
+    run ends on the one launch step (LAUNCH_SENTENCE). MAILBOX / ADDRESS /
+    AGENT are already shape-checked by the caller.
     """
     environ = os.environ if environ is None else environ
     resolved = Path.home() if home is None else home
@@ -733,6 +765,9 @@ def run_setup(
         lines.append(
             f"Would ask `{_verb()}` for the agent's box {agent!r} (--box {agent})."
         )
+    # Read only, and never part of the exit: 4 means mail steps are left.
+    if ears_model_missing(environ):
+        lines.append(EARS_MODEL_LINE)
     if defined.code == EXIT_OK:
         lines.append(launch_sentence(agent))
     return Outcome(code, lines)

sessionkit-0.2.1/pyproject.toml

@@ -1,54 +0,0 @@
-[project]
-name = "sessionkit"
-version = "0.2.1"
-description = "Session Kit gives your Claude Code sessions voice, mail, a phone line and a tmux sidebar, in one install."
-readme = "README.md"
-license = "AGPL-3.0-or-later"
-license-files = ["LICENSE"]
-classifiers = ["Development Status :: 3 - Alpha"]
-requires-python = ">=3.11,<3.15"
-dependencies = [
-    "click>=8.1",
-    "sessionmail>=0.2.1",
-    "sessiontools>=0.2.0",
-    "sessionphone[media]>=0.2.1",
-    "sessionview>=0.2.0",
-    "sessionvoice[capture]>=0.2.1",
-]
-
-[[project.authors]]
-name = "Mike Bailey"
-email = "mike@sessionkit.ai"
-
-[project.urls]
-Homepage = "https://github.com/sessionkit/sessionkit"
-Repository = "https://github.com/sessionkit/sessionkit"
-
-[project.scripts]
-sessionkit = "sessionkit.cli:main"
-message = "sessionmail.message:cli"
-pager = "sessionmail.pager:cli"
-memory = "sessionmail.memory:cli"
-session = "sessiontools.cli:main"
-sessionphone = "sessionphone.cli:main"
-sessionview = "sessionview:main"
-sessionview-config = "sessionview:main"
-sessionview-session = "sessionview:main"
-sessionview-messages = "sessionview:main"
-ears = "ears.cli:main"
-ears-serve = "ears.serve:main"
-mouth = "mouth.__main__:main"
-talk = "talk.cli:main"
-
-[build-system]
-requires = ["uv_build>=0.11.9,<0.12.0"]
-build-backend = "uv_build"
-
-[dependency-groups]
-dev = [
-    "pytest>=8",
-    "ruff>=0.6",
-]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]