sessionkit 0.3.3__tar.gz → 0.4.0__tar.gz

sessionkit-0.4.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: sessionkit
+Version: 0.4.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>
+License-Expression: AGPL-3.0-or-later
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Requires-Dist: click>=8.1
+Requires-Dist: sessionmail>=0.4.0
+Requires-Dist: sessiontools>=0.4.0
+Requires-Dist: sessionphone[media]>=0.4.0
+Requires-Dist: sessionview>=0.4.0
+Requires-Dist: sessionvoice[capture]>=0.4.0
+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
+Description-Content-Type: text/markdown
+
+# Session Kit
+
+Session Kit gives your Claude Code sessions a voice, a phone line and a
+mailbox. From the people who brought you [VoiceMode][voicemode].
+
+```bash
+curl -fsSL https://sessionkit.ai/install.sh | bash
+```
+
+This repo is the kit's home: the installer, the [manual steps][manual]
+and the docs.
+
+<!-- Hero image goes here: Talk on a phone, mid-conversation. -->
+
+## Features
+
+- **Voice.** Your session hears the room and answers aloud.
+- **A phone line.** Text or ring your session from Delta Chat on your phone.
+- **Mail.** Agents mail each other, and an idle agent wakes when mail lands
+  ([mail between agents][mail]).
+- **A crew.** One agent starts another and hands it the work.
+- **Talk.** Watch the conversation live in a browser.
+
+## Quick start
+
+After the install, do what its last screen lists (sign in to Claude Code
+once), then start your first session, in whatever folder you're in:
+
+```bash
+session start
+```
+
+Ask Claude to call you. It shows a QR code: scan it with your phone and
+follow the steps to install Delta Chat. Then you can text or ring your
+session. Asking Claude to call you, or ringing your session, is when you
+agree to be heard, and recorded if recording is on.
+
+## What it installs
+
+Session Kit installs the family in one go: five packages, each with its
+Claude Code plugin, and the Settings page.
+
+- [sessionmail][pkg-mail]: mail for agent memory and communication
+  ([the paper][paper]).
+- [sessiontools][pkg-tools]: your live sessions, and starting new ones.
+- [sessionvoice][pkg-voice]: the ears hear the room; the mouth speaks.
+- [sessionphone][pkg-phone]: a phone line to your session, over Delta Chat.
+- [sessionview][pkg-view]: a tmux sidebar of your projects and agents.
+- [settled][settled]: the kit's settings page, on your own Mac.
+
+Every command answers `--help`. Commands, services and folders:
+[components][components].
+
+## Requirements
+
+- [x] macOS on Apple silicon (tested on an M5 MacBook Air, 16 GB, macOS 27)
+- [ ] Linux (preliminary testing; no install steps yet)
+- [ ] WSL
+- [ ] Windows
+
+You need:
+
+- [Homebrew][brew]
+- [uv][uv]
+- [Claude Code][claude-code]
+- About 8 GB of free disk
+
+The installer adds any of the first three that are missing.
+
+## Installation
+
+The one line at the top checks your Mac, lists what it will add, and asks
+before it installs anything. Rather run each step yourself? With the
+requirements in place (the speech server is about 4 GB):
+
+```bash
+brew install tmux ffmpeg notmuch
+uv tool install --python 3.14 sessionkit
+claude plugin marketplace add sessionkit/sessionkit
+claude plugin install sessionkit@sessionkit
+ears install
+ears services install --agent claude
+sessionkit setup
+pager settings hooks on
+```
+
+Then quit Claude Code, every window, so the plugins load. Check it with
+`sessionkit doctor`. More detail: [step by step][install]. To remove it:
+[uninstall][uninstall].
+
+**Already using VoiceMode?** It keeps working. Use either one, or both side
+by side.
+
+## Configuration
+
+Each package's settings: [configuration][config]. How they stack:
+[settings][settings].
+
+## Logs
+
+Where each log is: [logs][logs]. Which to read for a symptom:
+[troubleshooting][trouble]. Restarting a service: [service][service].
+**Health:** `sessionkit doctor`.
+
+## Development
+
+`make install`, then `make check`. The rules: [AGENTS.md][agents].
+
+Working across the family? With your clones of the five packages beside this
+one, `make install-dev` installs the whole kit from them (`DRY_RUN=1` first
+to see the command).
+
+## Status
+
+Alpha, 0.4.0. A new release most Sundays. [Known gaps][gaps] · Licence
+[AGPL-3.0][licence].
+
+[voicemode]: https://voicemode.dev
+[brew]: https://brew.sh
+[uv]: https://docs.astral.sh/uv/
+[claude-code]: https://code.claude.com/docs/en/overview
+[install]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md
+[manual]: #installation
+[mail]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md#mail-between-agents
+[gaps]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md#7-known-gaps-you-will-hit
+[uninstall]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md#8-uninstall
+[components]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/components.md
+[config]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/configuration.md
+[settings]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/settings.md
+[service]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/service.md
+[logs]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/components.md#logs
+[trouble]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/troubleshooting.md
+[agents]: https://github.com/sessionkit/sessionkit/blob/HEAD/AGENTS.md
+[licence]: https://github.com/sessionkit/sessionkit/blob/HEAD/LICENSE
+[pkg-mail]: https://github.com/sessionkit/sessionmail
+[paper]: https://cora7.com/blog/the-mailbox-is-the-memory/
+[pkg-tools]: https://github.com/sessionkit/sessiontools
+[pkg-voice]: https://github.com/sessionkit/sessionvoice
+[pkg-phone]: https://github.com/sessionkit/sessionphone
+[pkg-view]: https://github.com/sessionkit/sessionview
+[settled]: https://github.com/sessionkit/settled

