@sylphx/iris 0.1.9 → 0.2.0

package/README.md

@@ -2,9 +2,11 @@
 
 # Iris
 
-### Image evidence for agents 
+### Image evidence for agents
 
-**Iris** (transitional package `@sylphx/image-reader-mcp`) — **Rust-first** local image facts, not default VLM guesses. `sharp`/`exifr` are optional, not required for MCP.
+Canonical package: **`@sylphx/iris`** · bin **`iris`** 
+
+**Iris** — **Rust-first** local image facts (`@sylphx/iris`) local image facts, not default VLM guesses. `sharp`/`exifr` are optional, not required for MCP.
 
 <p align="center">
   <img src="https://mark.sylphx.com/api/v1/banner?type=holo&theme=tokyonight&text=image+reader+mcp&desc=Evidence-first+image+reading+for+AI+agents+%E2%80%94+metadata%2C+OCR+text%2C+regions%2C+and+ci&height=200&animation=rise&credit=0" alt="image-reader-mcp — Sylphx Mark banner" width="100%" />
@@ -16,7 +18,7 @@ Evidence-first image reading for AI agents. One call turns any local image into
 **Agent Media Twin** — dimensions, metadata, optional OCR with bounding boxes, and
 trust warnings you can cite without asking a vision LLM to guess.
 
