sessionkit 0.3.2__tar.gz → 0.3.3__tar.gz

{sessionkit-0.3.2 → sessionkit-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionkit
-Version: 0.3.2
+Version: 0.3.3
 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,12 @@ License-Expression: AGPL-3.0-or-later
 License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
 Requires-Dist: click>=8.1
-Requires-Dist: sessionmail>=0.3.2
-Requires-Dist: sessiontools>=0.3.2
-Requires-Dist: sessionphone[media]>=0.3.2
-Requires-Dist: sessionview>=0.3.2
-Requires-Dist: sessionvoice[capture]>=0.3.2
+Requires-Dist: sessionmail>=0.3.3
+Requires-Dist: sessiontools>=0.3.3
+Requires-Dist: sessionphone[media]>=0.3.3
+Requires-Dist: sessionview>=0.3.3
+Requires-Dist: sessionvoice[capture]>=0.3.3
+Requires-Dist: settled[kit]>=0.1.0
 Requires-Python: >=3.11, <3.15
 Project-URL: Homepage, https://github.com/sessionkit/sessionkit
 Project-URL: Repository, https://github.com/sessionkit/sessionkit
@@ -197,32 +198,28 @@ 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
-  `~/.sessionkit/mail/settings/mail.json`. The plugin writes that file,
-  with the hooks off, the first time a Claude Code session runs a tool,
-  and it holds other settings too, so change only that key. Never write
-  the file over: that deletes the other keys. This works whether the file
-  is there yet or not, and whether it has a `hooks` key or not:
+  its tool calls. Turn them on with sessionmail's own command:
 
   ```bash
-  f=~/.sessionkit/mail/settings/mail.json
-  if [ -f "$f" ]; then
-    perl -0777 -pi -e '
-      if (/"hooks"\s*:/) { s/"hooks"\s*:\s*false/"hooks": true/ }
-      elsif (/\A\s*\{\s*\}\s*\z/) { s/\{\s*\}/{"hooks": true}/ }
-      else { s/\{(\s*)/"{$1" . q("hooks": true,) . ($1 || " ")/e }
-    ' "$f"
-  else
-    mkdir -p ~/.sessionkit/mail/settings
-    echo '{"version": 1, "hooks": true, "sendmail": "drop"}' > "$f"
-  fi
+  pager settings hooks on
   ```
 
-  A `"hooks": false` becomes `true`. A file with no `hooks` key gets
-  `"hooks": true` as its first key, and its other keys stay as they were.
-  If the file is not there yet, this writes what the plugin would have
-  written, with the hooks on. The plugin never replaces a file that is
-  already there.
+  - It sets only `"hooks": true` in
+    `~/.sessionkit/mail/settings/mail.json`, and keeps every other key in
+    that file. With no file yet, it makes one, with the hooks on.
+  - Each session's next hook reads it. A second run writes nothing.
+  - To turn them off again:
+
+    ```bash
+    pager settings hooks off
+    ```
+
+  - To see which they are, run it bare. It changes nothing, and exits 0
+    for on, 3 for off:
+
+    ```bash
+    pager settings hooks
+    ```
 
 Step by step, with every step that needs you marked: [the manual
 install][install].
@@ -252,8 +249,8 @@ The phone bot and the session key are shown, but they never fail it.
 sessionkit --version
 ```
 
-It lists the kit and each family package, with its version. Each `X.Y.Z`
-is the version you installed:
+It lists the kit, each family package and settled, the Settings app, each
+with its version. Each `X.Y.Z` is the version you installed:
 
 ```text
 sessionkit, version X.Y.Z
@@ -262,6 +259,7 @@ sessionkit, version X.Y.Z
   sessionphone  X.Y.Z
   sessionview   X.Y.Z
   sessionvoice  X.Y.Z
+  settled       X.Y.Z
 ```
 
 Start Claude in a project folder, not in your home folder, where a new
@@ -328,6 +326,11 @@ mouth say "the build is green"
   `mouth devices` lists the others, and `--device DEVICE` picks one.
 - **To hear you**, the ears need a speech-to-text server: [hearing and
   speaking][hearing].
+- **See the conversation in a browser.** Talk shows what the ears heard,
+  what the mouth said, and which seats heard it. Start it with
+  `ears services install --only talk`, then run `talk pair` in a terminal
+  on the same Mac and open the link it prints. Each browser pairs once
+  ([Talk][talk]).
 - **Your agent talks with the kit's mouth and ears.** sessionvoice's ears
   skill sets the default:
 
@@ -377,10 +380,14 @@ Session Kit installs these together:
 - [sessionview][pkg-view]: a tmux sidebar of your projects and your agents.
   `sessionview` (said "session view").
 
+It also installs settled, the Settings app: `settled`. It is not one of the
+five: it has its own version, and no Claude Code plugin.
+
 ## Components
 
 The commands, services and folders the install adds, and where each
-package logs: [components][components].
+package logs: [components][components]. To see the services and restart
+one: [sessionkit service][service].
 
 ## Configuration
 
@@ -408,7 +415,7 @@ The rules for changing the kit: [AGENTS.md][agents].
 
 ## Status
 
-Alpha, 0.3.2. Tested on macOS 27 on Apple silicon; Linux and Windows are
+Alpha, 0.3.3. 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].
@@ -424,10 +431,12 @@ Licence: [AGPL-3.0][licence].
 [uninstall]: INSTALL.md#8-uninstall
 [gaps]: INSTALL.md#7-known-gaps-you-will-hit
 [components]: docs/components.md
+[service]: docs/service.md
 [dependencies]: docs/dependencies.md
 [logs]: docs/components.md#logs
 [configuration]: docs/configuration.md
 [settings]: docs/settings.md
+[talk]: docs/talk.md
 [troubleshooting]: docs/troubleshooting.md
 [agents]: AGENTS.md
 [licence]: LICENSE

{sessionkit-0.3.2 → sessionkit-0.3.3}/README.md

@@ -177,32 +177,28 @@ 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
-  `~/.sessionkit/mail/settings/mail.json`. The plugin writes that file,
-  with the hooks off, the first time a Claude Code session runs a tool,
-  and it holds other settings too, so change only that key. Never write
-  the file over: that deletes the other keys. This works whether the file
-  is there yet or not, and whether it has a `hooks` key or not:
+  its tool calls. Turn them on with sessionmail's own command:
 
   ```bash
-  f=~/.sessionkit/mail/settings/mail.json
-  if [ -f "$f" ]; then
-    perl -0777 -pi -e '
-      if (/"hooks"\s*:/) { s/"hooks"\s*:\s*false/"hooks": true/ }
-      elsif (/\A\s*\{\s*\}\s*\z/) { s/\{\s*\}/{"hooks": true}/ }
-      else { s/\{(\s*)/"{$1" . q("hooks": true,) . ($1 || " ")/e }
-    ' "$f"
-  else
-    mkdir -p ~/.sessionkit/mail/settings
-    echo '{"version": 1, "hooks": true, "sendmail": "drop"}' > "$f"
-  fi
+  pager settings hooks on
   ```
 
-  A `"hooks": false` becomes `true`. A file with no `hooks` key gets
-  `"hooks": true` as its first key, and its other keys stay as they were.
-  If the file is not there yet, this writes what the plugin would have
-  written, with the hooks on. The plugin never replaces a file that is
-  already there.
+  - It sets only `"hooks": true` in
+    `~/.sessionkit/mail/settings/mail.json`, and keeps every other key in
+    that file. With no file yet, it makes one, with the hooks on.
+  - Each session's next hook reads it. A second run writes nothing.
+  - To turn them off again:
+
+    ```bash
+    pager settings hooks off
+    ```
+
+  - To see which they are, run it bare. It changes nothing, and exits 0
+    for on, 3 for off:
+
+    ```bash
+    pager settings hooks
+    ```
 
 Step by step, with every step that needs you marked: [the manual
 install][install].
@@ -232,8 +228,8 @@ The phone bot and the session key are shown, but they never fail it.
 sessionkit --version
 ```
 
-It lists the kit and each family package, with its version. Each `X.Y.Z`
-is the version you installed:
+It lists the kit, each family package and settled, the Settings app, each
+with its version. Each `X.Y.Z` is the version you installed:
 
 ```text
 sessionkit, version X.Y.Z
@@ -242,6 +238,7 @@ sessionkit, version X.Y.Z
   sessionphone  X.Y.Z
   sessionview   X.Y.Z
   sessionvoice  X.Y.Z
+  settled       X.Y.Z
 ```
 
 Start Claude in a project folder, not in your home folder, where a new
@@ -308,6 +305,11 @@ mouth say "the build is green"
   `mouth devices` lists the others, and `--device DEVICE` picks one.
 - **To hear you**, the ears need a speech-to-text server: [hearing and
   speaking][hearing].
+- **See the conversation in a browser.** Talk shows what the ears heard,
+  what the mouth said, and which seats heard it. Start it with
+  `ears services install --only talk`, then run `talk pair` in a terminal
+  on the same Mac and open the link it prints. Each browser pairs once
+  ([Talk][talk]).
 - **Your agent talks with the kit's mouth and ears.** sessionvoice's ears
   skill sets the default:
 
@@ -357,10 +359,14 @@ Session Kit installs these together:
 - [sessionview][pkg-view]: a tmux sidebar of your projects and your agents.
   `sessionview` (said "session view").
 
+It also installs settled, the Settings app: `settled`. It is not one of the
+five: it has its own version, and no Claude Code plugin.
+
 ## Components
 
 The commands, services and folders the install adds, and where each
-package logs: [components][components].
+package logs: [components][components]. To see the services and restart
+one: [sessionkit service][service].
 
 ## Configuration
 
@@ -388,7 +394,7 @@ The rules for changing the kit: [AGENTS.md][agents].
 
 ## Status
 
-Alpha, 0.3.2. Tested on macOS 27 on Apple silicon; Linux and Windows are
+Alpha, 0.3.3. 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].
@@ -404,10 +410,12 @@ Licence: [AGPL-3.0][licence].
 [uninstall]: INSTALL.md#8-uninstall
 [gaps]: INSTALL.md#7-known-gaps-you-will-hit
 [components]: docs/components.md
+[service]: docs/service.md
 [dependencies]: docs/dependencies.md
 [logs]: docs/components.md#logs
 [configuration]: docs/configuration.md
 [settings]: docs/settings.md
+[talk]: docs/talk.md
 [troubleshooting]: docs/troubleshooting.md
 [agents]: AGENTS.md
 [licence]: LICENSE

{sessionkit-0.3.2 → sessionkit-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sessionkit"
-version = "0.3.2"
+version = "0.3.3"
 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"
@@ -9,11 +9,12 @@ classifiers = ["Development Status :: 3 - Alpha"]
 requires-python = ">=3.11,<3.15"
 dependencies = [
     "click>=8.1",
-    "sessionmail>=0.3.2",
-    "sessiontools>=0.3.2",
-    "sessionphone[media]>=0.3.2",
-    "sessionview>=0.3.2",
-    "sessionvoice[capture]>=0.3.2",
+    "sessionmail>=0.3.3",
+    "sessiontools>=0.3.3",
+    "sessionphone[media]>=0.3.3",
+    "sessionview>=0.3.3",
+    "sessionvoice[capture]>=0.3.3",
+    "settled[kit]>=0.1.0",
 ]
 
 [[project.authors]]
@@ -39,6 +40,7 @@ ears = "ears.cli:main"
 ears-serve = "ears.serve:main"
 mouth = "mouth.__main__:main"
 talk = "talk.cli:main"
+settled = "settled.cli:main"
 
 [build-system]
 requires = ["uv_build>=0.11.9,<0.12.0"]

{sessionkit-0.3.2 → sessionkit-0.3.3}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "sessionkit"
-version = "0.3.2"
+version = "0.3.3"
 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"
@@ -14,25 +14,35 @@ requires-python = ">=3.11,<3.15"
 # 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.
-# sessiontools and sessionmail are floored at 0.3.1, for what the kit's code
-# and docs call on: `sessionkit setup` asks sessiontools 0.3.1's
-# `session agent default`, and INSTALL.md describes sessionmail 0.3.1's
-# one-run mail setup.
-# All five are floored at 0.3.2: the family is released together, and an older
+# Within the 0.3.3 floor below, `sessionkit setup` asks sessiontools for
+# `session agent default`, and INSTALL.md describes sessionmail's one-run
+# mail setup. Setup also asks sessiontools for the agents folder with
+# `session path agent --config --json`.
+# That verb ships in sessiontools 0.3.3, the floor below; with a sessiontools
+# that lacks it, setup writes no agent file and says so.
+# All five are floored at 0.3.3: the family is released together, and an older
 # copy of one package beside the others splits its state between the old
 # and new folders.
 # 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.
+# settled, the Settings app, is required too: a hard dependency, never an
+# optional extra. It is not a family package: it has its own version line,
+# floored at 0.1.0 so PyPI's 0.0.1 name placeholder can never satisfy it, and
+# its kit extra brings the kit's tool registry and jsonschema, without which
+# it shows none of the kit's tools.
+# That extra asks for sessiontools 0.3.3, which the sessiontools line below
+# now floors.
 # This is the RULED list, kept in tests/_ruled_deps.py with the ruling;
 # tests/test_dependency_gate.py fails when these lines, the built wheel or
 # uv.lock drift from it.
 dependencies = [
     "click>=8.1",
-    "sessionmail>=0.3.2",
-    "sessiontools>=0.3.2",
-    "sessionphone[media]>=0.3.2",
-    "sessionview>=0.3.2",
-    "sessionvoice[capture]>=0.3.2",
+    "sessionmail>=0.3.3",
+    "sessiontools>=0.3.3",
+    "sessionphone[media]>=0.3.3",
+    "sessionview>=0.3.3",
+    "sessionvoice[capture]>=0.3.3",
+    "settled[kit]>=0.1.0",
 ]
 
 [project.urls]
@@ -47,6 +57,8 @@ Repository = "https://github.com/sessionkit/sessionkit"
 # at each child's HEAD whenever a child adds, renames or drops a command.
 # 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.
+# settled: from the settings repo's pyproject at 1487963 and its 0.1.0
+# wheel, sha256 d796d326 (re-measure from the staged 0.1.0 wheel, by sha256).
 # 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
@@ -71,6 +83,8 @@ ears = "ears.cli:main"
 ears-serve = "ears.serve:main"
 mouth = "mouth.__main__:main"
 talk = "talk.cli:main"
+# settled
+settled = "settled.cli:main"
 
 [build-system]
 requires = ["uv_build>=0.11.9,<0.12.0"]