sessionkit-0.4.0/README.md

@@ -0,0 +1,141 @@
+# Session Kit
+
+Session Kit gives your Claude Code sessions a voice, a phone line and a
+mailbox. From the people who brought you [VoiceMode][voicemode].
+
+```bash
+curl -fsSL https://sessionkit.ai/install.sh | bash
+```
+
+This repo is the kit's home: the installer, the [manual steps][manual]
+and the docs.
+
+<!-- Hero image goes here: Talk on a phone, mid-conversation. -->
+
+## Features
+
+- **Voice.** Your session hears the room and answers aloud.
+- **A phone line.** Text or ring your session from Delta Chat on your phone.
+- **Mail.** Agents mail each other, and an idle agent wakes when mail lands
+  ([mail between agents][mail]).
+- **A crew.** One agent starts another and hands it the work.
+- **Talk.** Watch the conversation live in a browser.
+
+## Quick start
+
+After the install, do what its last screen lists (sign in to Claude Code
+once), then start your first session, in whatever folder you're in:
+
+```bash
+session start
+```
+
+Ask Claude to call you. It shows a QR code: scan it with your phone and
+follow the steps to install Delta Chat. Then you can text or ring your
+session. Asking Claude to call you, or ringing your session, is when you
+agree to be heard, and recorded if recording is on.
+
+## What it installs
+
+Session Kit installs the family in one go: five packages, each with its
+Claude Code plugin, and the Settings page.
+
+- [sessionmail][pkg-mail]: mail for agent memory and communication
+  ([the paper][paper]).
+- [sessiontools][pkg-tools]: your live sessions, and starting new ones.
+- [sessionvoice][pkg-voice]: the ears hear the room; the mouth speaks.
+- [sessionphone][pkg-phone]: a phone line to your session, over Delta Chat.
+- [sessionview][pkg-view]: a tmux sidebar of your projects and agents.
+- [settled][settled]: the kit's settings page, on your own Mac.
+
+Every command answers `--help`. Commands, services and folders:
+[components][components].
+
+## Requirements
+
+- [x] macOS on Apple silicon (tested on an M5 MacBook Air, 16 GB, macOS 27)
+- [ ] Linux (preliminary testing; no install steps yet)
+- [ ] WSL
+- [ ] Windows
+
+You need:
+
+- [Homebrew][brew]
+- [uv][uv]
+- [Claude Code][claude-code]
+- About 8 GB of free disk
+
+The installer adds any of the first three that are missing.
+
+## Installation
+
+The one line at the top checks your Mac, lists what it will add, and asks
+before it installs anything. Rather run each step yourself? With the
+requirements in place (the speech server is about 4 GB):
+
+```bash
+brew install tmux ffmpeg notmuch
+uv tool install --python 3.14 sessionkit
+claude plugin marketplace add sessionkit/sessionkit
+claude plugin install sessionkit@sessionkit
+ears install
+ears services install --agent claude
+sessionkit setup
+pager settings hooks on
+```
+
+Then quit Claude Code, every window, so the plugins load. Check it with
+`sessionkit doctor`. More detail: [step by step][install]. To remove it:
+[uninstall][uninstall].
+
+**Already using VoiceMode?** It keeps working. Use either one, or both side
+by side.
+
+## Configuration
+
+Each package's settings: [configuration][config]. How they stack:
+[settings][settings].
+
+## Logs
+
+Where each log is: [logs][logs]. Which to read for a symptom:
+[troubleshooting][trouble]. Restarting a service: [service][service].
+**Health:** `sessionkit doctor`.
+
+## Development
+
+`make install`, then `make check`. The rules: [AGENTS.md][agents].
+
+Working across the family? With your clones of the five packages beside this
+one, `make install-dev` installs the whole kit from them (`DRY_RUN=1` first
+to see the command).
+
+## Status
+
+Alpha, 0.4.0. A new release most Sundays. [Known gaps][gaps] · Licence
+[AGPL-3.0][licence].
+
+[voicemode]: https://voicemode.dev
+[brew]: https://brew.sh
+[uv]: https://docs.astral.sh/uv/
+[claude-code]: https://code.claude.com/docs/en/overview
+[install]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md
+[manual]: #installation
+[mail]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md#mail-between-agents
+[gaps]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md#7-known-gaps-you-will-hit
+[uninstall]: https://github.com/sessionkit/sessionkit/blob/HEAD/INSTALL.md#8-uninstall
+[components]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/components.md
+[config]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/configuration.md
+[settings]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/settings.md
+[service]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/service.md
+[logs]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/components.md#logs
+[trouble]: https://github.com/sessionkit/sessionkit/blob/HEAD/docs/troubleshooting.md
+[agents]: https://github.com/sessionkit/sessionkit/blob/HEAD/AGENTS.md
+[licence]: https://github.com/sessionkit/sessionkit/blob/HEAD/LICENSE
+[pkg-mail]: https://github.com/sessionkit/sessionmail
+[paper]: https://cora7.com/blog/the-mailbox-is-the-memory/
+[pkg-tools]: https://github.com/sessionkit/sessiontools
+[pkg-voice]: https://github.com/sessionkit/sessionvoice
+[pkg-phone]: https://github.com/sessionkit/sessionphone
+[pkg-view]: https://github.com/sessionkit/sessionview
+[settled]: https://github.com/sessionkit/settled

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

