@oneciel-ai/claude-any 0.1.24 → 0.1.27

package/README.md

@@ -3,6 +3,10 @@
 | English | [한국어](docs/README.ko.md) | [日本語](docs/README.ja.md) | [中文](docs/README.zh.md) |
 | --- | --- | --- | --- |
 
+[![npm version](https://img.shields.io/npm/v/@oneciel-ai/claude-any?logo=npm&label=npm)](https://www.npmjs.com/package/@oneciel-ai/claude-any)
+[![npm downloads](https://img.shields.io/npm/dm/@oneciel-ai/claude-any?logo=npm&label=downloads)](https://www.npmjs.com/package/@oneciel-ai/claude-any)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
 > ## 🚀 Use the full Claude Code experience with free or low-cost LLMs
 >
 > - **Free** — [NVIDIA hosted NIM](https://build.nvidia.com/) (qwen3-coder-480b, gpt-oss, and friends) through the API Catalog.
@@ -30,7 +34,7 @@ arguments through unchanged.
 
 Credits: One Ciel LLC
 
-Current version: `0.1.24`
+Current version: `0.1.27`
 
 ## Why This Exists
 
@@ -59,74 +63,78 @@ portable Python and shell wrappers. If you hit a macOS issue, please report it.
 
 ## Install
 
+[![npm version](https://img.shields.io/npm/v/@oneciel-ai/claude-any.svg)](https://www.npmjs.com/package/@oneciel-ai/claude-any)
+[![npm downloads](https://img.shields.io/npm/dm/@oneciel-ai/claude-any.svg)](https://www.npmjs.com/package/@oneciel-ai/claude-any)
+
 Requirements:
 
 - Python 3.10+
 - Claude Code installed and available as `claude`
-- Node/npm only if you enable MCP web tooling
+- Node/npm (used for the install shim and optional MCP web tooling)
 
-Current install from GitHub:
+**Install from the npm registry (recommended):**
 
 ```sh
-npm install -g https://github.com/OneCielAI/claude-any.git
+npm install -g @oneciel-ai/claude-any
 claude-any
 ```
 
-Source install:
+**Upgrade:**
 
 ```sh
-git clone https://github.com/OneCielAI/claude-any.git
-cd claude-any
-./install.sh
-claude-any
+npm update -g @oneciel-ai/claude-any
+claude-any version
 ```
 
-Windows PowerShell source install:
+**Uninstall:**
 
-```powershell
-git clone https://github.com/OneCielAI/claude-any.git
-cd claude-any
-.\install.ps1
-claude-any
+```sh
+npm uninstall -g @oneciel-ai/claude-any
 ```
 
-Registry install, after the first npm publish:
+### Alternative install paths
+
+Install directly from the GitHub repository (useful for testing unreleased
+commits between npm publishes):
 
 ```sh
-npm install -g @oneciel-ai/claude-any
+npm install -g https://github.com/OneCielAI/claude-any.git
 claude-any
 ```
 
-Upgrade:
+POSIX source install:
 
 ```sh
-# GitHub install, current recommended path
-npm install -g https://github.com/OneCielAI/claude-any.git --force
-claude-any version
+git clone https://github.com/OneCielAI/claude-any.git
+cd claude-any
+./install.sh
+claude-any
 ```
 
-To make `npm update -g @oneciel-ai/claude-any` work, the package must be
-published to the public npm registry under the same package name:
+Windows PowerShell source install:
 
-```sh
-npm login
-npm publish --access public
-npm install -g @oneciel-ai/claude-any
-npm update -g @oneciel-ai/claude-any
+```powershell
+git clone https://github.com/OneCielAI/claude-any.git
+cd claude-any
+.\install.ps1
+claude-any
 ```
 
-For automated publishing, create an npm automation token, save it as the
-repository secret `NPM_TOKEN`, then publish a GitHub Release or run the
-`Publish to npm` workflow manually.
+### Releasing (maintainers)
 
-Versioning uses SemVer. For future releases, bump `version` in `package.json`,
-create a matching Git tag such as `v0.1.1`, and publish a GitHub Release to
-trigger the npm publish workflow. After registry publication, the normal
-registry upgrade command will be:
+The npm registry version is published automatically by the
+[`Publish to npm`](.github/workflows/npm-publish.yml) workflow when a new
+GitHub Release is published. The workflow needs an `NPM_TOKEN` repository
+secret containing a granular access token for `@oneciel-ai/claude-any` with
+*Bypass 2FA for publishing* enabled.
 
-```sh
-npm update -g @oneciel-ai/claude-any
-```
+Release flow:
+
+1. Bump `version` in `package.json` and `VERSION` in `claude_any.py`.
+2. Add a Changelog entry.
+3. `git tag -a vX.Y.Z -m "..." && git push origin vX.Y.Z`.
+4. `gh release create vX.Y.Z --title "..." --notes "..."` — this triggers
+   the publish workflow.
 
 
 ![Claude Any menu](docs/assets/claude-any-main.en.png)
@@ -235,9 +243,38 @@ steps under that larger model's supervision.
   `Cannot create agent worktree: not in a git repository...`.
 - Config file caching — settings are read from disk once and reused until the
   file changes, reducing per-request overhead in the router.
+- Router control-plane endpoints for headless agent coordination:
+  `/ca/chat/messages`, `/ca/chat/wait`, `/ca/chat/stream`, `/ca/chat/files`,
+  and `/ca/plan/artifacts`.
 
 ## Changelog
 
+### 0.1.27
+
+- **Plan mode support for non-Anthropic providers**: the router now keeps
+  `EnterPlanMode` available and supports Claude Code Plan mode even when the
+  upstream model does not reliably choose that internal tool. Forced
+  `tool_choice=EnterPlanMode` is answered locally with a valid Anthropic
+  `tool_use`, and long implementation requests that receive only a short or
+  empty non-actionable text response are promoted to `EnterPlanMode` using
+  language-agnostic structure checks.
+- **Plan-mode self-tool handling**: unsupported Claude Code self-tools are
+  still stripped for non-Anthropic providers, but Plan-mode tools are handled
+  separately so planning can work instead of being disabled.
+
+### 0.1.25
+
+- **Plan-mode diagnostics**: set `~/.config/claude-any/log-level` to `TRACE`
+  to capture redacted request and response summaries in `requests.jsonl` /
+  `responses.jsonl`.
+- **Headless agent chat service**: the router exposes a small HTTP control
+  plane for sub coding agents. Agents can post messages, poll updates after
+  the last seen message id, or wait on an SSE stream when they do not have
+  their own loop.
+- **Plan artifact serving**: agents can create plan files through the router
+  and share stable local URLs, matching Claude Code's file/artifact-oriented
+  Plan-mode workflow without copying Anthropic's internal implementation.
+
 ### 0.1.24
 
 - **First public npm release** under the correct scope: `@oneciel-ai/claude-any`. Earlier 0.1.x versions were never published to the registry; this is the version that is actually installable via `npm install -g @oneciel-ai/claude-any`.
@@ -414,6 +451,29 @@ claude-any --ca-no-update-check -p "Reply with OK only." --output-format text
 
 All other arguments are passed through to Claude Code.
 
+## Headless Agent Chat
+
+When the claude-any router is running, sub agents can coordinate through local
+HTTP endpoints without opening the menu:
+
+```sh
+# Send a message to a channel.
+curl -s http://127.0.0.1:8799/ca/chat/messages \
+  -H 'content-type: application/json' \
+  -d '{"channel":"agents","sender_id":"codex","recipients":["kimi"],"message":"Need logs after id 42"}'
+
+# Poll updates after the last message id.
+curl -s 'http://127.0.0.1:8799/ca/chat/messages?channel=agents&recipient=kimi&after=42'
+
+# Wait on a stream until messages arrive.
+curl -N 'http://127.0.0.1:8799/ca/chat/stream?channel=agents&recipient=kimi&after=42&timeout=300'
+
+# Publish a plan file and get a served URL.
+curl -s http://127.0.0.1:8799/ca/plan/artifacts \
+  -H 'content-type: application/json' \
+  -d '{"title":"handoff","name":"handoff.md","content":"# Plan\n- step 1"}'
+```
+
 ## Security
 
 Do not commit runtime configuration or API keys. Claude Any stores local runtime