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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythinker-code
-Version: 0.15.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.15.0
+## 🆕 What's New in 0.17.0
 
-- **Native updater fixed for curl-bash installs.** `pythinker update` now recognizes PyInstaller-frozen `~/.local/bin/pythinker` binaries as native installs even when older onefile tarballs lack the `.pythinker-native` sentinel.
-- **Unix native updates pull release archives directly.** On Linux and Apple Silicon macOS, `pythinker update` downloads the matching `pythinker-0.15.0-<target>.tar.gz`, verifies its `.sha256`, and replaces the current native binary instead of trying to run `pythinker -m pip install`.
-- **Clearer fallback guidance.** Native update banners now point Unix users at the canonical `curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.15.0` command, while Windows still points at the native setup executable.
+- **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.15.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).
 
 
 ---
@@ -210,15 +211,13 @@ Swap providers and models per-session: `--model openai/gpt-5.5`, hosted Pythinke
 Pythinker ships **native installers for every platform**. Pick the row that
 matches your OS — no Python, Node, or `uv` prerequisite.
 
-| Platform | One-line install | Artifact |
+| Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | native `.exe` installer |
-| **🍎 macOS (Apple Silicon + Intel)** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | Homebrew tap |
-| **🐧 Linux (Debian / Ubuntu)** | `sudo dpkg -i pythinker-code_0.15.0_amd64.deb` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🐧 Linux (Fedora / RHEL)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo dnf install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🐧 Linux (openSUSE)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo zypper install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🌐 macOS / Linux — curl-bash** | `curl -fsSL https://pythinker.com/install.sh \| bash` | tarball |
-| **🐍 Python fallback** (universal) | `pip install pythinker-code` | PyPI |
+| **🪟 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
 any platform with `sha256sum`, `shasum -a 256`, or `Get-FileHash`.
@@ -239,7 +238,7 @@ pythinker                      # start the interactive TUI
 
 ### 🪟 Windows — native installer
 
-`PythinkerSetup-0.15.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.**
@@ -250,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.15.0.exe
+.\PythinkerSetup-0.17.0.exe
 
 # Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.15.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
@@ -273,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
@@ -299,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.15.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.15.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.15.0/pythinker-code-0.15.0.x86_64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.15.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.15.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.17.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.15.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.15.0/pythinker-code-0.15.0.aarch64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.15.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.15.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
@@ -334,8 +333,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 
 ```sh
-sha256sum -c pythinker-code_0.15.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.15.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` /
@@ -351,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
@@ -365,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.15.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
@@ -386,9 +385,9 @@ Supported targets:
 
 | `uname -s / -m`             | Tarball asset                                            |
 |---|---|
-| Linux / x86_64              | `pythinker-0.15.0-x86_64-unknown-linux-gnu.tar.gz`        |
-| Linux / aarch64             | `pythinker-0.15.0-aarch64-unknown-linux-gnu.tar.gz`       |
-| Darwin / arm64              | `pythinker-0.15.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`;
@@ -396,34 +395,16 @@ no PyInstaller-built Intel Darwin binary is published.
 
 **Uninstall:** `rm ~/.local/bin/pythinker`.
 
-### 🛠 Power-user / legacy install paths
+### 🐍 Python fallback
 
-> 🚧 **Deprecated.** These paths still work, but the per-OS native installers
-> above are the canonical install method for **all new releases**. The legacy
-> options below remain for existing automation; new tooling, examples, and
-> support docs target the native installers exclusively.
-
-<details>
-<summary>Legacy shell-script wrappers + uv / pipx</summary>
+Use the Python package only when a native installer is not available for your
+environment:
 
 ```sh
-# Compatibility shim to the native installer
-scripts/install.sh
-# Windows PowerShell native installer bootstrap:
-powershell -c "irm https://pythinker.com/install.ps1 | iex"
-
-# Legacy: one-off run via uvx
-uvx pythinker-code
-
-# Legacy: install as a uv tool
-uv tool install pythinker-code
-
-# Legacy: PyPI directly (universal fallback)
 pip install pythinker-code
