From a61558a0ade9281599ada8e665c2a538625749ef Mon Sep 17 00:00:00 2001 From: Hermenix Date: Sun, 11 Oct 2026 22:59:45 +0000 Subject: [PATCH] docs: the two counts that are prose rather than assertions `tools.py`'s module docstring and the module's `mcp.enable` warning both state the size of the surface in words, so neither moved when the stream added to it. Twenty-three tools, and twenty of them plus seven of the ten resources need the broker -- counted rather than carried over: the three that do not are `shot`, `record` and `run`, and `hhstream://status`, `hhstream://screen` and `hhstream://outputs/{name}` beside them. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_011ZeH65zd6pFTgBSu52W9PE --- nix/module.nix | 4 ++-- src/hhstream_mcp/tools.py | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/nix/module.nix b/nix/module.nix index 2896664..35ee3eb 100644 --- a/nix/module.nix +++ b/nix/module.nix @@ -989,8 +989,8 @@ in { # to declare. environment.systemPackages = lib.mkIf cfg.mcp.enable [ cfg.mcp.package ]; - # A warning and not an assertion: eighteen of the twenty-one tools and six - # of the eight resources need the broker, and an agent handed them against + # A warning and not an assertion: twenty of the twenty-three tools and + # seven of the ten resources need the broker, and an agent handed them against # a machine where it is off gets exit 5 from every one of them -- which is # a true answer, badly timed. The frame tools are genuinely useful on their # own, so this is a thing worth saying rather than a thing worth refusing. diff --git a/src/hhstream_mcp/tools.py b/src/hhstream_mcp/tools.py index 8c83df0..f8ea5eb 100644 --- a/src/hhstream_mcp/tools.py +++ b/src/hhstream_mcp/tools.py @@ -31,7 +31,7 @@ with an ``action`` enum. Three reasons, in order of weight: 3. ``readOnlyHint`` is per tool and is still a real distinction among what is left: ``shot`` reads, ``session_kill`` destroys, ``record`` writes a file. -The cost is twenty-one tools in one listing, and :data:`TOOLSETS` is the lever +The cost is twenty-three tools in one listing, and :data:`TOOLSETS` is the lever for a client that cannot afford them all. It is paid back by the names being the CLI's own: an agent that has read ``hhstream session --help``, or this repository's README, already knows what ``session_touch`` is, and a transcript