@@ -1,6 +1,6 @@
 [project]
 name = "sessionkit"
-version = "0.3.3"
+version = "0.4.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"
@@ -9,11 +9,11 @@ classifiers = ["Development Status :: 3 - Alpha"]
 requires-python = ">=3.11,<3.15"
 dependencies = [
     "click>=8.1",
-    "sessionmail>=0.3.3",
-    "sessiontools>=0.3.3",
-    "sessionphone[media]>=0.3.3",
-    "sessionview>=0.3.3",
-    "sessionvoice[capture]>=0.3.3",
+    "sessionmail>=0.4.0",
+    "sessiontools>=0.4.0",
+    "sessionphone[media]>=0.4.0",
+    "sessionview>=0.4.0",
+    "sessionvoice[capture]>=0.4.0",
     "settled[kit]>=0.1.0",
 ]
 
@@ -32,14 +32,29 @@ pager = "sessionmail.pager:cli"
 memory = "sessionmail.memory:cli"
 session = "sessiontools.cli:main"
 sessionphone = "sessionphone.cli:main"
+dc-answer = "sessionphone.dctools:main"
+dc-call = "sessionphone.dctools:main"
+dc-call-mix = "sessionphone.dctools:main"
+dc-delete = "sessionphone.dctools:main"
+dc-dm = "sessionphone.dctools:main"
+dc-fetch = "sessionphone.dctools:main"
+dc-hangup = "sessionphone.dctools:main"
+dc-invite = "sessionphone.dctools:main"
+dc-live = "sessionphone.dctools:main"
+dc-log = "sessionphone.dctools:main"
+dc-log-web = "sessionphone.dctools:main"
+dc-react = "sessionphone.dctools:main"
+dc-ring = "sessionphone.dctools:main"
+dc-say = "sessionphone.dctools:main"
+dc-send-file = "sessionphone.dctools:main"
+dc-xdc-realtime = "sessionphone.dctools:main"
+dc-xdc-update = "sessionphone.dctools: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"
+sessionvoice-web = "talk.web:main"
 settled = "settled.cli:main"
 
 [build-system]

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