-[![npm version](https://img.shields.io/npm/v/@sylphx/image-reader-mcp?style=flat-square)](https://www.npmjs.com/package/@sylphx/image-reader-mcp)
+[![npm version](https://img.shields.io/npm/v/@sylphx/iris?style=flat-square)](https://www.npmjs.com/package/@sylphx/iris)
 [![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](https://opensource.org/licenses/MIT)
 [![CI/CD](https://img.shields.io/github/actions/workflow/status/SylphxAI/image-reader-mcp/ci.yml?style=flat-square&label=CI/CD)](https://github.com/SylphxAI/image-reader-mcp/actions/workflows/ci.yml)
 [![TypeScript](https://img.shields.io/badge/TypeScript-7.0-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
@@ -37,13 +39,23 @@ Each instrument is an independent repository (marketplace + stars).
 
 
 
+## See objects (L2, optional)
+
+With a local Florence-class sidecar or Ollama, the same `read_image` can return **open-vocab objects** with pixel bboxes and scores:
+
+```json
+{ "path": "/abs/photo.jpg", "include_semantics": true, "semantics_prompt": "people and animals" }
+```
+
+Objects are `scored_non_locator` evidence — deterministic L0/L1 facts (geometry/OCR/layout) stay authoritative and always on.
+
 ## Read images (not vague vision)
 
 Iris is **local-first**: geometry + OCR + **layout blocks** + **agent_map** so a text-only agent can understand picture architecture without a vision model.
 
 Spec: [docs/specs/agent-image-read-contract.md](docs/specs/agent-image-read-contract.md)
 
-**Local-first frontier:** Rust decode, Tesseract native layout (no npm ML), optional Ollama VLM; cloud URL optional. Zero API key.
+**Local-first frontier:** Rust decode, Tesseract native layout (no npm ML), optional Ollama VLM; cloud URL optional. Zero API key. Optional **L2 local semantics** (include_semantics) detects open-vocab objects (people/animals/things) with pixel bboxes via an official Florence-class sidecar (examples/florence-sidecar/) or Ollama -- never authority over OCR/layout locators.
 
 ## Product docs
 
@@ -86,15 +98,15 @@ an image, not a creative caption.**
 ### Install (30 seconds)
 
 ```bash
-npm install -g @sylphx/image-reader-mcp
+npm install -g @sylphx/iris
 iris doctor
-claude mcp add iris -- npx @sylphx/image-reader-mcp
+claude mcp add iris -- npx @sylphx/iris
 ```
 
 **Install once. Call once.**
 
 ```bash
-claude mcp add image-reader -- npx @sylphx/image-reader-mcp
+claude mcp add image-reader -- npx @sylphx/iris
 ```
 
 ```json
@@ -148,7 +160,7 @@ Supported formats: PNG, JPEG, GIF, WebP, TIFF, and other formats the **Rust deco
 ### Claude Code
 
 ```bash
-claude mcp add image-reader -- npx @sylphx/image-reader-mcp
+claude mcp add image-reader -- npx @sylphx/iris
 ```
 
 ### Claude Desktop
@@ -160,7 +172,7 @@ Add this to `claude_desktop_config.json`:
   "mcpServers": {
     "image-reader": {
       "command": "npx",
-      "args": ["@sylphx/image-reader-mcp"]
+      "args": ["@sylphx/iris"]
     }
   }
 }
@@ -169,7 +181,7 @@ Add this to `claude_desktop_config.json`:
 ### Any MCP Client
 
 ```bash
-npx @sylphx/image-reader-mcp
+npx @sylphx/iris
 ```
 
 Node.js `>=22.13` is required. Optional OCR uses a local Tesseract adapter when
@@ -219,7 +231,7 @@ Example `read_image` requests live in [`examples/`](examples/).
 ## Support
 
 - [Issues](https://github.com/SylphxAI/image-reader-mcp/issues)
-- [npm package](https://www.npmjs.com/package/@sylphx/image-reader-mcp)
+- [npm package](https://www.npmjs.com/package/@sylphx/iris)
 - Portfolio orchestration: [smart-reader-mcp](https://github.com/SylphxAI/smart-reader-mcp)
 
 ## Help this reach more builders

package/bin/{image-reader-mcp → iris}

@@ -23,10 +23,10 @@ host_platform_key() {
 
 platform_package_name() {
 	case "$(host_platform_key)" in
-		darwin-arm64) printf '%s\n' '@sylphx/image-reader-mcp-darwin-arm64' ;;
-		darwin-x64) printf '%s\n' '@sylphx/image-reader-mcp-darwin-x64' ;;
-		linux-x64) printf '%s\n' '@sylphx/image-reader-mcp-linux-x64-gnu' ;;
-		linux-arm64) printf '%s\n' '@sylphx/image-reader-mcp-linux-arm64-gnu' ;;
+		darwin-arm64) printf '%s\n' '@sylphx/iris-darwin-arm64' ;;
+		darwin-x64) printf '%s\n' '@sylphx/iris-darwin-x64' ;;
+		linux-x64) printf '%s\n' '@sylphx/iris-linux-x64-gnu' ;;
+		linux-arm64) printf '%s\n' '@sylphx/iris-linux-arm64-gnu' ;;
 		*) return 1 ;;
 	esac
 }
@@ -47,7 +47,7 @@ resolve_from_optional_dep() {
 		"$PACKAGE_ROOT/../../node_modules"
 	)
 	for root in "${search_roots[@]}"; do
-		candidate="$root/$pkg_name/image-reader-mcp-server"
+		candidate="$root/$pkg_name/iris-mcp-server"
 		if is_runnable_native "$candidate"; then
 			printf '%s\n' "$candidate"
 			return 0
@@ -61,7 +61,7 @@ resolve_from_optional_dep() {
           const { createRequire } = require('node:module');
           const r = createRequire(p.join(process.argv[1], 'package.json'));
           const pkg = r.resolve(process.argv[2] + '/package.json');
-          process.stdout.write(p.join(p.dirname(pkg), 'image-reader-mcp-server'));
+          process.stdout.write(p.join(p.dirname(pkg), 'iris-mcp-server'));
         } catch { process.exit(1); }
       " "$PACKAGE_ROOT" "$pkg_name" 2>/dev/null || true
 		)"
@@ -74,8 +74,8 @@ resolve_from_optional_dep() {
 }
 
 resolve_rust_bin() {
-	if [[ -n "${IMAGE_READER_MCP_RUST_BIN:-}" && -x "${IMAGE_READER_MCP_RUST_BIN}" ]]; then
-		printf '%s\n' "${IMAGE_READER_MCP_RUST_BIN}"
+	if [[ -n "${IRIS_RUST_BIN:-}" && -x "${IRIS_RUST_BIN}" ]]; then
+		printf '%s\n' "${IRIS_RUST_BIN}"
 		return 0
 	fi
 	if bin="$(resolve_from_optional_dep)"; then
@@ -83,9 +83,9 @@ resolve_rust_bin() {
 		return 0
 	fi
 	for candidate in \
-		"$PACKAGE_ROOT/bin/native/image-reader-mcp-server" \
-		"$PACKAGE_ROOT/target/release/image-reader-mcp-server" \
-		"$PACKAGE_ROOT/target/debug/image-reader-mcp-server"; do
+		"$PACKAGE_ROOT/bin/native/iris-mcp-server" \
+		"$PACKAGE_ROOT/target/release/iris-mcp-server" \
+		"$PACKAGE_ROOT/target/debug/iris-mcp-server"; do
 		if is_runnable_native "$candidate"; then
 			printf '%s\n' "$candidate"
 			return 0
@@ -115,5 +115,5 @@ if bin="$(resolve_rust_bin)"; then
 	exec "$bin" "$@"
 fi
 
-echo "[iris] Rust MCP server not found. Install matching optional native package (@sylphx/image-reader-mcp-<platform>) or run: bun run build:rust" >&2
+echo "[iris] Rust MCP server not found. Install matching optional native package (@sylphx/iris-<platform>) or run: bun run build:rust" >&2
 exit 1

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "@sylphx/iris",
-  "version": "0.1.9",
-  "mcpName": "io.github.SylphxAI/image-reader-mcp",
-  "description": "Iris — Evidence-first image reading for AI agents — metadata, OCR text, regions, and citeable evidence without generative LLM. (brand alias of @sylphx/image-reader-mcp)",
+  "version": "0.2.0",
+  "mcpName": "io.github.SylphxAI/iris",
+  "description": "Iris \u2014 evidence-first image reading for AI agents. Metadata, OCR text, regions, citeable evidence. Local-first. No generative LLM authority.",
   "type": "module",
   "bin": {
-    "image-reader-mcp": "./bin/image-reader-mcp",
-    "iris": "./bin/image-reader-mcp"
+    "iris": "./bin/iris"
   },
   "files": [
-    "bin/image-reader-mcp",
+    "bin/iris",
     "dist/",
     "README.md",
     "LICENSE",
@@ -17,8 +16,7 @@
   ],
   "exports": {
     ".": "./dist/doctor-cli.js",
-    "./sdk": "./src/sdk.ts",
-    "./iris": "./src/sdk.ts"
+    "./sdk": "./src/sdk.ts"
   },
   "publishConfig": {
     "access": "public"
@@ -60,8 +58,9 @@
     "benchmark:release-gate": "bun scripts/release-gate.ts",
     "sync:server-json": "bun scripts/sync-server-json.ts",
     "version-packages": "changeset version && bun run sync:server-json",
-    "start": "./bin/image-reader-mcp",
+    "start": "./bin/iris",
     "clean": "rm -rf dist coverage",
+    "prepublishOnly": "bun run clean && bun run build && bun run build:rust",
     "release": "bun run typecheck && bun run check && bun run build && bun test && changeset publish",
     "benchmark:public-proof": "bun scripts/public-proof.ts",
     "brand:pack-plan": "bun scripts/brand-pack-plan.ts"
@@ -83,9 +82,9 @@
   "optionalDependencies": {
     "sharp": "^0.35.0",
     "exifr": "^7.1.3",
-    "@sylphx/image-reader-mcp-darwin-arm64": "0.1.9",
-    "@sylphx/image-reader-mcp-darwin-x64": "0.1.9",
-    "@sylphx/image-reader-mcp-linux-x64-gnu": "0.1.9",
-    "@sylphx/image-reader-mcp-linux-arm64-gnu": "0.1.9"
+    "@sylphx/iris-darwin-arm64": "0.2.0",
+    "@sylphx/iris-darwin-x64": "0.2.0",
+    "@sylphx/iris-linux-x64-gnu": "0.2.0",
+    "@sylphx/iris-linux-arm64-gnu": "0.2.0"
   }
-}
+}