pythinker-code 0.16.0__tar.gz → 0.17.0__tar.gz

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythinker-code
-Version: 0.16.0
+Version: 0.17.0
 Summary: Pythinker Code is your next CLI agent.
 Keywords: cli,agent,ai,coding-assistant,llm,claude,openai,terminal
 Author: Mohamed Elkholy
@@ -80,7 +80,6 @@ Description-Content-Type: text/markdown
 [![CI](https://img.shields.io/github/actions/workflow/status/mohamed-elkholy95/Pythinker-Code/ci-pythinker-cli.yml?branch=main&label=CI&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/mohamed-elkholy95/Pythinker-Code/actions/workflows/ci-pythinker-cli.yml?query=branch%3Amain)
 
 [![Downloads](https://img.shields.io/pepy/dt/pythinker-code?cacheSeconds=300)](https://pepy.tech/projects/pythinker-code)
-[![Installs](https://img.shields.io/endpoint?url=https://pythinker.com/api/installs/badge&cacheSeconds=300)](https://pythinker.com)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-f59e0b.svg?style=flat-square&logo=ruff&logoColor=white)](https://docs.astral.sh/ruff/)
 [![ACP ready](https://img.shields.io/badge/ACP-ready-7c3aed.svg?style=flat-square)](https://github.com/agentclientprotocol/agent-client-protocol)
 [![MCP tools](https://img.shields.io/badge/MCP-tools-0891b2.svg?style=flat-square)](https://modelcontextprotocol.io/)
@@ -116,13 +115,15 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 
 ---
 
-## 🆕 What's New in 0.16.0
+## 🆕 What's New in 0.17.0
 
-- **Native installation is standardized across platforms.** Quick Start now leads with the canonical hosted installers: `irm https://pythinker.com/install.ps1 | iex` on Windows and `curl -fsSL https://pythinker.com/install.sh | bash` on macOS/Linux.
-- **Old local installer wrappers are removed from user-facing docs.** Legacy local shell wrappers and Python-tool manager shortcuts are no longer presented as install options; Python package installs remain documented only as the universal fallback.
-- **Release artifact links are consistent.** Manual `.exe`, `.deb`, `.rpm`, and tarball instructions all point at GitHub Release assets for `0.16.0` and include SHA-256 verification guidance.
+- **Sharper compaction continuity.** PreCompact now carries custom instructions, restores skill and hook context after compaction, triggers SessionStart after restore, and preserves the `Conversation compacted.` handoff so long sessions resume cleanly.
+- **Better subagent orchestration.** Subagent specs merge inherited subagent maps, launches preserve parent-agent IDs for spawn-tree tracking, RunAgents fingerprints include agent names, and markdown agent discovery warns on unknown models instead of silently falling back.
+- **Polished terminal workflow.** The shell adopts the robot-brand palette, compact transcript/agent/file-mention menus, pinned live todo activity, calmer tool output, and safer auto-backgrounding for long shell commands.
+- **Release and installer hardening.** Interactive sessions show a blocking pre-start update prompt, update exits wait for acknowledgement, Homebrew publish retries package installs, and native installers gain a friendlier animated path with Windows User PATH automation.
+- **Provider compatibility refresh.** Anthropic SDK support is updated for 0.101 tool-result block types so direct Anthropic sessions continue to stream tool output correctly.
 
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.16.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.17.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
 
 
 ---
@@ -212,10 +213,10 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 
 | Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.16.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS / 🐧 Linux** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
-| **🐧 Linux — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.17.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux">** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
+| **<img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
 | **🐍 Python fallback** | `pip install pythinker-code` | PyPI |
 
 Every artifact ships with a matching `.sha256` file — verify before install on
@@ -237,7 +238,7 @@ pythinker                      # start the interactive TUI
 
 ### 🪟 Windows — native installer
 
-`PythinkerSetup-0.16.0.exe` is a signed* Inno Setup wizard. Installs per-user
+`PythinkerSetup-0.17.0.exe` is a signed* Inno Setup wizard. Installs per-user
 into `%LOCALAPPDATA%\Programs\Pythinker`, registers `pythinker` on your user
 PATH (`HKCU\Environment`), broadcasts `WM_SETTINGCHANGE` so new shells see
 the change. **No UAC prompt.**
@@ -248,13 +249,13 @@ irm https://pythinker.com/install.ps1 | iex
 
 # Or manually download the installer + checksum from the Releases page,
 # verify with Get-FileHash, then run:
-.\PythinkerSetup-0.16.0.exe
+.\PythinkerSetup-0.17.0.exe
 
 # Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.16.0.exe /ALLUSERS`
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.17.0.exe /ALLUSERS`
 installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
 
 **Upgrade:** `pythinker update` from inside the running app — it downloads
@@ -271,7 +272,7 @@ the files and the PATH edit.
 
 ---
 
-### 🍎 macOS — Homebrew tap
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew tap
 
 ```sh
 # 1. Install
@@ -297,33 +298,33 @@ auto-update; run this whenever you want the latest).
 
 ---
 
-### 🐧 Linux — system packages
+### <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system packages
 
 Native `.deb` and `.rpm` packages for both `x86_64` and `aarch64` are
 attached to every GitHub Release.
 
 ```sh
 # Debian / Ubuntu (x86_64)
-sudo dpkg -i pythinker-code_0.16.0_amd64.deb
+sudo dpkg -i pythinker-code_0.17.0_amd64.deb
 sudo apt-get install -f       # only if dpkg reports missing deps
 
 # Debian / Ubuntu (ARM64)
-sudo dpkg -i pythinker-code_0.16.0_arm64.deb
+sudo dpkg -i pythinker-code_0.17.0_arm64.deb
 
 # Fedora / RHEL / openSUSE (x86_64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.x86_64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.17.0.x86_64.rpm.sha256
 # Fedora / RHEL:
-sudo dnf install ./pythinker-code-0.16.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.17.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.16.0.x86_64.rpm
+sudo zypper install ./pythinker-code-0.17.0.x86_64.rpm
 
 # Fedora / RHEL (aarch64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.16.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.17.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.17.0.aarch64.rpm
 ```
 
 Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
@@ -332,8 +333,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 
 ```sh
-sha256sum -c pythinker-code_0.16.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256       # Fedora/RHEL
+sha256sum -c pythinker-code_0.17.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.17.0.x86_64.rpm.sha256       # Fedora/RHEL
 ```
 
 **Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
@@ -349,7 +350,7 @@ sudo rpm -e pythinker-code                                 # Fedora/RHEL
 
 ---
 
-### 🌐 macOS / Linux — curl-bash native installer
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — curl-bash native installer
 
 For containers, fresh VMs, or any host without a system package manager.
 The canonical `https://pythinker.com/install.sh` endpoint is backed by
@@ -363,7 +364,7 @@ at `~/.local/bin/pythinker`.
 curl -fsSL https://pythinker.com/install.sh | bash
 
 # Pin a specific version
-curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.16.0
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.17.0
 
 # Custom prefix (defaults to $HOME/.local)
 curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker
@@ -384,9 +385,9 @@ Supported targets:
 
 | `uname -s / -m`             | Tarball asset                                            |
 |---|---|
-| Linux / x86_64              | `pythinker-0.16.0-x86_64-unknown-linux-gnu.tar.gz`        |
-| Linux / aarch64             | `pythinker-0.16.0-aarch64-unknown-linux-gnu.tar.gz`       |
-| Darwin / arm64              | `pythinker-0.16.0-aarch64-apple-darwin.tar.gz`            |
+| Linux / x86_64              | `pythinker-0.17.0-x86_64-unknown-linux-gnu.tar.gz`        |
+| Linux / aarch64             | `pythinker-0.17.0-aarch64-unknown-linux-gnu.tar.gz`       |
+| Darwin / arm64              | `pythinker-0.17.0-aarch64-apple-darwin.tar.gz`            |
 
 The script prints PATH guidance if `~/.local/bin` isn't already on your
 `$PATH`. Intel macOS users — use Homebrew or `pip install pythinker-code`;

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/README.md

@@ -15,7 +15,6 @@
 [![CI](https://img.shields.io/github/actions/workflow/status/mohamed-elkholy95/Pythinker-Code/ci-pythinker-cli.yml?branch=main&label=CI&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/mohamed-elkholy95/Pythinker-Code/actions/workflows/ci-pythinker-cli.yml?query=branch%3Amain)
 
 [![Downloads](https://img.shields.io/pepy/dt/pythinker-code?cacheSeconds=300)](https://pepy.tech/projects/pythinker-code)
-[![Installs](https://img.shields.io/endpoint?url=https://pythinker.com/api/installs/badge&cacheSeconds=300)](https://pythinker.com)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-f59e0b.svg?style=flat-square&logo=ruff&logoColor=white)](https://docs.astral.sh/ruff/)
 [![ACP ready](https://img.shields.io/badge/ACP-ready-7c3aed.svg?style=flat-square)](https://github.com/agentclientprotocol/agent-client-protocol)
 [![MCP tools](https://img.shields.io/badge/MCP-tools-0891b2.svg?style=flat-square)](https://modelcontextprotocol.io/)
@@ -51,13 +50,15 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 
 ---
 
-## 🆕 What's New in 0.16.0
+## 🆕 What's New in 0.17.0
 
-- **Native installation is standardized across platforms.** Quick Start now leads with the canonical hosted installers: `irm https://pythinker.com/install.ps1 | iex` on Windows and `curl -fsSL https://pythinker.com/install.sh | bash` on macOS/Linux.
-- **Old local installer wrappers are removed from user-facing docs.** Legacy local shell wrappers and Python-tool manager shortcuts are no longer presented as install options; Python package installs remain documented only as the universal fallback.
-- **Release artifact links are consistent.** Manual `.exe`, `.deb`, `.rpm`, and tarball instructions all point at GitHub Release assets for `0.16.0` and include SHA-256 verification guidance.
+- **Sharper compaction continuity.** PreCompact now carries custom instructions, restores skill and hook context after compaction, triggers SessionStart after restore, and preserves the `Conversation compacted.` handoff so long sessions resume cleanly.
+- **Better subagent orchestration.** Subagent specs merge inherited subagent maps, launches preserve parent-agent IDs for spawn-tree tracking, RunAgents fingerprints include agent names, and markdown agent discovery warns on unknown models instead of silently falling back.
+- **Polished terminal workflow.** The shell adopts the robot-brand palette, compact transcript/agent/file-mention menus, pinned live todo activity, calmer tool output, and safer auto-backgrounding for long shell commands.
+- **Release and installer hardening.** Interactive sessions show a blocking pre-start update prompt, update exits wait for acknowledgement, Homebrew publish retries package installs, and native installers gain a friendlier animated path with Windows User PATH automation.
+- **Provider compatibility refresh.** Anthropic SDK support is updated for 0.101 tool-result block types so direct Anthropic sessions continue to stream tool output correctly.
 
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.16.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.17.0`, or use the native installer for your platform from the [Releases page](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest).
 
 
 ---
@@ -147,10 +148,10 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 
 | Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.16.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS / 🐧 Linux** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🍎 macOS — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
-| **🐧 Linux — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.17.0.exe` from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux">** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
+| **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | auto-published Homebrew tap |
+| **<img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
 | **🐍 Python fallback** | `pip install pythinker-code` | PyPI |
 
 Every artifact ships with a matching `.sha256` file — verify before install on
@@ -172,7 +173,7 @@ pythinker                      # start the interactive TUI
 
 ### 🪟 Windows — native installer
 
-`PythinkerSetup-0.16.0.exe` is a signed* Inno Setup wizard. Installs per-user
+`PythinkerSetup-0.17.0.exe` is a signed* Inno Setup wizard. Installs per-user
 into `%LOCALAPPDATA%\Programs\Pythinker`, registers `pythinker` on your user
 PATH (`HKCU\Environment`), broadcasts `WM_SETTINGCHANGE` so new shells see
 the change. **No UAC prompt.**
@@ -183,13 +184,13 @@ irm https://pythinker.com/install.ps1 | iex
 
 # Or manually download the installer + checksum from the Releases page,
 # verify with Get-FileHash, then run:
-.\PythinkerSetup-0.16.0.exe
+.\PythinkerSetup-0.17.0.exe
 
 # Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.16.0.exe /ALLUSERS`
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.17.0.exe /ALLUSERS`
 installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
 
 **Upgrade:** `pythinker update` from inside the running app — it downloads
@@ -206,7 +207,7 @@ the files and the PATH edit.
 
 ---
 
-### 🍎 macOS — Homebrew tap
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew tap
 
 ```sh
 # 1. Install
@@ -232,33 +233,33 @@ auto-update; run this whenever you want the latest).
 
 ---
 
-### 🐧 Linux — system packages
+### <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system packages
 
 Native `.deb` and `.rpm` packages for both `x86_64` and `aarch64` are
 attached to every GitHub Release.
 
 ```sh
 # Debian / Ubuntu (x86_64)
-sudo dpkg -i pythinker-code_0.16.0_amd64.deb
+sudo dpkg -i pythinker-code_0.17.0_amd64.deb
 sudo apt-get install -f       # only if dpkg reports missing deps
 
 # Debian / Ubuntu (ARM64)
-sudo dpkg -i pythinker-code_0.16.0_arm64.deb
+sudo dpkg -i pythinker-code_0.17.0_arm64.deb
 
 # Fedora / RHEL / openSUSE (x86_64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.x86_64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.17.0.x86_64.rpm.sha256
 # Fedora / RHEL:
-sudo dnf install ./pythinker-code-0.16.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.17.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.16.0.x86_64.rpm
+sudo zypper install ./pythinker-code-0.17.0.x86_64.rpm
 
 # Fedora / RHEL (aarch64)
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.16.0/pythinker-code-0.16.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.16.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.16.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.aarch64.rpm
+curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.17.0/pythinker-code-0.17.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.17.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.17.0.aarch64.rpm
 ```
 
 Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
@@ -267,8 +268,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 
 ```sh
-sha256sum -c pythinker-code_0.16.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.16.0.x86_64.rpm.sha256       # Fedora/RHEL
+sha256sum -c pythinker-code_0.17.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.17.0.x86_64.rpm.sha256       # Fedora/RHEL
 ```
 
 **Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
@@ -284,7 +285,7 @@ sudo rpm -e pythinker-code                                 # Fedora/RHEL
 
 ---
 
-### 🌐 macOS / Linux — curl-bash native installer
+### <img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — curl-bash native installer
 
 For containers, fresh VMs, or any host without a system package manager.
 The canonical `https://pythinker.com/install.sh` endpoint is backed by
@@ -298,7 +299,7 @@ at `~/.local/bin/pythinker`.
 curl -fsSL https://pythinker.com/install.sh | bash
 
 # Pin a specific version
-curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.16.0
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.17.0
 
 # Custom prefix (defaults to $HOME/.local)
 curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker
@@ -319,9 +320,9 @@ Supported targets:
 
 | `uname -s / -m`             | Tarball asset                                            |
 |---|---|
-| Linux / x86_64              | `pythinker-0.16.0-x86_64-unknown-linux-gnu.tar.gz`        |
-| Linux / aarch64             | `pythinker-0.16.0-aarch64-unknown-linux-gnu.tar.gz`       |
-| Darwin / arm64              | `pythinker-0.16.0-aarch64-apple-darwin.tar.gz`            |
+| Linux / x86_64              | `pythinker-0.17.0-x86_64-unknown-linux-gnu.tar.gz`        |
+| Linux / aarch64             | `pythinker-0.17.0-aarch64-unknown-linux-gnu.tar.gz`       |
+| Darwin / arm64              | `pythinker-0.17.0-aarch64-apple-darwin.tar.gz`            |
 
 The script prints PATH guidance if `~/.local/bin` isn't already on your
 `$PATH`. Intel macOS users — use Homebrew or `pip install pythinker-code`;

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pythinker-code"
-version = "0.16.0"
+version = "0.17.0"
 description = "Pythinker Code is your next CLI agent."
 readme = "README.md"
 requires-python = ">=3.12"

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/CHANGELOG.md

@@ -15,6 +15,18 @@ GitHub Releases page; `0.8.0` is the new starting line.
 
 ## Unreleased
 
+## 0.17.0 (2026-05-25)
+
+### What changed in this release
+
+- **Sharper compaction continuity.** PreCompact now carries custom instructions, restores skill and hook context after compaction, triggers SessionStart after restore, and preserves the `Conversation compacted.` handoff so long sessions resume cleanly.
+- **Better subagent orchestration.** Subagent specs merge inherited subagent maps, foreground and background launches preserve parent-agent IDs for spawn-tree tracking, RunAgents fingerprints include agent names, and markdown agent discovery warns on unknown models instead of silently falling back.
+- **Polished terminal workflow.** The shell adopts the robot-brand palette, compact transcript/agent/file-mention menus, pinned live todo activity, calmer tool output, safer auto-backgrounding for long shell commands, and updated render snapshots.
+- **Release and installer hardening.** Interactive sessions show a blocking pre-start update prompt, update exits wait for acknowledgement, Homebrew publish retries package installs, and native installers gain a friendlier animated path with Windows User PATH automation.
+- **Provider compatibility refresh.** Anthropic SDK support is updated for 0.101 tool-result block types so direct Anthropic sessions continue to stream tool output correctly.
+
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.17.0`, or use the native installer for your OS (see the README install table).
+
 ## 0.16.0 (2026-05-24)
 
 ### What changed in this release

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/agents/default/system.md

@@ -22,9 +22,9 @@ The user's messages may contain questions and/or task descriptions in natural la
 
 When handling the user's request, if it involves creating, modifying, or running code or files, you MUST use the appropriate tools (e.g., `WriteFile`, `Shell`) to make actual changes — do not just describe the solution in text. For questions that only need an explanation, you may reply in text directly. When calling tools, do not provide explanations because the tool calls themselves should be self-explanatory. You MUST follow the description of each tool and its parameters when calling tools.
 
-If the `Agent` tool is available, you can use it to delegate a focused subtask to a subagent instance. Treat subagents as focused roles, not just extra capacity: use `explore` for read-only mapping, `plan` for strategy, `coder` or `implementer` for scoped edits, `review` for severity-scored critique, and `verifier` for validation gates. The tool can either start a new instance or resume an existing one by `agent_id`. Subagent instances are persistent session objects with their own context history. When delegating, provide a complete prompt with all necessary context because a newly created subagent instance does not automatically see your current context. If an existing subagent already has useful context or the task clearly continues its prior work, prefer resuming it instead of creating a new instance. Default to foreground subagents. Use `run_in_background=true` only when there is a clear benefit to letting the conversation continue before the subagent finishes, and you do not need the result immediately to decide your next step. Spawn multiple subagents in the same turn when they can investigate independent regions concurrently.
+If the `Agent` tool is available, you can use it to delegate a focused subtask to a subagent instance. Treat subagents as focused roles, not just extra capacity: use `explore` for read-only mapping, `plan` for strategy, `coder` or `implementer` for scoped edits, `review` for severity-scored critique, and `verifier` for validation gates. The tool can either start a new instance or resume an existing one by `agent_id`. Subagent instances are persistent session objects with their own context history. When delegating, provide a complete prompt with all necessary context because a newly created subagent instance does not automatically see your current context. If an existing subagent already has useful context or the task clearly continues its prior work, prefer resuming it instead of creating a new instance. Default to foreground subagents. Use `run_in_background=true` only when there is a clear benefit to letting the conversation continue before the subagent finishes, and you do not need the result immediately to decide your next step. Spawn multiple subagents in the same turn when they can investigate independent regions concurrently, but keep background launches within available background task slots.
 
-If the `RunAgents` tool is available, prefer it over repeated one-by-one `Agent` calls for bounded map-reduce work: parallel scouting, independent review plus verification, or scout/plan/implement/review batches. Keep each child prompt focused and include a shared `base_prompt` with the user goal, repository constraints, and required output format.
+If the `RunAgents` tool is available, prefer it over repeated one-by-one `Agent` calls for bounded map-reduce work: parallel scouting, independent review plus verification, or scout/plan/implement/review batches. Keep each child prompt focused and include a shared `base_prompt` with the user goal, repository constraints, and required output format. In background mode, never request more children than available background task slots; split larger maps into smaller batches or set `run_in_background=false` for sequential foreground execution.
 
 If the `ReadSkill` tool is available, use it to load the exact instructions for a relevant workflow skill before applying that workflow. This is especially important for `review-pr`, `diagnose-ci-failures`, `fix-errors`, `implement-specs`, `spec-driven-implementation`, `check-impl-against-spec`, `resolve-merge-conflicts`, and `create-pr`.
 

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/agentspec.py

@@ -158,6 +158,15 @@ def _load_agent_spec(agent_file: Path) -> AgentSpec:
         if not isinstance(agent_spec.exclude_tools, Inherit):
             base_agent_spec.exclude_tools = agent_spec.exclude_tools
         if not isinstance(agent_spec.subagents, Inherit):
-            base_agent_spec.subagents = agent_spec.subagents
+            if isinstance(agent_spec.subagents, dict) and isinstance(
+                base_agent_spec.subagents, dict
+            ):
+                # Child entries WIN on key conflicts; base entries fill the rest.
+                base_agent_spec.subagents = {
+                    **base_agent_spec.subagents,
+                    **agent_spec.subagents,
+                }
+            else:
+                base_agent_spec.subagents = agent_spec.subagents
         agent_spec = base_agent_spec
     return agent_spec

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/app.py

@@ -735,15 +735,6 @@ class PythinkerCLI:
         """Run the Pythinker CLI instance with shell UI."""
         from pythinker_code.ui.shell import Shell, WelcomeInfoItem
 
-        if command is None:
-            from pythinker_code.ui.shell.update import (
-                print_update_banner,
-                schedule_auto_update_check,
-            )
-
-            print_update_banner()
-            schedule_auto_update_check()
-
         work_dir = self._runtime.session.work_dir
         welcome_info = [
             WelcomeInfoItem(name="Directory", value=str(shorten_home(work_dir))),

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/background/agent_runner.py

@@ -15,7 +15,11 @@ from pythinker_code.soul import RunCancelled
 from pythinker_code.subagents.builder import SubagentBuilder
 from pythinker_code.subagents.core import SubagentRunSpec, prepare_soul
 from pythinker_code.subagents.output import SubagentOutputWriter
-from pythinker_code.subagents.runner import run_with_summary_continuation
+from pythinker_code.subagents.runner import (
+    _SUMMARY_MIN_LENGTH_BY_TYPE,
+    _SUMMARY_MIN_LENGTH_DEFAULT,
+    run_with_summary_continuation,
+)
 from pythinker_code.utils.logging import logger
 from pythinker_code.wire import Wire
 
@@ -160,6 +164,8 @@ class BackgroundAgentRunner:
             self._runtime.subagent_store,
             on_stage=output.stage,
         )
+        if self._runtime.hook_engine is not None:
+            soul.set_hook_engine(self._runtime.hook_engine)
 
         async def _ui_loop_fn(wire: Wire) -> None:
             wire_ui = wire.ui_side(merge=True)
@@ -173,6 +179,9 @@ class BackgroundAgentRunner:
             prompt,
             _ui_loop_fn,
             self._runtime.subagent_store.wire_path(self._agent_id),
+            min_length=_SUMMARY_MIN_LENGTH_BY_TYPE.get(
+                self._subagent_type, _SUMMARY_MIN_LENGTH_DEFAULT
+            ),
         )
         if failure is not None:
             self._manager._mark_task_failed(self._task_id, failure.message)

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/background/manager.py

@@ -94,6 +94,14 @@ class BackgroundTaskManager:
             1 for view in self._store.list_views() if not is_terminal_status(view.runtime.status)
         )
 
+    def active_task_count(self) -> int:
+        """Return the number of non-terminal background tasks."""
+        return self._active_task_count()
+
+    def available_task_slots(self) -> int:
+        """Return how many new background tasks can be started right now."""
+        return max(0, self._config.max_running_tasks - self._active_task_count())
+
     def has_active_tasks(self) -> bool:
         """Return True if any background tasks are in a non-terminal status.
 

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/cli/__init__.py

@@ -941,6 +941,11 @@ def pythinker(
                         await _delete_empty_session(_latest_created_session)
             raise
 
+    if ui == "shell" and prompt is None:
+        from pythinker_code.ui.shell.update import prompt_pre_start_update
+
+        asyncio.run(prompt_pre_start_update())
+
     if _picker_mode:
         from prompt_toolkit.shortcuts.choice_input import ChoiceInput
         from rich.console import Console

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/hooks/events.py

@@ -148,11 +148,13 @@ def pre_compact(
     cwd: str,
     trigger: str,
     token_count: int,
+    custom_instructions: str = "",
 ) -> dict[str, Any]:
     return {
         **_base("PreCompact", session_id, cwd),
         "trigger": trigger,
         "token_count": token_count,
+        "custom_instructions": custom_instructions,
     }
 
 
@@ -162,11 +164,13 @@ def post_compact(
     cwd: str,
     trigger: str,
     estimated_token_count: int,
+    compact_summary: str = "",
 ) -> dict[str, Any]:
     return {
         **_base("PostCompact", session_id, cwd),
         "trigger": trigger,
         "estimated_token_count": estimated_token_count,
+        "compact_summary": compact_summary,
     }
 
 

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/hooks/runner.py

@@ -18,6 +18,7 @@ class HookResult:
     stderr: str = ""
     exit_code: int = 0
     timed_out: bool = False
+    additional_context: str = ""
 
 
 async def run_hook(
@@ -78,6 +79,7 @@ async def run_hook(
             if isinstance(raw, dict):
                 parsed = cast(dict[str, Any], raw)
                 hook_output = cast(dict[str, Any], parsed.get("hookSpecificOutput", {}))
+                additional_context = _extract_additional_context(parsed, hook_output)
                 if hook_output.get("permissionDecision") == "deny":
                     return HookResult(
                         action="block",
@@ -85,8 +87,40 @@ async def run_hook(
                         stdout=stdout,
                         stderr=stderr,
                         exit_code=0,
+                        additional_context=additional_context,
                     )
+                return HookResult(
+                    action="allow",
+                    stdout=stdout,
+                    stderr=stderr,
+                    exit_code=exit_code,
+                    additional_context=additional_context,
+                )
         except (json.JSONDecodeError, TypeError):
-            pass
+            if _stdout_adds_context(input_data):
+                return HookResult(
+                    action="allow",
+                    stdout=stdout,
+                    stderr=stderr,
+                    exit_code=exit_code,
+                    additional_context=stdout,
+                )
 
     return HookResult(action="allow", stdout=stdout, stderr=stderr, exit_code=exit_code)
+
+
+def _extract_additional_context(parsed: dict[str, Any], hook_output: dict[str, Any]) -> str:
+    """Extract Claude-Code-style additionalContext from JSON hook output."""
+    candidates = (hook_output.get("additionalContext"), parsed.get("additionalContext"))
+    for value in candidates:
+        if isinstance(value, str) and value.strip():
+            return value
+    return ""
+
+
+def _stdout_adds_context(input_data: dict[str, Any]) -> bool:
+    """Whether plain stdout from this hook should be recoverable as context."""
+    event = input_data.get("hook_event_name")
+    if event == "PostCompact":
+        return True
+    return event == "SessionStart" and input_data.get("source") == "compact"

{pythinker_code-0.16.0 → pythinker_code-0.17.0}/src/pythinker_code/session_state.py

@@ -55,6 +55,8 @@ class SessionState(BaseModel):
     auto_archive_exempt: bool = False
     # Todo list state
     todos: list[TodoItemState] = Field(default_factory=list)  # pyright: ignore[reportUnknownVariableType]
+    # Skill names explicitly invoked in this session and restored after compaction.
+    active_skills: list[str] = Field(default_factory=list)
 
 
 _LEGACY_METADATA_FILENAME = "metadata.json"