@@ -1,6 +1,6 @@
 [project]
 name = "sessionkit"
-version = "0.3.3"
+version = "0.4.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"
@@ -14,15 +14,18 @@ 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.
-# Within the 0.3.3 floor below, `sessionkit setup` asks sessiontools for
+# Within the 0.4.0 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 verb ships in sessiontools 0.3.3, below the floor; 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.
+# All five are floored at 0.4.0 or later: the family is released together, and
+# an older copy of one package beside the others splits its state between the
+# old and new folders.
+# sessionview from 0.4.0 has its helpers as verbs, and the kit links
+# `sessionview` alone. An older sessionview still types
+# `sessionview-messages` into its messages tab, which the kit no longer links.
 # 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
@@ -31,17 +34,17 @@ requires-python = ">=3.11,<3.15"
 # 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.
+# covers.
 # 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.3",
-    "sessiontools>=0.3.3",
-    "sessionphone[media]>=0.3.3",
-    "sessionview>=0.3.3",
-    "sessionvoice[capture]>=0.3.3",
+    "sessionmail>=0.4.0",
+    "sessiontools>=0.4.0",
+    "sessionphone[media]>=0.4.0",
+    "sessionview>=0.4.0",
+    "sessionvoice[capture]>=0.4.0",
     "settled[kit]>=0.1.0",
 ]
 
@@ -59,8 +62,8 @@ Repository = "https://github.com/sessionkit/sessionkit"
 # 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.
+# sessionview ships one command. Its helpers are verbs of it, `sessionview
+# config`, `sessionview session` and `sessionview messages`, never on the PATH.
 # The kit itself still ships no `session` of its own: `session` below is
 # sessiontools' command, re-exported, not a second implementation.
 [project.scripts]
@@ -73,16 +76,36 @@ memory = "sessionmail.memory:cli"
 session = "sessiontools.cli:main"
 # sessionphone
 sessionphone = "sessionphone.cli:main"
+# sessionphone's dc-* tools: one console-script target, sessionphone.dctools:main,
+# which runs the tool named by argv[0]. uv links only the kit's own scripts, so
+# without these lines a kit install leaves them off PATH.
+# dc-env (a library the tools source), bridge-check and bin/sessionphone never ship.
+dc-answer = "sessionphone.dctools:main"
+dc-call = "sessionphone.dctools:main"
+dc-call-mix = "sessionphone.dctools:main"
+dc-delete = "sessionphone.dctools:main"
+dc-dm = "sessionphone.dctools:main"
+dc-fetch = "sessionphone.dctools:main"
+dc-hangup = "sessionphone.dctools:main"
+dc-invite = "sessionphone.dctools:main"
+dc-live = "sessionphone.dctools:main"
+dc-log = "sessionphone.dctools:main"
+dc-log-web = "sessionphone.dctools:main"
+dc-react = "sessionphone.dctools:main"
+dc-ring = "sessionphone.dctools:main"
+dc-say = "sessionphone.dctools:main"
+dc-send-file = "sessionphone.dctools:main"
+dc-xdc-realtime = "sessionphone.dctools:main"
+dc-xdc-update = "sessionphone.dctools:main"
 # sessionview
 sessionview = "sessionview:main"
