needle-cloud 2.11.0 → 2.11.1

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [2.11.1] - 2026-10-16
+### Added
+- Opt-in inline chat tool calls with `capabilities.inlineToolCalls`, ordered message parts, and the `updateInlineChatParts` streaming helper.
+
+### Fixed
+- Published TypeScript declarations export the inline chat helper and its public types.
+
+## [2.11.0] - 2026-10-15
+### Added
+- `stop` (alias `quit`) requests an authenticated shutdown of the local license/MCP server and exits. Existing servers without the new endpoint report that manual shutdown is required.
+
 ## [2.10.0] - 2026-10-14
 ### Added
 - `label list` and `label set` to inspect labels, promote a completed version, create custom labels, or roll back, with JSON output and token/team support.

package/README.md

@@ -35,6 +35,25 @@ npx needle-cloud help <command>    # Help for a specific command
 - `start` — Start the local server for licensing, editor integrations, and MCP tools
 - `settings` — View CLI settings, including [local tool access for Needle Cloud AI](#local-tools-in-needle-cloud-ai)
 
+## Stop the local license server
+
+Close Unity or other integrations that may automatically start the server, then run:
+
+```bash
+npx needle-cloud stop
+```
+
+`quit` is an alias. The command authenticates with the local server token, requests
+shutdown, and exits. It does not sign you out, remove settings, or kill unrelated
+Node.js processes. The shared licensing/MCP server disconnects from Cloud and
+closes its HTTP and WebSocket connections, allowing up to three seconds to drain.
+
+If the server is not running, the command exits successfully. Older running
+versions without the stop endpoint must be closed manually once; this command
+cannot add shutdown support to an already-running old server. After that, start
+the updated CLI or reopen your project. `needle-cloud status` shows the running
+server's port and PID.
+
 ## Upload assets
 
 ```bash
@@ -223,6 +242,25 @@ Or use the official [GitHub Action](https://github.com/marketplace/actions/deplo
     name: my-project
 ```
 
+## AI evaluation images and quota actions
+
+The web API accepts PNG/JPEG image parts in evaluation state:
+
+```js
+import { aiEvaluate } from "needle-cloud";
+
+const result = await aiEvaluate(
+  ["Current viewport", { type: "image_url", image_url: { url: pngDataUrl } }],
+  { visible: { type: "boolean", instructions: "Is the selected object visible?" } },
+  undefined,
+  { org: teamId },
+);
+```
+
+Use base64 data URLs, not remote image URLs. A request supports up to four images with 2 MiB of decoded data in total, plus 128,000 characters of JSON text excluding the image URLs. Images must be 256–1,568 pixels on each side and at least 78,400 pixels in total. Image evaluation is experimental; resize screenshots before sending them.
+
+Chat quota failures expose `details` on HTTP `AIChatError` objects and streamed `error` events. Evaluation errors also expose `details`. The quota metadata contains `code: "ai_allowance_exhausted"`, `account_id`, a readable `message`, and `actions` with `kind`, `label`, and `url` fields. Render these as links: `top_up` opens the team's top-up control; `view_usage` opens its usage section. Opening a link does not automatically purchase credits. Older servers may return text-only errors without `details`.
+
 ## Links
 
 - [Needle Cloud](https://cloud.needle.tools)