-pipx install pythinker-code
 ```
 
-</details>
+Native installs remain the supported path for new users and for in-app updates.
 
 ### 🔐 Authenticate (optional)
 

{pythinker_code-0.15.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.15.0
+## 🆕 What's New in 0.17.0
 
-- **Native updater fixed for curl-bash installs.** `pythinker update` now recognizes PyInstaller-frozen `~/.local/bin/pythinker` binaries as native installs even when older onefile tarballs lack the `.pythinker-native` sentinel.
-- **Unix native updates pull release archives directly.** On Linux and Apple Silicon macOS, `pythinker update` downloads the matching `pythinker-0.15.0-<target>.tar.gz`, verifies its `.sha256`, and replaces the current native binary instead of trying to run `pythinker -m pip install`.
-- **Clearer fallback guidance.** Native update banners now point Unix users at the canonical `curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.15.0` command, while Windows still points at the native setup executable.
+- **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.15.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).
 
 
 ---
@@ -145,15 +146,13 @@ Swap providers and models per-session: `--model openai/gpt-5.5`, hosted Pythinke
 Pythinker ships **native installers for every platform**. Pick the row that
 matches your OS — no Python, Node, or `uv` prerequisite.
 
-| Platform | One-line install | Artifact |
+| Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | native `.exe` installer |
-| **🍎 macOS (Apple Silicon + Intel)** | `brew install mohamed-elkholy95/pythinker/pythinker-code` | Homebrew tap |
-| **🐧 Linux (Debian / Ubuntu)** | `sudo dpkg -i pythinker-code_0.15.0_amd64.deb` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🐧 Linux (Fedora / RHEL)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo dnf install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🐧 Linux (openSUSE)** | Download `pythinker-code-0.15.0.x86_64.rpm`, then `sudo zypper install ./pythinker-code-0.15.0.x86_64.rpm` | [Releases](https://github.com/mohamed-elkholy95/Pythinker-Code/releases/latest) |
-| **🌐 macOS / Linux — curl-bash** | `curl -fsSL https://pythinker.com/install.sh \| bash` | tarball |
-| **🐍 Python fallback** (universal) | `pip install pythinker-code` | PyPI |
+| **🪟 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
 any platform with `sha256sum`, `shasum -a 256`, or `Get-FileHash`.
@@ -174,7 +173,7 @@ pythinker                      # start the interactive TUI
 
 ### 🪟 Windows — native installer
 
-`PythinkerSetup-0.15.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.**
@@ -185,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.15.0.exe
+.\PythinkerSetup-0.17.0.exe
 
 # Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.15.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
@@ -208,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
@@ -234,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.15.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.15.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.15.0/pythinker-code-0.15.0.x86_64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.15.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.15.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.17.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.15.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.15.0/pythinker-code-0.15.0.aarch64.rpm
-curl -LO https://github.com/mohamed-elkholy95/Pythinker-Code/releases/download/v0.15.0/pythinker-code-0.15.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.15.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.15.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
@@ -269,8 +268,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 
 ```sh
-sha256sum -c pythinker-code_0.15.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.15.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` /
@@ -286,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
@@ -300,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.15.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
@@ -321,9 +320,9 @@ Supported targets:
 
 | `uname -s / -m`             | Tarball asset                                            |
 |---|---|
-| Linux / x86_64              | `pythinker-0.15.0-x86_64-unknown-linux-gnu.tar.gz`        |
-| Linux / aarch64             | `pythinker-0.15.0-aarch64-unknown-linux-gnu.tar.gz`       |
-| Darwin / arm64              | `pythinker-0.15.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`;
@@ -331,34 +330,16 @@ no PyInstaller-built Intel Darwin binary is published.
 
 **Uninstall:** `rm ~/.local/bin/pythinker`.
 
-### 🛠 Power-user / legacy install paths
+### 🐍 Python fallback
 
-> 🚧 **Deprecated.** These paths still work, but the per-OS native installers
-> above are the canonical install method for **all new releases**. The legacy
-> options below remain for existing automation; new tooling, examples, and
-> support docs target the native installers exclusively.
-
-<details>
-<summary>Legacy shell-script wrappers + uv / pipx</summary>
+Use the Python package only when a native installer is not available for your
+environment:
 
 ```sh
-# Compatibility shim to the native installer
-scripts/install.sh
-# Windows PowerShell native installer bootstrap:
-powershell -c "irm https://pythinker.com/install.ps1 | iex"
-
-# Legacy: one-off run via uvx
-uvx pythinker-code
-
-# Legacy: install as a uv tool
-uv tool install pythinker-code
-
-# Legacy: PyPI directly (universal fallback)
 pip install pythinker-code
-pipx install pythinker-code
 ```
 
-</details>
+Native installs remain the supported path for new users and for in-app updates.
 
 ### 🔐 Authenticate (optional)
 

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

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

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

@@ -15,6 +15,28 @@ 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
+
+- **Standardized native install docs across platforms.** README Quick Start now presents one canonical Windows command (`irm https://pythinker.com/install.ps1 | iex`) and one canonical macOS/Linux command (`curl -fsSL https://pythinker.com/install.sh | bash`) before package-manager/manual alternatives.
+- **Removed old local installer guidance.** User-facing docs no longer advertise legacy local shell wrappers or Python-tool manager shortcuts. `pip install pythinker-code==0.16.0` remains as the universal Python fallback and release-gate snippet.
+- **Aligned release artifact instructions.** Manual Windows, Linux package, and tarball sections all point at `0.16.0` GitHub Release assets and keep SHA-256 verification explicit.
+
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.16.0`, or use the native installer for your OS (see the README install table).
+
 ## 0.15.0 (2026-05-24)
 
 ### What changed in this release

{pythinker_code-0.15.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.15.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.15.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.15.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.15.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.15.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.15.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,
     }