-sessionview-config = "sessionview:main"
-sessionview-session = "sessionview:main"
-sessionview-messages = "sessionview:main"
 # sessionvoice
 ears = "ears.cli:main"
 ears-serve = "ears.serve:main"
 mouth = "mouth.__main__:main"
 talk = "talk.cli:main"
+# the front door asks it for Talk's room: `sessionvoice-web web-room` (docs/family-web.md)
+sessionvoice-web = "talk.web:main"
 # settled
 settled = "settled.cli:main"
 

{sessionkit-0.3.3 → sessionkit-0.4.0}/src/sessionkit/cli.py

@@ -86,7 +86,7 @@ def _shape(check):
     metavar="NAME",
     callback=_shape(operator_setup.check_mailbox_shape),
     help="Your mail box: a box `message box path NAME` finds. "
-    "Default: your OS account name, if sessionmail has a box by that name.",
+    "Default: the box sessionmail names as the operator's, if it exists.",
 )
 @click.option(
     "--address",
@@ -142,7 +142,10 @@ def setup(
 
     Before that step it adds the wake seat with `ears wake add`: NAME when
     --agent is given, else the default seat, so saying "hey" and its name
-    wakes it. Without `ears` on the PATH, or when it refuses, it says one line
+    wakes it once the ears' services run. It asks `ears services status`,
+    read only: unless the keeper and the mail service both run, the line
+    says "hey NAME" works once they do and names `ears services install`.
+    Without `ears` on the PATH, or when it refuses, it says one line
     with the step to run; that line never changes the exit. It never runs
     `ears services install`. Then it asks `ears backends`, read only. If
     the ears' voice-activity model is missing, it says one line naming

{sessionkit-0.3.3 → sessionkit-0.4.0}/src/sessionkit/doctor.py

@@ -37,6 +37,9 @@ from collections.abc import Callable, Mapping
 from dataclasses import dataclass, field
 from pathlib import Path
 
+from sessionkit import phoneowner
+from sessionkit.setup import REPOSITORY
+
 # install.sh --check's exits, passed straight through.
 EXIT_OK = 0
 EXIT_MISSING = 1
@@ -97,7 +100,8 @@ HOOKS_ON = "pager settings hooks on"
 # install.sh's HOOKS_BY_HAND, for a pager with no hooks verb: the file is
 # sessionmail's, so the doctor names the edit and never makes it.
 HOOKS_BY_HAND = 'set "hooks": true in {shown}, and change no other key'
-HOOKS_SECTION = 'the README\'s Installation, "The mail hooks start off"'
+# INSTALL.md ships in neither the wheel nor the sdist: the hint names the repo.
+HOOKS_SECTION = f'INSTALL.md section 4, "Turn the mail hooks on", in {REPOSITORY}'
 # How long the pager's help may take. A pager that does not answer in time is
 # read as one with no verb: the hand edit works with any pager.
 HELP_TIMEOUT = 10
@@ -170,7 +174,14 @@ def phone_row(env: Mapping[str, str]) -> Row:
     """The phone bot: optional, so it never fails the run. sessionphone names
     the bot as its own install would, and asks launchd, read-only. Never
     `sessionphone bot status`: that sends a clip to the job's speech URL,
-    which can be any host."""
+    which can be any host. Under it, the owner's key pin, read from
+    sessionphone's callers readers (phoneowner): info, never missing."""
+    row = _bot_row(env)
+    row.under += phoneowner.doctor_lines(env)
+    return row
+
+
+def _bot_row(env: Mapping[str, str]) -> Row:
     what = "📞 Phone bot (optional, for calls)"
     # The call ear is not checked: sessionphone has no read-only check for it
     # yet. A row for it waits for the release that adds one.