Skip to content

gentle-pi v4.9.0 — Desktop, Tower, and Session Controls

Latest

Choose a tag to compare

@Alan-TheGentleman Alan-TheGentleman released this 18 Nov 18:22
ce64a9a

Gentle Shell v4.9.0 is a minor release that adds desktop and browser views for working with sessions, expands the Desktop RPC interface, and updates the bundled Gentle AI runtime to v4.6.0. The npm package remains gentle-pi.

Provenance

  • Previous stable: v4.8.0 → 3dc9029755912358d0a172b4972e5842c239570c
  • Release target: v4.9.0 → ce64a9a708e50c0ca899c8023140e63f29f293e1
  • Release validation: run 44369145609 passed package verification, published gentle-pi@4.9.0 to npm with provenance, and built all three installers. The distribution installed and ran with a frozen lockfile on Linux, macOS, and Windows.
  • Pinned Gentle AI: v4.6.0 (08317b958); the provider contract advances from 1.5.0 to 1.6.0.

What's new

Desktop and Tower

Gentle Shell Desktop gives Herdr-hosted sessions a native window for chat, controls, and the terminal. Windows users still install Herdr separately. Gentle Tower gives you a local browser view of sessions, tasks, and artifacts; increases in permissions still require confirmation in the terminal. Interactive Herdr sessions can publish bounded activity records so you can see what jobs and agents are doing.

Included work: #3277, #3270, #3348 (issue #3347).

Desktop clients can see and switch sessions

Desktop RPC clients can list and switch sessions, request selected snapshot sections, and receive snapshot updates. Requests that overlap a switch get a retryable response. Clients can also read cached update status or explicitly refresh it; a failed check reports unknown, not up to date.

Included work: #3330 (issue #3320), #3328 (issue #3319), #3340 (issue #3337).

Desktop clients can inspect work and controls

Clients can read bounded subagent threads and job-output tails, inspect changed files and bounded diffs, and get usage statistics. Threads and output may contain unredacted task or process text. Clients can also read or request a change to receipt-driven development mode, with confirmation. Config and permission events now also report best-effort external changes; use their source to distinguish them from writes made by the client.

Included work: #3334 (issue #3323), #3329 (issue #3309), #3333 (issue #3322), #3327 (issue #3325), #3326 (issue #3324), #3335 (issue #3321).

Profiles, design, and orchestration

Eligible new sessions use their resolved profile's orchestrator without changing saved defaults. Unusable models leave the current model in place and show a notice. The design canvas adds a Gentleman theme while keeping Neutral as the default. Updated orchestration guidance keeps independent authorized work moving, uses decision tools for choices they can represent, and lets the parent decide edit-surface additions that stay within scope. Responses no longer require a closing Key Learnings section.

Included work: #3208 (issue #1064, split #2716), #3289 (issue #2740), #3286 (issue #3285).

Gentle AI v4.6.0 pin

The package and double-click installers use the same verified Gentle AI v4.6.0 release. See Pinned runtime for the platform and contract details.

Included work: #3371 (issue #3370).

What was fixed

Decisions and recovery

Ordinary choice dialogs now accept typed answers by default; closed consent and exact-token choices keep their fixed options. Workers that exhaust corrections now return a diagnosis for the orchestrator to act on, and refused delegation explains the next step. Managed guidance distinguishes ordinary system-temp reads and writes from deletion, without changing runtime guards.

Included work: #3292 (issue #3291), #3339 (issue #3338), #3300 (issue #3299).

Profiles and skill discovery

Profiles can save Fast mode for GPT-6.2 Sol and Astra on supported routes. Skill discovery skips hidden entries at skill roots and prefers the named skill over a backup copy.

Included work: #3350 (issue #3349), #3298 (issue #3297).

Pinned runtime

Gentle Shell pins Gentle AI v4.6.0 (github.com/gentleman-programming/gentle-ai/v4). Darwin and Linux use the signed release archives and pinned binary SHA-256 values. Windows builds from the SumDB-verified Go module. The upstream provider contract is now 1.6.0, and the published bundle matches all ten files in Shell's existing mirror byte-for-byte. The NATIVE_CLI_CONTRACTS row for 4.6.0 preserves the CLI's capabilities/v2.6 identity.

Breaking changes

No user-facing command or package interface break is declared. Desktop RPC clients must handle config and permission events from outside their own writes. Callers that require an ordinary choice dialog to accept only the listed options should explicitly disable custom responses.

Upgrade

pi install npm:gentle-pi@4.9.0

Restart Pi, then run gentle-ai sync so the managed orchestrator assets match the pinned runtime.

Numbers

37 non-merge commits, 21 merged pull requests, and 5 unique GitHub PR authors since v4.8.0.

Verification

  • Package verification passed: 302 files and 69 byte-pinned package contract artifacts. npm pack --dry-run passed, and the packed gentle-pi runner exercised the real published Gentle AI v4.6.0 assets.
  • Independent verification matched all four archive and executable digest pairs, the Windows SumDB checksum, the ten provider mirror files, and the live CLI capability contract. The focused contract suite passed 33 tests.
  • Local macOS arm64 full suite: 11,280 passed, 96 skipped, and the same six environment-specific failures as on the unmodified base. Provider and runtime harness stages passed. The canonical PR CI for pin head 2310efd00 passed all seven jobs, including the full Linux verification and the macOS session-transport job.
  • Native review: both high-risk Desktop slices (#3277) were approved after one bounded correction each. Tower (#3270) exceeded the whole-branch review budget, so four sensitive-code slices were reviewed and approved separately. Eight Desktop RPC PRs (#3326–#3330 and #3333–#3335) record approval and non-blocking follow-ups. The PR notes do not record lineage IDs or a complete count of findings.

Install

pi install npm:gentle-pi@4.9.0

Package: https://www.npmjs.com/package/gentle-pi

Full changelog: v4.8.0...v4.9.0